params-proto 3.1.2__tar.gz → 3.2.0__tar.gz

{params_proto-3.1.2 → params_proto-3.2.0}/.idea/workspace.xml

@@ -4,7 +4,13 @@
     <option name="autoReloadType" value="SELECTIVE" />
   </component>
   <component name="ChangeListManager">
-    <list default="true" id="7a053ece-f497-4c97-ac58-a86c807155ac" name="Changes" comment="add design specs" />
+    <list default="true" id="7a053ece-f497-4c97-ac58-a86c807155ac" name="Changes" comment="add design specs">
+      <change beforePath="$PROJECT_DIR$/src/params_proto/cli/cli_parse.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/params_proto/cli/cli_parse.py" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/params_proto/hyper/sweep.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/params_proto/hyper/sweep.py" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/params_proto/proto.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/params_proto/proto.py" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/test_v3/test_cli_parsing.py" beforeDir="false" afterPath="$PROJECT_DIR$/tests/test_v3/test_cli_parsing.py" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/tests/test_v3/test_piter.py" beforeDir="false" afterPath="$PROJECT_DIR$/tests/test_v3/test_piter.py" afterDir="false" />
+    </list>
     <option name="SHOW_DIALOG" value="false" />
     <option name="HIGHLIGHT_CONFLICTS" value="true" />
     <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
@@ -33,6 +39,7 @@
   <component name="HighlightingSettingsPerFile">
     <setting file="file://$USER_HOME$/Library/Caches/JetBrains/PyCharm2025.2/python_stubs/-1979844046/_typing.py" root0="SKIP_INSPECTION" />
     <setting file="file://$PROJECT_DIR$/pyproject.toml" root0="SKIP_INSPECTION" />
