Metadata-Version: 2.1
Name: yamk
Version: 5.3.0
Summary: Yet another make
Home-page: https://yamk.readthedocs.io/en/stable/
License: LGPL-3.0+
Keywords: make,build,cli
Author: Stephanos Kuma
Author-email: stephanos@kuma.ai
Requires-Python: >=3.8,<4.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development :: Build Tools
Requires-Dist: dj_settings (>=4.2,<5.0)
Requires-Dist: packaging (>=23.0,<24.0)
Project-URL: Documentation, https://yamk.readthedocs.io/en/stable/
Project-URL: Repository, https://github.com/spapanik/yamk
Description-Content-Type: text/x-rst

=====================
yam: yet another make
=====================

.. image:: https://github.com/spapanik/yamk/actions/workflows/tests.yml/badge.svg
  :alt: Tests
  :target: https://github.com/spapanik/yamk/actions/workflows/tests.yml
.. image:: https://img.shields.io/github/license/spapanik/yamk
  :alt: License
  :target: https://github.com/spapanik/yamk/blob/main/LICENSE.txt
.. image:: https://img.shields.io/pypi/v/yamk
  :alt: PyPI
  :target: https://pypi.org/project/yamk
.. image:: https://pepy.tech/badge/yamk
  :alt: Downloads
  :target: https://pepy.tech/project/yamk
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
  :alt: code style: black
  :target: https://github.com/psf/black
.. image:: https://img.shields.io/badge/build%20automation-yamk-success
  :alt: build automation: yam
  :target: https://github.com/spapanik/yamk
.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v1.json
  :alt: Lint: ruff
  :target: https://github.com/charliermarsh/ruff

``yam`` offers an alternative tool to control the housekeeping tasks of
a project, as well as the creation of executables and non-source files
from source files.

In a nutshell
-------------

Installation
^^^^^^^^^^^^

The easiest way is to use `pipx`_ to install ``yam``.

.. code:: console

   $ pipx install yamk

Usage
^^^^^

``yam``'s behaviour is defined in a toml file, called a cookbook. The default name is ``make.toml``,
but you can specify a different file if you want. Specifying a name ``<name.toml>`` will also parse all the ``.toml``
files in the directory named ``<name.toml>.d``.

``yam`` can be invoked by using the command ``yam``, which is also aliased to ``yamk``. ``yam`` follows
the GNU recommendations for command line interfaces.

Links
-----

- `Documentation`_
- `Changelog`_


.. _Changelog: https://github.com/spapanik/yamk/blob/main/docs/CHANGELOG.rst
.. _Documentation: https://yamk.readthedocs.io/en/stable/
.. _pipx: https://pypa.github.io/pipx/

