Skip to content

chore: update instructions on generate_repo.py #2449

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

Merged
merged 9 commits into from
Feb 8, 2024
Merged

Conversation

JoeWang1127
Copy link
Collaborator

@JoeWang1127 JoeWang1127 commented Feb 8, 2024

In this PR:

  • Update instructions on generate_repo.py.

@product-auto-label product-auto-label bot added the size: l Pull request size is large. label Feb 8, 2024
@JoeWang1127 JoeWang1127 changed the title chore: update instructions on generate_repo.py chore: update instructions on generate_repo.py Feb 8, 2024
@JoeWang1127 JoeWang1127 marked this pull request as ready for review February 8, 2024 19:25
@JoeWang1127 JoeWang1127 requested a review from a team as a code owner February 8, 2024 19:25
will be generated; otherwise all libraries in the configuration file will be
generated.
This can be useful when you just want to generate one library for debugging
purpose.
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
purpose.
purposes.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

done


The path to where the generated repository goes.

The default value is the current working directory when running the script.
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
The default value is the current working directory when running the script.
The default value is the current working directory when running the script. For example, `cd google-cloud-java && python generate_repo.py ...` without specifying the `--repository_path` option will modify the `google-cloud-java` repository the user `cd`'d into.

Just a redundant explanation to clarify.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

done

Please refer [here](go/java-client-releasing#versionstxt-manifest) for more info
of versions.txt.

## Output of `generate_repo.py`
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
## Output of `generate_repo.py`
## Output of `generate_repo.py`
For each module (e.g. `google-cloud-java/java-asset`), the following files/folders will be created/modified

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

done

Comment on lines +87 to +89
| googleapis-commitish | Yes | |
| owlbot-cli-image | Yes | |
| synthtool-commitish | Yes | |
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
| googleapis-commitish | Yes | |
| owlbot-cli-image | Yes | |
| synthtool-commitish | Yes | |
| googleapis_commitish | Yes | |
| owlbot_cli_image | Yes | |
| synthtool_commitish | Yes | |
| template_excludes | Yes | |

Hope you don't mind if I add template_excludes which will be merged soon

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Sure.


```bash
# install python module
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
# install python module
# install python module (allows the `library_generation` module to be imported from anywhere)
python -m pip install library_generation
# install dependencies

Although it may not be necessary for some setups, installing via setup.py may be safer so the module can be ensured to be importable

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

done

Copy link
Contributor

@diegomarquezp diegomarquezp left a comment

Choose a reason for hiding this comment

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

Thank you

googleapis_commitish: 1a45bf7393b52407188c82e63101db7dc9c72026
owlbot_cli_image: sha256:623647ee79ac605858d09e60c1382a716c125fb776f69301b72de1cd35d49409
synthtool_commitish: 6612ab8f3afcd5e292aecd647f0fa68812c9f5b5
destination_path: google-cloud-java
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
destination_path: google-cloud-java
destination_path: google-cloud-java
template_excludes:
- ".github/*"
- ".kokoro/*"
- "samples/*"
- "CODE_OF_CONDUCT.md"
- "CONTRIBUTING.md"
- "LICENSE"
- "SECURITY.md"
- "java.header"
- "license-checks.xml"
- "renovate.json"
- ".gitignore"

Copy link
Contributor

Choose a reason for hiding this comment

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

forgot to add an example for this one

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

done

@JoeWang1127 JoeWang1127 enabled auto-merge (squash) February 8, 2024 20:15
Copy link

sonarqubecloud bot commented Feb 8, 2024

Quality Gate Passed Quality Gate passed for 'gapic-generator-java-root'

Issues
0 New issues

Measures
0 Security Hotspots
No data about Coverage
No data about Duplication

See analysis details on SonarCloud

Copy link

sonarqubecloud bot commented Feb 8, 2024

Quality Gate Passed Quality Gate passed for 'java_showcase_integration_tests'

Issues
0 New issues

Measures
0 Security Hotspots
No data about Coverage
No data about Duplication

See analysis details on SonarCloud

@JoeWang1127 JoeWang1127 merged commit dba4c10 into main Feb 8, 2024
@JoeWang1127 JoeWang1127 deleted the chore/update-readme branch February 8, 2024 20:27
ddixit14 pushed a commit that referenced this pull request Feb 15, 2024
In this PR:
- Update instructions on `generate_repo.py`.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
size: l Pull request size is large.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants