mxflow

[[ formely npm/hgit ✏️]]

a CICD for internal processes and workflows on local machines

group commands under a workflow, write steps, use special commands like confirm

Special commands

• confirm {command} adds confirmation step to command
• autocomplete checkout {pattern} prompt checkout the pattern branch
• list logs list last n pretty graph log

Config order

• ./.mxflow/config.yml
• ~/.config/mxflow/config.yml

config_version: 0.47.0
graph_git_log_limit: 40
issue_tracker: jira
issue_tracker_tenant: metaory
sleep_between_commands: 1000
workflows:
  foobar:
    description: example placeholder
    pattern: '{branchType}/{taskId}-{description}'
    steps:
      - git fetch origin
      - git checkout master
      - git merge origin/master
      - autocomplete checkout xorg
      - git checkout -b {branchName}
      - git status
      - confirm git push --set-upstream origin {branchName}
      - list logs
  xorg:
    description: example placeholder
    steps:
      - echo hello word
      - echo goodbye cruel world
      - confirm echo goodbye

sample usecase: git-workflow

🚀 beautiful unopinionated config based workflow engine

Streamline complex workflows across team

Simplify complex commands

Requirements

• Node 16.x

Installation

npm i -g mxflow

or

npx mxflow

Usage

mxflow # or mxf
mxflow --trigger foobar
mxflow --trigger feature --branch feat/xorg
mxflow --trigger hotfix --branch hotfix/zelda --verbose

Options

--verbose                 | verbose logs
--trigger <workflow-name> | non-interactive workflow trigger

Roadmap

• project based config file
• plugin system for dynamic lists
• aurgument mode
• argument autocomplete

        ___           ___           ___
       /__/\         /__/|         /  /\
      |  |::\       |  |:|        /  /:/_
      |  |:|:\      |  |:|       /  /:/ /\
    __|__|:|\:\   __|__|:|      /  /:/ /:/
   /__/::::| \:\ /__/::::\____ /__/:/ /:/
   \  \:\~~\__\/    ~\~~\::::/ \  \:\/:/
    \  \:\           |~~|:|~~   \  \::/
     \  \:\          |  |:|      \  \:\
      \  \:\         |  |:|       \  \:\
       \__\/         |__|/         \__\/