2 stable releases

1.1.0 May 1, 2022
1.0.0 Apr 18, 2022

#2271 in Command line utilities

38 downloads per month
Used in 2 crates

MIT license

18KB
291 lines

ANGEL MARKUP LANGUAGE

Simple data storage with no drama.

GitHub CI

ABOUT

Since I am currently working on the static-site generator oriented towards blogs called Acid, I need a data-storage format which allows comments and doesn't like drama. ANGEL MARKUP LANGUAGE is that format.

INSTALLATION

You should have the following tools installed and available from the command line:

  • Rust
  • Git

To install Angel Markup, there are two options:

  • Install the latest cutting-edge version from GitHub:
$ cargo install --git https://github.com/iamtheblackunicorn/angelmarkup
  • Install the latest stable version from Rust's package registry:
$ cargo install angelmarkup

This should make the amlc binary available from the command line.

USAGE

COMMAND LINE

Once you have correctly installed ANGELMARKUP, you should have the amlc binary available from the command line. You can use the compiler in the following ways:

  • Compile an ANGELMARKUP file to YAML:
$ amlc --inf sample.aml --ouf sample.yml --yml
# OR
$ amlc -i sample.aml -o sample.yml -y
  • Compile an ANGELMARKUP file to TOML:
$ amlc --inf sample.aml --ouf sample.toml --tml
# OR
$ amlc -i sample.aml -o sample.toml -t
  • Compile an ANGELMARKUP file to JSON:
$ amlc --inf sample.aml --ouf sample.json --jsn
# OR
$ amlc -i sample.aml -o sample.json -j
  • Get some version info about the compiler:
$ amlc --version
# OR
$ amlc -v
  • Get some help info about the compiler:
$ amlc --help
# OR
$ amlc -h

IN RUST PROJECTS

To use ANGELMARKUP in your projects, add this to your Cargo.toml:

[dependencies]
angelmarkup = "1.1.0"

To import ANGELMARKUP's functions, put this line of code inside your Rust code:

use angelmarkup::*;

To refer to ANGELMARKUP's functions and structs, please click here.

CHANGELOG

Version 1.0.0

  • Initial release.
  • Upload to GitHub.

Version 1.1.0

  • Implemented a small linter.
  • Implemented compilation from AML to JSON.
  • Implemented compilation from AML to TOML.
  • Implemented compilation from AML to YAML.
  • Improved the CLI with the help of cleasy.
  • Implemented a Result for the serialize method.
  • Implemented an error enum for Angelmarkup Language code.

NOTE

  • ANGEL MARKUP LANGUAGE by Alexander Abraham a.k.a. "The Black Unicorn"
  • Licensed under the MIT license.

Dependencies

~3–14MB
~127K SLoC