aliasfile 0.1.1

No project description provided

Define your per-directory command aliases in Yaml, to get quick shortcuts (and avoid having to remember long commands).

WARNING: This project is still experimental, and things may change suddenly. Suggestions are welcome.

Configuration

Configuration is held in a file, usually named ./.aliases, as a dictionary serialized in YAML format.

The main section is commands, a dict mapping alias names to their specification.

Command specification

• command: command to be run, as a string
  • will be tokenized via shlex.split
  • string-format-style placeholders will be replaced:
    • positional arguments ({}, {1}) -> variadic arguments to the command
    • ..or explicit: {args[1]}
    • environment: {env[USER]}
    • vars (see below): {vars[USER]}
    • extra arguments will be appended to the command
• env: environment for the command
  • not considered in string formatting
  • will go through the same formatting as commands
• vars: to be replaced in env/command formatting

Notes

• we want some way to prevent automatic appending of varargs
• we might want to use jinja for formatting, so we can have conditionals / defaults
• we might want inheritance, rather than having “nested” aliasing

Examples

commands:
  test:
    command: xvfb-run py.test --reuse-db -vvv ./tests/
    env:
      DJANGO_SETTINGS_MODULE: fooproject.settings.testing
      PYTHONPATH: "{env[HOME]}/Projects/fooproject"

commands:
  manage:
    command: python manage.py
    env:
      DJANGO_SETTINGS_MODULE: fooproject.settings.testing
      PYTHONPATH: "{env[HOME]}/Projects/fooproject"
      LOG_LEVEL: DEBUG

  runserver:
    command: aliasfile manage runserver

  migrate:
    command: aliasfile manage migrate

  shell:
    command: aliasfile manage shell