CLI Reference

Basic Usage

python -m struct_frame [proto_file] [options]

Code Generation Flags

Flag	Description
--build_c	Generate C code
--build_cpp	Generate C++ code
--build_ts	Generate TypeScript code
--build_py	Generate Python code
--build_js	Generate JavaScript code
--build_gql	Generate GraphQL schema
--build_csharp	Generate C# code

Output Path Options

Flag	Description	Default
--c_path PATH	Output directory for C	generated/c/
--cpp_path PATH	Output directory for C++	generated/cpp/
--ts_path PATH	Output directory for TypeScript	generated/ts/
--py_path PATH	Output directory for Python	generated/py/
--js_path PATH	Output directory for JavaScript	generated/js/
--gql_path PATH	Output directory for GraphQL	generated/gql/
--csharp_path PATH	Output directory for C#	generated/csharp/

SDK Options

Flag	Description
--sdk	Include full SDK with network transports (C++, Python, TypeScript)
--sdk_embedded	Include embedded SDK without external dependencies (C++ only)

Examples

Generate C code:

python -m struct_frame messages.proto --build_c

Generate multiple languages:

python -m struct_frame messages.proto --build_c --build_cpp --build_py

Custom output paths:

python -m struct_frame messages.proto --build_c --c_path src/generated/

Generate with SDK:

python -m struct_frame messages.proto --build_cpp --sdk

Generated Files

C

• <name>.structframe.h - Message definitions
• Frame utilities (frame_base.h, frame_headers.h, frame_profiles.h, etc.)

C++

• <name>.structframe.hpp - Message definitions
• Frame utilities (frame_base.hpp, frame_headers.hpp, frame_profiles.hpp, etc.)
• struct_frame_sdk/ - SDK files (if --sdk or --sdk_embedded used)

TypeScript

• <name>.structframe.ts - Message definitions and classes
• Frame utilities (frame-base.ts, frame-headers.ts, frame-profiles.ts, etc.)
• struct_frame_sdk/ - SDK files (if --sdk used)

Python

• struct_frame/generated/<name>.py - Message definitions and classes
• Frame utilities (init.py, frame_base.py, frame_profiles.py, etc.)
• struct_frame_sdk/ - SDK files (if --sdk used)

JavaScript

• <name>.structframe.js - Message definitions and classes
• Frame parsing utilities

GraphQL

• <name>.structframe.graphql - GraphQL schema definitions

C

• <name>.structframe.cs - Message definitions and classes
• Frame parsing utilities