+    <setting file="file://$PROJECT_DIR$/src/params_proto/envvar.py" root0="SKIP_INSPECTION" />
   </component>
   <component name="KubernetesApiPersistence">{}</component>
   <component name="KubernetesApiProvider">{
@@ -193,10 +200,10 @@
       <option name="ADD_CONTENT_ROOTS" value="true" />
       <option name="ADD_SOURCE_ROOTS" value="true" />
       <EXTENSION ID="PythonCoverageRunConfigurationExtension" runner="coverage.py" />
-      <option name="RUN_TOOL" value="" />
+      <option name="RUN_TOOL" value="true" />
       <option name="_new_keywords" value="&quot;&quot;" />
       <option name="_new_parameters" value="&quot;&quot;" />
-      <option name="_new_additionalArguments" value="&quot;&quot;" />
+      <option name="_new_additionalArguments" value="&quot;-n auto&quot;" />
       <option name="_new_target" value="&quot;$PROJECT_DIR$/tests&quot;" />
       <option name="_new_targetType" value="&quot;PATH&quot;" />
       <method v="2" />
@@ -223,8 +230,8 @@
   <component name="SharedIndexes">
     <attachedChunks>
       <set>
-        <option value="bundled-js-predefined-d6986cc7102b-9b0f141eb926-JavaScript-PY-253.29346.308" />
-        <option value="bundled-python-sdk-ca5e2b39c7df-6e1f45a539f7-com.jetbrains.pycharm.pro.sharedIndexes.bundled-PY-253.29346.308" />
+        <option value="bundled-js-predefined-d6986cc7102b-9b0f141eb926-JavaScript-PY-253.30387.127" />
+        <option value="bundled-python-sdk-3944b0c99280-6d6dccd035ac-com.jetbrains.pycharm.pro.sharedIndexes.bundled-PY-253.30387.127" />
       </set>
     </attachedChunks>
   </component>
@@ -255,6 +262,8 @@
       <workItem from="1768126847510" duration="6729000" />
       <workItem from="1768382679094" duration="3000" />
       <workItem from="1769135684123" duration="4247000" />
+      <workItem from="1769569263076" duration="1863000" />
+      <workItem from="1769933004821" duration="1704000" />
     </task>
     <task id="LOCAL-00001" summary="add design specs">
       <option name="closed" value="true" />
@@ -295,7 +304,7 @@
     <SUITE FILE_PATH="coverage/params_proto$scratch.coverage" NAME="scratch Coverage Results" MODIFIED="1762422882594" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$" />
     <SUITE FILE_PATH="coverage/params_proto$demo_params_proto.coverage" NAME="demo_params_proto Coverage Results" MODIFIED="1762230413342" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$/scratch" />
     <SUITE FILE_PATH="coverage/params_proto$pytest_for_tests_test_v3_test_proto_cli_test_proto_cli.coverage" NAME="pytest for tests.test_v3.test_proto_cli.test_proto_cli Coverage Results" MODIFIED="1762386112096" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$" />
-    <SUITE FILE_PATH="coverage/params_proto$pytest_in_tests.coverage" NAME="pytest in tests Coverage Results" MODIFIED="1767991865711" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$/tests" />
+    <SUITE FILE_PATH="coverage/params_proto$pytest_in_tests.coverage" NAME="pytest in tests Coverage Results" MODIFIED="1769934711414" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$/tests" />
     <SUITE FILE_PATH="coverage/params_proto$pytest_in_test_parse_env_template_py.coverage" NAME="pytest in test_parse_env_template.py Coverage Results" MODIFIED="1762242493577" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$" />
     <SUITE FILE_PATH="coverage/params_proto$pytest_in_test_v2.coverage" NAME="pytest in test_v2 Coverage Results" MODIFIED="1762232660046" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$/tests/test_v2" />
     <SUITE FILE_PATH="coverage/params_proto$pytest_in_test_neo_proto_py.coverage" NAME="pytest in test_neo_proto.py Coverage Results" MODIFIED="1762233469671" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$" />

{params_proto-3.1.2 → params_proto-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: params-proto
-Version: 3.1.2
+Version: 3.2.0
 Summary: Modern Hyper Parameter Management for Machine Learning
 Project-URL: Homepage, https://github.com/geyang/params-proto
 Project-URL: Documentation, https://params-proto.readthedocs.io

{params_proto-3.1.2 → params_proto-3.2.0}/docs/key_concepts/union_types.md

@@ -36,8 +36,13 @@ class SGD:
 def train(optimizer: Adam | SGD, epochs: int = 10):
     pass
 
-# CLI: python train.py --optimizer:Adam --optimizer.lr 0.01
-# CLI: python train.py adam --epochs 50
+# CLI: python train.py adam --lr 0.01 --epochs 50
+# CLI: python train.py sgd --momentum 0.95
+```
+
+```{note}
+**Version 3.2.0+**: Subcommand attributes are **unprefixed by default**.
+Use `--lr` instead of `--optimizer.lr`. The prefixed syntax still works for backwards compatibility.
 ```
 
 ```python
@@ -51,8 +56,8 @@ class Model:
 def main(model: Model):
     pass
 
-# CLI: python main.py --model:Model --model.hidden-size 512
-# CLI: python main.py model
+# CLI: python main.py model --hidden-size 512
+# CLI: python main.py model --name vit
 ```
 
 ```python
@@ -75,17 +80,17 @@ Use Union types when you need to **select which class to instantiate**. This cre
 First, let's see how users interact with this from the command line:
 
 ```bash
-# Positional selection (simplest)
-python render.py perspective-camera --output scene.png
+# Positional selection with unprefixed attrs (v3.2.0+)
+python render.py perspective-camera --fov 45 --aspect 1.77
 
-# Named selection (explicit)
-python render.py --camera:perspective-camera
+# Alternative class
+python render.py orthographic-camera --scale 2.0
 
-# With attribute overrides
-python render.py perspective-camera --camera.fov 45 --camera.aspect 1.77
+# With shared parameters
+python render.py perspective-camera --output scene.png
 
-# Alternative class
-python render.py --camera:OrthographicCamera --camera.scale 2.0
+# Prefixed syntax still works (backwards compatible)
+python render.py --camera:perspective-camera --camera.fov 45
 ```
 
 Now the implementation:
@@ -121,7 +126,7 @@ if __name__ == "__main__":
 **How it works:**
 - `camera` is a **required parameter** with Union type
 - params-proto instantiates the selected class
-- Each class has its own parameter namespace (`--camera.fov`, `--camera.aspect`, etc.)
+- Attributes are unprefixed by default (`--fov`, `--aspect`)
 - Use `isinstance()` to dispatch on the selected type
 
 ## Optional[T]: Simple Optional Parameters
@@ -180,10 +185,10 @@ def train(checkpoint: Optional[str] = None, epochs: int = 10):
 --camera:PerspectiveCamera      # Exact match
 --camera:perspective-camera     # kebab-case
 --camera:perspectivecamera      # lowercase
-perspective-camera              # Positional
+perspective-camera              # Positional (recommended)
 ```
 
-**Attribute overrides** (kebab-case conversion):
+**Attribute overrides** (v3.2.0+: unprefixed by default):
 
 ```python
 @dataclass
@@ -191,11 +196,37 @@ class Config:
     batch_size: int = 32          # Python: snake_case
     learning_rate: float = 0.001
 
-# CLI uses kebab-case
+# CLI uses kebab-case (unprefixed by default)
+--batch-size 64
+--learning-rate 0.01
+
+# Prefixed syntax still works
 --config.batch-size 64
 --config.learning-rate 0.01
 ```
 
+### Using `@proto.prefix` for Required Prefixes
+
+If you want to **require** prefixed syntax for a class (e.g., for disambiguation), decorate it with `@proto.prefix`:
+
+```python
+@proto.prefix  # Now requires --config.batch-size syntax
+@dataclass
+class Config:
+    batch_size: int = 32
+
+@dataclass
+class Model:
+    batch_size: int = 16  # Same attr name, no conflict
+
+@proto.cli
+def train(config: Config, model: Model):
+    pass
+
+# CLI: Config requires prefix, Model doesn't
+# python train.py config model --config.batch-size 64 --batch-size 32
+```
+
 ## Examples
 
 ### Example 1: Optimizer Selection
@@ -203,9 +234,11 @@ class Config:
 Command-line usage:
 
 ```bash
-# Choose optimizer and override defaults
-python train.py adam --optimizer.lr 0.01
-python train.py sgd --optimizer.momentum 0.95
+# Choose optimizer and override defaults (unprefixed)
+python train.py adam --lr 0.01
+python train.py sgd --momentum 0.95
+
+# Prefixed syntax also works
 python train.py --optimizer:Adam --optimizer.beta1 0.95
 ```
 
@@ -237,10 +270,10 @@ def train(optimizer: Adam | SGD):  # Union type selector
 Command-line usage:
 
 ```bash
-# Positional class selection
-python connect.py database-config --db.host prod.example.com --db.port 3306
+# Positional class selection with unprefixed attrs
+python connect.py database-config --host prod.example.com --port 3306
 
-# Or named selection
+# Or named selection with prefixed attrs
 python connect.py --db:DatabaseConfig --db.user root
 ```
 
@@ -264,11 +297,11 @@ def connect(db: DatabaseConfig):  # Single class (still uses Union mechanism)
 Command-line usage:
 
 ```bash
-# Union option + shared parameters
-python render.py perspective-camera --output scene.png --verbose
+# Union option + shared parameters (unprefixed)
+python render.py perspective-camera --fov 45 --output scene.png --verbose
 
 # Different union option with overrides
-python render.py --camera:OrthographicCamera --camera.scale 2.0 --verbose
+python render.py orthographic-camera --scale 2.0 --verbose
 
 # Help shows all options
 python render.py --help
@@ -303,6 +336,47 @@ def render(
 
 **Key point:** Union parameters are **required**, while other parameters can be optional with defaults.
 
+### Example 4: @proto.prefix Classes Require Prefixed Syntax
+
+When a Union class is decorated with `@proto.prefix`, its CLI attributes require prefixed syntax:
+
+```python
+@proto.prefix  # Requires prefixed syntax
+@dataclass
+class Train:
+    lr: float = 0.001
+    epochs: int = 100
+
+@dataclass  # Regular dataclass - unprefixed works
+class Evaluate:
+    checkpoint: str = "model.pt"
+
+@proto.cli
+def main(mode: Train | Evaluate):
+    if isinstance(mode, Train):
+        print(f"Training: lr={mode.lr}, epochs={mode.epochs}")
+    else:
+        print(f"Evaluating: {mode.checkpoint}")
+
+if __name__ == "__main__":
+    main()
+```
+
+Command-line usage:
+
+```bash
+# Train is @proto.prefix - requires prefixed syntax
+python main.py train --mode.lr 0.01 --mode.epochs 50
+
+# Evaluate is regular dataclass - unprefixed works
+python main.py evaluate --checkpoint best.pt
+```
+
+This is useful when:
+- You have multiple Union params with overlapping attribute names
+- You want explicit namespacing for clarity
+- You're using the class as a singleton config elsewhere
+
 ## Related
 
 - [Core Concepts](core-concepts) - Three main decorators

{params_proto-3.1.2 → params_proto-3.2.0}/docs/release_notes.md

@@ -2,6 +2,41 @@
 
 This page contains the release history and changelog for params-proto.
 
+## Version 3.2.0 (2025-02-01)
+
+### ✨ Features
+
+- **Unprefixed CLI Subcommand Attributes**: Subcommand attributes no longer require prefix by default
+  - Old: `python train.py train-config --config.epochs 200`
+  - New: `python train.py train-config --epochs 200`
+  - Prefixed syntax still works for backwards compatibility
+
+- **`@proto.prefix` Controls CLI Prefix Requirement**: Classes decorated with `@proto.prefix` require prefixed CLI syntax
+  - Regular dataclasses: `--epochs 200` (unprefixed)
+  - `@proto.prefix` classes: `--config.epochs 200` (prefixed required)
+
+### 🐛 Bug Fixes
+
+- **`isinstance()` for `@proto.prefix` Instances**: Fixed `isinstance(instance, DecoratedClass)` returning `False`
+  - Instances of `@proto.prefix` decorated classes now correctly pass isinstance checks
+  - Enables proper type checking in Union subcommand handlers
+
+### 🧪 Testing
+
+- Added comprehensive nested CLI subcommand tests (`test_nested_cli.py`)
+- Added parallel test execution with `pytest-xdist`
+- Run tests in parallel: `pytest -n auto`
+
+---
+
+## Version 3.1.2 (2025-01-27)
+
+### 📚 Documentation
+
+- **Claude Code Plugin**: Fixed install command format in plugin documentation
+
+---
+
 ## Version 3.1.1 (2025-01-25)
 
 ### 🐛 Bug Fixes

{params_proto-3.1.2 → params_proto-3.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "params-proto"
-version = "3.1.2"
+version = "3.2.0"
 description = "Modern Hyper Parameter Management for Machine Learning"
 authors = [
     { name = "Ge Yang" }

{params_proto-3.1.2 → params_proto-3.2.0}/skills/params-proto/SKILL.md

@@ -10,14 +10,14 @@ description: |
   (6) Work with Union types for subcommand-like CLI patterns
 ---
 
-# params-proto v3.1.1
+# params-proto v3.2.0
 
 Declarative hyperparameter management for ML experiments with automatic CLI generation.
 
 ## Installation
 
 ```bash
-pip install params-proto==3.1.1
+pip install params-proto==3.2.0
 ```
 
 ## Three Decorators

{params_proto-3.1.2 → params_proto-3.2.0}/skills/params-proto/references/cli-and-types.md

@@ -309,9 +309,39 @@ def main(mode: Train | Evaluate):
 ```
 
 ```bash
-python main.py train --lr 0.01
+# v3.2.0+: Attributes are unprefixed by default
+python main.py train --lr 0.01 --epochs 50
+python main.py evaluate --checkpoint best.pt
+
+# Prefixed syntax still works (backwards compatible)
+python main.py --mode:train --mode.lr 0.01
+```
+
+### @proto.prefix Classes Require Prefixed Syntax
+
+When a Union class is decorated with `@proto.prefix`, its attributes require prefixed CLI syntax:
+
+```python
+@proto.prefix  # Requires prefixed syntax
+@dataclass
+class Train:
+    lr: float = 0.001
+
+@dataclass  # Regular dataclass - unprefixed works
+class Evaluate:
+    checkpoint: str = "model.pt"
+
+@proto.cli
+def main(mode: Train | Evaluate):
+    ...
+```
+
+```bash
+# Train is @proto.prefix - requires prefix
+python main.py train --mode.lr 0.01
+
+# Evaluate is regular - unprefixed works
 python main.py evaluate --checkpoint best.pt
-# Also: --mode:train, --mode:Train, --mode:perspective-camera
 ```
 
 ### Enum Types

{params_proto-3.1.2 → params_proto-3.2.0}/src/params_proto/cli/cli_parse.py

@@ -164,6 +164,23 @@ def parse_cli_args(wrapper) -> Dict[str, Any]:
         is_bool = annotation == bool
         prefix_params[kebab_key] = (singleton, param_name, annotation, is_bool)
 
+  # Build unprefixed union attribute map for classes NOT decorated with @proto.prefix
+  # Maps attr-name -> (union_param_name, attr_name_underscore)
+  # Classes in _SINGLETONS are @proto.prefix decorated and require prefixed attrs
+  unprefixed_attrs = {}
+  for kebab_name, (param_name, union_classes) in union_params.items():
+    for cls in union_classes:
+      # Skip if class is a @proto.prefix singleton (requires prefixed attrs)
+      is_prefix_class = cls in _SINGLETONS.values()
+      if is_prefix_class:
+        continue
+      if hasattr(cls, "__annotations__"):
+        for attr_name in cls.__annotations__:
+          kebab_attr = attr_name.replace("_", "-")
+          # Map to the union param (first one wins if multiple unions have same attr)
+          if kebab_attr not in unprefixed_attrs:
+            unprefixed_attrs[kebab_attr] = (param_name, attr_name)
+
   # Parse arguments
   result = {}
   prefix_values = {}  # (singleton, param_name) -> value
@@ -336,6 +353,17 @@ def parse_cli_args(wrapper) -> Dict[str, Any]:
             i += 2
         continue
 
+      # Check unprefixed union attrs when cli_prefix=False
+      if key in unprefixed_attrs:
+        union_param_name, attr_name = unprefixed_attrs[key]
+        # Get the value
+        if i + 1 >= len(args):
+          raise SystemExit(f"error: argument --{key} requires a value")
+        value_str = args[i + 1]
+        union_attrs[(union_param_name, attr_name)] = value_str
+        i += 2
+        continue
+
       # Unknown argument
       raise SystemExit(f"error: unrecognized argument: {arg}")
 

{params_proto-3.1.2 → params_proto-3.2.0}/src/params_proto/hyper/sweep.py

@@ -143,6 +143,77 @@ class ParameterIterator:
     """Return number of configs (materializes list)."""
     return len(self.list)
 
+  def save(self, filename="sweep.jsonl", overwrite=True, verbose=True):
+    """
+    Save parameter configurations to JSONL file.
+
+    Args:
+        filename: Path to output file (str or PathLike)
+        overwrite: If True, overwrite existing file; if False, append
+        verbose: If True, print save confirmation
+
+    Example:
+        configs = piter @ {"lr": [0.001, 0.01]} * {"batch_size": [32, 64]}
+        configs.save("experiment.jsonl")
+    """
+    import json
+    import os
+    from urllib import parse
+
+    # Convert Path objects to string
+    filename_str = os.fspath(filename) if hasattr(os, "fspath") else str(filename)
+    configs = self.list
+
+    with open(filename_str, "w" if overwrite else "a+") as f:
+      for item in configs:
+        f.write(json.dumps(item) + "\n")
+
+    if verbose:
+      try:
+        from termcolor import colored as c
+
+        print(
+          c("saved", "blue"),
+          c(len(configs), "green"),
+          c("items to", "blue"),
+          filename_str,
+          ".",
+          "file://" + parse.quote(os.path.realpath(filename_str)),
+        )
+      except ImportError:
+        print(f"Saved {len(configs)} items to {filename_str}")
+
+  @staticmethod
+  def load(filename="sweep.jsonl"):
+    """
+    Load parameter configurations from JSONL file.
+
+    Args:
+        filename: Path to input file (str or PathLike)
+
+    Returns:
+        ParameterIterator with loaded configurations
+
+    Example:
+        configs = ParameterIterator.load("experiment.jsonl")
+        for config in configs:
+            run_experiment(**config)
+    """
+    import json
+    import os
+
+    # Convert Path objects to string
+    filename_str = os.fspath(filename) if hasattr(os, "fspath") else str(filename)
+
+    configs = []
+    with open(filename_str, "r") as f:
+      for line in f:
+        line = line.strip()
+        if line and not line.startswith("//"):
+          configs.append(json.loads(line))
+
+    return ParameterIterator(iter(configs))
+
 
 class PiterFactory:
   """

{params_proto-3.1.2 → params_proto-3.2.0}/src/params_proto/proto.py

@@ -669,20 +669,32 @@ class ptype(type):
 
     # Get the original class
     original_cls = type.__getattribute__(cls, "__proto_original_class__")
+    annotations = getattr(cls, "__proto_annotations__", {})
 
-    # Create instance
-    instance = object.__new__(original_cls)
+    # Check if this is a dataclass (has generated __init__ that accepts kwargs)
+    is_dataclass = hasattr(original_cls, "__dataclass_fields__")
 
-    # Set attributes
-    annotations = getattr(cls, "__proto_annotations__", {})
-    for name in annotations.keys():
-      if name in final_kwargs:
-        setattr(instance, name, final_kwargs[name])
-      elif hasattr(cls, "__proto_defaults__") and name in cls.__proto_defaults__:
-        setattr(instance, name, cls.__proto_defaults__[name])
-      else:
-        # Required field
-        setattr(instance, name, None)
+    if is_dataclass:
+      # For dataclasses: use the constructor directly
+      instance = original_cls(**final_kwargs)
+    else:
+      # For regular classes: create instance and set attributes manually
+      instance = object.__new__(original_cls)
+      for name in annotations.keys():
+        if name in final_kwargs:
+          setattr(instance, name, final_kwargs[name])
+        elif hasattr(cls, "__proto_defaults__") and name in cls.__proto_defaults__:
+          setattr(instance, name, cls.__proto_defaults__[name])
+        else:
+          # Required field
+          setattr(instance, name, None)
+      # Call __post_init__ if defined (dataclasses call it in __init__)
+      if hasattr(instance, '__post_init__'):
+        instance.__post_init__()
+
+    # Update the instance's class to the decorated class
+    # This allows isinstance(instance, DecoratedClass) to work
+    object.__setattr__(instance, "__class__", cls)
 
     # Copy methods from original class and wrap to return self
     for name in dir(original_cls):
@@ -722,10 +734,6 @@ class ptype(type):
 
       setattr(instance, name, make_wrapper(method))
 
-    # Call __post_init__ if defined (like dataclasses)
-    if hasattr(instance, '__post_init__'):
-      instance.__post_init__()
-
     return instance
 
 
@@ -1013,6 +1021,10 @@ def cli(obj: Any = None, *, prog: str = None):
   """
   Set up an object as a CLI entry point.
 
+  By default, subcommand attributes don't require prefix (--epochs works).
+  If the subcommand class is decorated with @proto.prefix, prefix is required
+  (--config.epochs).
+
   Args:
       obj: The class, function, or Union type to setup as CLI.
            If None, returns a decorator.

params_proto-3.2.0/tests/test_v3/conftest.py

@@ -0,0 +1,56 @@
+"""Shared fixtures for v3 CLI tests."""
+
+import subprocess
+import sys
+import tempfile
+from pathlib import Path
+
+import pytest
+
+
+@pytest.fixture
+def run_cli():
+  """Fixture for running CLI scripts in shell."""
+
+  def _run(script_content: str, args: list[str] = None, expect_error: bool = False):
+    """
+    Run a Python script with CLI arguments.
+
+    Args:
+        script_content: Python code to execute
+        args: List of command-line arguments
+        expect_error: If True, expect non-zero exit code
+
+    Returns:
+        dict with keys: stdout, stderr, returncode
+    """
+    args = args or []
+
+    with tempfile.NamedTemporaryFile(mode="w", suffix=".py", delete=False) as f:
+      f.write(script_content)
+      script_path = f.name
+
+    try:
+      result = subprocess.run(
+        [sys.executable, script_path] + args,
+        capture_output=True,
+        text=True,
+        timeout=5,
+      )
+
+      if not expect_error and result.returncode != 0:
+        pytest.fail(
+          f"Script failed with exit code {result.returncode}\n"
+          f"stdout: {result.stdout}\n"
+          f"stderr: {result.stderr}"
+        )
+
+      return {
+        "stdout": result.stdout,
+        "stderr": result.stderr,
+        "returncode": result.returncode,
+      }
+    finally:
+      Path(script_path).unlink(missing_ok=True)
+
+  return _run