Skip to content
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