Skip to main content

Frictionless way of managing project-specific commands.

Project description


PyPi Version Supported Python Versions Build Status Code Coverage Requirements Status Downloads

1build is an automation tool that arms you with the convenience to configure project-local command line aliases – and then run the commands quickly and easily. It is particularly helpful when you deal with multiple projects and switch between them all the time. It is often the fact that different projects use different build tools and have different environment requirements – and then switching from one project to another is becoming increasingly cumbersome. That is where 1build comes into play.

With 1build you can create simple and easily memorable command aliases for commonly used project commands such as build, test, run or anything else. These aliases will have a project-local scope which means that they will be accessible only within the project directory. This way you can unify all your projects to build with the same simple command disregarding of what build tool they use. It will remove the hassle of remembering all those commands improving the mental focus for the things that actually matter.


pip install 1build


pip3 install 1build



  • create project configuration file in the project folder with name 1build.yaml

  • Example of 1build.yaml for JVM maven project:

    project: Sample JVM Project Name
      - build: mvn clean package
      - lint: mvn antrun:run@ktlint-format
      - test: mvn clean test

Running 1build for the above sample project:

  • building the project

    1build build
  • fix the coding guidelinges lint and run tests (executing more than one commands at once)

    1build lint test

Using before and after commands

Consider that your project X requires Java 11 and the other project requires Java 8. It is a headache to always remember to switch the java version. What you want is to switch to Java 11 automatically when you build the project X and switch it back to Java 8 when the build is complete. Another example – a project requires Docker to be up and running or you need to clean up the database after running a test harness.

This is where before & after commands are useful. These commands are both optional –  you can use one of them, both or neither.


  1. Switching to Java 11 and then back to Java 8

    project: Sample JVM Project Name
    before: ./
    after: ./
      - build: mvn clean package
  2. Ensure that Docker is up and running

    project: Containerized Project
    before: ./
      - build: ./gradlew clean
  3. Clean up database after some commands

    project: Containerized Project
    after: ./
     - build: ./gradlew clean

Command usage

usage: 1build [-h] [-l] [-v] [command]

positional arguments:
 command     Command to run - from `1build.yaml` file

optional arguments:
 -h, --help  Print this help message
 -l, --list  Show all available commands - from `1build.yaml` file
 -v, --version  Show version of 1build and exit
 -i, --init     Create default `1build.yaml` configuration file


Please read for details on our code of conduct, and the process for submitting pull requests to us.


We use Semantic Versioning for all our releases. For the versions available, see the tags on this repository.


All notable changes to this project in each release will be documented in

The format is based on Keep a Changelog.


This project is licensed under the MIT License - see the LICENSE file for details


See also the list of contributors who participated in this project.

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

1build-1.1.1.tar.gz (6.7 kB view hashes)

Uploaded source

Built Distribution

1build-1.1.1-py3-none-any.whl (11.1 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page