viperx 0.9.14__py3-none-any.whl → 0.9.26__py3-none-any.whl

viperx/config_engine.py

@@ -129,7 +129,7 @@ class ConfigEngine:
                     author=project_conf.get("author", "Your Name"), # Inherit author
                     use_env=pkg.get("use_env", settings_conf.get("use_env", False)),     # Inherit settings or default False
                     use_config=pkg.get("use_config", settings_conf.get("use_config", True)), # Inherit or default True
-                    use_readme=pkg.get("use_readme", True),
+                    use_readme=pkg.get("use_readme", False),
                     use_tests=pkg.get("use_tests", settings_conf.get("use_tests", True)),
                     framework=pkg.get("framework", FRAMEWORK_PYTORCH),
                     verbose=self.verbose

viperx/constants.py

@@ -33,3 +33,8 @@ PROJECT_TYPES = [TYPE_CLASSIC, TYPE_ML, TYPE_DL]
 FRAMEWORK_PYTORCH = "pytorch"
 FRAMEWORK_TENSORFLOW = "tensorflow"
 DL_FRAMEWORKS = [FRAMEWORK_PYTORCH, FRAMEWORK_TENSORFLOW]
+
+# Builders
+BUILDER_UV = "uv"
+BUILDER_HATCH = "hatch"
+SUPPORTED_BUILDERS = [BUILDER_UV, BUILDER_HATCH]

viperx/core.py

@@ -62,6 +62,13 @@ class ProjectGenerator:
             loader=PackageLoader("viperx", "templates"),
             autoescape=select_autoescape()
         )
+        
+        # Validate Builder
+        from viperx.utils import check_builder_installed
+        if not check_builder_installed(self.builder):
+             console.print(f"[bold red]Error:[/bold red] The requested builder '[bold]{self.builder}[/bold]' is not installed or not in PATH.")
+             console.print(f"Please install it (e.g., `pip install {self.builder}` or `curl -LsSf https://astral.sh/uv/install.sh | sh` for uv).")
+             sys.exit(1)
 
     def log(self, message: str, style: str = "dim"):
         if self.verbose:
@@ -136,6 +143,13 @@ class ProjectGenerator:
         # 4. Overwrite/Add Files
         self._generate_files(project_dir, is_subpackage)
         
+        
+        # Cleanup extra files for subpackages
+        if is_subpackage:
+            for f in [".gitignore", ".python-version"]:
+                if (project_dir / f).exists():
+                    (project_dir / f).unlink()
+        
         # 5. Git & Final Steps
         console.print(f"\n[bold green]✓ Project {self.raw_name} created successfully![/bold green]")
         if not is_subpackage:
@@ -189,8 +203,14 @@ class ProjectGenerator:
             "framework": self.framework,
         }
         
-        # pyproject.toml (Overwrite uv's basic one to add our specific deps)
-        self._render("pyproject.toml.j2", root / "pyproject.toml", context)
+        if not is_subpackage:
+            # pyproject.toml (Overwrite uv's basic one to add our specific deps)
+            self._render("pyproject.toml.j2", root / "pyproject.toml", context)
+        else:
+             # Subpackages: remove default pyproject.toml from uv init
+             if (root / "pyproject.toml").exists():
+                 (root / "pyproject.toml").unlink()
+                 self.log("Removed default pyproject.toml (Subpackage: Code Only)")
         
         # Determine Package Root
         if is_subpackage:
@@ -210,19 +230,33 @@ class ProjectGenerator:
         self._render("__init__.py.j2", pkg_root / "__init__.py", context)
         
         # README.md
-        if self.use_readme:
-             self._render("README.md.j2", root / "README.md", context)
+        # README.md
+        if not is_subpackage:
+            # Root Project: Respect use_readme
+            if self.use_readme:
+                 self._render("README.md.j2", root / "README.md", context)
+            else:
+                 if (root / "README.md").exists():
+                     (root / "README.md").unlink()
+                     self.log("Removed default README.md (requested --no-readme)")
         else:
