ssot-codegen 0.2.4__tar.gz → 0.2.5__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,130 @@
1
+ Metadata-Version: 2.4
2
+ Name: ssot-codegen
3
+ Version: 0.2.5
4
+ Summary: Generators for SSOT contract, CLI, and TUI artifacts.
5
+ Author-email: Jacob Stewart <jacob@swarmauri.com>
6
+ License-Expression: Apache-2.0
7
+ Project-URL: Homepage, https://github.com/groupsum/ssot-registry
8
+ Project-URL: Repository, https://github.com/groupsum/ssot-registry
9
+ Project-URL: Issues, https://github.com/groupsum/ssot-registry/issues
10
+ Keywords: ssot,codegen,generators,contracts
11
+ Classifier: Development Status :: 3 - Alpha
12
+ Classifier: Environment :: Console
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: Operating System :: OS Independent
15
+ Classifier: Programming Language :: Python :: 3
16
+ Classifier: Programming Language :: Python :: 3 :: Only
17
+ Classifier: Programming Language :: Python :: 3.10
18
+ Classifier: Programming Language :: Python :: 3.11
19
+ Classifier: Programming Language :: Python :: 3.12
20
+ Classifier: Programming Language :: Python :: 3.13
21
+ Classifier: Topic :: Software Development :: Code Generators
22
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
23
+ Requires-Python: <3.14,>=3.10
24
+ Description-Content-Type: text/markdown
25
+ Requires-Dist: ssot-contracts==0.2.5
26
+ Requires-Dist: ssot-views==0.2.5
27
+ Requires-Dist: tomli>=2.0.1; python_version < "3.11"
28
+
29
+ <div align="center">
30
+ <h1>🔷 ssot-codegen</h1>
31
+ <p><strong>Development-time generators for SSOT contract-side metadata artifacts.</strong></p>
32
+ </div>
33
+
34
+ <div align="center">
35
+ <a href="https://pypi.org/project/ssot-codegen/"><img src="https://img.shields.io/pypi/v/ssot-codegen?label=PyPI%20version" alt="PyPI version" /></a>
36
+ <a href="https://pypi.org/project/ssot-codegen/"><img src="https://img.shields.io/pypi/pyversions/ssot-codegen?label=Python" alt="Supported Python versions" /></a>
37
+ <a href="https://pepy.tech/project/ssot-codegen"><img src="https://static.pepy.tech/badge/ssot-codegen" alt="Downloads" /></a>
38
+ <a href="https://hits.sh/github.com/groupsum/ssot-registry/"><img src="https://hits.sh/github.com/groupsum/ssot-registry.svg?style=flat-square" alt="Repository hits" /></a>
39
+ </div>
40
+
41
+ `ssot-codegen` contains generators for SSOT contract-side metadata artifacts.
42
+
43
+ It is a development-oriented package used to materialize generated JSON and Python outputs from the canonical contract layer. It is not the main runtime entry point for end users.
44
+
45
+ ## What this package owns
46
+
47
+ - The `ssot-codegen` console command
48
+ - Generation of Python-side metadata artifacts derived from `ssot-contracts`
49
+ - Development-time regeneration of CLI and TUI metadata outputs
50
+
51
+ ## When to use this package
52
+
53
+ Use `ssot-codegen` when you want:
54
+
55
+ - to regenerate packaged metadata artifacts during development
56
+ - to inspect the current generated contract index, CLI metadata, or TUI metadata
57
+ - a small development utility around the canonical contract package
58
+
59
+ Use another package when you want:
60
+
61
+ - `ssot-cli` for the main user-facing CLI
62
+ - `ssot-registry` for the core runtime and Python APIs
63
+ - `ssot-contracts` for the packaged artifacts themselves
64
+ - `ssot-tui` for terminal UI access
65
+ - `ssot-views` for report and graph builders
66
+
67
+ ## Install
68
+
69
+ ```bash
70
+ python -m pip install ssot-codegen
71
+ ```
72
+
73
+ For local development from this repository:
74
+
75
+ ```bash
76
+ python -m pip install -e pkgs/ssot-codegen
77
+ ```
78
+
79
+ ## Command-line usage
80
+
81
+ The current command surface is intentionally small:
82
+
83
+ ```bash
84
+ ssot-codegen --help
85
+ ssot-codegen --output-root .tmp_codegen
86
+ ```
87
+
88
+ `--output-root` controls the directory where generated files are written. If omitted, the command writes to a `.tmp_codegen` directory under the current working directory.
89
+
90
+ ## Generated outputs
91
+
92
+ `generate_python_artifacts()` currently writes:
93
+
94
+ - `contracts.index.json`
95
+ - `cli.metadata.json`
96
+ - `tui.metadata.json`
97
+ - `enums.py`
98
+ - `cli_metadata.py`
99
+ - `tui_metadata.py`
100
+
101
+ Example:
102
+
103
+ ```bash
104
+ ssot-codegen --output-root .tmp_codegen
105
+ ```
106
+
107
+ Typical output files and purpose:
108
+
109
+ - `contracts.index.json`: schema version and packaged ADR/spec manifest identifiers
110
+ - `cli.metadata.json`: output formats and entity sections used by CLI-facing tooling
111
+ - `tui.metadata.json`: entity sections used by TUI-facing tooling
112
+ - `enums.py`: generated Python constants derived from `CONTRACT_DATA`
113
+
114
+ ## Programmatic usage
115
+
116
+ ```python
117
+ from ssot_codegen.generator import generate_python_artifacts
118
+
119
+ written = generate_python_artifacts(".tmp_codegen")
120
+ for path in written:
121
+ print(path.as_posix())
122
+ ```
123
+
124
+ ## Package relationships
125
+
126
+ - Package type: development/code-generation package
127
+ - Depends on: `ssot-contracts`, `ssot-views`
128
+ - Consumed by: maintainers and release tooling that regenerate derived metadata artifacts
129
+
130
+ If you are using SSOT as an application or library, you usually do not need this package directly. It is primarily for maintainers working on the SSOT workspace itself.
@@ -0,0 +1,102 @@
1
+ <div align="center">
2
+ <h1>🔷 ssot-codegen</h1>
3
+ <p><strong>Development-time generators for SSOT contract-side metadata artifacts.</strong></p>
4
+ </div>
5
+
6
+ <div align="center">
7
+ <a href="https://pypi.org/project/ssot-codegen/"><img src="https://img.shields.io/pypi/v/ssot-codegen?label=PyPI%20version" alt="PyPI version" /></a>
8
+ <a href="https://pypi.org/project/ssot-codegen/"><img src="https://img.shields.io/pypi/pyversions/ssot-codegen?label=Python" alt="Supported Python versions" /></a>
9
+ <a href="https://pepy.tech/project/ssot-codegen"><img src="https://static.pepy.tech/badge/ssot-codegen" alt="Downloads" /></a>
10
+ <a href="https://hits.sh/github.com/groupsum/ssot-registry/"><img src="https://hits.sh/github.com/groupsum/ssot-registry.svg?style=flat-square" alt="Repository hits" /></a>
11
+ </div>
12
+
13
+ `ssot-codegen` contains generators for SSOT contract-side metadata artifacts.
14
+
15
+ It is a development-oriented package used to materialize generated JSON and Python outputs from the canonical contract layer. It is not the main runtime entry point for end users.
16
+
17
+ ## What this package owns
18
+
19
+ - The `ssot-codegen` console command
20
+ - Generation of Python-side metadata artifacts derived from `ssot-contracts`
21
+ - Development-time regeneration of CLI and TUI metadata outputs
22
+
23
+ ## When to use this package
24
+
25
+ Use `ssot-codegen` when you want:
26
+
27
+ - to regenerate packaged metadata artifacts during development
28
+ - to inspect the current generated contract index, CLI metadata, or TUI metadata
29
+ - a small development utility around the canonical contract package
30
+
31
+ Use another package when you want:
32
+
33
+ - `ssot-cli` for the main user-facing CLI
34
+ - `ssot-registry` for the core runtime and Python APIs
35
+ - `ssot-contracts` for the packaged artifacts themselves
36
+ - `ssot-tui` for terminal UI access
37
+ - `ssot-views` for report and graph builders
38
+
39
+ ## Install
40
+
41
+ ```bash
42
+ python -m pip install ssot-codegen
43
+ ```
44
+
45
+ For local development from this repository:
46
+
47
+ ```bash
48
+ python -m pip install -e pkgs/ssot-codegen
49
+ ```
50
+
51
+ ## Command-line usage
52
+
53
+ The current command surface is intentionally small:
54
+
55
+ ```bash
56
+ ssot-codegen --help
57
+ ssot-codegen --output-root .tmp_codegen
58
+ ```
59
+
60
+ `--output-root` controls the directory where generated files are written. If omitted, the command writes to a `.tmp_codegen` directory under the current working directory.
61
+
62
+ ## Generated outputs
63
+
64
+ `generate_python_artifacts()` currently writes:
65
+
66
+ - `contracts.index.json`
67
+ - `cli.metadata.json`
68
+ - `tui.metadata.json`
69
+ - `enums.py`
70
+ - `cli_metadata.py`
71
+ - `tui_metadata.py`
72
+
73
+ Example:
74
+
75
+ ```bash
76
+ ssot-codegen --output-root .tmp_codegen
77
+ ```
78
+
79
+ Typical output files and purpose:
80
+
81
+ - `contracts.index.json`: schema version and packaged ADR/spec manifest identifiers
82
+ - `cli.metadata.json`: output formats and entity sections used by CLI-facing tooling
83
+ - `tui.metadata.json`: entity sections used by TUI-facing tooling
84
+ - `enums.py`: generated Python constants derived from `CONTRACT_DATA`
85
+
86
+ ## Programmatic usage
87
+
88
+ ```python
89
+ from ssot_codegen.generator import generate_python_artifacts
90
+
91
+ written = generate_python_artifacts(".tmp_codegen")
92
+ for path in written:
93
+ print(path.as_posix())
94
+ ```
95
+
96
+ ## Package relationships
97
+
98
+ - Package type: development/code-generation package
99
+ - Depends on: `ssot-contracts`, `ssot-views`
100
+ - Consumed by: maintainers and release tooling that regenerate derived metadata artifacts
101
+
102
+ If you are using SSOT as an application or library, you usually do not need this package directly. It is primarily for maintainers working on the SSOT workspace itself.
@@ -4,15 +4,15 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "ssot-codegen"
7
- version = "0.2.4"
7
+ version = "0.2.5"
8
8
  description = "Generators for SSOT contract, CLI, and TUI artifacts."
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10,<3.14"
11
11
  license = "Apache-2.0"
