Skip to content

Conversation

Pkylas007
Copy link
Collaborator

@Pkylas007 Pkylas007 commented Aug 17, 2025

JIRA

Version

  • 7.3.2

Preview

@Pkylas007 Pkylas007 force-pushed the mta-5964-cli-guide-maven-flag branch from a79842c to fe12b05 Compare August 17, 2025 15:39
@Pkylas007 Pkylas007 requested a review from istein1 August 17, 2025 15:43
@Pkylas007 Pkylas007 force-pushed the mta-5964-cli-guide-maven-flag branch from ad578c4 to c13717a Compare August 17, 2025 15:52
Copy link
Collaborator

@anarnold97 anarnold97 left a comment

Choose a reason for hiding this comment

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

LGTM

Copy link
Collaborator

@ibragins ibragins left a comment

Choose a reason for hiding this comment

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

LGTM

@Pkylas007
Copy link
Collaborator Author

LGTM

Thank you!

@Pkylas007
Copy link
Collaborator Author

LGTM

Thank you a quick review, Igor!

@Pkylas007 Pkylas007 requested review from jmle and eemcmullan August 18, 2025 08:15
@Pkylas007
Copy link
Collaborator Author

@jmle @eemcmullan Could you review the --disable-maven-search flag description please?

@Pkylas007 Pkylas007 removed the request for review from istein1 August 18, 2025 09:13
@Pkylas007 Pkylas007 force-pushed the mta-5964-cli-guide-maven-flag branch from f6dc9de to 4e16c7a Compare August 20, 2025 05:23
|`--context-lines` (int)|A number of lines of source code to include in the output for each incident. The default is 100.
|`--disable-maven-search`| Set the flag to `true` to disable {ProductShortName} from relying on the Maven search index to determine if a dependency is publicly available (such as an open-source dependency) or internal to the Java binary application during analysis.

When you disable Maven search, {ProductShortName} at first tries to determine dependencies from the compiled JAR file. If this method does not succeed, {ProductShortName} goes through the directory structure to determine dependencies. This method may not produce a reliable dependency classification since the package structure can differ from what is expected by {ProductShortName}. You may see more dependencies in the `dependencies.yaml` file because some dependencies may be wrongly classified as internal.
Copy link
Collaborator

@jmle jmle Aug 20, 2025

Choose a reason for hiding this comment

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

Suggestion:

When you disable Maven search, {ProductShortName} at first tries to determine dependencies from the JAR files' POM file, if any. If this method does not succeed, {ProductShortName} goes through the directory structure of the JAR to try to determine its identity.

The rest looks good 👍

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Thanks @jmle! I have updated as you suggested.

|`--context-lines` (int)|A number of lines of source code to include in the output for each incident. The default is 100.
|`--disable-maven-search`| Set the flag to `true` to disable {ProductShortName} from relying on the Maven search index to determine if a dependency is publicly available (such as an open-source dependency) or internal to the Java binary application during analysis.

When you disable Maven search, {ProductShortName} at first tries to determine dependencies from the the JAR file's POM file (if any). If this method does not succeed, {ProductShortName} goes through the directory structure to determine dependencies. This method may not produce a reliable dependency classification since the package structure can differ from what is expected by {ProductShortName}. You may see more dependencies in the `dependencies.yaml` file because some dependencies may be wrongly classified as internal.

Choose a reason for hiding this comment

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

Instead of noting dependencies in dependencies.yaml, it would probably be better to mention this could cause more incidents vs using maven search.

Signed-off-by: Prabha Kylasamiyer Sundara Rajan <[email protected]>
@Pkylas007 Pkylas007 force-pushed the mta-5964-cli-guide-maven-flag branch from f7ed6c3 to 2ef8157 Compare August 20, 2025 14:05
@Pkylas007 Pkylas007 requested a review from eemcmullan August 20, 2025 14:07
@Pkylas007 Pkylas007 merged commit 627dfdd into migtools:main Aug 26, 2025
1 check passed
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.

5 participants