-             if (root / "README.md").exists():
+             # Subpackage: Default False, but if True, generate it
+             if self.use_readme:
+                  self._render("README.md.j2", root / "README.md", context)
+             elif (root / "README.md").exists():
+                 # Cleanup default README from uv init if we didn't request one
                  (root / "README.md").unlink()
-                 self.log("Removed default README.md (requested --no-readme)")
+
         
         # LICENSE
-        license_text = LICENSES.get(self.license, LICENSES["MIT"])
-        license_text = license_text.format(year=datetime.now().year, author=self.author)
-        with open(root / "LICENSE", "w") as f:
-            f.write(license_text)
-        self.log(f"Generated LICENSE ({self.license})")
+        if not is_subpackage:
+            license_text = LICENSES.get(self.license, LICENSES["MIT"])
+            license_text = license_text.format(year=datetime.now().year, author=self.author)
+            with open(root / "LICENSE", "w") as f:
+                f.write(license_text)
+            self.log(f"Generated LICENSE ({self.license})")
+        elif (root / "LICENSE").exists():
+            (root / "LICENSE").unlink()
 
         # Config files
         if self.use_config:
@@ -249,10 +283,12 @@ class ProjectGenerator:
             self.log(f"Created .env and .env.example in {pkg_root.relative_to(root)}")
                 
         # .gitignore
-        with open(root / ".gitignore", "a") as f:
-            # Add data/ to gitignore but allow .gitkeep
-            f.write("\n# ViperX specific\n.ipynb_checkpoints/\n# Isolated Env\nsrc/**/.env\n# Data (Local)\ndata/*\n!data/.gitkeep\n")
-        self.log("Updated .gitignore")
+        # Only for Root
+        if not is_subpackage: 
+            with open(root / ".gitignore", "a") as f:
+                # Add data/ to gitignore but allow .gitkeep
+                f.write("\n# ViperX specific\n.ipynb_checkpoints/\n# Isolated Env\nsrc/**/.env\n# Data (Local)\ndata/*\n!data/.gitkeep\n")
+            self.log("Updated .gitignore")
 
     def _render(self, template_name: str, target_path: Path, context: dict):
         template = self.env.get_template(template_name)

viperx/main.py

@@ -14,9 +14,14 @@ from viperx.constants import (
     DL_FRAMEWORKS,
     FRAMEWORK_PYTORCH,
 )
-
-HELP_TEXT = """
-[bold green]ViperX[/bold green]: Professional Python Project Initializer
+import importlib.metadata
+try:
+    version = importlib.metadata.version("viperx")
+except importlib.metadata.PackageNotFoundError:
+    version = "unknown"
+    
+HELP_TEXT = f"""
+[bold green]ViperX[/bold green] (v{version}): Professional Python Project Initializer
 .
     
     Automates the creation of professional-grade Python projects using `uv`.
@@ -28,31 +33,15 @@ app = typer.Typer(
     add_completion=False,
     no_args_is_help=True,
     rich_markup_mode="markdown",
-    epilog="Made with ❤️ by KpihX"
+    epilog="Made with ❤️  by KpihX"
 )
 
 # Global state for verbose flag
 state = {"verbose": False}
 console = Console(force_terminal=True)
 
-
-    """
-    **ViperX**: Professional Python Project Initializer.
-    
-    Automates the creation of professional-grade Python projects using `uv`.
-    Supports Standard Libraries, Machine Learning, and Deep Learning templates.
-    """
-    if verbose:
-        state["verbose"] = True
-        console.print("[dim]Verbose mode enabled[/dim]")
-
 def version_callback(value: bool):
     if value:
-        import importlib.metadata
-        try:
-            version = importlib.metadata.version("viperx")
-        except importlib.metadata.PackageNotFoundError:
-            version = "unknown"
         console.print(f"ViperX CLI Version: [bold green]{version}[/bold green]")
         raise typer.Exit()
 
