asciii 3.1.4

The advanced but simple commandline interface for invoice invocation. This is an internal tool of the Studentencafe ascii in Dresden and therefore specialized for our use cases.
Documentation

asciii

travis license crates.io version documentation

The advanced but simple commandline interface for invoice invocation.

NoSql, blockchain based, serverless, cross-platform project management tool.

Here I rewrite the original ascii-invoicer in Rust. Why? Because!

Introduction

The ascii-invoicer is a command-line tool that manages projects and stores them not in a database but in a folder structure. New projects can be created from templates and are stored in a working directory. Projects can be archived, each year will have its own archive. A project consists of a folder containing a yaml file describing it and a number of attached files, such tex files. Projects can contain products and personal. You can create preliminary offers and invoices from your projects.

Installation

Archlinux

You can install the package asciii-git from the AUR.

macOS

You can install asciii via homebrew.

$ brew tap ascii-dresden/formulae
$ brew install asciii

Using cargo

Just plain old cargo install --git https://github.com/ascii-dresden/asciii will do.

Requirements

You need at least rustc, cargo, cmake, git and zlib1g-dev to run this.

Development

Hint! After the first build you can removed the content of build.rss fn main() during dev for significantly improved compile times :D

Usage

After installation simply run asciii and it will present you with a list of possible subcommands. asciii help list will give you a comprehensive explanation of what asciii list does.

You can also run asciii doc which will take you to the complete online user and development documentation. Further information may be found in the README of version 2.5

Logging

asciii uses Rusts env_logger. To enable logging you have to set ASCIII_LOG=debug. Besides debug, you can also use trace, warn or error. You can enable logging per-module logging like this: ASCIII_LOG=storage=debug. Modules are all top-level files and folders in src/.

CI/CD

Travis-CI Build Status