lrq3000/py3make

A basic Makefile-like system in pure Python

py3make

Bring basic Makefile support to any system with Python.

Simply install with pip install py3make then execute py3make in a directory containing a Makefile.

py3make works on any platform (Linux, Windows, Mac, FreeBSD, Solaris/SunOS).

py3make does not require any library to run, just a vanilla Python interpreter will do.

The goal is not to reproduce a whole implementation of GNU make, but only a very fast and succinct commands runner. This is often used to ease running tests and deployments locally, before uploading to a continuous integration/continuous deployment system such as GitHub Workflows.

Do not be fooled by the lack of updates: this module is very stable and is very frequently (daily) used in most of my Python projects.

This repository is a "fork" by the original author to regain full editing permissions stolen by a co-author, to update this package with full freedom.

---

Table of contents

• Installation
  • Latest PyPI stable release
  • Latest development release on GitHub
• Changelog
• Usage
• Known Issues
• Documentation
• Contributions
• LICENCE
• Authors

Installation

Latest PyPI stable release

pip install py3make

Latest development release on GitHub

Pull and install in the current directory:

pip install -e git+https://github.com/lrq3000/py3make.git

Changelog

The list of all changes is available either on GitHub's Releases: or on crawlers such as allmychanges.com.

Usage

Simply install then execute py3make -p to list commands and py3make <command> to use a command, in a directory containing a Makefile.

Known Issues

For compatibility, ensure:

1. Every alias is preceded by @[+]make (eg: @make alias)
2. A maximum of one @make alias or command per line

Sample makefile compatible with py3make:

PY=python -m py_compile
.PHONY:
    all
    test
    install
    compile
all:
    @+make test
    @make install
test:
    nosetest
install:
    python setup.py\
    install
compile:
    $(PY) test.py
circle:
    # of life
    circle
empty:
    # this is a comment

If you get a "Permission Denied" error, please check if maybe your antivirus may be preventing the launch of compiled python scripts, if the Scripts subdirectory is in the PATH, or other issues with the Python install.

Documentation

py3make --help

Contributions

All source code is hosted on GitHub. Contributions are welcome.

See the CONTRIBUTE file for more information.

LICENCE

Open Source (OSI approved):

Authors

The main developers, ranked by surviving lines of code (git fame -wMC), are:

• Stephen Karl Larroque (lrq3000, core logic & maintenance Py3)
• Casper da Costa-Luis (casperdcl, modularization & self-referential aliases & ironing out edge cases & documentation)

We are grateful for all !