Skip to content
This repository has been archived by the owner on Dec 6, 2022. It is now read-only.

An Odin library to convert a C header file into an Odin binding file.

License

Notifications You must be signed in to change notification settings

Breush/odin-binding-generator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Odin binding generator

I dropped the support of this tool at the end of 2022. The reason is that I don't care anymore about Odin, and fixing "bugs" about C stupid syntax is not fun. Feel free to fork and keep alive if you need it.

An Odin library to convert a C header file into an Odin binding file.

Current status

No more support of this tool since the end of 2022.

The library has been tested against multiple C-libraries, such as xcb or vulkan, and the generated bindings are working fine.

When new tricky cases appear while converting a well-known library header, these are considered as bugs and are expected to be resolved quickly.

The C-parser is not expected to be perfect. Notably, "bugs" based on complex macros expansions are considered "intended". The goal is not to parse and resolve C wrong design decisions, but just be able to get a .odin file that works with most of C libraries.

No more support of this tool since the end of 2022.

Usage

import "bindgen"

main :: proc() {
    options : bindgen.GeneratorOptions;
    bindgen.generate(
        packageName = "vk",
        foreignLibrary = "system:vulkan",
        outputFile = "vulkan.odin",
        headerFiles = []string{"./vulkan.h"},
        options = options,
    );
}

See the examples to show options tweaking in practice (such as case conventions), run them from the root folder: odin run ./examples/vulkan/generate.odin.

These examples generate bindings from the C headers of the library into ./examples/vulkans/generated/ and can be tested with odin run ./examples/vulkan/vulkan/test.odin.

Please note that these examples are not meant to generate up-to-date bindings, but to test said bindings.

One way to prevent errors with C macros is to run the preprocessor first, like so:

cat zlib.h | grep -v "#include " | gcc -E - -o - | grep -v "# " > zlib-preprocessed.h

Generator options

Variables

Variables, in this context, are function parameters and struct members names.

void function(int variableName);
Description Generated code
Enforce a new case syntax for variables.
Case.Unknown keeps original.
  • variableCase = Case.Snake
function :: proc(variable_name : int) ---;

Defines

Parsing C #define, macros will be ignored. Other directives like #ifdef or #pragma are fully ignored too.

#define AB_MY_BEST_NUMBER 4
Description Generated code
A list of prefixes that should be removed from define names.
These are recursive and will be removed as long as long possible.
  • definePrefixes = []string{"AB_"}
Postfix variant definePostfixes.
MY_BEST_NUMBER :: 4;
A list of prefixes that should be kept but ignored while prefix removing.
  • definePrefixes = []string{"MY_"}
  • defineTransparentPrefixes = []string{"AB_"}
Postfix variant defineTransparentPostfixes.
AB_BEST_NUMBER :: 4;
Enforce a new case syntax for defines.
Case.Unknown keeps original.
  • defineCase = Case.Camel
abMyBestNumber :: 4;

Pseudo-types

A pseudo-type is either a struct, union, enum or typedef alias. That is to say anything that can be used as a type.

typedef struct {} ab_my_shape_ext;
Description Generated code
A list of prefixes that should be removed from pseudo-type names.
These are recursive and will be removed as long as long possible.
  • pseudoTypePrefixes = []string{"ab_"}
Postfix variant pseudoTypePostfixes.
my_shape_ext :: struct {}
A list of prefixes that should be kept but ignored while prefix removing.
  • pseudoTypePrefixes = []string{"my_"}
  • pseudoTypeTransparentPrefixes = []string{"ab_"}
Postfix variant pseudoTypeTransparentPostfixes.
ab_shape_ext :: struct {}
Enforce a new case syntax for pseudo-types.
Case.Unknown keeps original.
  • pseudoTypeCase = Case.Pascal
AbMyShapeExt :: struct {}

Functions

Only functions declarations are parsed, definitions are ignored.

uint32_t abMyFunction();
Description Generated code
A list of prefixes that should be removed from function names.
These are recursive and will be removed as long as long possible.
  • functionPrefixes = []string{"ab"}
Postfix variant functionPostfixes.
MyFunction :: proc() -> u32 ---;
A list of prefixes that should be kept but ignored while prefix removing.
  • functionPrefixes = []string{"My"}
  • functionTransparentPrefixes = []string{"ab"}
Postfix variant functionTransparentPostfixes.
abFunction :: proc() -> u32 ---;
Enforce a new case syntax for functions.
Case.Unknown keeps original.
  • functionCase = Case.Pascal
ab_my_function :: proc() -> u32 ---;

Enum values

Enum values are members of enums.

typedef enum {
    AB_MY_SHAPE_EXT_SQUARE, // The enum name is repeated in the value.
    AB_MY_SHAPE_CIRCLE_EXT, // Here, the EXT part has been moved to the end.
} abMyShapeExt;
Description Generated code
A list of prefixes that should be removed from enum values.
These are recursive and will be removed as long as long possible.
  • enumValuePrefixes = []string{"AB_"}
Postfix variant enumValuePostfixes.
abMyShapeExt :: enum i32 {
MY_SHAPE_EXT_SQUARE,
MY_SHAPE_CIRCLE_EXT
}
A list of prefixes that should be kept but ignored while prefix removing.
  • enumValuePrefixes = []string{"MY_"}
  • enumValueTransparentPrefixes = []string{"AB_"}
Postfix variant enumValueTransparentPostfixes.
abMyShapeExt :: enum i32 {
AB_SHAPE_EXT_SQUARE,
AB_SHAPE_CIRCLE_EXT
}
Enforce a new case syntax for enum values.
Case.Unknown keeps original.
  • enumValueCase = Case.Pascal
abMyShapeExt :: enum i32 {
AbMyShapeExtSquare,
AbMyShapeCircleExt
}
Whether we should remove the prefix of an enum value if it matches its enum name.
The case variant of the enum value is detected automatically.
  • enumValueNameRemove = true
abMyShapeExt :: enum i32 {
SQUARE,
AB_MY_SHAPE_CIRCLE_EXT
}
The postfixes to be removed from the enum name while removing it from enum values.
If any postfix is removed, we try to remove it from all the enum values too (adapting the case).
  • enumValueNameRemove = true
  • enumValueNameRemovePostfixes = []string{"Ext"}
abMyShapeExt :: enum i32 {
EXT_SQUARE,
CIRCLE
}

Parser options

One can specify options for the parser, through the generator options. The purpose is mainly to handle custom macros, as the binding generator won't handle them.

Description
A list of tokens that should be understood as whitespaces.
  • ignoredTokens = []string{"AB_INLINE"}
A map of handlers used to understand a part of code that starts with the key as token. See ./examples/vulkan/generate.odin to find a use case.
  • customHandlers["AB_DEFINE"] = proc(data : ^ParserData) { ... };
A map of handlers used to understand a part of code that starts with the key as token and that generates some expression value. See ./examples/vulkan/generate.odin to find a use case.
  • customExpressionHandlers["AB_SQRT"] = proc(data : ^ParserData) -> LiteralValue { ... };

License

This library is MIT-licensed. See license.txt.

About

An Odin library to convert a C header file into an Odin binding file.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published