Meta Controller

Meta Controller (MC or Meta) is a meta programming tool that allows not only building of a project's source code but also actively control it. This is accomplished by an abstract file structure representation of the source code together with a configuration file (by default meta.json). Controlling these two components provides powerfull control of the resultant source code.

Some features are:

• Switching code between environments
• Transformations and injections using Go's templating language
• Composing and decomposing of files (or fan-in/fan-out)
• Running actions and building files (ordered by a DAG)
• Extend build functionallity to fit various applications
• and many more...

The broader goal of MC to allow development on a small set of abstact code while controlling large code bases. In doing so the hope is to improve programming efficiency and readability while reducing complexity.

The significant problems we face cannot be solved by the same level of thinking that created them. Albert Einstein

Read more about Meta at oligoden.com/meta 🇿🇦

---

MC is part of the Oligoden set of tools and libraries. Checkout some of the other repositories.

---

Table of Contents

• Getting Started
• Introduction
  • Motivation
  • Meta Programming
  • Overview
  • Usage
• Installation
• Configuration Reference
• Extending to your own builder

Getting Started

If you have Go installed (and your ~/go/bin in your PATH env):

go install github.com/oligoden/meta@latest

will install Meta and:

meta

will print the usage. See Installing Meta for more information. You can now create a config file with:

echo "{\"name\": \"my-app\"}" > meta.json
mkdir work

and build with:

meta build

A file can now be added and Meta configured to include it:

{
  "name": "my-app",
  "dirs": {
    "cmd": {
      "dest":"/.app",
      "options":"output"
      "files": {
        "main.go": {}
      }
    }
  }
}

This time run meta up. Meta builds again and keeps on running to watch for file changes until stopped with Ctrl-C. You should now see a .app folder with a main.go file in it. The cmd/main.go file is processed(derived) and written to .app/main.go. Derived files be removed by running meta down.

Refer to Getting Started for more information.

Installation

Download the compressed package from github.com/oligoden/meta/releases

Optionally, download the SHA256SUMS file and run

sha256sum -c SHA256SUMS 2>&1 | grep OK

Extract the package

#Linux, macOS or FreeBSD
unzip meta-$VERSION-$OS-$ARCH.zip -d /usr/local

Add binary to your environment:

export PATH=$PATH:/usr/local/meta/bin

meta.json Configuration Reference

Refer to The meta.json Configuration Reference

Extending to your own builder

coming