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

viperx/config_engine.py

@@ -4,7 +4,7 @@ from rich.console import Console
 from rich.panel import Panel
 
 from viperx.core import ProjectGenerator
-from viperx.constants import DEFAULT_LICENSE, DEFAULT_BUILDER, TYPE_CLASSIC, FRAMEWORK_PYTORCH
+from viperx.constants import DEFAULT_LICENSE, DEFAULT_BUILDER, TYPE_CLASSIC, TYPE_ML, TYPE_DL, FRAMEWORK_PYTORCH
 
 console = Console()
 
@@ -69,6 +69,7 @@ class ConfigEngine:
                     use_config=settings_conf.get("use_config", True),
                     use_tests=settings_conf.get("use_tests", True),
                     framework=settings_conf.get("framework", FRAMEWORK_PYTORCH),
+                    scripts={project_name: f"{project_name}.main:main"}, # Simple default for hydration 
                     verbose=self.verbose
                 )
                  # generate() expects parent dir, and will operate on parent/name (which is self.root_path)
@@ -84,9 +85,55 @@ class ConfigEngine:
             else:
                 if target_dir.exists():
                      console.print(Panel(f"⚠️  [bold yellow]Directory exists but not initialized. Hydrating:[/bold yellow] {project_name}", border_style="yellow"))
-                else:
-                     console.print(Panel(f"🚀 [bold green]Creating New Project:[/bold green] {project_name}", border_style="green"))
+                # Prepare Scripts & Dependency Context
+                packages = workspace_conf.get("packages", [])
                 
+                # --- Aggregate Global Dependencies ---
+                # Start with Root Settings
+                # Root is always present (ProjectGenerator uses these)
+                root_use_config = settings_conf.get("use_config", True)
+                root_use_env = settings_conf.get("use_env", False)
+                root_type = settings_conf.get("type", TYPE_CLASSIC)
+                root_framework = settings_conf.get("framework", FRAMEWORK_PYTORCH)
+                
+                glob_has_config = root_use_config
+                glob_has_env = root_use_env
+                glob_is_ml_dl = root_type in [TYPE_ML, TYPE_DL]
+                glob_is_dl = root_type == TYPE_DL
+                glob_frameworks = {root_framework} if glob_is_dl else set()
+
+                project_scripts = {project_name: f"{project_name}.main:main"}
+                
+                for pkg in packages:
+                    # Scripts
+                    pkg_name = pkg.get("name")
+                    from viperx.utils import sanitize_project_name
+                    pkg_name_clean = sanitize_project_name(pkg_name)
+                    # CLI Command = Raw Name (e.g. test-classic) -> sanitized module path (test_classic.main:main)
+                    project_scripts[pkg_name] = f"{pkg_name_clean}.main:main"
+                    
+                    # Dependency Aggregation
+                    # Inherit defaults if not defined in pkg
+                    p_config = pkg.get("use_config", settings_conf.get("use_config", True))
+                    p_env = pkg.get("use_env", settings_conf.get("use_env", False))
+                    p_type = pkg.get("type", TYPE_CLASSIC)
+                    p_framework = pkg.get("framework", FRAMEWORK_PYTORCH) # Defaults to pytorch if implicit
+
+                    if p_config: glob_has_config = True
+                    if p_env: glob_has_env = True
+                    if p_type in [TYPE_ML, TYPE_DL]: glob_is_ml_dl = True
+                    if p_type == TYPE_DL: 
+                         glob_is_dl = True
+                         glob_frameworks.add(p_framework)
+
+                dep_context = {
+                    "has_config": glob_has_config,
+                    "has_env": glob_has_env,
+                    "is_ml_dl": glob_is_ml_dl,
+                    "is_dl": glob_is_dl,
+                    "frameworks": list(glob_frameworks)
+                }
+
                 # Create Root (or Hydrate)
                 gen = ProjectGenerator(
                     name=project_name,
@@ -99,6 +146,8 @@ class ConfigEngine:
                     use_config=settings_conf.get("use_config", True),
                     use_tests=settings_conf.get("use_tests", True),
                     framework=settings_conf.get("framework", FRAMEWORK_PYTORCH),
+                    scripts=project_scripts,
+                    dependency_context=dep_context,
                     verbose=self.verbose
                 )
                 gen.generate(self.root_path)
