#fun #command #execute-command #yaml-config #cli #command-line-tool #hierarchical

bin+lib humor

A tool to execute commands based on YAML configuration files

4 releases

0.0.3 Aug 12, 2024
0.0.2 Aug 12, 2024
0.0.1 Aug 12, 2024
0.0.0 Aug 11, 2022

#1016 in Command line utilities

Download history 6/week @ 2024-07-25 2/week @ 2024-08-01 293/week @ 2024-08-08 63/week @ 2024-08-15

359 downloads per month

MIT/Apache

15KB
320 lines

Humor

Humor is a practical command line tool that supports hierarchical reading of YAML configuration files to execute script instructions.

Humor's idea is to provide developers with a simple tool to manage commonly used commands.

Roadmap

  • Hierarchical configuration
  • Execute commands

Example

Humor can read the default configuration file from ~/.humors, or start reading commands from humor.yaml in the current directory. Humor supports hierarchical reading to meet the call requirements of instructions for different domains, and supports short queries to find the instructions you need.

As in the following example, if you want to execute python -m unittest testall.py, the following commands are equivalent:

humor testall
humor python testall
humor python test testall

Because both Rust and Python have a Humor command called build, the following calls are correct:

humor python build
humor python dev build

humor rust build
humor rust prelude build

Example humor.yaml:

import:
  - /somepath/test.yaml
  - /somepath/dev.yaml

commands:
  rust:
    prelude:
      check: cargo fmt && cargo check
      build: cargo build

Example test.yaml

commands:
  python:
    test:
      testall: python -m unittest testall.py
      testmodule: python -m unittest testmodule.py

Example dev.yaml

commands:
  python:
    dev:
      build: python -m build --wheel
      install: pip install ./dist/somepackage-py3-0.0.1.wheel

Dependencies

~3–14MB
~121K SLoC