Pyke
(WIP, Beta Release) Make-like build automation tool for Python projects with extensive DSL features.
Features:
- Users can specify tasks, subtasks, and task rules.
- Use regex rules patterns to create targets for tasks.
- Significantly less confusing than Makefiles (is that a tab or space...?)
- Complete Python DSL with full access to builtins and external dependencies.
- [WIP] Run and execute tasks in parallel with each other (threaded multitasking).
Example:
import pyke
# create a defualt task, named "build"
@pyke.task("build", default=True)
def build():
print("Building the project...")
# create a task dependency. running `pyke dist`
# will make the "build" task run first!
@pyke.task("dist", deps=["build"])
def dist():
print("Distributing the project...")
pyke.run()
Put that in a Pykefile and you're good to go. Then run pyke in the same directory and watch the magic happen!
$ pyke dist
Building the project...
Distributing the project...
Installation:
Install the pykefile library with pip. Requires Python 3.8 or higher.
python -m pip install pykefile
You can also add it your developement dependencies with poetry.
python -m poetry add pykefile --dev
Usage:
Just like any other Makefile, you'll need the Pykefile in your current directory. (Pykefile.py also works)
Then use the pyke command to execute and run specified tasks.
Running pyke without any commands will call the default task if there is one. The first argument will call a task by that name.
Developement:
- Fork the repository:
Fork - Clone locally (
git clone https://github.com/)/pyke.git - Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -a -m 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request!
🎉
Local Developement:
In order to properly test the pyke commands, install the package locally like so:
python -m pip install -e .
You can now use pyke in your terminal, and it will automatically use the latest changes to the source code.
Use bash bin/build to build the project. bash bin/docs will update and start the documentation server locally.
Final Notes:
Pyke is still in beta and I'm open to feature requests or bug reports. Feel free to open an issue! Thanks for checking this project out and I hope it'll make your Python developement process easier!
1.7k Jan 4, 2023
3 Nov 24, 2021
1.6k Jan 3, 2023
336 Dec 27, 2022
7 Feb 11, 2022
368 Dec 23, 2022
5k Jan 5, 2023
1.9k Jan 5, 2023
452 Dec 9, 2022
154 Jan 04, 2023
552 Nov 26, 2022
8.9k Dec 30, 2022
1 Dec 05, 2021
6.5k Jan 08, 2023
5 Oct 04, 2021
341 Jan 08, 2023
6 Mar 13, 2022
9 Mar 15, 2022
7 Nov 12, 2022
1.5k Jan 04, 2023
24 Dec 13, 2022