chore(): init

Author: jwerle

.gitattributes

@@ -0,0 +1 @@
+*.zz linguist-language=C++

.github/workflows/tests.yml

@@ -0,0 +1,27 @@
+name: Tests
+
+on:
+  pull_request:
+  push:
+    branches:
+      - master
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: 'Download ZZ'
+      run: |
+        git clone https://github.com/aep/zz.git
+    - uses: actions-rs/cargo@v1
+      with:
+        command: install
+        args: --path zz
+    - name: 'Install System Dependencies'
+      run: |
+        sudo apt install -y z3
+    - name: 'Tests'
+      run: |
+        zz test

.gitignore

@@ -0,0 +1,6 @@
+/target
+.gdb_history
+vgcore.*
+**/*.o
+**/*.parsecache
+**/*.buildcache

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Joseph Werle
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,72 @@
+format
+======
+
+> String format macros for ZZ
+
+## Installation
+
+Add this to your `zz.toml` file:
+
+```toml
+[dependencies]
+format = "*"
+
+[repos]
+format = "git://github.com/zzmodules/format"
+```
+
+## Usage
+
+```c++
+using format
+```
+
+## API
+
+### `@format::with(fmt, ...)`
+
+Creates a formatted string from a variety of special tokens with traditional
+`printf` style specifiers supported.
+
+### Tokens
+
+* `{}` - Treats argument like a _struct_, calling `.display()` for a `char *`
+* `{*}` - Treats argument like a _pointer to a struct_, calling `->display()`  for a `char *`
+* `{0..9}` - References argument by position. Treatment is the same as `{}`
+* `{*0..9}` - References pointer argument by position. Treatment is same as `{*}`
+* `{$0..9}` - References argument _identifier name_ by position and uses it inline
+* `{0..9%X}` - References argument by position with format. Treatment is like a limited `printf`
+
+### `Display` Interface
+
+The `@format::with()` macro will treat struct and struct pointers specified
+with `{}`, `{*}`, and its variant as special input that should implement a
+**displayable** interface. Structs should simply implement a
+`display() -> char *` method like in the example below:
+
+```c++
+using format
+using log
+using string
+
+struct Vector {
+  float x;
+  float y;
+}
+
+fn display(Vector *self) -> char * {
+  new+64000 out = string::make();
+  out.format("Vector { x: %0.2f, y: %0.2f }", self->x, self->y);
+  return out.cstr();
+}
+
+fn main() -> {
+  let vec = Vector { x: 1.23, y: 2.46 };
+  log::info("%s", @format::with("{}", vec)); // Vector { x: 1.23, y: 2.46 }
+  return 0;
+}
+```
+
+## License
+
+MIT