makeapp 2.3.0__tar.gz → 2.5.0__tar.gz

{makeapp-2.3.0 → makeapp-2.5.0}/.gitignore

@@ -10,4 +10,6 @@ __pycache__
 .mypy_cache
 .ruff_cache
 .pytest_cache
+.ma-*
 .env
+*.lock

makeapp-2.5.0/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.5
+Name: makeapp
+Version: 2.5.0
+Summary: Simplifies routine Python application development processes.
+Project-URL: Homepage, https://github.com/idlesign/makeapp
+Project-URL: Documentation, https://makeapp.readthedocs.io/
+Author-email: Igor Starikov <idlesign@yandex.ru>
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Keywords: development,scaffolding
+Requires-Python: >=3.11
+Requires-Dist: click
+Requires-Dist: jinja2~=3.1
+Requires-Dist: pyyaml
+Requires-Dist: requests
+Description-Content-Type: text/markdown
+
+# makeapp
+
+[![PyPI - Version](https://img.shields.io/pypi/v/makeapp)](https://pypi.org/project/makeapp/)
+[![License](https://img.shields.io/pypi/l/makeapp)](https://pypi.org/project/makeapp/)
+[![Coverage](https://img.shields.io/coverallsCoverage/github/idlesign/makeapp)](https://coveralls.io/github/idlesign/makeapp)
+[![Docs](https://img.shields.io/readthedocs/makeapp)](https://makeapp.readthedocs.io/)
+
+`makeapp` scaffolds Python projects and provides one CLI for their common development tasks. It can create a project
+from composable templates, initialize Git and a virtual environment, run a GitHub Actions test matrix locally, maintain
+a changelog, and publish releases.
+
+## Install
+
+Python 3.11 or newer and [uv](https://docs.astral.sh/uv/getting-started/installation/) are required.
+
+```bash
+uv tool install makeapp
+```
+
+Both `makeapp` and its short alias `ma` invoke the same command.
+
+## Quick start
+
+```bash
+ma new shiny_app ./shiny-app --description "My app" --author "I am" --no-prompt
+cd shiny-app
+ma tests
+```
+
+The default scaffold contains a `src`-layout package, tests, project metadata, a changelog, and MkDocs documentation.
+The non-interactive command also initializes Git and runs `uv sync` to create `.venv`.
+
+Bundled templates can extend the default scaffold:
+
+- `console` for an `argparse` command-line application;
+- `click` for a Click command-line application;
+- `django` for a reusable Django application;
+- `pytestplugin` for a pytest plugin;
+- `webscaff` for a Linux-hosted Django/Webscaff project.
+
+For example:
+
+```bash
+ma new shiny_cli ./shiny-cli -t click --no-prompt
+```
+
+## Documentation
+
+The full user and extension documentation is available at <https://makeapp.readthedocs.io/>.
+
+- [Quickstart](https://makeapp.readthedocs.io/en/latest/quickstart/)
+- [CLI reference](https://makeapp.readthedocs.io/en/latest/cli_reference/)
+- [Template authoring](https://makeapp.readthedocs.io/en/latest/template_authoring/)
+- [Publishing](https://makeapp.readthedocs.io/en/latest/publishing/)
+Issues and feature requests are welcome in the [GitHub issue tracker](https://github.com/idlesign/makeapp/issues).

makeapp-2.5.0/README.md

@@ -0,0 +1,55 @@
+# makeapp
+
+[![PyPI - Version](https://img.shields.io/pypi/v/makeapp)](https://pypi.org/project/makeapp/)
+[![License](https://img.shields.io/pypi/l/makeapp)](https://pypi.org/project/makeapp/)
+[![Coverage](https://img.shields.io/coverallsCoverage/github/idlesign/makeapp)](https://coveralls.io/github/idlesign/makeapp)
+[![Docs](https://img.shields.io/readthedocs/makeapp)](https://makeapp.readthedocs.io/)
+
+`makeapp` scaffolds Python projects and provides one CLI for their common development tasks. It can create a project
+from composable templates, initialize Git and a virtual environment, run a GitHub Actions test matrix locally, maintain
+a changelog, and publish releases.
+
+## Install
+
+Python 3.11 or newer and [uv](https://docs.astral.sh/uv/getting-started/installation/) are required.
+
+```bash
+uv tool install makeapp
+```
+
+Both `makeapp` and its short alias `ma` invoke the same command.
+
+## Quick start
+
+```bash
+ma new shiny_app ./shiny-app --description "My app" --author "I am" --no-prompt
+cd shiny-app
+ma tests
+```
+
+The default scaffold contains a `src`-layout package, tests, project metadata, a changelog, and MkDocs documentation.
+The non-interactive command also initializes Git and runs `uv sync` to create `.venv`.
+
+Bundled templates can extend the default scaffold:
+
+- `console` for an `argparse` command-line application;
+- `click` for a Click command-line application;
+- `django` for a reusable Django application;
+- `pytestplugin` for a pytest plugin;
+- `webscaff` for a Linux-hosted Django/Webscaff project.
+
+For example:
+
+```bash
+ma new shiny_cli ./shiny-cli -t click --no-prompt
+```
+
+## Documentation
+
+The full user and extension documentation is available at <https://makeapp.readthedocs.io/>.
+
+- [Quickstart](https://makeapp.readthedocs.io/en/latest/quickstart/)
+- [CLI reference](https://makeapp.readthedocs.io/en/latest/cli_reference/)
+- [Template authoring](https://makeapp.readthedocs.io/en/latest/template_authoring/)
+- [Publishing](https://makeapp.readthedocs.io/en/latest/publishing/)
+Issues and feature requests are welcome in the [GitHub issue tracker](https://github.com/idlesign/makeapp/issues).

makeapp-2.5.0/src/makeapp/__init__.py

@@ -0,0 +1,3 @@
+
+VERSION = '2.5.0'
+"""Application version number tuple."""

{makeapp-2.3.0 → makeapp-2.5.0}/src/makeapp/app_templates/__default__/.github/workflows/python-package.yml

@@ -2,9 +2,7 @@ name: Python package
 
 on:
   push:
-    branches: [ master ]
   pull_request:
-    branches: [ master ]
 
 jobs:
   build:
@@ -27,15 +25,15 @@ jobs:
     - name: Install deps
       run: |
         uv sync --only-group tests
-        uv pip install coveralls
+        uv pip install -e . coveralls
     - uses: astral-sh/ruff-action@v3
       with:
-        version: 0.13.1
+        version: 0.17.5
         args: check
     - name: Run tests
       env:
         GITHUB_TOKEN: ${{ secrets.github_token }}
 {% endraw %}
       run: |
-        uv run coverage run -m pytest
-        uv run coveralls --service=github
+        uv run --no-sync coverage run -m pytest
+        uv run --no-sync coveralls --service=github

{makeapp-2.3.0 → makeapp-2.5.0}/src/makeapp/app_templates/__default__/.gitignore

@@ -11,5 +11,6 @@ __pycache__
 .mypy_cache
 .ruff_cache
 .pytest_cache
+.ma-*
 .env
-{% endblock %}
+{% endblock %}

makeapp-2.5.0/src/makeapp/app_templates/__default__/AGENTS.md

@@ -0,0 +1,3 @@
+# Agent rules
+
+See IDLE.md for further instructions.

makeapp-2.5.0/src/makeapp/app_templates/__default__/CONTRIBUTING.md

@@ -0,0 +1,45 @@
+# contributing {{ app_name }}
+
+
+## Submit issues
+
+If you spotted something weird in application behavior or want to propose a feature you are welcome.
+
+
+## Write code
+
+If you are eager to participate in application development and to work on an existing issue (whether it should
+be a bugfix or a feature implementation), fork, write code, and make a pull request right from the forked project page.
+
+When contributing code, follow the rules from IDLE.md shipped with the project.
+
+
+## Project workflow
+
+The development tasks are provided by [makeapp](https://pypi.org/project/makeapp/). Install or update it first:
+
+```bash
+uv tool install makeapp   # or: uv tool upgrade makeapp
+```
+
+Then, from the project directory:
+
+```bash
+ma up              # Synchronize the development environment.
+ma style           # Run Ruff checks and apply safe fixes.
+ma tests           # Run the configured test matrix.
+ma docs --build    # Build documentation without starting a server.
+ma change "+ Add a feature"  # Update the changelog and commit modified files.
+ma release         # Prepare a release and optionally publish it.
+```
+
+Review changes before running `ma change`: it stages and commits modified tracked files together with the changelog.
+
+
+## Spread the word
+
+If you have some tips and tricks or any other words that you think might be of interest for the others --- publish it
+wherever you find convenient.
+
+
+See also: {{ url }}