nika

Welcome to the nika monorepo. Feel free to look around.

• See PROJECTS for project goals and objectives.
• See the ROADMAP for (old) project direction and status.

Development

Setup

We use Nix for dev shells, enabled by direnv. You should have both of these installed, and you should have the flake features enabled for your Nix installation.

If all is well, enter the project directory and direnv should complain about the .envrc being untrusted. Trust it with direnv allow, and nix will begin to build the devshell. When that's complete, you should have a shell with all the necessary dependencies available. The devshell will also come with custom commands, which you can explore with the menu command.

Contributing

• Before submitting a PR, run the check command (an alias of nix flake check -L). This will test many things, and will also be run in CI.
• If you modify the graph of the first-party crates, please update the crate graph with update-crate-graph.

Crate Map

• api (bin) - main action entrypoint over HTTP.
• art - macro-based ascii art.
• cli (bin) - command line interface (mostly useless right now).
• daemon (bin) - task runner daemon.
• db - model-based database adapter interface, and TiKV implementer.
• dvf - usage-specific newtypes used in models.
• fetcher - temporary binary for the fetch pathway.
• kv - key-value store interface and types, and TiKV implementer.
• migrator (bin) - database migration tool.
• models - primary db model types.
• mollusk - interfaces for HTTP errors, public and private.
• names - name generator.
• nasty - nix daemon interactions.
• prime-domain - service-level entrypoints for logic in the prime domain.
• repos - repository interfaces and implementers.
• rope - persistent distributed task interface.
• slugger - slug types.
• starc - smart pointer for static, owned, or ref-counted data.
• storage - storage interface and implementers.
• tasks - task types and logic.

License

This project is licensed under the AGPL-3.0 with an addendum restricting direct competition.

• See the LICENSE file for the full AGPL text.
• See the ADDENDUM file for additional restrictions.

As of this moment, this workspace is not published on crates.io so the cargo license metadata is not populated. This has no bearing on the licensure of the code.

By using this software, you agree to be bound by the terms of the AGPL and the addendum.