emcd-projects 1.17.1__py3-none-any.whl → 1.18rc0__py3-none-any.whl

{emcd_projects-1.17.1.dist-info → emcd_projects-1.18rc0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: emcd-projects
-Version: 1.17.1
+Version: 1.18rc0
 Summary: Project management utilities.
 Project-URL: Homepage, https://github.com/emcd/python-project-common
 Project-URL: Documentation, https://emcd.github.io/python-project-common

{emcd_projects-1.17.1.dist-info → emcd_projects-1.18rc0.dist-info}/RECORD

@@ -1,27 +1,27 @@
 emcdproj/data/.gitignore,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 emcdproj/data/copier/answers-default.yaml,sha256=dgdxDTcZZpHjg3-uZyDALzJ0Gc7GBcSSvQ7L_OmebWM,150
-emcdproj/data/copier/answers-maximum.yaml,sha256=aVAiQZgltQYZWf3wYGzw6-Syp2iZr7yjOauqd2lhYfQ,392
+emcdproj/data/copier/answers-maximum.yaml,sha256=zc0BP1zwYOdRPemq0NrY66JPmSujPkRjhD1HEtvhnhY,339
 emcdproj/data/templates/coverage.svg.jinja,sha256=UWJE9I1QVoo31DB4PAcf_sYFs1oOViDbnCmhzuoVuq8,1479
 emcdproj/data/templates/website.html.jinja,sha256=V958XUcGdNmvSl_RalRvPRIZ5uUcpaXgycddOLN6rfA,1513
 emcdproj/README.rst,sha256=ThJlTJWDLurnGuhCXlQDRuSYexDJrAUnHIPiTGaAmww,4495
-emcdproj/__init__.py,sha256=1MycSYTMCTpcnxNOv-F0WLp7lu7s1oJa4vOMS_6PEYM,1584
+emcdproj/__init__.py,sha256=WmRfuBDICaUBkFYm1WL0NUeX2vbL7oGnb7v7a5rIoRo,1585
 emcdproj/__main__.py,sha256=KkTeK75rYgF2yVf2HpTs-L2V1jru3j7ohDSgGXWFXjQ,1409
 emcdproj/cli.py,sha256=WNAF0pmAbdxtmuCcyTBkuG1CQnWixpkDSXNuQ4KwXDE,4414
 emcdproj/exceptions.py,sha256=Y9n5pGh1-hMkKtOYherAjUw19af4-uWDNzUZjiqiU00,2641
 emcdproj/filesystem.py,sha256=YgcX5Q52r2hTYU-7_VoW2inMC4NBTzqSTINB9eNT9Hw,1708
 emcdproj/interfaces.py,sha256=PvNZb4G0EhXbK_yaAOhqcgp0uNR30FCRUf4Qn0e03M8,3185
 emcdproj/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-emcdproj/template.py,sha256=S_SAlrVtEco2c2eO0QNdy-Gffn_hk8zVFFT1GzqXcuc,4823
+emcdproj/template.py,sha256=bMUt_Nm1Ks85zqYi0k2cSxFijdYLyD8deNaWzVPSI6Y,5345
 emcdproj/website.py,sha256=YfIGPp2WzoL0E9nQLJgbfU6yVbipns-I7F6alkSowb0,10657
-emcdproj/__/__init__.py,sha256=oGdDy7STF7jZlrxKzgvdbqw5-tR-RRWqurizIazVvvg,1598
+emcdproj/__/__init__.py,sha256=qIdtKkPRa4WV6o4G8KVcGnLPg2aydIQzJXjrRPefRHY,1516
 emcdproj/__/application.py,sha256=6uF2yTIlAsLWKadus7a7mPvr7q3pagplPrDAA1EUwlw,2316
 emcdproj/__/distribution.py,sha256=9TCSm8oJtIot-MPR8Ypt72gMaUh77WXtkpuxggb6tGQ,3972
-emcdproj/__/imports.py,sha256=P4r8oEkrKGQ0NuA4uTTbM-ZYUJp3QgvjuqJELdlSJH0,2340
+emcdproj/__/imports.py,sha256=0dEBJLIEEtV4aFyWo4mqEarG6yz_Y7vLKcymjmhw-VI,2377
 emcdproj/__/preparation.py,sha256=rNbA8VvrspanbP_0O4GjmwaqgzgPf0SdY7WadcINJZE,3824
 emcdproj/__/state.py,sha256=inChROB1WcJ_b9kZ6VfQZr-dLj56-MxWoMHrvB-yXu4,3596
 emcdproj/_typedecls/__builtins__.pyi,sha256=VhJfnYgggXihUzomBHtA1xEKzG7XqEHkSjhl0Ro6qgg,153
-emcd_projects-1.17.1.dist-info/METADATA,sha256=9dx5mYIRuZSUusB9tI4Uyf9Vi-XDU7eZWmvP0FEj5sA,6087
-emcd_projects-1.17.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-emcd_projects-1.17.1.dist-info/entry_points.txt,sha256=22Pc1xg3OboNBxpTnDM3gLYXo8QuY2E0SOv1djo0fdc,43
-emcd_projects-1.17.1.dist-info/licenses/LICENSE.txt,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
-emcd_projects-1.17.1.dist-info/RECORD,,
+emcd_projects-1.18rc0.dist-info/METADATA,sha256=20ir2UUhbTKQ2Njl1v5oqt7KMdOttugewtjTDElPzmA,6088
+emcd_projects-1.18rc0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+emcd_projects-1.18rc0.dist-info/entry_points.txt,sha256=22Pc1xg3OboNBxpTnDM3gLYXo8QuY2E0SOv1djo0fdc,43
+emcd_projects-1.18rc0.dist-info/licenses/LICENSE.txt,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+emcd_projects-1.18rc0.dist-info/RECORD,,

emcdproj/__/__init__.py

@@ -21,13 +21,8 @@
 ''' Common constants, imports, and utilities. '''
 
 
-# Expose everything from internal modules.
-from .imports import *
 from .application import Information as ApplicationInformation
 from .distribution import Information as DistributionInformation
 from .imports import *
 from .preparation import *
 from .state import Globals
-
-
-__all__ = ( )

emcdproj/__/imports.py

@@ -35,6 +35,7 @@ import                      math
 import                      os
 import                      shutil
 import                      sys
+import                      tempfile
 import                      types
 
 from pathlib import Path

emcdproj/__init__.py

@@ -27,7 +27,7 @@ from . import exceptions
 # --- END: Injected by Copier ---
 
 
-__version__ = '1.17.1'
+__version__ = '1.18rc0'
 
 
 def main( ):

emcdproj/data/copier/answers-maximum.yaml

@@ -10,5 +10,3 @@ enable_cli: true
 enable_executables: true
 inject_foundations: true
 inject_exceptions: true
-inject_immutables: true
-inject_docstring_utils: true

emcdproj/template.py

@@ -24,7 +24,6 @@
 from __future__ import annotations
 
 import subprocess as _subprocess
-import tempfile as _tempfile
 
 from . import __
 from . import interfaces as _interfaces
@@ -33,7 +32,7 @@ from . import interfaces as _interfaces
 class CommandDispatcher(
     _interfaces.CliCommand, decorators = ( __.standard_tyro_class, ),
 ):
-    ''' Dispatches commands for static website maintenance. '''
+    ''' Dispatches commands for Copier template maintenance. '''
 
     command: __.typx.Union[
         __.typx.Annotated[
@@ -76,13 +75,18 @@ class ValidateCommand(
         __.typx.Doc( ''' Configuration variant to validate. ''' ),
         __.tyro.conf.Positional,
     ]
+    preserve: __.typx.Annotated[
+        bool,
+        __.typx.Doc( ''' Preserve generated project for inspection? ''' ),
+    ] = False
 
     async def __call__(
         self, auxdata: __.Globals, display: _interfaces.ConsoleDisplay
     ) -> None:
         ''' Copies new project from template for configuration variant. '''
         # TODO: Validate variant argument.
-        validate_variant( auxdata, self.variant )
+        validate_variant(
+            auxdata, self.variant, preserve = self.preserve )
 
 
 def copy_template( answers_file: __.Path, projectdir: __.Path ) -> None:
@@ -103,7 +107,9 @@ def survey_variants( auxdata: __.Globals ) -> __.cabc.Sequence[ str ]:
         if fsent.is_file( ) )
 
 
-def validate_variant( auxdata: __.Globals, variant: str ) -> None:
+def validate_variant(
+    auxdata: __.Globals, variant: str, preserve: bool
+) -> None:
     ''' Validates configuration variant. '''
     answers_file = (
         auxdata.distribution.provide_data_location(
@@ -111,8 +117,8 @@ def validate_variant( auxdata: __.Globals, variant: str ) -> None:
     if not answers_file.is_file( ):
         # TODO: Raise error.
         return
-    with _tempfile.TemporaryDirectory( ) as tmpdir:
-        projectdir = __.Path( tmpdir ) / variant
+    with _manage_temporary_directory( preserve = preserve ) as tmpdir:
+        projectdir = tmpdir / variant
         copy_template( answers_file, projectdir )
         validate_variant_project( projectdir )
 
@@ -125,3 +131,14 @@ def validate_variant_project( projectdir: __.Path ) -> None:
             '--upgrade', 'pip', 'build' ),
         (   'hatch', '--env', 'develop', 'run', 'make-all' ),
     ): _subprocess.run( command, cwd = str( projectdir ), check = True ) # noqa: S603
+
+
+@__.ctxl.contextmanager
+def _manage_temporary_directory(
+    preserve: bool
+) -> __.cabc.Iterator[ __.Path ]:
+    # TODO: Python 3.12: Replace with tempfile.TemporaryDirectory,
+    #                    ( delete = not preserve )
+    location = __.Path( __.tempfile.mkdtemp( ) )
+    yield location
+    if not preserve: __.shutil.rmtree( location )