Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Change annotation name #43

Merged
merged 1 commit into from
Jan 29, 2025
Merged

Change annotation name #43

merged 1 commit into from
Jan 29, 2025

Conversation

jasondlee
Copy link
Collaborator

Rename DockerRequired to ContainerRequired
Clean up stray references to "docker"

Resolves #39.

@jasondlee jasondlee requested a review from jamezp November 18, 2024 17:58
@rhusar rhusar self-requested a review November 18, 2024 18:27
Copy link
Collaborator

@rhusar rhusar left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I was hoping to some aggressive discussion/voting on that issue. I have to say my favorite is @ContainerRuntimeRequired.

@jasondlee
Copy link
Collaborator Author

I was hoping to some aggressive discussion/voting on that issue. I have to say my favorite is @ContainerRuntimeRequired.

And we can have that. :) I just pushed this so I didn't lose the changes I had locally.

@jasondlee jasondlee marked this pull request as ready for review January 28, 2025 19:05
@jasondlee jasondlee requested a review from rhusar January 28, 2025 19:05
Copy link
Collaborator

@rhusar rhusar left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

After more discussions with @jamezp I believe this should be actually called '@TestcontainersRequired'. What we need the annotation to specify, is that Testcontainers client works. This is to my knowledge currently the same as podman or docker required, but this may not always be the case. Also, that's what the implementation checks for.

@jamezp
Copy link
Collaborator

jamezp commented Jan 28, 2025

After more discussions with @jamezp I believe this should be actually called '@TestcontainersRequired'. What we need the annotation to specify, is that Testcontainers client works. This is to my knowledge currently the same as podman or docker required, but this may not always be the case. Also, that's what the implementation checks for.

This makes the most sense to me as well.

*
* <pre>
* &#064;ExtendWith(ArquillianExtension.class)
* &#064;RunAsClient
* // By throwing the TestAbortedException, the test will be skipped if docker is not available
* // By throwing the TestAbortedException, the test will be skipped if a container engine is not available
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a very minor comment. Should this "a Testcontainer engine"? I don't have a real strong opinion either way.

Copy link
Collaborator

@rhusar rhusar Jan 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I also think this needs a different wording, but I am not yet sure what's the ideal wording :)

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm fine to leave it as is, but no strong opinion either. I think, though, that the "engine" is either Docker or Podman (at this point), whereas Testcontainers is the... orchestration tool that starts a "container" using whatever "engine" is available in the environment.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I also think this needs a different wording, but I am not yet sure what's the ideal wording :)

Well, it seems that whole Javadoc is pretty outdated anyway. That sample code is pretty rough. Let me revisit that...

Copy link
Collaborator

@rhusar rhusar Jan 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Though "Testcontainer engine" is not a thing, how about going the descriptive way something like "the test will be skipped if Testcontainers requirements are not available." or just "Testcontainers are not available."

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@rhusar @jamezp, Updated the sample code and just removed the comment altogether.

Rename DockerRequired to ContainerRequired
Clean up stray references to "docker"
Copy link
Collaborator

@jamezp jamezp left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm good with whatever wording we choose. I like the annotation name so I'm approving :)

@jasondlee
Copy link
Collaborator Author

I think we have a consensus, so I'm going to merge this. If you want any further changes, @rhusar, please follow up with an issue.

@jasondlee jasondlee merged commit f7b1260 into arquillian:main Jan 29, 2025
7 checks passed
@jasondlee jasondlee deleted the ARQTC-39 branch January 29, 2025 14:23
@rhusar
Copy link
Collaborator

rhusar commented Jan 29, 2025

Agreed! Thanks.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Better name for @DockerRequired
3 participants