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

docs: update documentation about Maven registry support #1340

Merged
merged 5 commits into from
Oct 24, 2024
Merged

Conversation

cuixq
Copy link
Contributor

@cuixq cuixq commented Oct 23, 2024

#1286 adds support for Maven registry during resolution.

As a follow up, this PR updates the documentation for transitive scanning about specifying data source during resolution as well as specifying Maven registry.

This PR also corrects the deps.dev API version we are using.

We also need to update the documentation in #1181.

@cuixq cuixq marked this pull request as ready for review October 23, 2024 02:36

If instead you'd like to fetch data from [Maven Central](https://repo.maven.apache.org/maven2/), you can use the `--experimental-resolution-data-source=native` flag.

If your project uses mirrored or private registries, in addition to setting `--experimental-resolution-data-source=native`, you will need to use the `--experimental-maven-registry` flag to specify the registry.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
If your project uses mirrored or private registries, in addition to setting `--experimental-resolution-data-source=native`, you will need to use the `--experimental-maven-registry` flag to specify the registry.
If your project uses mirrored or private registries, in addition to setting `--experimental-resolution-data-source=native`, you will need to use the `--experimental-maven-registry=<full-registry-url>` flag to specify the registry.

Is this what you mean? Can you also add an example to clarify details like whether you need to include (https://) for example.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

yes - example added

@codecov-commenter
Copy link

codecov-commenter commented Oct 23, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 68.41%. Comparing base (e054385) to head (d86d572).

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #1340      +/-   ##
==========================================
- Coverage   68.43%   68.41%   -0.02%     
==========================================
  Files         183      183              
  Lines       17606    17606              
==========================================
- Hits        12049    12046       -3     
- Misses       4895     4897       +2     
- Partials      662      663       +1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.


If instead you'd like to fetch data from [Maven Central](https://repo.maven.apache.org/maven2/), you can use the `--experimental-resolution-data-source=native` flag.

If your project uses mirrored or private registries, in addition to setting `--experimental-resolution-data-source=native`, you will need to use the `--experimental-maven-registry=<full-registry-url>` flag to specify the registry (e.g. `--experimental-maven-registry=https://repo.maven.apache.org/maven2/`).
Copy link
Collaborator

Choose a reason for hiding this comment

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

Unrelated to documentation, but should we name the flag --resolution-registry to be more generic? Or is it very specific to Maven?

Copy link
Contributor Author

@cuixq cuixq Oct 23, 2024

Choose a reason for hiding this comment

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

I have thought of this considering we will soon support transitive scanning for Python requirements.txt - ideally I would like to have something --resolution-registry=Maven:[URL],PyPI:[URL], but I don't have a very clear picture about how does Python private registry work so I don't want to put too much effort on finalizing this flag now, and this is also why I mark this flag as experimental. Also for the ecosystem string to be used in the flag, this should follow the spec that Gareth is working on which is also not finalized.

Copy link
Collaborator

Choose a reason for hiding this comment

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

SGTM

@cuixq cuixq enabled auto-merge (squash) October 24, 2024 02:15
@cuixq cuixq disabled auto-merge October 24, 2024 02:15
@another-rex another-rex changed the title docs: update documentation about Maven registry support do update documentation about Maven registry support Oct 24, 2024
@another-rex another-rex changed the title do update documentation about Maven registry support docs: update documentation about Maven registry support Oct 24, 2024
@cuixq cuixq merged commit 24aca23 into google:main Oct 24, 2024
13 checks passed
@cuixq cuixq deleted the docs branch October 24, 2024 02:36
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