Frictionless way of managing project-specific commands.
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.yamlfor JVM maven project:
project: Sample JVM Project Name commands: - build: mvn clean package - lint: mvn antrun:run@ktlint-format - test: mvn clean test
Running 1build for the above sample project:
building the project
fix the coding guidelinges lint and run tests (executing more than one commands at once)
1build lint test
Consider that your project
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
after commands are useful. These commands are both optional –
you can use one of them, both or neither.
Java 11and then back to
project: Sample JVM Project Name before: ./switch_to_java_11.sh after: ./switch_to_java_8.sh commands: - build: mvn clean package
Dockeris up and running
project: Containerized Project before: ./docker_run.sh commands: - build: ./gradlew clean
Clean up database after some commands
project: Containerized Project after: ./clean_database.sh commands: - build: ./gradlew clean
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 CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
All notable changes to this project in each release will be documented in CHANGELOG.md.
The format is based on Keep a Changelog.
This project is licensed under the MIT License - see the LICENSE file for details
- Gopinath Langote - Initial work & Maintainer – Github –Twitter
- Alexander Lukianchuk - Maintainer – Github – Twitter
See also the list of contributors who participated in this project.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size 1build-1.1.1-py3-none-any.whl (11.1 kB)||File type Wheel||Python version py3||Upload date||Hashes View hashes|
|Filename, size 1build-1.1.1.tar.gz (6.7 kB)||File type Source||Python version None||Upload date||Hashes View hashes|