cshape 0.1.0__tar.gz

cshape-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alex Balan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cshape-0.1.0/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: cshape
+Version: 0.1.0
+Summary: A dependency-free C AST + printer: build a tree in Python, get C11 source back
+Author-email: Alex Balan <outsiders.b@gmail.com>
+License-Expression: MIT
+Keywords: c,codegen,code-generation,ast,transpiler,compiler
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: C
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Compilers
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# cshape
+
+A dependency-free C AST + printer for Python: build a tree and get C11
+source back. No parsing, no dependencies beyond the standard library —
+just `CType*` / `CValue*` / `CStmt*` nodes and a `render()` function that
+turns them into text.
+
+Originally the C backend's printer for the Modest compiler, split out
+because it doesn't know anything about Modest — it only knows about C.
+
+## Install
+
+```sh
+pip install cshape
+```
+
+## Example
+
+```python
+from cshape import *
+
+func = CStmtDefFunc(
+	id_str="add",
+	type=CTypeFunc(
+		params=[CField(id_str="a", type=CTypeNamed("int")),
+		        CField(id_str="b", type=CTypeNamed("int"))],
+		to=CTypeNamed("int"),
+	),
+	block=CStmtBlock([
+		CStmtReturn(CValueAdd(CValueNamed("a"), CValueNamed("b"))),
+	]),
+)
+
+print(render(func).strip())
+```
+
+```c
+int add(int a, int b) {
+	return a + b;
+}
+```
+
+(`render()` returns the node's own leading blank lines too — `CStmtDefFunc`
+starts with a blank line by default, so `.strip()` if you're printing a
+single node standalone rather than concatenating several.)
+
+## What it covers
+
+- Types: named types, pointers, arrays, function types, structs/unions, enums
+- Values: the full C11 expression grammar with correct operator precedence
+  and parenthesization (including the extra parens GCC/Clang warn about for
+  mixed bitwise/shift expressions)
+- Statements: blocks, if/while, return, break/continue, inline asm, raw
+  inserts
+- Preprocessor: `#define`, `#undef`, `#include`, `#if`/`#elif`/`#else`/`#endif`
+  regions
+- Two brace styles (`legacy` — K&R-ish, `modern` — Allman-ish), configurable
+  via `render(node, style=...)`
+- A `.mark` field on every node: set it to any string and it shows up as a
+  `/*mark*/` comment right before that node in the output — useful for
+  tracing which part of your own compiler/generator produced which bit of C
+
+## What it doesn't do
+
+No parsing, no semantic analysis, no type checking. It's a printer, not a
+compiler frontend — you build the tree, it hands you back text.
+
+## License
+
+MIT

cshape-0.1.0/README.md

@@ -0,0 +1,70 @@
+# cshape
+
+A dependency-free C AST + printer for Python: build a tree and get C11
+source back. No parsing, no dependencies beyond the standard library —
+just `CType*` / `CValue*` / `CStmt*` nodes and a `render()` function that
+turns them into text.
+
+Originally the C backend's printer for the Modest compiler, split out
+because it doesn't know anything about Modest — it only knows about C.
+
+## Install
+
+```sh
+pip install cshape
+```
+
+## Example
+
+```python
+from cshape import *
+
+func = CStmtDefFunc(
+	id_str="add",
+	type=CTypeFunc(
+		params=[CField(id_str="a", type=CTypeNamed("int")),
+		        CField(id_str="b", type=CTypeNamed("int"))],
+		to=CTypeNamed("int"),
+	),
+	block=CStmtBlock([
+		CStmtReturn(CValueAdd(CValueNamed("a"), CValueNamed("b"))),
+	]),
+)
+
+print(render(func).strip())
+```
+
+```c
+int add(int a, int b) {
+	return a + b;
+}
+```
+
+(`render()` returns the node's own leading blank lines too — `CStmtDefFunc`
+starts with a blank line by default, so `.strip()` if you're printing a
+single node standalone rather than concatenating several.)
+
+## What it covers
+
+- Types: named types, pointers, arrays, function types, structs/unions, enums
+- Values: the full C11 expression grammar with correct operator precedence
+  and parenthesization (including the extra parens GCC/Clang warn about for
+  mixed bitwise/shift expressions)
+- Statements: blocks, if/while, return, break/continue, inline asm, raw
+  inserts
+- Preprocessor: `#define`, `#undef`, `#include`, `#if`/`#elif`/`#else`/`#endif`
+  regions
+- Two brace styles (`legacy` — K&R-ish, `modern` — Allman-ish), configurable
+  via `render(node, style=...)`
+- A `.mark` field on every node: set it to any string and it shows up as a
+  `/*mark*/` comment right before that node in the output — useful for
+  tracing which part of your own compiler/generator produced which bit of C
+
+## What it doesn't do
+
+No parsing, no semantic analysis, no type checking. It's a printer, not a
+compiler frontend — you build the tree, it hands you back text.
+
+## License
+
+MIT

