building.h

Go to the documentation of this file.

 
#pragma once
 
// ============================================================================
// Opaque build types (owned by the VM / host runner)
// ============================================================================
 
typedef struct __cccc_Builder Builder;
 
typedef struct __cccc_BuildTarget BuildTarget;
 
// ============================================================================
// Underlying FFI-callable functions
// ============================================================================
 
const char *__builtin_build_root(Builder *ctx);
 
const char *__builtin_build_out_dir(Builder *ctx);
 
const char *__builtin_build_host(Builder *ctx);
 
int __builtin_build_verbose(Builder *ctx);
 
void __builtin_build_watch(Builder *ctx, const char *path);
void __builtin_build_watch_glob(Builder *ctx, const char *pattern);
void __builtin_build_ignore_watch(Builder *ctx, const char *pattern);
int __builtin_build_watching(Builder *ctx);
 
const char *__builtin_build_cccc_path(Builder *ctx);
 
BuildTarget *__builtin_build_executable(Builder *ctx, const char *name);
 
BuildTarget *__builtin_build_static_lib(Builder *ctx, const char *name);
 
BuildTarget *__builtin_build_dynamic_lib(Builder *ctx, const char *name);
 
BuildTarget *__builtin_build_cccc_executable(Builder *ctx, const char *name);
 
BuildTarget *__builtin_build_cccc_object(Builder *ctx, const char *name);
 
void __builtin_build_set_output(BuildTarget *t, const char *path);
 
const char *__builtin_build_target_output(BuildTarget *t);
 
void __builtin_build_declare_output(BuildTarget *t, const char *path);
 
void __builtin_build_add_input(BuildTarget *t, const char *path);
 
void __builtin_build_add_source(BuildTarget *t, const char *path);
 
void __builtin_build_add_sources_glob(BuildTarget *t, const char *pattern);
 
void __builtin_build_add_sources_glob_deferred(BuildTarget *t,
                                               const char  *pattern);
 
void __builtin_build_add_source_str(BuildTarget *t, const char *name,
                                    const char *content);
 
void __builtin_build_exclude_source(BuildTarget *t, const char *pattern);
 
void __builtin_build_add_include(BuildTarget *t, const char *path);
 
void __builtin_build_add_system_include(BuildTarget *t, const char *path);
 
void __builtin_build_add_define(BuildTarget *t, const char *name,
                                const char *value);
 
void __builtin_build_add_undef(BuildTarget *t, const char *name);
 
void __builtin_build_add_cflag(BuildTarget *t, const char *flag);
 
void __builtin_build_add_ldflag(BuildTarget *t, const char *flag);
 
void __builtin_build_set_target_env(BuildTarget *t, const char *name,
                                    const char *value);
 
void __builtin_build_link_with(BuildTarget *t, BuildTarget *dep);
 
void __builtin_build_depends_on(BuildTarget *t, BuildTarget *dep);
 
void __builtin_build_add_lib(BuildTarget *t, const char *name);
 
void __builtin_build_add_libpath(BuildTarget *t, const char *path);
 
const char *__builtin_build_get_env(Builder *ctx, const char *name);
 
const char *__builtin_build_capture_command(Builder *ctx, const char *cmd);
 
int __builtin_build_file_exists(Builder *ctx, const char *path);
 
int __builtin_build_have_tool(Builder *ctx, const char *name);
 
int __builtin_build_pkg_config(BuildTarget *t, const char *pkg);
 
BuildTarget *__builtin_build_run_custom(Builder *ctx, const char *name,
                                        const char *cmd);
 
void __builtin_build_set_profile(BuildTarget *t, const char *profile);
 
const char *__builtin_build_profile(Builder *ctx);
 
void __builtin_build_set_toolchain(BuildTarget *t, const char *cc);
 
void __builtin_build_set_target_triple(BuildTarget *t, const char *triple);
 
const char *__builtin_build_target_triple(Builder *ctx);
 
int __builtin_build_target_count(Builder *ctx);
 
const char *__builtin_build_target_name(Builder *ctx, int i);
 
const char *__builtin_build_find_tool(Builder *ctx, const char *name);
 
