Learn the Zig programming language by fixing tiny broken programs.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Dave Gauer 1a89e4ebf1
Merge pull request #99 from idle-z/fix-build-2022-05-01
1 week ago
.github/workflows workflow_dispatch test 1 year ago
exercises fix loop else clause explanation 1 month ago
patches Manually cleaned up patches/patches for issue #73 2 months ago
.gitattributes Cleaned up some extraneous whitespace characters 1 year ago
.gitignore Added testing ability 1 year ago
CONTRIBUTING.md fix: typo in CONTRIBUTING.md 10 months ago
LICENSE Added Ex. 2, polished script, added LICENSE 1 year ago
README.md Bump stable version of Zig in README to correct 1 month ago
build.zig Fix build on latest nightly zig 3 weeks ago

README.md

Ziglings

Welcome to Ziglings! This project contains a series of tiny broken programs. By fixing them, you'll learn how to read and write Zig code.

ziglings

Those tiny broken programs need your help! (You'll also save the planet from evil aliens and help some friendly elephants stick together, which is very sweet of you.)

This project was directly inspired by the brilliant and fun rustlings project for the Rust language. Indirect inspiration comes from Ruby Koans and the Little LISPer/Little Schemer series of books.

Intended Audience

This will probably be difficult if you've never programmed before. But no specific programming experience is required. And in particular, you are not expected to have any prior experience with "systems programming" or a "systems" level language such as C.

Each exercise is self-contained and self-explained. However, you're encouraged to also check out these Zig language resources for more detail:

Also, the Zig community is incredibly friendly and helpful!

Getting Started

Install a development build of the Zig compiler. (See the "master" section of the downloads page.)

Verify the installation and build number of zig like so:

$ zig version
0.10.0-dev.1427+xxxxxxxxx

Clone this repository with Git:

$ git clone https://github.com/ratfactor/ziglings
$ cd ziglings

Then run zig build and follow the instructions to begin!

$ zig build

A Note About Versions

The Zig language is under very active development. In order to be current, Ziglings tracks development builds of the Zig compiler rather than versioned release builds. The last stable release was 0.9.1, but Ziglings needs a dev build with pre-release version "0.10.0" and a build number at least as high as that shown in the example version check above.

It is likely that you'll download a build which is greater than the minimum.

(For those who cannot easily update Zig, there are also community-supported branches in this repo. At the moment, there's one for v0.8.1. Older version branches may or may not have all exercises and/or bugfixes.)

Once you have a build of the Zig compiler that works with Ziglings, they'll continue to work together. But keep in mind that if you update one, you may need to also update the other.

Also note that the current "stage 1" Zig compiler is very strict about input: no tab characters or Windows CR/LF newlines are allowed.

Version Changes

  • 2022-03-19 zig 0.10.0-dev.1427 - method for getting sentinel of type changed
  • 2021-12-20 zig 0.9.0-dev.2025 - c_void is now anyopaque
  • 2021-06-14 zig 0.9.0-dev.137 - std.build.Id .Custom is now .custom
  • 2021-04-21 zig 0.8.0-dev.1983 - std.fmt.format() any format string required
  • 2021-02-12 zig 0.8.0-dev.1065 - std.fmt.format() s (string) format string required

Advanced Usage

It can be handy to check just a single exercise or start from a single exercise:

zig build 19
zig build 19_start

You can also run without checking for correctness:

zig build 19_test

Or skip the build system entirely and interact directly with the compiler if you're into that sort of thing:

zig run exercises/001_hello.zig

Calling all wizards: To prepare an executable for debugging, install it to zig-cache/bin with:

zig build 19_install

What's Covered

I've decide to limit Ziglings to the core language and not attempt coverage of the Standard Library. Perhaps you can change my mind?

Core Language

  • Hello world (main needs to be public)
  • Importing standard library
  • Assignment
  • Arrays
  • Strings
  • If
  • While
  • For
  • Functions
  • Errors (error/try/catch/if-else-err)
  • Defer (and errdefer)
  • Switch
  • Unreachable
  • Enums
  • Structs
  • Pointers
  • Optionals
  • Struct methods
  • Slices
  • Many-item pointers
  • Unions
  • Numeric types (integers, floats)
  • Labelled blocks and loops
  • Loops as expressions
  • Builtins
  • Inline loops
  • Comptime
  • Sentinel termination
  • Quoted identifiers @""
  • Anonymous structs/tuples/lists
  • Async <--- IN PROGRESS!

Contributing

Contributions are very welcome! I'm writing this to teach myself and to create the learning resource I wished for. There will be tons of room for improvement:

  • Wording of explanations
  • Idiomatic usage of Zig
  • Maybe additional exercises?

Please see CONTRIBUTING.md in this repo for the full details.