zig/example
Andrew Kelley 91955dee58
breaking changes to zig build API and improved caching
* in Zig build scripts, getOutputPath() is no longer a valid function
   to call, unless setOutputDir() was used, or within a custom make()
   function. Instead there is more convenient API to use which takes
   advantage of the caching system. Search this commit diff for
   `exe.run()` for an example.
 * Zig build by default enables caching. All build artifacts will go
   into zig-cache. If you want to access build artifacts in a convenient
   location, it is recommended to add an `install` step. Otherwise
   you can use the `run()` API mentioned above to execute programs
   directly from their location in the cache. Closes #330.
   `addSystemCommand` is available for programs not built with Zig
   build.
 * Please note that Zig does no cache evicting yet. You may have to
   manually delete zig-cache directories periodically to keep disk
   usage down. It's planned for this to be a simple Least Recently
   Used eviction system eventually.
 * `--output`, `--output-lib`, and `--output-h` are removed. Instead,
   use `--output-dir` which defaults to the current working directory.
   Or take advantage of `--cache on`, which will print the main output
   path to stdout, and the other artifacts will be in the same directory
   with predictable file names. `--disable-gen-h` is available when
   one wants to prevent .h file generation.
 * `@cImport` is always independently cached now. Closes #2015.
   It always writes the generated Zig code to disk which makes debug
   info and compile errors better. No more "TODO: remember C source
   location to display here"
 * Fix .d file parsing. (Fixes the MacOS CI failure)
 * Zig no longer creates "temporary files" other than inside a
   zig-cache directory.

This breaks the CLI API that Godbolt uses. The suggested new invocation
can be found in this commit diff, in the changes to `test/cli.zig`.
2019-03-08 23:23:11 -05:00
..
cat New Zig formal grammar (#1685) 2018-11-13 05:08:37 -08:00
guess_number breaking API changes to all readInt/writeInt functions & more 2018-12-12 20:35:04 -05:00
hello_world hello world example can use `const` instead of `var` 2018-12-23 13:57:37 -05:00
mix_o_files breaking changes to zig build API and improved caching 2019-03-08 23:23:11 -05:00
shared_library breaking changes to zig build API and improved caching 2019-03-08 23:23:11 -05:00
README.md delete rogue file 2018-11-16 14:26:53 -05:00

README.md

Zig Examples

  • Tetris - A simple Tetris clone written in Zig. See andrewrk/tetris.
  • hello_world - demonstration of a printing a single line to stdout. One version depends on libc; one does not.
  • guess_number - simple console game where you guess the number the computer is thinking of and it says higher or lower. No dependency on libc.
  • cat - implementation of the cat UNIX utility in Zig, with no dependency on libc.
  • shared_library - demonstration of building a shared library and generating a header file for interop with C code.
  • mix_o_files - how to mix .zig and .c files together as object files