const char *__builtin_build_get_build_option(Builder *ctx, const char *name);
 
int __builtin_build_have_build_option(Builder *ctx, const char *name);
 
void __builtin_build_add_framework(BuildTarget *t, const char *name);
 
void __builtin_build_add_framework_path(BuildTarget *t, const char *path);
 
void __builtin_build_use_system_headers(BuildTarget *t);
 
int __builtin_build_argc(Builder *ctx);
 
const char *__builtin_build_argv(Builder *ctx, int i);
 
void __builtin_build_set_install_prefix(Builder *ctx, const char *path);
 
void __builtin_build_install_artifact(Builder *ctx, BuildTarget *t);
 
int __builtin_build_wants_install(Builder *ctx);
 
int __builtin_build_dir_exists(Builder *ctx, const char *path);
 
const char **__builtin_build_glob_files(Builder *ctx, const char *pattern);
 
const char *__builtin_build_read_file(Builder *ctx, const char *path);
 
int __builtin_build_write_file(Builder *ctx, const char *path,
                               const char *content);
 
int __builtin_build_set_cwd(Builder *ctx, const char *path);
 
const char *__builtin_build_get_cwd(Builder *ctx);
 
int __builtin_build_copy_file(Builder *ctx, const char *src, const char *dst);
 
int __builtin_build_move_file(Builder *ctx, const char *src, const char *dst);
 
int __builtin_build_delete_file(Builder *ctx, const char *path);
 
int __builtin_build_mkdir(Builder *ctx, const char *path);
 
int __builtin_build_delete_dir(Builder *ctx, const char *path);
 
int __builtin_build_run(Builder *ctx, BuildTarget *t);
 
int __builtin_build_run_all(Builder *ctx);
 
int __builtin_build_run_default(Builder *ctx);
 
// ============================================================================
// PascalCase macro wrappers (ctx is passed explicitly by the build entry)
// ============================================================================
 
#define BuildRoot(ctx) __builtin_build_root(ctx)
 
#define BuildOutDir(ctx) __builtin_build_out_dir(ctx)
 
#define BuildHost(ctx) __builtin_build_host(ctx)
 
#define BuildVerbose(ctx) __builtin_build_verbose(ctx)
 
#define Watch(ctx, path) __builtin_build_watch(ctx, path)
 
#define WatchGlob(ctx, pat) __builtin_build_watch_glob(ctx, pat)
 
#define IgnoreWatch(ctx, pat) __builtin_build_ignore_watch(ctx, pat)
 
#define BuildWatching(ctx) __builtin_build_watching(ctx)
 
#define CcccPath(ctx) __builtin_build_cccc_path(ctx)
 
#define Executable(ctx, name) __builtin_build_executable(ctx, name)
 
#define StaticLib(ctx, name) __builtin_build_static_lib(ctx, name)
 
#define DynamicLib(ctx, name) __builtin_build_dynamic_lib(ctx, name)
 
#define CcccExecutable(ctx, name) __builtin_build_cccc_executable(ctx, name)
 
#define CcccObject(ctx, name) __builtin_build_cccc_object(ctx, name)
 
#define SetOutput(t, p) __builtin_build_set_output(t, p)
 
#define TargetOutput(t) __builtin_build_target_output(t)
 
#define DeclareOutput(t, p) __builtin_build_declare_output(t, p)
 
#define AddSource(t, p) __builtin_build_add_source(t, p)
 
#define AddSourcesGlob(t, pat) __builtin_build_add_sources_glob(t, pat)
 
#define AddSourcesGlobDeferred(t, pat)                                         \
    __builtin_build_add_sources_glob_deferred(t, pat)
 
#define AddSourceStr(t, n, c) __builtin_build_add_source_str(t, n, c)
 
#define AddInput(t, p) __builtin_build_add_input(t, p)
 
#define ExcludeSource(t, pat) __builtin_build_exclude_source(t, pat)
 
#define AddInclude(t, p) __builtin_build_add_include(t, p)
 
#define AddSystemInclude(t, p) __builtin_build_add_system_include(t, p)
 
