Welcome to cgen’s documentation!

cgen offers a simple abstract syntax tree for C and related languages (C++/CUDA/OpenCL) to allow structured code generation from Python.

Here’s an example, to give you an impression:

import cgen as c


func = c.FunctionBody(
    c.FunctionDeclaration(c.Const(c.Pointer(c.Value("char", "greet"))), []),
    c.Block([
        c.Statement('return "hello world"')
        ])
    )

print(func)

This prints the following:

char const *greet()
{
  return "hello world";
}

cgen deliberately does not worry about expression trees. Its sister package pymbolic can help you build those.

Contents

• cgen – C-Generation Reference Documentation
  • dtype_to_ctype()
  • Generable
  • Block
  • Collection
  • Module
  • Line
  • Data and Functions
  • Preprocessor Code
  • Declarators
  • Nested Declarators
  • Declaration Specifiers
  • Statements
  • cgen.cuda – Extensions to generate CUDA-compatible C Sources
  • cgen.opencl – Extensions to generate OpenCL-compatible C Sources
• License
• 🚀 Github
• 💾 Download Releases

Indices and tables

• Index

• Module Index

• Search Page