@@ -129,7 +178,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

@@ -34,12 +34,32 @@ class ProjectGenerator:
                  license: str = DEFAULT_LICENSE, 
                  builder: str = DEFAULT_BUILDER, 
                  framework: str = "pytorch",
+                 scripts: Optional[dict] = None,
+                 dependency_context: Optional[dict] = None,
                  verbose: bool = False):
         self.raw_name = name
         self.project_name = sanitize_project_name(name)
         self.description = description or name
         self.type = type
         self.framework = framework
+        self.scripts = scripts or {}
+        # Dependency Context (Global workspace features)
+        self.dependency_context = dependency_context or {
+            "has_config": use_config,
+            "has_env": use_env,
+            "is_ml_dl": type in ["ml", "dl"],
+            "is_dl": type == "dl",
+            "frameworks": [framework] if type == "dl" else []
+        }
+        
+        # Default script for the main package if none provided (and it's a root project mostly)
+        self.scripts = scripts or {}
+        # Default script for the main package if none provided (and it's a root project mostly)
+        if not self.scripts:
+             # Key = Raw Name (CLI command, e.g. test-classic)
+             # Value = Sanitized Path (Module, e.g. test_classic.main:main)
+             self.scripts = {self.raw_name: f"{self.project_name}.main:main"}
+             
         self.author = author
         if not self.author or self.author == "Your Name":
              self.author, self.author_email = get_author_from_git()
@@ -54,9 +74,39 @@ class ProjectGenerator:
         self.use_tests = use_tests
         self.verbose = verbose
         
-        # Detect System Python
-        self.python_version = f"{sys.version_info.major}.{sys.version_info.minor}"
+        # Detect System Python (For logging/diagnostics)
+        self.system_python_version = f"{sys.version_info.major}.{sys.version_info.minor}"
+        
+        # Project Python Version (For requires-python in pyproject.toml)
+        # Driven by package constants to ensure compatibility/evolution
+        from viperx.constants import DEFAULT_PYTHON_VERSION
+        self.python_version = DEFAULT_PYTHON_VERSION
         
+        
+        # Validate Choices
+        from viperx.utils import validate_choice, check_builder_installed
+        from viperx.constants import PROJECT_TYPES, DL_FRAMEWORKS, TYPE_DL
+        
+        try:
+            validate_choice(self.type, PROJECT_TYPES, "project type")
+            if self.type == TYPE_DL:
+                validate_choice(self.framework, DL_FRAMEWORKS, "framework")
+            
+            # Validate Builder Existence & Support
+            if not check_builder_installed(self.builder):
+                 from viperx.constants import SUPPORTED_BUILDERS
+                 if self.builder not in SUPPORTED_BUILDERS:
+                      console.print(f"[bold red]Error:[/bold red] Invalid builder '[bold]{self.builder}[/bold]'.")
+                      console.print(f"Supported builders: [green]{', '.join(SUPPORTED_BUILDERS)}[/green]")
+                 else:
+                      console.print(f"[bold red]Error:[/bold red] The 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)
+                 
+        except ValueError as e:
+            console.print(f"[bold red]Configuration Error:[/bold red] {e}")
+            sys.exit(1)
+
         # Jinja Setup
         self.env = Environment(
             loader=PackageLoader("viperx", "templates"),
@@ -81,7 +131,8 @@ class ProjectGenerator:
         console.print(f"[bold green]Creating project {self.raw_name} ({self.type})...[/bold green]")
         
         self.log(f"Target directory: {project_dir}")
-        self.log(f"Python version: {self.python_version}")
+        self.log(f"System Python: {self.system_python_version}")
+        self.log(f"Project Python: {self.python_version}")
 
 
     def generate(self, target_dir: Path, is_subpackage: bool = False):
@@ -102,8 +153,13 @@ class ProjectGenerator:
                 )
             else:
                 # Create new
+                # STRICT DIR NAMING: Use self.project_name (underscores) for directory
+                # But use self.raw_name (hyphens) for the package Name metadata if possible?
+                # uv init [NAME] creates directory NAME.
+                # If we want dir=test_classic but name=test-classic:
+                # uv init test_classic --name test-classic
                 subprocess.run(
-                    ["uv", "init", "--package", "--no-workspace", self.raw_name], 
+                    ["uv", "init", "--package", "--no-workspace", self.project_name, "--name", self.raw_name], 
                     check=True, cwd=target_dir, capture_output=True
                 )
             console.print("  [blue]✓ Scaffolding created with uv init[/blue]")
@@ -136,10 +192,17 @@ 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:
-            console.print(f"  [dim]cd {self.raw_name} && uv sync[/dim]")
+            console.print(f"  [dim]cd {self.project_name} && uv sync[/dim]")
 
     def _create_extra_dirs(self, root: Path, is_subpackage: bool = False):
         if is_subpackage:
@@ -186,10 +249,15 @@ class ProjectGenerator:
             "has_config": self.use_config,
             "use_readme": self.use_readme,
             "use_env": self.use_env,
+            "use_env": self.use_env,
             "framework": self.framework,
+            "scripts": self.scripts,
         }