@@ -79,9 +68,21 @@ def cli_callback(
     if verbose:
         state["verbose"] = True
         console.print("[dim]Verbose mode enabled[/dim]")
+        
+
 
-@app.command()
-def init(
+
+# Config Management Group (The Main Entry Point)
+config_app = typer.Typer(
+    help="Manage Declarative Configuration (viperx.yaml).",
+    no_args_is_help=False,  # Allow running without subcommands (acts as apply)
+)
+app.add_typer(config_app, name="config")
+
+
+@config_app.callback(invoke_without_command=True)
+def config_main(
+    ctx: typer.Context,
     # --- Config Driven Mode ---
     config: Path = typer.Option(
         None, "--config", "-c",
@@ -115,10 +116,17 @@ def init(
     verbose: bool = typer.Option(False, "--verbose", "-v", help="Enable verbose logging"),
 ):
     """
-    Initialize a new Python project.
+    **Configure & Initialize**: Apply configuration to create or update a project.
     
-    Can stem from a config file (Declarative) or CLI arguments (Imperative).
+    usage: [bold]viperx config [OPTIONS][/bold]
+           [bold]viperx config get[/bold]
     """
+    # Check if a subcommand (like 'get') is invoked
+    if ctx.invoked_subcommand is not None:
+        return
+
+    # --- Apply Logic (Former Init) ---
+    
     # 1. Declarative Mode
     if config:
         if not config.exists():
@@ -131,6 +139,10 @@ def init(
 
     # 2. Imperative Mode (Validation)
     if not name:
+         # Implicitly show help if no options provided?
+         # Or error out. User expects correct run.
+         # If user runs `viperx config` with NO args, and NO config, what happens?
+         # "Missing option name".
          console.print("[bold red]Error:[/bold red] Missing option '--name' / '-n'. Required in manual mode.")
          raise typer.Exit(code=1)
 
@@ -156,12 +168,8 @@ def init(
     # Generate in current directory
     generator.generate(Path.cwd())
 
-# Config Management Group
-config_app = typer.Typer(
-    help="Manage Declarative Configuration (viperx.yaml).",
-    no_args_is_help=True
-)
-app.add_typer(config_app, name="config")
+
+
 
 @config_app.command("get")
 def config_get(
@@ -212,7 +220,7 @@ def package_add(
     ),
     use_env: bool = typer.Option(True, "--env/--no-env", help="Generate .env file"),
     use_config: bool = typer.Option(True, "--embed-config/--no-embed-config", help="Generate embedded config"),
-    use_readme: bool = typer.Option(True, "--readme/--no-readme", help="Generate README.md"),
+    use_readme: bool = typer.Option(False, "--readme/--no-readme", help="Generate README.md"),
     verbose: bool = typer.Option(False, "--verbose", "-v", help="Enable verbose logging"),
 ):
     """
@@ -275,4 +283,18 @@ def package_update(
     generator.update_package(Path.cwd())
 
 if __name__ == "__main__":
-    app()
+    try:
+        app()
+    except SystemExit as e:
+        if e.code != 0:
+            # On error (non-zero exit), display help as requested
+            from typer.main import get_command
+            import click
+            cli = get_command(app)
+            # Create a dummy context to render help
+            # We print it to stderr or stdout? Console prints to stdout usually.
+            # User wants it displayed immediately.
+            with click.Context(cli) as ctx:
+                 console.print("\n")
+                 console.print(cli.get_help(ctx))
+            raise

viperx/templates/config.py.j2

@@ -28,6 +28,7 @@ def get_config(key: str, default: Any = None) -> Any:
     """Retrieve a value from the globally loaded settings."""
     return SETTINGS.get(key, default)
 
+{% if project_type != 'classic' %}
 def get_dataset_path(notebook_name: str, key: str = "datasets", extension: str = ".csv") -> str | None:
     """
     Helper for notebook data loading.
@@ -38,3 +39,4 @@ def get_dataset_path(notebook_name: str, key: str = "datasets", extension: str =
     if not dataset_name:
         return None
     return f"{dataset_name}{extension}"
+{% endif %}

viperx/templates/pyproject.toml.j2

@@ -43,13 +43,10 @@ dependencies = [
 {% if builder == 'hatch' %}
 requires = ["hatchling"]
 build-backend = "hatchling.build"
-{% elif builder == 'flit' %}
-requires = ["flit_core>=3.2,<4"]
-build-backend = "flit_core.buildapi"
 {% else %}
-# Default to Setuptools (Standard/Robust) to avoid Hatchling unless requested
-requires = ["setuptools>=61.0"]
-build-backend = "setuptools.build_meta"
+# Default: uv native build backend
+requires = ["uv_build>=0.9.21,<0.10.0"]
+build-backend = "uv_build"
 {% endif %}
 
 {% if use_uv %}

viperx/templates/viperx_config.yaml.j2

@@ -42,4 +42,5 @@ workspace:
     #   use_env: false
     #   use_config: true
     #   use_tests: true
+    #   use_readme: false
 

viperx/utils.py

@@ -1,6 +1,5 @@
 import re
 import shutil
-import subprocess
 from rich.console import Console
 
 console = Console()
@@ -32,16 +31,32 @@ def validate_project_name(ctx, param, value):
         raise BadParameter("Project name must contain only letters, numbers, underscores, and hyphens.")
     return value
 
+def check_builder_installed(builder: str) -> bool:
+    """
+    Check if the specified builder is installed.
+    Uses shutil.which() for robust path detection.
+    """
+    return shutil.which(builder) is not None
+
 def get_author_from_git() -> tuple[str, str]:
     """
     Attempt to get author name and email from git config.
     Returns (name, email) or defaults.
     """
     try:
+        # Check if git is installed first
+        if not shutil.which("git"):
+             return "Nameless", "nameless@example.com"
+             
         import git
-        config = git.GitConfigParser(git.GitConfigParser.get_global_config(), read_only=True)
-        name = config.get("user", "name", fallback="Your Name")
-        email = config.get("user", "email", fallback="your.email@example.com")
-        return name, email
+        # Robust way using git command wrapper
+        reader = git.Git().config
+        name = reader("--global", "--get", "user.name")
+        email = reader("--global", "--get", "user.email")
+        
+        # strip newlines if any
+        return (name.strip() if name else "Nameless", 
+                email.strip() if email else "nameless@example.com")
     except Exception:
-        return "Your Name", "your.email@example.com"
+        # Fallback if git call fails
+        return "Nameless", "nameless@example.com"

{viperx-0.9.14.dist-info → viperx-0.9.26.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: viperx
-Version: 0.9.14
+Version: 0.9.26
 Summary: Professional Python Project Initializer with uv, ml/dl support, and embedded config.
 Keywords: python,project-template,uv,data-science,machine-learning
 Author: Ivann KAMDEM

{viperx-0.9.14.dist-info → viperx-0.9.26.dist-info}/RECORD

@@ -1,22 +1,22 @@
 viperx/__init__.py,sha256=mRrD-SK9PtwBhqgLzJrvefdViNsXCyBGknzFNsIou1I,51
-viperx/config_engine.py,sha256=Fzb5F3rE7BqcnpAdu6QhN28tfQNTuBHI04YuR1B7cHM,7340
-viperx/constants.py,sha256=BMogG1-ik67YeheQdCgjsdS5FNFYiLfdro6utCWwczY,784
-viperx/core.py,sha256=dOLLPxBohYN6A5i1BnT5gx35x6x5n40yYYGm6yEZKHM,18733
+viperx/config_engine.py,sha256=9P9xxWIYWhL_QFRyvi601D3_4HBHn4RA20dreGwdSX4,7341
+viperx/constants.py,sha256=Mv5tFjFxe3tD4VDCEsXiwfiV7biTlzl45ALkHmiK33M,887
+viperx/core.py,sha256=R0IzxNTL_Coyz1bCTc2QAnQM3FK36ADV86NVQXuXmBM,20438
 viperx/licenses.py,sha256=TPsG1aqNAjtOsvuD6i3SiC5rUK9f3DslPHQkKiV7vxs,12482
-viperx/main.py,sha256=B8Z6bjESFKFvL80NJcfPGgYycxQP3NwLhKtJDtaj1Zc,9856
+viperx/main.py,sha256=N0pqLnZoWr00XjH1kS5dxbDKEqXvazsVspqLQ_-fF8k,10663
 viperx/templates/Base.ipynb.j2,sha256=rlGCw7jIds3RiXFrG8D8oAjzXzzj1cayKjBI91k-1kA,3140
 viperx/templates/Base_General.ipynb.j2,sha256=f5ZUu65khtvBeCofs3Lvzccn5Krl0nRGu0dv7SzLvzg,2716
 viperx/templates/Base_Kaggle.ipynb.j2,sha256=gPkmFt4cA5UzhRU_gLZ1UzSjEa7Mgel001Eqiw94-fc,2698
 viperx/templates/README.md.j2,sha256=TJNUwTcKnjALrP0MOSs8UBx8zNhI8erRHrc2-8nuMgQ,3445
 viperx/templates/__init__.py.j2,sha256=uq8IYd0SGYX2-cpGb9q5197eYs-ode-g5y2NCGWU5YM,196
-viperx/templates/config.py.j2,sha256=sU6bwiA0eW7g0d9Y_rhxSd-6LcMUyYiZKBhcF_OJcxM,1409
+viperx/templates/config.py.j2,sha256=ExMbopPQPntmkNgbv9uKooGDjv82gh_XhyQmjJ8MiQg,1456
 viperx/templates/config.yaml.j2,sha256=IYvjQUioZ9lyzVHVDgwrdjgM6s4pUnCFXwtnydoKe2k,485
 viperx/templates/data_loader.py.j2,sha256=hehewwvBAYJM-acKn6_T4cU5EvUPX7wHAurAQ3z3ET4,3696
 viperx/templates/main.py.j2,sha256=caGN54Hck_EcwT3Aqju52CBuGujSnzU2Hehw8mowzjI,277
-viperx/templates/pyproject.toml.j2,sha256=RnJm7BinT-p646BiC2gxOTBuIX0nmRM7BUqt0n981io,1434
-viperx/templates/viperx_config.yaml.j2,sha256=dZ5GtiGRWT_FOsMeF1YUjqL5wHO0y0i38gqU-lwrVSQ,1379
-viperx/utils.py,sha256=2kiQLDHsPcCELEKeQYbIkSL8e3HhW4pRzw1pUth6hYA,1583
-viperx-0.9.14.dist-info/WHEEL,sha256=RRVLqVugUmFOqBedBFAmA4bsgFcROUBiSUKlERi0Hcg,79
-viperx-0.9.14.dist-info/entry_points.txt,sha256=Is38BrTuf6unQCLgDE990Rjd9HyGldBSw4Uzy_nMePY,44
-viperx-0.9.14.dist-info/METADATA,sha256=OC8UDqEikK2-pU1RKt02YGRbKtsLvg0p-7OFGzvzXKA,6782
-viperx-0.9.14.dist-info/RECORD,,
+viperx/templates/pyproject.toml.j2,sha256=9s3wbXZjoA_643feZAlS5-7YMQLxVUd6XLPhDusyuJY,1287
+viperx/templates/viperx_config.yaml.j2,sha256=a2H0N_W8sq0Zrjio4El7kFjOYQUATf_VdD9zK3NzG3U,1405
+viperx/utils.py,sha256=yCJMclJT10_Vc8A1dx_lP0OSs7crCnVNLP46SCpxmog,2054
+viperx-0.9.26.dist-info/WHEEL,sha256=RRVLqVugUmFOqBedBFAmA4bsgFcROUBiSUKlERi0Hcg,79
+viperx-0.9.26.dist-info/entry_points.txt,sha256=Is38BrTuf6unQCLgDE990Rjd9HyGldBSw4Uzy_nMePY,44
+viperx-0.9.26.dist-info/METADATA,sha256=GuapQRE5fpVYvo6_5i54EI8uA1AplAIAAsEaSiBTty4,6782
+viperx-0.9.26.dist-info/RECORD,,