Skip to content

Add README.md for all top level codegen modules #86

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 1 commit into from
Jan 24, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions src/codegen/cli/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# Codegen CLI
A codegen module that handles all `codegen` CLI commands.

### Dependencies
- [codegen.sdk](https://github.com/codegen-sh/codegen-sdk/tree/develop/src/codegen/sdk)
- [codegen.shared](https://github.com/codegen-sh/codegen-sdk/tree/develop/src/codegen/shared)

## Best Practices

- Each folder in `cli` should correspond to a command group. The name of the folder should be the name of the command group. Ex: `task` for codegen task commands.
- The command group folder should have a file called `commands.py` where the CLI group (i.e. function decorated with `@click.group()`) and CLI commands are defined (i.e. functions decorated with ex: `@task.command()`) and if necessary a folder called `utils` (or a single `utils.py`) that holds any additional files with helpers/utilities that are specific to the command group.
- Store utils specific to a CLI command group within its folder.
- Store utils that can be shared across command groups in an appropriate file in cli/utils. If none exists, create a new appropriately named one!
6 changes: 6 additions & 0 deletions src/codegen/git/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Codegen Git
A codegen module to supports git operations on codebase.

### Dependencies
- [codegen.sdk](https://github.com/codegen-sh/codegen-sdk/tree/develop/src/codegen/sdk)
- [codegen.shared](https://github.com/codegen-sh/codegen-sdk/tree/develop/src/codegen/shared)
2 changes: 2 additions & 0 deletions src/codegen/gsbuild/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
# Codegen GS Build
A codegen module that builds the codegen SDK.
8 changes: 2 additions & 6 deletions src/codegen/gscli/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,2 @@
# Best Practices

- Each folder in `cli` should correspond to a command group. The name of the folder should be the name of the command group. Ex: `task` for codegen task commands.
- The command group folder should have a file called `commands.py` where the CLI group (i.e. function decorated with `@click.group()`) and CLI commands are defined (i.e. functions decorated with ex: `@task.command()`) and if necessary a folder called `utils` (or a single `utils.py`) that holds any additional files with helpers/utilities that are specific to the command group.
- Store utils specific to a CLI command group within its folder.
- Store utils that can be shared across command groups in an appropriate file in cli/utils. If none exists, create a new appropriately named one!
# Codegen GS CLI
This module to be moved out into `src/code_generation`
Empty file.
7 changes: 7 additions & 0 deletions src/codegen/runner/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Codegen Runner
A codegen module to run codemods against a Codebase graph with a managed lifecycle.

### Dependencies
- [codegen.sdk](https://github.com/codegen-sh/codegen-sdk/tree/develop/src/codegen/sdk)
- [codegen.git](https://github.com/codegen-sh/codegen-sdk/tree/develop/src/codegen/git)
- [codegen.shared](https://github.com/codegen-sh/codegen-sdk/tree/develop/src/codegen/shared)
6 changes: 6 additions & 0 deletions src/codegen/sdk/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Codegen SDK
A codegen module that contains the core Codebase graph parsing and manipulation logic.

### Dependencies
- [codegen.git](https://github.com/codegen-sh/codegen-sdk/tree/develop/src/codegen/git)
- [codegen.shared](https://github.com/codegen-sh/codegen-sdk/tree/develop/src/codegen/shared)
6 changes: 6 additions & 0 deletions src/codegen/shared/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Codegen Shared
A codegen module to contain a miscellaneous set of shared utilities.

### Dependencies
This module should NOT contain any high level dependencies on other codegen modules.
It should only depend on standard libraries and other shared utilities.
Loading