+        # Merge dependency context overrides
+        context.update(self.dependency_context)
         
         # pyproject.toml (Overwrite uv's basic one to add our specific deps)
+        # Even subpackages need this if they are Workspace Members (which they are in our model)
         self._render("pyproject.toml.j2", root / "pyproject.toml", context)
         
         # Determine Package Root
@@ -210,19 +278,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 +331,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)
@@ -265,57 +349,9 @@ class ProjectGenerator:
         """Add a new package to an existing workspace."""
         console.print(f"[bold green]Adding package {self.raw_name} to workspace...[/bold green]")
         
-        pyproject_path = workspace_root / "pyproject.toml"
-        if not pyproject_path.exists():
-            console.print("[red]Error: Not in a valid project root (pyproject.toml missing).[/red]")
-            return
-            
-        # Read pyproject.toml
-        with open(pyproject_path, "r") as f:
-            content = f.read()
-
-        # Check if it's already a workspace
-        is_workspace = "[tool.uv.workspace]" in content
-        
-        if not is_workspace:
-            console.print("[yellow]Upgrading project to Workspace...[/yellow]")
-            # Append workspace definition
-            with open(pyproject_path, "a") as f:
-                f.write(f"\n[tool.uv.workspace]\nmembers = [\"src/{self.raw_name}\"]\n")
-            self.log("Added [tool.uv.workspace] section")
-        else:
-            # Add member to specific list if it exists
-            # We use a simple regex approach to find 'members = [...]'
-            import re
-            members_pattern = r'members\s*=\s*\[(.*?)\]'
-            match = re.search(members_pattern, content, re.DOTALL)
-            
-            if match:
-                current_members = match.group(1)
-                # Check if already present
-                if f'"{self.raw_name}"' in current_members or f"'{self.raw_name}'" in current_members:
-                    self.log(f"Package {self.raw_name} is already in workspace members.")
-                else:
-                    # Append new member
-                    # We inject it into the list
-                    self.log("Adding member to existing workspace list")
-                    # Naively replace the closing bracket
-                    # Better: parse, but for now robust string insertion
-                    # Cleanest way without breaking formatting involves finding the last element
-                    # Cleanest way without breaking formatting involves finding the last element
-                    new_member = f', "src/{self.raw_name}"'
-                    # Warning: This regex replace is basic. `uv` handles toml well, maybe we should just edit safely.
-                    # Let's try to append to the end of the content of the list
-                    new_content = re.sub(members_pattern, lambda m: f'members = [{m.group(1)}{new_member}]', content, flags=re.DOTALL)
-                    with open(pyproject_path, "w") as f:
-                        f.write(new_content)
-            else:
-                 # Section exists but members key might be missing? Or weird formatting.
-                 # Append to section?
-                 # Safe fallback
-                 console.print("[yellow]Warning: Could not parse members list. Adding manually at end.[/yellow]")
-                 with open(pyproject_path, "a") as f:
-                     f.write(f"\n# Added by viperx\n[tool.uv.workspace]\nmembers = [\"{self.raw_name}\"]\n")
+        # User Request: Do not modify root pyproject.toml to add workspace members.
+        # "uv est assez intelligent"
+        pass
 
         # Generate the package in the root IF it doesn't exist
         pkg_dir = workspace_root / SRC_DIR / self.raw_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/__init__.py.j2

