C/C++ file generator
Project description
cwriter
Project Description
The package facilitates the creation of C (.h) files from Python. It's not designed to generate every possible C file or cover the entire C syntax. Rather, its primary focus is to generate files that contain elements like arrays or strings as well as constants, defines, and typedefs that can be imported from other sources or linked into a project.
Example
This code
numbers = list(range(100))
f = CFile("example.h")
f.openGuard()
f.define("THIS", 0)
f.newLine()
f.comment("A variable definition with intialization")
an = {5: "This is an annotation for the element at position 5", 30: ("Another annotation, but with single=True for the element at position 30", True)}
f.varDefinition("const int[]", "values", numbers, to_str_fn=paddedHex(2), annotations=an)
f.newLine(2)
f.comment("A variable declaration")
f.varDeclaration("const int", "size", extern=True)
f.newLine()
f.varDeclaration("const int[]", "values")
f.newLine()
f.comment(["Now a multilne", "comment", "here"])
f.newLine()
f.comment("Another comment with a backslash at the end (note the added dot) -> \\")
f.newLine()
f.comment("Another array")
f.varDefinition("const char[]", "other", [1, 2, 3, 4, 5])
f.comment("A variable definition, with extra attributes")
f.varDefinition(["const", "char[]"],
"var_name", "this is a string",
extra_attribs="__attribute__ ((aligned (16)))")
f.closeGuard()
f.print()
f.write()
Prints and generates this file
#ifndef EXAMPLE_H_GUARD
#define EXAMPLE_H_GUARD
#define THIS 0
// A variable definition with intialization
const int values[] = {
0x00, 0x01, 0x02, 0x03, 0x04,
// This is an annotation for the element at position 5
0x05, 0x06, 0x07, 0x08, 0x09, 0x0a, 0x0b, 0x0c, 0x0d, 0x0e, 0x0f, 0x10, 0x11, 0x12, 0x13, 0x14,
0x15, 0x16, 0x17, 0x18, 0x19, 0x1a, 0x1b, 0x1c, 0x1d,
// Another annotation, but with single=True for the element at position 30
0x1e,
0x1f, 0x20, 0x21, 0x22, 0x23, 0x24, 0x25, 0x26, 0x27, 0x28, 0x29, 0x2a, 0x2b, 0x2c, 0x2d, 0x2e,
0x2f, 0x30, 0x31, 0x32, 0x33, 0x34, 0x35, 0x36, 0x37, 0x38, 0x39, 0x3a, 0x3b, 0x3c, 0x3d, 0x3e,
0x3f, 0x40, 0x41, 0x42, 0x43, 0x44, 0x45, 0x46, 0x47, 0x48, 0x49, 0x4a, 0x4b, 0x4c, 0x4d, 0x4e,
0x4f, 0x50, 0x51, 0x52, 0x53, 0x54, 0x55, 0x56, 0x57, 0x58, 0x59, 0x5a, 0x5b, 0x5c, 0x5d, 0x5e,
0x5f, 0x60, 0x61, 0x62, 0x63
};
// A variable declaration
extern const int size;
extern const int values[];
/*
* Now a multilne
* comment
* here
*/
// Another comment with a backslash at the end (note the added dot) -> \.
// Another array
const char other[] = {1, 2, 3, 4, 5};
// A variable definition, with extra attributes
const char var_name[] __attribute__ ((aligned (16))) = "this is a string";
#endif /* EXAMPLE_H_GUARD */
NOTE: The generated code above is only meant as an example, and doesn't intend to show what should be placed in an .h file.
Licensing and Copyright
BSD 2-Clause License
Copyright © 2023, Guillermo Romero (Gato)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
cwriter-0.1.0a3.tar.gz
(8.5 kB
view hashes)
Built Distribution
Close
Hashes for cwriter-0.1.0a3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e3f256677db4dc90d781e57fe39121b3adb2d1a9dfd22b62e7e27aa72fa0e210 |
|
MD5 | 25b5e4ad9790353f0e88265650aef8a8 |
|
BLAKE2b-256 | 18e30a88862d42ab42b1f892f843ebb5bd0dc838d385c84bb413e00d81073096 |