Product Promotion
0x5a.live
for different kinds of informations and explorations.
GitHub - gopinath-langote/1build: Frictionless way of managing project-specific commands
Frictionless way of managing project-specific commands - gopinath-langote/1build
Visit SiteGitHub - gopinath-langote/1build: Frictionless way of managing project-specific commands
Frictionless way of managing project-specific commands - gopinath-langote/1build
Powered by 0x5a.live 💗
1build is an automation tool used for research and development projects 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.
Install
Homebrew
brew install gopinath-langote/one-build/one-build
Manual
- Download and install binary from the latest release
- Recommended: add
1build
executable to your$PATH
.
Usage
Configuration
-
Create
1build.yaml
configuration file by1build init --name <your_project_name>
-
Edit file according to project command list, Example of
1build.yaml
for node project:project: Sample Web App commands: - build: npm run build - test: npm run test
Running 1build for the above sample project
- building the project
1build build
- fix the coding guidelines lint and run tests (executing more than one commands at once)
1build lint test
Set new or update existing configuration
- Set new command configuration for
lint
to"eslint server.js"
1build set lint "eslint server.js"
Remove/Unset existing configuration
- Unset command configuration for
lint
1build unset lint
- To unset multiple commands at once
1build unset lint test build
Using before
and after
commands
Consider that your project requires some environment variables to set before running any
commands and you want to clean up those after running commands. It is a headache to always
remember to set those environment variables. What you want is to set env variables automatically
when you run the command in the project and remove those when the command 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.
Examples
-
Setting env variables and cleaning those up
1build set before 'export VARNAME="my value"' 1build set after "unset VARNAME"
Configuration with before and after setup
project: Sample Web App before: export VARNAME="my value" after: unset VARNAME commands: - build: npm run build
-
Ensure that
Docker
is up and running1build set before "./docker_run.sh"
-
Clean up database after some commands
1build set after "./clean_database.sh"
-
Remove
before
andafter
commands1build unset before after
Using --quiet
or -q
flag
Sometimes you choose to not see all logs/output of your command and just see success or failure as the outcome.
So using --quiet
or -q
flag to 1build command execution will result in just executing the command
but not showing the entire output of it, only shows SUCCESS/FAILURE as result of command execution.
1build lint test --quiet
OR
1build lint test -q
See 1build --help
for command usages.
Contributing
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
Versioning
We use Semantic Versioning for all our releases. For the versions available, see the tags on this repository.
Changelog
All notable changes to this project in each release will be documented in Releases Page.
The format is based on Keep a Changelog.
License
This project is licensed under the MIT License - see the LICENSE file for details
Contributors
Sponsors
GoLang Resources
are all listed below.
Made with ❤️
to provide different kinds of informations and resources.