CCODE - Package Manager + Project Generator

This is a project generator that uses Go and its package management for C++ packages. The structure of packages are defined in Go and files can be generated for Visual Studio (.sln, .vcxproj and .filters), Xcode, Tundra and also a custom C++ buildsystem called Clay.

If you like my work and want to support me. Please consider to buy me a coffee!

Any C++ external dependency like Boost, DirectX or whatnot should be wrapped in a package (github or other git server). There are a couple of notable features that can be triggered when generating the project files:

• generating .clang-format and/or .gitignore
• generating source/test/cpp/test_main.cpp
• converting any file in embedded (following the directory structure) to C style array's so as to embed those files into your library/app
• code generation of C++ enum from .json file

Also this project is a personal project and thus is not perfect but it serves my needs, feel free to post issues/requests if you want to see additional features.

This allows me to write packages (C++ libraries) and use them in another C++ package by defining a dependency on them. Using the go package management solution you can 'get' these packages and then by running go run %name%.go you can generate, for example Visual Studio solution and project files. The goal is to support the following IDE's:

• Visual Studio (supported, Windows)
• Xcode (supported, Mac)

And buildsystems:

• Tundra (supported, Mac, Linux and Windows)
• Clay (supported on Mac, (Linux and Windows are coming soon))

Make as a buildsystem is deprecated, but still supported:

• Make (supported on Mac and Linux)

Currently the design is quite set and the goal is to keep API changes to a minimum.

If you have a repository/package that uses ccode, you can do the following to generate the tundra build files (default on Mac and Linux), this example uses the cbase repository:

1. go run cbase.go --dev=tundra
2. cd into target/tundra
3. tundra debug (will build all configuration, e.g. debug and release)
4. tundra clean (will clean all artifacts)
5. tundra debugtest (will build only debugtest configuration)

For Visual Studio (on Windows, Visual Studio is the default generator):

1. go run cbase.go --dev=vs2022
2. cd into target/msdev
3. You now should have Visual Studio solution and project files

For Clay (on Mac):

1. go run cbase.go --dev=clay
2. cd into target/clay
3. run ./clay build --build debug-dev-test

These are the steps to make a new package, or take a peek at one of my libraries, like github.com/jurgen-kluft/cbase:

1. Create a new Github repository like mylibrary
2. In the root create a mylibrary.go file
3. In the root create a folder called package with a file in it called package.go
4. Once you have specified everything in package.go:
   • In the root 'go get' (this will get all your specified dependencies in GO_PATH)
   • To generate the VS solution (default on Windows) and projects just run: go run mylibrary.go
   • To generate the Tundra build file (default on MacOS) run: go run mylibrary.go

Example: The content of the mylibrary.go file:

package main

import (
    "github.com/jurgen-kluft/mylibrary/package"
    "github.com/jurgen-kluft/ccode"
)

func main() {
    if ccode.Init() {
        // This will generate
        // - ./.gitignore
        // - ./.clang-format
        // - ./source/test/cpp/test_main.cpp    
        ccode.GenerateFiles()
        
        // This will generate the Visual Studio solution and projects, 
        // makefile, tundra or clay build files
        ccode.Generate(mylibrary.GetPackage())

        // You can also insert generated C++ enums with ToString and other functions, the my_enums.h
        // file should already exist and have 2 delimiter lines that you can configure as 
        // 'between' (take a peek inside the `embedded/my_enums.h.json` file)
        ccode.GenerateCppEnums("embedded/my_enums.h.json", "main/include/cbase/my_enums.h")

        // Or if you are up to it, even generating structs is possible
        ccode.GenerateCppStructs("embedded/my_structs.h.json", "main/include/cbase/my_structs.h")
    }
}

The content of the /package/package.go file with one dependency on 'myunittest':

package mylibrary

import (
	cbase "github.com/jurgen-kluft/cbase/package"
	denv "github.com/jurgen-kluft/ccode/denv"
	cunittest "github.com/jurgen-kluft/cunittest/package"
)

const (
	repo_path = "github.com\\jurgen-kluft"
	repo_name = "mylibrary"
)

func GetPackage() *denv.Package {
	name := repo_name

	// dependencies
	cunittestpkg := cunittest.GetPackage()
	cbasepkg := cbase.GetPackage()

	// main package
	mainpkg := denv.NewPackage(repo_path, repo_name)
	mainpkg.AddPackage(cunittestpkg)
	mainpkg.AddPackage(cbasepkg)

	// main library
	mainlib := denv.SetupCppLibProject(mainpkg, name)
	mainlib.AddDependencies(cbasepkg.GetMainLib()...)

	// test library
	testlib := denv.SetupCppTestLibProject(mainpkg, name)
	testlib.AddDependencies(cbasepkg.GetTestLib()...)
	testlib.AddDependencies(cunittestpkg.GetTestLib()...)

	// unittest project
	maintest := denv.SetupCppTestProject(mainpkg, name)
	maintest.AddDependencies(cunittestpkg.GetMainLib()...)
	maintest.AddDependency(testlib)

	mainpkg.AddMainLib(mainlib)
	mainpkg.AddTestLib(testlib)
	mainpkg.AddUnittest(maintest)
	return mainpkg
}

There are some requirements for the layout of folders inside of your repository to hold the library and unittest files, this is the layout:

1. source\main\cpp: the cpp files of your library. Header files should be included as #include "mylibrary/header.h"
2. source\main\include\mylibrary: the header files of your library
3. source\test\cpp: the cpp files of your unittest app
4. source\test\include: the header files of your unittest app
5. embedded\**: all the files that need to be auto embedded or are used for code generation
   • binary file to .cpp C array
   • C++ enum code generation (from .json file)