opml/README.md

32 lines
1.5 KiB
Markdown
Raw Normal View History

2022-09-30 21:34:20 +00:00
# OPML 📄
2022-09-30 21:34:20 +00:00
> **OPML library for Rust & standalone CLI.**
## API
2022-09-30 21:34:20 +00:00
For API documentation and examples see [docs.rs](https://docs.rs/opml).
## CLI
2022-09-30 21:34:20 +00:00
### Cargo
2022-09-30 21:34:20 +00:00
With a working [Rust and Cargo](https://www.rust-lang.org/learn/get-started) installation, you can install the OPML CLI from [Crates.io](https://crates.io/crates/opml_cli).
2022-09-30 21:34:20 +00:00
```
cargo install opml_cli
```
### Binaries
2022-09-30 21:34:20 +00:00
Precompiled `x86_64-unknown-linux-gnu` binaries are available on the [Releases page](https://git.bauke.xyz/Holllo/opml/releases).
2024-01-21 12:58:36 +00:00
## Development
With [Nix flakes](https://nixos.wiki/wiki/Flakes) and [direnv](https://direnv.net/) installed and enabled, all the required dependencies are automatically loaded from [`shell.nix`](./shell.nix). Then [cargo-make](https://sagiegurari.github.io/cargo-make/) can be used to build, deploy and lint the code. The available tasks are all described in the [`Makefile.toml`](Makefile.toml) configuration.
2022-09-30 21:34:20 +00:00
## License
2022-09-30 21:34:20 +00:00
Distributed under the [Apache License 2.0](https://spdx.org/licenses/Apache-2.0.html) and [MIT](https://spdx.org/licenses/MIT.html) licenses, see [LICENSE-Apache](https://git.bauke.xyz/Holllo/opml/src/branch/main/LICENSE-Apache) and [LICENSE-MIT](https://git.bauke.xyz/Holllo/opml/src/branch/main/LICENSE-MIT) for more information.
2022-09-30 21:34:20 +00:00
The samples located in `opml_api/tests/spec_samples`) were [taken from the OPML 2.0 spec](http://dev.opml.org/spec2.html#examples) and are subject to [their own license](https://git.bauke.xyz/Holllo/opml/src/branch/main/opml_api/tests/spec_samples/LICENSE).