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

Documentation: Add a note related to quarkus-picocli in dev mode #43282

Merged
merged 1 commit into from
Sep 23, 2024

Conversation

jcarranzan
Copy link
Contributor

@jcarranzan jcarranzan commented Sep 13, 2024

This adds a note to the Quarkus-picocli guide docs regarding the lifecycle behavior in dev mode.
The motivation was this issue--> #43182

@quarkus-bot
Copy link

quarkus-bot bot commented Sep 13, 2024

Thanks for your pull request!

Your pull request does not follow our editorial rules. Could you have a look?

  • title should preferably start with an uppercase character (if it makes sense!)

This message is automatically generated by a bot.

@mkouba
Copy link
Contributor

mkouba commented Sep 13, 2024

This PR documents the problem discussed in #43182.

@mkouba mkouba changed the title [docs] Add a note related to quarkus-picocli in dev mode Documentation: add a note related to quarkus-picocli in dev mode Sep 13, 2024
Copy link

github-actions bot commented Sep 13, 2024

🙈 The PR is closed and the preview is expired.

@quarkus-bot

This comment has been minimized.

@geoand
Copy link
Contributor

geoand commented Sep 13, 2024

I assume that this PR would close the linked issue?

@jcarranzan jcarranzan changed the title Documentation: add a note related to quarkus-picocli in dev mode Documentation: Add a note related to quarkus-picocli in dev mode Sep 17, 2024
@jcarranzan
Copy link
Contributor Author

@mkouba could it be merged?

@@ -298,6 +298,10 @@ annotationProcessor 'info.picocli:picocli-codegen'
== Development Mode

In the development mode, i.e. when running `mvn quarkus:dev`, the application is executed and restarted every time the `Space bar` key is pressed. You can also pass arguments to your command line app via the `quarkus.args` system property, e.g. `mvn quarkus:dev -Dquarkus.args='--help'` and `mvn quarkus:dev -Dquarkus.args='-c -w --val 1'`.
[NOTE]
====
If you're creating a typical Quarkus application (e.g., HTTP-based services) that includes command-line functionality, you'll need to handle the application's lifecycle differently. In the Runnable.run() method of your command, make sure to use `Quarkus.waitForExit()` or `Quarkus.asyncExit()`. This will prevent the application from shutting down prematurely and ensure a proper shutdown process.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
If you're creating a typical Quarkus application (e.g., HTTP-based services) that includes command-line functionality, you'll need to handle the application's lifecycle differently. In the Runnable.run() method of your command, make sure to use `Quarkus.waitForExit()` or `Quarkus.asyncExit()`. This will prevent the application from shutting down prematurely and ensure a proper shutdown process.
If you're creating a typical Quarkus application (e.g., HTTP-based services) that includes command-line functionality, you'll need to handle the application's lifecycle differently. In the `Runnable.run()` method of your command, make sure to use `Quarkus.waitForExit()` or `Quarkus.asyncExit()`. This will prevent the application from shutting down prematurely and ensure a proper shutdown process.

Copy link
Contributor

Choose a reason for hiding this comment

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

Otherwise looks good.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

done, thanks.

@quarkus-bot
Copy link

quarkus-bot bot commented Sep 23, 2024

Status for workflow Quarkus Documentation CI

This is the status report for running Quarkus Documentation CI on commit 7c6eed7.

✅ The latest workflow run for the pull request has completed successfully.

It should be safe to merge provided you have a look at the other checks in the summary.

@mkouba mkouba merged commit bb58dbc into quarkusio:main Sep 23, 2024
5 checks passed
@quarkus-bot quarkus-bot bot added this to the 3.16 - main milestone Sep 23, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants