Skip to main content

The familar Make / Bash hybrid.

Project description

$ bake — a s☿rangely familiar workflow utlity.            

~ under development ~  

$ cat Bakefile $ bake install install: install/node install/python + Executing install/node: echo 'All ready!' | yarn install v1.17.3 install/full: install/system install | info No lockfile found. install/python: @skip:key=Pipfile.lock | [1/4] Resolving packages... pipenv install | [2/4] Fetching packages... install/node: @skip:key=yarn.lock | [3/4] Linking dependencies... yarn install | [4/4] Building fresh packages... install/system: @confirm | success Saved lockfile. brew install pipenv yarn | Done in 0.05s. + Executing install/python: python/format: | Installing dependencies from … black . + Executing install: | All ready! utils/argv: + Done. set -u && echo "$HELLO: $@" Rinse and repeat… utils/deploy: @confirm:secure exit 0

~ see bake's own Bakefile ~            

What's in the oven?

  • A Bakefile, which looks and feels like the good parts of a Makefile.
  • Except, you can write real bash code!      Any and all syntax is accepted — no magic going on here. ;)
  • Unlike Makefile, you may utilize either \t or      [ 4 × U+0020 a.k.a. “space”], at your full adult discretion.
  • Environment variables are explicitly passed or whitelisted (--allow), not inherited from the parent shell.
  • Tasks can be run safely and reliably. Rest assured that scripts are executed from the project root directory.
  • There are many other benefits to this design, that have yet to be expressed in this document.

Automate Workflows — Bootstrap Development Environments — Commit The Tasks

I love using Makefile for one-off tasks in projects.

The problem with doing this is that you can't use familiar bash–isms when doing so, as GNU Make doesn't use the familiar Bash syntax, nor does it allow for simple ad–hoc use of arbitrary scripting languages (e.g. Python).

project seeks to bridge all of these worlds into a single entrypoint — ideal for cross–language repositories


Bootstraping bake —                                          (for local development workflows)

Various *nix Distributions (Python 3.6+):

The primary installation method of bake, today, is via pip:

$ pip3 install bake-cli
Collecting bake-cli

Successfully installed bake-cli-0.2.0 delegator.py-0.1.1 pexpect-4.7.0 ptyprocess-0.6.0

This will always work, but it will not be the default recommendation.

MacOS (Previously known as OS X)

Installation of bake will (soon) be very easy, with Homebrew. The formula needs a subtle adjustment — if you want to help, here's the repo!

$ brew install kennethreitz/-/bake
==> Installing bake from kennethreitz/-

🍺  /usr/local/Cellar/bake/19-09-16: 1,563 files, 16.7MB, built in 11 seconds

Homebrew will be the primary installation target of bake.

✨🍰✨

Bootstraping bake —                                             (for production workflows)

Containers! e.g. Docker.

You an also run bake via Docker! An official image has been made available on DockerHub:

$ docker run kennethreitz/bake                                                                                                                                                                       Wed Sep 18 10:11:01 2019
No Bakefile found!
Usage:  [OPTIONS] [TASK] [ARGUMENTS]...

 $ bake  the strangely familiar task–runner.

Options:
  -b, --bakefile PATH      The Bakefile to use.
  -l, --list               Lists available tasks (and their dependencies).
  -h, --help               Show this message and exit.
  --shellcheck             Run shellcheck on Bakefile.
  --allow TEXT             Whitelist an environment variable for use.
  --no-deps                Do not run dependent tasks.
  --yes                    Set medium–security prompts to yes.
  --continue               Continue, if a task fails.
  -i, --interactive        Run in interactive mode.
  --insecure               Inherit parent shell's environment variables.
  -s, --silent             Reduce output.
  -e, --environ-json TEXT  Provide environment variables via JSON.
  -j, --json               Output in JSON format (stdout).
  • Bakefile is expected to live at /app/Bakefile.
  • If you inherit from this image, ONBUILD directives will automatically copy your application code (build context) into the container, into /app.

Bonus Points: this image is also available on the GitHub Package Registry (beta).


Team & Workflow Management

$ bake install
 + Executing install/node:
 |  yarn install v1.17.3
 |  info No lockfile found.
 |  [1/4] Resolving packages...
 |  [2/4] Fetching packages...
 |  [3/4] Linking dependencies...
 |  [4/4] Building fresh packages...
 |  success Saved lockfile.
 |  Done in 0.05s.
 + Executing install/python:
 |  Installing dependencies from Pipfile.lock (f10bb0)…
 + Executing install:
 + Done.

Skip Steps, Automatically

Because we configured yarn.lock and Pipfile.lock as cache keys, bake will automatically skip the configured steps— only running them when the files are changed!

So, let's run that command again :)

$ bake install
 + Skipping install/node:
 + Skipping install/python.
 + Executing install:
 + Done.

Neat, eh?

Arguments & Parameters: Passing Values In

$ bake utils/argv KEY=VALUES 1 2 3
 + Executing utils/argv:
 |  VALUES: 1 2 3
 + Done.

(Optional) Non-Deterministic Confirmation Dialouges

$ bake utils/deploy
   What is 10 times 2?: 7
Aborted.

Community / Contrib


 

This open source software has been designed, for you, with much joy, by the hands of:

 

 

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bake-cli-0.8.3.tar.gz (19.1 kB view details)

Uploaded Source

Built Distribution

bake_cli-0.8.3-py2.py3-none-any.whl (16.2 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file bake-cli-0.8.3.tar.gz.

File metadata

  • Download URL: bake-cli-0.8.3.tar.gz
  • Upload date:
  • Size: 19.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.14.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.35.0 CPython/3.7.4

File hashes

Hashes for bake-cli-0.8.3.tar.gz
Algorithm Hash digest
SHA256 bdc5f3760abe54b44776566b4889880a06b283c790628b87efc81d6f08336d27
MD5 3124c7ba890c26e920512c1a772a20a8
BLAKE2b-256 7abff8d5cde5e5f5bd261f7fc32475f8f993bbf205fd312c4f31e188795176e8

See more details on using hashes here.

Provenance

File details

Details for the file bake_cli-0.8.3-py2.py3-none-any.whl.

File metadata

  • Download URL: bake_cli-0.8.3-py2.py3-none-any.whl
  • Upload date:
  • Size: 16.2 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.14.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.35.0 CPython/3.7.4

File hashes

Hashes for bake_cli-0.8.3-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 711324fbe13f6b316b01a05aae47c63c70924a88e397c9599faa402379e90a43
MD5 c5fc0e439a7366528e693bfa2402e919
BLAKE2b-256 441368b56f0814a008524d23861d8d1ae9098b8176984a8d2f011fca62f72a1c

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page