-
Notifications
You must be signed in to change notification settings - Fork 65
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
Conversation
generate_repo.py
library_generation/README.md
Outdated
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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
purpose. | |
purposes. |
There was a problem hiding this comment.
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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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.
There was a problem hiding this comment.
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` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
## 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 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done
| googleapis-commitish | Yes | | | ||
| owlbot-cli-image | Yes | | | ||
| synthtool-commitish | Yes | | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| 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
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Sure.
library_generation/README.md
Outdated
|
||
```bash | ||
# install python module |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
# 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 import
able
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done
There was a problem hiding this 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 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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" |
There was a problem hiding this comment.
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
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done
|
|
In this PR: - Update instructions on `generate_repo.py`.
In this PR:
generate_repo.py
.