zibra

WARNING This project is actively in work! HEAD usually works but it may be broken or produce nasty results.

This repo holds my Zig code for the browser implemented in Web Browser Engineering.

Usage

You'll need Zig installed.

Clone the project

git clone https://github.com/braheezy/zibra.git

To build the project, run:

zig build
cp zig-out/bin/zibra .

zibra (optionally) takes one URL and displays the result in a window:

zibra https://example.org

Run without a URL for a default HTML.

zibra is small but supports the basics:

HTTP/1.1
HTTPS
file:// URIs
data: URIs
Entity support:
- & → & (ampersand)
- < → < (less than)
- > → > (greater than)
- " → " (quotation mark)
- ' → ' (apostrophe)
-  → (soft hyphen)
Connections that live beyond single request for Connection: keep-alive header
Redirects
Cache-Control header
Content-Encoding: gzip and Transfer-Encoding: chunked headers
Emojis and CJK text
Various tags for styling:
- <b>Bold</b>
- <i>Italic</i>
- <big>Larger text</big>
- <small>Smaller text</small>
- <sup>Superscript</sup>
- <h1 class="title">Centered title</h1>: An h1 with class set to title will be centered
- <abbr>Abbreviations</abbr>
- <pre>Preformatted text</pre>: Including bold and italic variants
HTML parsing features:
- Automatic insertion of implicit <html>, <head>, and <body> tags
- Proper handling of self-closing tags like <img />, <br />, and <input />
- Support for quoted, unquoted, and boolean HTML attributes

There's more Zig commands:

# build and run
zig build run -- https://example.com
# Run tests
zig build test

To test chunked gzip responses, run gzipServer.py locally.

On Mac, the content is stretched while the window is being resized. Apparently this is known behavior in SDL2 because Mac blocks the main thread while the mouse is being held down to resize windows, preventing SDL from rendering the content properly...I think.