12
12
  authors = [{ name = "Jacob Stewart", email = "jacob@swarmauri.com" }]
13
13
  dependencies = [
14
- "ssot-contracts==0.2.4",
15
- "ssot-views==0.2.4",
14
+ "ssot-contracts==0.2.5",
15
+ "ssot-views==0.2.5",
16
16
  "tomli>=2.0.1; python_version < '3.11'",
17
17
  ]
18
18
  keywords = ["ssot", "codegen", "generators", "contracts"]
@@ -0,0 +1,130 @@
1
+ Metadata-Version: 2.4
2
+ Name: ssot-codegen
3
+ Version: 0.2.5
4
+ Summary: Generators for SSOT contract, CLI, and TUI artifacts.
5
+ Author-email: Jacob Stewart <jacob@swarmauri.com>
6
+ License-Expression: Apache-2.0
7
+ Project-URL: Homepage, https://github.com/groupsum/ssot-registry
8
+ Project-URL: Repository, https://github.com/groupsum/ssot-registry
9
+ Project-URL: Issues, https://github.com/groupsum/ssot-registry/issues
10
+ Keywords: ssot,codegen,generators,contracts
11
+ Classifier: Development Status :: 3 - Alpha
12
+ Classifier: Environment :: Console
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: Operating System :: OS Independent
15
+ Classifier: Programming Language :: Python :: 3
16
+ Classifier: Programming Language :: Python :: 3 :: Only
17
+ Classifier: Programming Language :: Python :: 3.10
18
+ Classifier: Programming Language :: Python :: 3.11
19
+ Classifier: Programming Language :: Python :: 3.12
20
+ Classifier: Programming Language :: Python :: 3.13
21
+ Classifier: Topic :: Software Development :: Code Generators
22
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
23
+ Requires-Python: <3.14,>=3.10
24
+ Description-Content-Type: text/markdown
25
+ Requires-Dist: ssot-contracts==0.2.5
26
+ Requires-Dist: ssot-views==0.2.5
27
+ Requires-Dist: tomli>=2.0.1; python_version < "3.11"
28
+
29
+ <div align="center">
30
+ <h1>🔷 ssot-codegen</h1>
31
+ <p><strong>Development-time generators for SSOT contract-side metadata artifacts.</strong></p>
32
+ </div>
33
+
34
+ <div align="center">
35
+ <a href="https://pypi.org/project/ssot-codegen/"><img src="https://img.shields.io/pypi/v/ssot-codegen?label=PyPI%20version" alt="PyPI version" /></a>
36
+ <a href="https://pypi.org/project/ssot-codegen/"><img src="https://img.shields.io/pypi/pyversions/ssot-codegen?label=Python" alt="Supported Python versions" /></a>
37
+ <a href="https://pepy.tech/project/ssot-codegen"><img src="https://static.pepy.tech/badge/ssot-codegen" alt="Downloads" /></a>
38
+ <a href="https://hits.sh/github.com/groupsum/ssot-registry/"><img src="https://hits.sh/github.com/groupsum/ssot-registry.svg?style=flat-square" alt="Repository hits" /></a>
39
+ </div>
40
+
41
+ `ssot-codegen` contains generators for SSOT contract-side metadata artifacts.
42
+
43
+ It is a development-oriented package used to materialize generated JSON and Python outputs from the canonical contract layer. It is not the main runtime entry point for end users.
44
+
45
+ ## What this package owns
46
+
47
+ - The `ssot-codegen` console command
48
+ - Generation of Python-side metadata artifacts derived from `ssot-contracts`
49
+ - Development-time regeneration of CLI and TUI metadata outputs
50
+
51
+ ## When to use this package
52
+
53
+ Use `ssot-codegen` when you want:
54
+
55
+ - to regenerate packaged metadata artifacts during development
56
+ - to inspect the current generated contract index, CLI metadata, or TUI metadata
57
+ - a small development utility around the canonical contract package
58
+
59
+ Use another package when you want:
60
+
61
+ - `ssot-cli` for the main user-facing CLI
62
+ - `ssot-registry` for the core runtime and Python APIs
63
+ - `ssot-contracts` for the packaged artifacts themselves
64
+ - `ssot-tui` for terminal UI access
65
+ - `ssot-views` for report and graph builders
66
+
67
+ ## Install
68
+
69
+ ```bash
70
+ python -m pip install ssot-codegen
71
+ ```
72
+
73
+ For local development from this repository:
74
+
75
+ ```bash
76
+ python -m pip install -e pkgs/ssot-codegen
77
+ ```
78
+
79
+ ## Command-line usage
80
+
81
+ The current command surface is intentionally small:
82
+
83
+ ```bash
84
+ ssot-codegen --help
85
+ ssot-codegen --output-root .tmp_codegen
86
+ ```
87
+
88
+ `--output-root` controls the directory where generated files are written. If omitted, the command writes to a `.tmp_codegen` directory under the current working directory.
89
+
90
+ ## Generated outputs
91
+
92
+ `generate_python_artifacts()` currently writes:
93
+
94
+ - `contracts.index.json`
95
+ - `cli.metadata.json`
96
+ - `tui.metadata.json`
97
+ - `enums.py`
98
+ - `cli_metadata.py`
99
+ - `tui_metadata.py`
100
+
101
+ Example:
102
+
103
+ ```bash
104
+ ssot-codegen --output-root .tmp_codegen
105
+ ```
106
+
107
+ Typical output files and purpose:
108
+
109
+ - `contracts.index.json`: schema version and packaged ADR/spec manifest identifiers
110
+ - `cli.metadata.json`: output formats and entity sections used by CLI-facing tooling
111
+ - `tui.metadata.json`: entity sections used by TUI-facing tooling
112
+ - `enums.py`: generated Python constants derived from `CONTRACT_DATA`
113
+
114
+ ## Programmatic usage
115
+
116
+ ```python
117
+ from ssot_codegen.generator import generate_python_artifacts
118
+
119
+ written = generate_python_artifacts(".tmp_codegen")
120
+ for path in written:
121
+ print(path.as_posix())
122
+ ```
123
+
124
+ ## Package relationships
125
+
126
+ - Package type: development/code-generation package
127
+ - Depends on: `ssot-contracts`, `ssot-views`
128
+ - Consumed by: maintainers and release tooling that regenerate derived metadata artifacts
129
+
130
+ If you are using SSOT as an application or library, you usually do not need this package directly. It is primarily for maintainers working on the SSOT workspace itself.
@@ -1,5 +1,5 @@
1
- ssot-contracts==0.2.4
2
- ssot-views==0.2.4
1
+ ssot-contracts==0.2.5
2
+ ssot-views==0.2.5
3
3
 