@@ -2,7 +2,4 @@
 from .config import SETTINGS, get_config, get_dataset_path
 {% endif %}
 
-__version__ = "{{ version }}"
 
-def hello():
-    print(f"Hello from {{ project_name }} v{__version__}!")

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/config.yaml.j2

@@ -1,3 +1,6 @@
+# Global Project Configuration
+project_name: "{{ project_name }}"
+
 {% if project_type in ['ml', 'dl'] %}
 data_urls:
   iris: "https://raw.githubusercontent.com/mwaskom/seaborn-data/master/iris.csv"

viperx/templates/main.py.j2

@@ -1,12 +1,12 @@
-from {{ package_name }} import hello
 {% if has_config %}
 from {{ package_name }} import SETTINGS
 {% endif %}
 
 def main():
-    hello()
     {% if has_config %}
-    print(f"Project config loaded: {SETTINGS['project_name']}")
+    print(f"Hi from {SETTINGS['project_name']}!")
+    {% else %}
+    print("Hi from viperx!")
     {% endif %}
 
 if __name__ == "__main__":

viperx/templates/pyproject.toml.j2

@@ -11,10 +11,14 @@ authors = [
 ]
 license = { text = "{{ license }}" }
 dependencies = [
+    {%- if has_config %}
     "pyyaml>=6.0",
+    {%- endif %}
+    {%- if has_env %}
     "python-dotenv>=1.0.0",
+    {%- endif %}
+    {%- if is_ml_dl %}
     "kagglehub>=0.2.0",
-    {% if project_type == 'ml' %}
     "numpy>=1.24.0",
     "pandas>=2.0.0",
     "scikit-learn>=1.3.0",
@@ -22,38 +26,32 @@ dependencies = [
     "seaborn>=0.12.0",
     "requests>=2.30.0",
     "tqdm>=4.65.0",
-    {% elif project_type == 'dl' %}
-    {% if framework == 'pytorch' %}
+    {%- endif %}
+    {%- if is_dl %}
+    {%- if 'pytorch' in frameworks %}
     "torch>=2.0.0",
     "torchvision>=0.15.0",
-    {% elif framework == 'tensorflow' %}
+    {%- endif %}
+    {%- if 'tensorflow' in frameworks %}
     "tensorflow>=2.13.0",
     # "keras>=3.0.0", # Optional, included in tf usually
-    {% endif %}
-    "numpy>=1.24.0",
-    "pandas>=2.0.0",
-    "matplotlib>=3.7.0",
-    "seaborn>=0.12.0",
-    "requests>=2.30.0",
-    "tqdm>=4.65.0",
-    {% endif %}
+    {%- endif %}
+    {%- endif %}
 ]
 
+[project.scripts]
+{%- for name, entry in scripts.items() %}
+{{ name }} = "{{ entry }}"
+{%- endfor %}
+
 [build-system]
-{% if builder == 'hatch' %}
+{%- 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"
-{% endif %}
+{%- else %}
+# Default: uv native build backend
+requires = ["uv_build>=0.9.21,<0.10.0"]
+build-backend = "uv_build"
+{%- endif %}
 
-{% if use_uv %}
-[tool.uv]
-managed = true
-{% endif %}
 

viperx/templates/viperx_config.yaml.j2

@@ -10,7 +10,7 @@ project:
   
   # [Optional] Defaults (Inferred from git/system if omitted)
   # description: "My robust project"
-  # author: "KpihX"
+  # author: "Nameless"
   # license: "MIT"
   # builder: "uv"
 
@@ -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,48 @@ def validate_project_name(ctx, param, value):
         raise BadParameter("Project name must contain only letters, numbers, underscores, and hyphens.")
     return value
 
+from viperx.constants import SUPPORTED_BUILDERS
+
+def validate_choice(value: str, choices: list[str], name: str):
+    """
+    Validate that a value is within the allowed choices.
+    Raises ValueError with a friendly message if invalid.
+    """
+    if value not in choices:
+        raise ValueError(f"Invalid {name} '{value}'. Allowed: {', '.join(choices)}")
+    return value
+
+def check_builder_installed(builder: str) -> bool:
+    """
+    Check if the specified builder is valid AND installed.
+    Uses shutil.which() for robust path detection.
+    """
+    # 1. Validate against supported list
+    if builder not in SUPPORTED_BUILDERS:
+        return False
+        
+    # 2. Check existence
+    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.40.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: viperx
-Version: 0.9.14
+Version: 0.9.40
 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.40.dist-info/RECORD

@@ -0,0 +1,22 @@
+viperx/__init__.py,sha256=mRrD-SK9PtwBhqgLzJrvefdViNsXCyBGknzFNsIou1I,51
+viperx/config_engine.py,sha256=A5u1qUaWlgvXQReRHtF05--spPsd90XgT81zZYR2rBM,9908
+viperx/constants.py,sha256=Mv5tFjFxe3tD4VDCEsXiwfiV7biTlzl45ALkHmiK33M,887
+viperx/core.py,sha256=yEACR7U-z5h7_fuCKyy4uljGPMe4S-F1HO5H_XeqHNg,20308
+viperx/licenses.py,sha256=TPsG1aqNAjtOsvuD6i3SiC5rUK9f3DslPHQkKiV7vxs,12482
+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=j-i1NRnKdvk-EgjijSyx-rfOsxWOVSXCyHY2-JEwMDM,93
+viperx/templates/config.py.j2,sha256=ExMbopPQPntmkNgbv9uKooGDjv82gh_XhyQmjJ8MiQg,1456
+viperx/templates/config.yaml.j2,sha256=EyeUfIIGvNIyMSHayh4i_0XVxIeu4Wdf2I6uAgfmSf4,552
+viperx/templates/data_loader.py.j2,sha256=hehewwvBAYJM-acKn6_T4cU5EvUPX7wHAurAQ3z3ET4,3696
+viperx/templates/main.py.j2,sha256=cpXjtc9MS6CnGAZ0RK1jaB3xBqh4r5Q4iwscBVB2pcY,258
+viperx/templates/pyproject.toml.j2,sha256=NGrgIJM_pzjbQ3OAgsT_y3mX2n8UzdAg_mo9AERhGmU,1297
+viperx/templates/viperx_config.yaml.j2,sha256=z-teOb1hTYmoVdXBQqgr6kK5fQGkMpI6KsTzbeF0m4Q,1408
+viperx/utils.py,sha256=c9FKL9eRsszNvinQd3zjvA2bRMVhEQI5F26aLN_PPZE,2578
+viperx-0.9.40.dist-info/WHEEL,sha256=RRVLqVugUmFOqBedBFAmA4bsgFcROUBiSUKlERi0Hcg,79
+viperx-0.9.40.dist-info/entry_points.txt,sha256=Is38BrTuf6unQCLgDE990Rjd9HyGldBSw4Uzy_nMePY,44
+viperx-0.9.40.dist-info/METADATA,sha256=h7IGeSpqB1LJ__SFKtWl_PGaJ1tVoZCARLzynArtGEk,6782
+viperx-0.9.40.dist-info/RECORD,,

viperx-0.9.14.dist-info/RECORD

@@ -1,22 +0,0 @@
-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/licenses.py,sha256=TPsG1aqNAjtOsvuD6i3SiC5rUK9f3DslPHQkKiV7vxs,12482
-viperx/main.py,sha256=B8Z6bjESFKFvL80NJcfPGgYycxQP3NwLhKtJDtaj1Zc,9856
-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.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,,