makeapp 2.0.0__tar.gz → 2.1.0__tar.gz

{makeapp-2.0.0 → makeapp-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: makeapp
-Version: 2.0.0
+Version: 2.1.0
 Summary: Simplifies routine Python application development processes.
 Project-URL: Homepage, https://github.com/idlesign/makeapp
 Project-URL: Documentation, https://makeapp.readthedocs.io/
@@ -35,6 +35,7 @@ https://github.com/idlesign/makeapp
 * Easily add entries to your changelog.
 * Publish your application to remotes (VCS, PyPI) with a single command.
 * Easily bootstrap your development environment.
+* Build and local serve the docs.
 * Run code styling/linting.
 
 ## Application scaffolding
@@ -110,6 +111,15 @@ Apply code style with `style` command:
 ma style
 ```
 
+
+## Build/serve docs
+
+Use `docs` command:
+
+``` bash
+ma docs
+```
+
 ## Documentation
 
 https://makeapp.readthedocs.io/

{makeapp-2.0.0 → makeapp-2.1.0}/README.md

@@ -19,6 +19,7 @@ https://github.com/idlesign/makeapp
 * Easily add entries to your changelog.
 * Publish your application to remotes (VCS, PyPI) with a single command.
 * Easily bootstrap your development environment.
+* Build and local serve the docs.
 * Run code styling/linting.
 
 ## Application scaffolding
@@ -94,6 +95,15 @@ Apply code style with `style` command:
 ma style
 ```
 
+
+## Build/serve docs
+
+Use `docs` command:
+
+``` bash
+ma docs
+```
+
 ## Documentation
 
 https://makeapp.readthedocs.io/

makeapp-2.1.0/src/makeapp/__init__.py

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

{makeapp-2.0.0 → makeapp-2.1.0}/src/makeapp/apptools.py

@@ -8,7 +8,7 @@ from .helpers.dist import DistHelper
 from .helpers.files import FileHelper
 from .helpers.vcs import VcsHelper
 from .helpers.venvs import VenvHelper
-from .utils import chdir, configure_logging, Uv, Ruff
+from .utils import chdir, configure_logging, Uv, Ruff, MkDocs
 
 LOG = logging.getLogger(__name__)
 
@@ -510,6 +510,10 @@ class Project:
         LOG.info('Styling ...')
         Ruff.check()
 
+    def docs(self, *, serve: bool = True):
+        LOG.info('Making docs ...')
+        MkDocs.serve() if serve else MkDocs.build()
+
     def venv_init(self, *, reset: bool = False, register_tool: bool = False):
         self.venv.initialize(reset=reset)
 

{makeapp-2.0.0 → makeapp-2.1.0}/src/makeapp/cli.py

@@ -234,6 +234,19 @@ def style(debug):
     click.secho('Done', fg='green')
 
 
+@entry_point.command()
+@option_debug
+@click.option(
+    '-b', '--build',
+    help='Build only. Do not serve', is_flag=True
+)
+def docs(debug, build):
+    """Build/serve documentation."""
+    project = Project(log_level=logging.DEBUG if debug else logging.INFO)
+    project.docs(serve=not build)
+    click.secho('Done', fg='green')
+
+
 def main():
     try:
         entry_point(obj={})

{makeapp-2.0.0 → makeapp-2.1.0}/src/makeapp/utils.py

@@ -163,6 +163,22 @@ class Ruff:
         return cls._run(f'check{" --fix" if fix else ""}')
 
 
+class MkDocs:
+    """MkDocs wrapper."""
+
+    @classmethod
+    def _run(cls, cmd: str) -> list[str]:
+        return run_command(f'mkdocs {cmd}', capture=False)
+
+    @classmethod
+    def serve(cls) -> list[str]:
+        return cls._run('serve -o')
+
+    @classmethod
+    def build(cls) -> list[str]:
+        return cls._run('build')
+
+
 class Uv:
     """Uv wrapper."""
 

makeapp-2.0.0/src/makeapp/__init__.py

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