4
4
  [:python_version < "3.11"]
5
5
  tomli>=2.0.1
@@ -1,36 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: ssot-codegen
3
- Version: 0.2.4
4
- Summary: Generators for SSOT contract, CLI, and TUI artifacts.
5
- Author-email: Jacob Stewart <jacob@swarmauri.com>
6
- License-Expression: Apache-2.0
7
- Project-URL: Homepage, https://github.com/groupsum/ssot-registry
8
- Project-URL: Repository, https://github.com/groupsum/ssot-registry
9
- Project-URL: Issues, https://github.com/groupsum/ssot-registry/issues
10
- Keywords: ssot,codegen,generators,contracts
11
- Classifier: Development Status :: 3 - Alpha
12
- Classifier: Environment :: Console
13
- Classifier: Intended Audience :: Developers
14
- Classifier: Operating System :: OS Independent
15
- Classifier: Programming Language :: Python :: 3
16
- Classifier: Programming Language :: Python :: 3 :: Only
17
- Classifier: Programming Language :: Python :: 3.10
18
- Classifier: Programming Language :: Python :: 3.11
19
- Classifier: Programming Language :: Python :: 3.12
20
- Classifier: Programming Language :: Python :: 3.13
21
- Classifier: Topic :: Software Development :: Code Generators
22
- Classifier: Topic :: Software Development :: Libraries :: Python Modules
23
- Requires-Python: <3.14,>=3.10
24
- Description-Content-Type: text/markdown
25
- Requires-Dist: ssot-contracts==0.2.4
26
- Requires-Dist: ssot-views==0.2.4
27
- Requires-Dist: tomli>=2.0.1; python_version < "3.11"
28
-
29
- # ssot-codegen
30
-
31
- SSOT generators for:
32
-
33
- - Python contract artifacts
34
- - CLI metadata
35
- - TUI metadata
36
- - future TypeScript/npm parity outputs
@@ -1,8 +0,0 @@
1
- # ssot-codegen
2
-
3
- SSOT generators for:
4
-
5
- - Python contract artifacts
6
- - CLI metadata
7
- - TUI metadata
8
- - future TypeScript/npm parity outputs
@@ -1,36 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: ssot-codegen
3
- Version: 0.2.4
4
- Summary: Generators for SSOT contract, CLI, and TUI artifacts.
5
- Author-email: Jacob Stewart <jacob@swarmauri.com>
6
- License-Expression: Apache-2.0
7
- Project-URL: Homepage, https://github.com/groupsum/ssot-registry
8
- Project-URL: Repository, https://github.com/groupsum/ssot-registry
9
- Project-URL: Issues, https://github.com/groupsum/ssot-registry/issues
10
- Keywords: ssot,codegen,generators,contracts
11
- Classifier: Development Status :: 3 - Alpha
12
- Classifier: Environment :: Console
13
- Classifier: Intended Audience :: Developers
14
- Classifier: Operating System :: OS Independent
15
- Classifier: Programming Language :: Python :: 3
16
- Classifier: Programming Language :: Python :: 3 :: Only
17
- Classifier: Programming Language :: Python :: 3.10
18
- Classifier: Programming Language :: Python :: 3.11
19
- Classifier: Programming Language :: Python :: 3.12
20
- Classifier: Programming Language :: Python :: 3.13
21
- Classifier: Topic :: Software Development :: Code Generators
22
- Classifier: Topic :: Software Development :: Libraries :: Python Modules
23
- Requires-Python: <3.14,>=3.10
24
- Description-Content-Type: text/markdown
25
- Requires-Dist: ssot-contracts==0.2.4
26
- Requires-Dist: ssot-views==0.2.4
27
- Requires-Dist: tomli>=2.0.1; python_version < "3.11"
28
-
29
- # ssot-codegen
30
-
31
- SSOT generators for:
32
-
33
- - Python contract artifacts
34
- - CLI metadata
35
- - TUI metadata
36
- - future TypeScript/npm parity outputs
File without changes