mirror of
https://github.com/juspay/omnix.git
synced 2024-11-23 23:05:04 +03:00
🚧 A Nix wrapper to improve developer experience
af87950a43
Some checks failed
CI / main (${{ contains(github.ref, 'main') }}, aarch64-darwin) (push) Has been cancelled
CI / main (${{ contains(github.ref, 'main') }}, aarch64-linux) (push) Has been cancelled
CI / main (${{ contains(github.ref, 'main') }}, x86_64-darwin) (push) Has been cancelled
CI / main (${{ contains(github.ref, 'main') }}, x86_64-linux) (push) Has been cancelled
CI / website (push) Has been cancelled
CI / static-binary-check (macos-latest) (push) Has been cancelled
CI / static-binary-check (ubuntu-latest) (push) Has been cancelled
|
||
---|---|---|
.github/workflows | ||
.vscode | ||
crates | ||
doc | ||
nix | ||
.envrc | ||
.gitattributes | ||
.gitignore | ||
bacon.toml | ||
Cargo.lock | ||
Cargo.toml | ||
flake.lock | ||
flake.nix | ||
justfile | ||
LICENSE | ||
omnixrc | ||
README.md | ||
rust-toolchain.toml |
omnix
Pronounced /ɒmˈnɪks/
Note
🚧 omnix is in active development. It aims to supplement the Nix CLI to improve developer experience.
Usage
Developing
- Install Nix
- Setup
direnv
- Clone this repo,
cd
to it, and rundirenv allow
.
This will automatically activate the nix develop shell. Open VSCode and install recommended extensions, ensuring that direnv activates in VSCode as well.
Running locally
To run omnix-cli
,
just watch # Or `just w`; you can also pass args, e.g.: `just w show`
Nix workflows
Inside the nix develop shell (activated by direnv) you can use any of the cargo
or rustc
commands, as well as just
workflows. Nix specific commands can also be used to work with the project:
# Full nix build of CLI
nix build .#default
# Build and run the CLI
nix run
Contributing
Tip
Run
just fmt
to autoformat the source tree.
- Run
just ci
to run CI locally. - Add documentation wherever useful.
- Run
just doc run
to preview website docs; edit, and runjust doc check
- To preview Rust API docs, run
just doc cargo
.
- Run
- Changes to library crates must accompany a corresponding
CHANGELOG.md
entry.1
-
We don't use any automatic changelog generator for this repo. ↩︎