معرفی شرکت ها
bygg-0.0.dev2
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
A small build system
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | bygg-0.0.dev2 |
| نام | bygg |
| نسخه کتابخانه | 0.0.dev2 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | - |
| ایمیل نویسنده | Rikard Gillemyr <rikard.gillemyr@gmail.com> |
| آدرس صفحه اصلی | - |
| آدرس اینترنتی | https://pypi.org/project/bygg/ |
| مجوز | MIT License Copyright (c) 2023 rikardg Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
<div align="center">
# Bygg
_a Python build system that gets out of your way_
[](https://pypi.org/project/bygg/)
[](https://github.com/rikardg/bygg/releases)
[](https://github.com/rikardg/bygg/actions?query=branch%3Amaster+)
[](LICENSE)
[Installation](#installation) • [Usage](#usage) • [Development](#development)
</div>
---
_Bygg is in early stage of development. It is usable and useful for its
currently implemented use cases. Feel free to try it out, but also expect
things to change and evolve. Feedback and bug reports are welcome!_
## Introduction
Bygg is a build system implemented in and configured using Python. It is
general-purpose, but is aimed at those that use Python to glue together other
systems.
Bygg tries to get out of your way and be as thin as possible, while still
providing correctness and minimal rebuilds.
### Basics
- Specify actions in pure Python.
- Actions can depend on other actions.
- An action will be executed if the digests of its source or output files have
changed.
## Installation
_Bygg currently requires Python 3.11. Support for earlier versions should be
straightforward but hasn't been prioritised; feel free to open an issue if you
need it._
Install globally with
`pip install bygg`
or
`pipx install bygg`
or in a virtual environment.
## Usage
Specify the actions in `Byggfile.py` in your source directory. Either wrap the
action function using the `@action` decorator, or use the `Action` constructor
directly.
```python
# Decorator:
@action(
"build1",
inputs=["foo.in", "bar.in"],
outputs=["foo.out", "bar.out"]
is_entrypoint: True
)
def a_build_command(ctx: Context):
# do stuff
...
# Separate function + Action constructor:
def also_a_build_command(ctx: Context):
# do stuff
...
Action(
"build2",
inputs=["foo.in", "bar.in"],
outputs=["foo.out", "bar.out"],
dependencies=["another action"],
command=also_a_build_command
is_entrypoint=True
)
```
Bygg will check for the presence of `Byggfile.py` in the current directory. The
actions above can be built with `bygg build1` and `bygg build2`, respectively.
### Settings file
There is also experimental support for declaring actions in a settings file
(currently YAML). This is intended primarily for configuring static settings
like which virtual environment to use, but can also be used for declaring
simple actions. See `examples/taskrunner/Byggfile.yml`.
## Getting a local copy
If you want to try out the examples or even develop Bygg itself, Bygg can be
tried out and worked on without installing it globally:
First, clone this repo and cd into it, then execute the commands below.
`bootstrap.sh` creates a virtual environment and installs Bygg into it together
with its dependencies.
```shell
./bootstrap.sh
. .venv/bin/activate
```
Now you can try out one of the examples:
```shell
cd examples/trivial
bygg transform
```
In the above, `bygg` is the command to execute `bygg`, and `transform` is an
action (much like a target in a `Makefile`). See `examples/trivial/Byggfile.py`
for details.
The target can be cleaned with
```shell
bygg transform --clean` .
```
## Development
### Running tests
With Bygg's virtual environment activated per above, tests can be run from the root directory:
```shell
pytest
```
With the virtual environment _deactivated_, the full test suite (so far
synonymous to just running `pytest` though) can be run with `nox`. Nox should
be installed globally since it manages its own virtual environments:
```shell
pipx install nox
```
After that, run tests with
```shell
nox
```
نیازمندی
| مقدار | نام |
|---|---|
| - | dill==0.3.6 |
| - | markdown-it-py==2.2.0 |
| - | mdurl==0.1.2 |
| - | msgspec==0.14.2 |
| - | multiprocess==0.70.14 |
| - | pygments==2.15.1 |
| - | pyyaml==6.0 |
| - | rich==13.3.5 |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.11 | Python |
نحوه نصب
نصب پکیج whl bygg-0.0.dev2:
pip install bygg-0.0.dev2.whl
نصب پکیج tar.gz bygg-0.0.dev2:
pip install bygg-0.0.dev2.tar.gz