*The crate was published with empty Typst to crates.io mostly to reserve the name for the typst dev if they wanted it later (and they can have the name anytime). This means that this formatter will likely change it's name (typfmt) at some point (or become the official one but I likely won't be the main dev then)*

In progress formatter for the Typst language!

- [Goals](#goals)
- [State](#state)
- [Installing](#installing)
- [Contributing](#contributing)
- [Architecture](#architecture)
  - [Main logic](#main-logic)
- [Testing and visualizing](#testing-and-visualizing)
  - [Installing Insta](#installing-insta)
  - [Using insta here](#using-insta-here)
    - [Can I see it in action?](#can-i-see-it-in-action)
    - [Is that all I have to help me test?](#is-that-all-i-have-to-help-me-test)


# Goals

- Decent output under any circumstances, anything not decent should be reported as a bug!
- Fast, Small, configurable and embeddable library and binary ! 

# State

Currently, the output shouldn't be always trusted and isn't perfect but should be lossless.

# Installing

```sh
cargo install --git https://github.com/astrale-sharp/typstfmt.git
```

This will put the compiled binary in `~/.cargo/bin/`. To use it without prefixing path to the binary you must add this directory to your `PATH`. You can check if it was already added with `echo "$PATH"`.

If you haven't added `~/.cargo/bin` to you `PATH`, you should add next line in your `.bashrc`, `.zshrc` etc.:

```sh
export PATH="$HOME/.cargo/bin:$PATH"
```

New instances of your shell (bash, zsh) will have an updated `PATH`.
Or you can add this to your `.profile` or `.zshenv` to update your `PATH` when the OS is booted. This will require a restart of the machine.

# Contributing
- feel free to open issue or discuss! I don't have github notifications so also feel free to go ping me on the typst discord server (at Astrale).
- once discussed, you may open a PR, not before cause I'm a bit chaotic and this is wip so things change fast and I would hate it if you lost your time.

# Architecture
## Main logic

Since we're visiting a AST (which is a tree) we have a recursive function
`visit(node: &LinkedNode, ctx: &mut Ctx)` that meets all the nodes in the tree.

It formats the children first (bottom up), the the parent decide what to do with their children.

Children have access to arbitrary context (they can know the kind of their parents, who are their siblings etc).


# Testing and visualizing

## Installing Insta
We use insta! If you don't have it installed take a look [here](https://insta.rs/docs/cli/) (I advise installing with [cargo binstall](https://github.com/cargo-bins/cargo-binstall) since I have a small computer and don't like waiting for things to compile)

one liner for cargo binstall : `curl -L --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/cargo-bins/cargo-binstall/main/install-from-binstall-release.sh | bash`

then `cargo binstall cargo-insta`

## Using insta here

### Can I see it in action?
to see how it currently formats all the snippets 
+ run `cargo test`, a failing test indicates one of the snippets displayed in the next step is not formatted like this anymore.
+ run `show_all.sh`

### Is that all I have to help me test?
Of course not! We have tracing enabled during tests!

If you're contributing tests you should add a test case under `src/tests` for instance: `make_test!(call_func_empty, "#f()");`

then running your tests: `cargo test && cargo insta review`

if the info log isn't enough, run `DEBUG=true cargo test`.
if you wish to pipe to a file run `NO_COLOR=true cargo test`
you may also set the `NOLOG` env variable if you wish to disable logging entirely.