Skip to content

suirad/zig-header-gen

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HeaderGen

HeaderGen automatically generates headers/bindings for other languages given Zig code with exported functions/types

Here are the following supported language binding outputs:

  • C Bindings
  • Python Bindings
  • Rust Bindings
  • Go Bindings
  • Nim Bindings

Here are the following supported Zig language features:

  • Extern Functions
  • Extern Structs
  • Extern Unions
  • Extern Enums

Getting started

Given the following Zig code as the file src/fancylib.zig and using the C generator:

const std = @import("std");

export fn print_msg(msg_ptr: ?[*]const u8, len: usize) bool {
    if (msg_ptr) |raw_msg| {
        const msg = raw_msg[0 .. len - 1];
        std.debug.print("Msg is: {}", .{msg});
        return true;
    }
    return false;
}

const Internal = struct {
    a: u64,
};

const External = extern struct {
    b: u64,
    c: [100]u8,
};

export fn use_internal_and_external(i: ?*Internal, e: ?*External) void {
    // do things...
}

You will receive the following C header in headers/fancylib.h:

#ifndef _fancylib_H

#define _fancylib_H
#include <stddef.h>
#include <stdint.h>
#include <stdbool.h>

typedef struct External {
   uint64_t b;
   uint8_t c[100];
} External_t;

bool print_msg(uint8_t* arg0, size_t arg1);

void use_internal_and_external(void* arg0, External_t* arg1);


#endif

Usage Notes

  • Copy from this repo header_gen.zig and the folder generators; drop them next to your build.zig
  • See the build.zig in this repo for an example of integration