#define AddDefine(t, n, v) __builtin_build_add_define(t, n, v)
 
#define AddUndef(t, n) __builtin_build_add_undef(t, n)
 
#define AddCFlag(t, f) __builtin_build_add_cflag(t, f)
 
#define AddLdFlag(t, f) __builtin_build_add_ldflag(t, f)
 
#define SetTargetEnv(t, n, v) __builtin_build_set_target_env(t, n, v)
 
#define LinkWith(t, dep) __builtin_build_link_with(t, dep)
 
#define DependsOn(t, dep) __builtin_build_depends_on(t, dep)
 
#define AddLib(t, n) __builtin_build_add_lib(t, n)
 
#define AddLibPath(t, p) __builtin_build_add_libpath(t, p)
 
#define GetEnv(ctx, name) __builtin_build_get_env(ctx, name)
 
#define CaptureCommand(ctx, cmd) __builtin_build_capture_command(ctx, cmd)
 
#define FileExists(ctx, path) __builtin_build_file_exists(ctx, path)
 
#define DirExists(ctx, path) __builtin_build_dir_exists(ctx, path)
 
#define GlobFiles(ctx, pattern) __builtin_build_glob_files(ctx, pattern)
 
#define ReadFile(ctx, path) __builtin_build_read_file(ctx, path)
 
#define WriteFile(ctx, path, c) __builtin_build_write_file(ctx, path, c)
 
#define SetCwd(ctx, path) __builtin_build_set_cwd(ctx, path)
 
#define GetCwd(ctx) __builtin_build_get_cwd(ctx)
 
#define CopyFile(ctx, src, dst) __builtin_build_copy_file(ctx, src, dst)
 
#define MoveFile(ctx, src, dst) __builtin_build_move_file(ctx, src, dst)
 
#define DeleteFile(ctx, path) __builtin_build_delete_file(ctx, path)
 
#define MkDir(ctx, path) __builtin_build_mkdir(ctx, path)
 
#define DeleteDir(ctx, path) __builtin_build_delete_dir(ctx, path)
 
#define HaveTool(ctx, name) __builtin_build_have_tool(ctx, name)
 
#define FindTool(ctx, name) __builtin_build_find_tool(ctx, name)
 
#define PkgConfig(t, pkg) __builtin_build_pkg_config(t, pkg)
 
#define RunCustom(ctx, name, cmd) __builtin_build_run_custom(ctx, name, cmd)
 
#define GetBuildOption(ctx, name) __builtin_build_get_build_option(ctx, name)
 
#define HaveBuildOption(ctx, name) __builtin_build_have_build_option(ctx, name)
 
#define AddFramework(t, name) __builtin_build_add_framework(t, name)
 
#define AddFrameworkPath(t, p) __builtin_build_add_framework_path(t, p)
 
#define UseSystemHeaders(t) __builtin_build_use_system_headers(t)
 
#define BuildArgc(ctx) __builtin_build_argc(ctx)
 
#define BuildArgv(ctx, i) __builtin_build_argv(ctx, i)
 
#define SetInstallPrefix(ctx, path)                                            \
    __builtin_build_set_install_prefix(ctx, path)
 
#define InstallArtifact(ctx, t) __builtin_build_install_artifact(ctx, t)
 
#define BuildWantsInstall(ctx) __builtin_build_wants_install(ctx)
 
#define SetProfile(t, p) __builtin_build_set_profile(t, p)
 
#define BuildProfile(ctx) __builtin_build_profile(ctx)
 
#define SetToolchain(t, cc) __builtin_build_set_toolchain(t, cc)
 
#define SetTargetTriple(t, triple) __builtin_build_set_target_triple(t, triple)
 
#define BuildTargetTriple(ctx) __builtin_build_target_triple(ctx)
 
#define BuildTargetCount(ctx) __builtin_build_target_count(ctx)
 
#define BuildTargetName(ctx, i) __builtin_build_target_name(ctx, i)
 
#define Build(ctx, t) __builtin_build_run(ctx, t)
 
#define BuildAll(ctx) __builtin_build_run_all(ctx)
 
#define BuildDefault(ctx) __builtin_build_run_default(ctx)