h-e-l-l-o-w-o-r-l-d

An unnecessary-ily long build pipeline for a hello world program

Build

Only dependency you need is docker-compose
Run ./build.sh to build the entire pipeline

Clean

Run ./build.sh clean to clean all build related files

Run

Run ./build.sh run to run the hello_world executable created by ./build.sh

Shell (for debugging)

Run ./build.sh shell to start a shell in the container where ./build.sh is run

Setup

Tools

• generate_build_py: JS script to generate build.py based on a jsonc file
• build_tools: Zig library that gets compiled into a python module; used in the build.py to execute bash statements
• PATH: C executable that transpiles PATH to C
• hello_world.c_maker: PATH file that, when transpiled to c and compiled, will make the final hello_world.c

Pipeline

• Generate build.py

  • src/generate_build_py
  • See src/build_steps.jsonc, src/build_template.py, and src/start-build.sh

• Build tools python module

  • src/build_tools
  • See src/start-build.sh

• Compile brainfuck to PATH transpiler

  • src/bf2path
  • See src/bf2path/build.sh

• Compile PATH to C transpiler

  • src/PATH
  • See src/PATH/Makefile

• Compile hello_world.c_maker

  • src/hello_world.c_maker
  • hello_world.c_maker.PATH -> hello_world.c_maker.c -> hello_world.c_maker
  • Uses PATH to C transpiler
  • See src/hello_world.c_maker/build.sh

• Compile hello_world

  • hello_world.c_maker -> hello_world.c -> hello_world

Contributing

If you wish to contribute to this project, you're free to do so, just fork the repository, do your changes, open a pull request, and if your changes are good (they make the build time longer), we'll merge it

Also please make sure to do the following

1. Add necessary commands to src/build_steps.jsonc (or src/start-build.sh)
2. Add any intermediate files to .gitignore and src/clean.sh
3. Keep documentation up to date (mainly this README.md)

What to contribute, what not to

What we want is not you just going

heh, I'll just add the gcc source code to this and compile that, then it'll take a couple minutes at least

We want something more creative, something that was built specifically for this project, specifically to make it build slower

How to add dependencies

If you need a specific program for your contribution to work, add it to the Dockerfile.

This should be doable by getting it through apk add, provided the program you need is in the alpine linux package list.
If that is not the case, please add commands to manually build the dependency in setup-docker-image.sh.

Dependency in this case refers to an external program - one that was not coded for h-e-l-l-o-w-o-r-l-d. Any program you (or someone else) created for this may (and should) be built at build time, not setup time.

DISCLAIMER

By contributing to this project, you agree to license the code you wrote for this project under the Unlisence
Or in other words, anyone is allowed to do whatever they want with your code