cshape-0.1.0/cshape.egg-info/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: cshape
+Version: 0.1.0
+Summary: A dependency-free C AST + printer: build a tree in Python, get C11 source back
+Author-email: Alex Balan <outsiders.b@gmail.com>
+License-Expression: MIT
+Keywords: c,codegen,code-generation,ast,transpiler,compiler
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: C
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Compilers
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# cshape
+
+A dependency-free C AST + printer for Python: build a tree and get C11
+source back. No parsing, no dependencies beyond the standard library —
+just `CType*` / `CValue*` / `CStmt*` nodes and a `render()` function that
+turns them into text.
+
+Originally the C backend's printer for the Modest compiler, split out
+because it doesn't know anything about Modest — it only knows about C.
+
+## Install
+
+```sh
+pip install cshape
+```
+
+## Example
+
+```python
+from cshape import *
+
+func = CStmtDefFunc(
+	id_str="add",
+	type=CTypeFunc(
+		params=[CField(id_str="a", type=CTypeNamed("int")),
+		        CField(id_str="b", type=CTypeNamed("int"))],
+		to=CTypeNamed("int"),
+	),
+	block=CStmtBlock([
+		CStmtReturn(CValueAdd(CValueNamed("a"), CValueNamed("b"))),
+	]),
+)
+
+print(render(func).strip())
+```
+
+```c
+int add(int a, int b) {
+	return a + b;
+}
+```
+
+(`render()` returns the node's own leading blank lines too — `CStmtDefFunc`
+starts with a blank line by default, so `.strip()` if you're printing a
+single node standalone rather than concatenating several.)
+
+## What it covers
+
+- Types: named types, pointers, arrays, function types, structs/unions, enums
+- Values: the full C11 expression grammar with correct operator precedence
+  and parenthesization (including the extra parens GCC/Clang warn about for
+  mixed bitwise/shift expressions)
+- Statements: blocks, if/while, return, break/continue, inline asm, raw
+  inserts
+- Preprocessor: `#define`, `#undef`, `#include`, `#if`/`#elif`/`#else`/`#endif`
+  regions
+- Two brace styles (`legacy` — K&R-ish, `modern` — Allman-ish), configurable
+  via `render(node, style=...)`
+- A `.mark` field on every node: set it to any string and it shows up as a
+  `/*mark*/` comment right before that node in the output — useful for
+  tracing which part of your own compiler/generator produced which bit of C
+
+## What it doesn't do
+
+No parsing, no semantic analysis, no type checking. It's a printer, not a
+compiler frontend — you build the tree, it hands you back text.
+
+## License
+
+MIT

cshape-0.1.0/cshape.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+cshape.py
+pyproject.toml
+cshape.egg-info/PKG-INFO
+cshape.egg-info/SOURCES.txt
+cshape.egg-info/dependency_links.txt
+cshape.egg-info/top_level.txt
+tests/test_smoke.py

cshape-0.1.0/cshape.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cshape-0.1.0/cshape.egg-info/top_level.txt

@@ -0,0 +1 @@
+cshape