A CI/CD tool
Project description
Bluish
Bluish automates software development and deployment tasks, similar to GitHub Actions, but for local execution or within Docker. It allows you to define, organize, and execute workflows in your own environment without relying on external services.
Features
- Command-Line Interface: Bluish offers a
make
-like experience via theblu
command for easy task execution (e.g.,blu build
). - Local and Remote Automation: Execute tasks locally, without needing cloud services, or remotely via SSH.
- Docker Integration: Run workflows in Docker containers for a controlled environment.
- Simple Configuration: Define workflows in YAML files, following a familiar structure for defining steps.
- CI/CD Integration: Integrate with GitHub Actions, GitLab CI/CD, and other CI/CD tools for unified local and remote workflows.
Installation
pip install bluish
Usage
Refer to the project wiki for more detailed documentation. Please note that the documentation is still in progress and may be incomplete or not fully reliable.
Define workflows in a YAML file (bluish.yml
). Each workflow contains steps executed in sequence. Example:
name: My Local Workflow
steps:
- name: Clone repository
uses: git/checkout
with:
repository: https://github.com/myuser/myproject.git
- name: Build Docker image
run: docker build -t myproject .
- name: Run tests
run: docker run --rm myproject pytest
- name: Cleanup
run: docker rmi myproject
To run a workflow:
blu <workflow>
The command looks for bluish.yml
in the current or .bluish/
directory.
Examples
- Local CI: Build and test your project without a cloud CI platform.
- Reproducible Environments: Run code in Docker containers for consistency.
- Task Automation: Automate repetitive development tasks.
Comparison with GitHub Actions
Feature | GitHub Actions | Bluish |
---|---|---|
Execution Environment | Cloud | Local / Remote / Docker Containers |
Privacy | Data hosted on GitHub servers | No data exposure, or exposure that is tightly controlled |
Flexibility | Tied to GitHub's CI/CD model | Agnostic, adaptable to different CI/CD systems |
Internet Requirement | Yes | No |
Bluish is ideal for:
- Privacy: No data exposed to third-party platforms.
- Control: Define and modify environments without external limitations.
- Offline Development: Use workflows without internet.
- Unified Workflows: Consistent local and CI/CD workflows.
Comparison with nektos/act
nektos/act runs GitHub Actions locally but is tied to GitHub's syntax. Bluish offers more flexibility and is not restricted by GitHub-specific rules, making it more versatile across different CI/CD systems.
Contributing
Contributions are welcome! Open an issue or send a pull request. See the contribution guidelines for more details.
License
Licensed under the MIT License. See the LICENSE
file for details.
Contact
For questions or suggestions, open an issue in the repository or contact me on GitHub: luismedel.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file bluish-0.8.2.1.tar.gz
.
File metadata
- Download URL: bluish-0.8.2.1.tar.gz
- Upload date:
- Size: 30.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 78b216c07a88a12eebbeb1e0c16d3471dbe38a526c7118057ffefa075941cd90 |
|
MD5 | ed468671188eb45c1a1508aea54dead0 |
|
BLAKE2b-256 | 5c3ee0eb24ff27b4faaaa0aae3f0b59ac83495a8d024ecfeb8af6db720724e0e |
File details
Details for the file bluish-0.8.2.1-py3-none-any.whl
.
File metadata
- Download URL: bluish-0.8.2.1-py3-none-any.whl
- Upload date:
- Size: 30.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | c6eb049559077b8273ff531f0b667e005ec375f997acb527f8cea96a7bd038c8 |
|
MD5 | e036375b832f157283e549a188b35f03 |
|
BLAKE2b-256 | e6b2cc92f20cfefa05df63327499bef60039c42997b6dd73244f581c668887c5 |