linkinpycli 0.0.1__tar.gz → 0.0.2__tar.gz

{linkinpycli-0.0.1 → linkinpycli-0.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linkinpycli
-Version: 0.0.1
+Version: 0.0.2
 Summary: CLI finder for LinkinPy integration
 Project-URL: Homepage, https://github.com/HenriquesLab/LinkinPy
 Project-URL: Repository, https://github.com/HenriquesLab/LinkinPy
@@ -15,6 +15,7 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Requires-Python: >=3.10
+Requires-Dist: pyyaml>=6.0.0
 Description-Content-Type: text/markdown
 
 # linkinpycli

{linkinpycli-0.0.1 → linkinpycli-0.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "linkinpycli"
-version = "0.0.1"
+version = "0.0.2"
 description = "CLI finder for LinkinPy integration"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -20,10 +20,13 @@ classifiers = [
     "Programming Language :: Python :: 3.10",
     "Operating System :: OS Independent",
 ]
-dependencies = []
+dependencies = [
+    "PyYAML>=6.0.0",
+]
 
 [project.scripts]
 linkinpy-parse = "linkinpycli.linkinpycli:parse_linkinpy_scripts"
+linkinpy-usage = "linkinpycli.linkinpycli:save_linkinpy_usage"
 
 [project.urls]
 Homepage = "https://github.com/HenriquesLab/LinkinPy"

{linkinpycli-0.0.1 → linkinpycli-0.0.2}/src/linkinpycli/linkinpycli.py

@@ -1,11 +1,15 @@
 from __future__ import annotations
 
+import argparse
 import inspect
 import json
+from datetime import datetime, timezone
 from importlib import import_module
 from importlib.metadata import EntryPoint
 from pathlib import Path
 
+import yaml
+
 from .crawler import find_linkinpy_entry_points
 
 
@@ -110,6 +114,59 @@ def parse_linkinpy_scripts() -> None:
     print(f"Saved {len(scripts)} scripts to {output_path}")
 
 
+def save_linkinpy_usage() -> None:
+    """Append a LinkinPy run entry to ~/.linkinpy/usage.yaml."""
+    parser = argparse.ArgumentParser(
+        prog="linkinpy-usage",
+        description="Save LinkinPy run usage metadata.",
+    )
+    parser.add_argument("--package", required=True, help="Package used in the run.")
+    parser.add_argument("--method", required=True, help="Method name used in the run.")
+    parser.add_argument(
+        "--arg",
+        dest="arguments",
+        action="append",
+        default=[],
+        metavar="KEY=VALUE",
+        help="Argument pair used in the run. Can be passed multiple times.",
+    )
+    parsed = parser.parse_args()
+
+    arguments: dict[str, str] = {}
+    for item in parsed.arguments:
+        if "=" not in item:
+            raise SystemExit(f"Invalid --arg '{item}'. Expected KEY=VALUE.")
+        key, value = item.split("=", 1)
+        key = key.strip()
+        if not key:
+            raise SystemExit(f"Invalid --arg '{item}'. KEY cannot be empty.")
+        arguments[key] = value.strip()
+
+    linkinpy_home = Path.home() / ".linkinpy"
+    linkinpy_home.mkdir(parents=True, exist_ok=True)
+    usage_path = linkinpy_home / "usage.yaml"
+
+    existing = []
+    if usage_path.exists():
+        loaded = yaml.safe_load(usage_path.read_text(encoding="utf-8"))
+        if isinstance(loaded, list):
+            existing = loaded
+
+    entry = {
+        "timestamp": datetime.now(timezone.utc).isoformat(),
+        "package": parsed.package,
+        "method": parsed.method,
+        "arguments": arguments,
+    }
+    existing.append(entry)
+
+    usage_path.write_text(
+        yaml.safe_dump(existing, sort_keys=False, allow_unicode=False),
+        encoding="utf-8",
+    )
+    print(f"Saved usage entry to {usage_path}")
+
+
 class LinkinPyCLI:
     """Minimal example class generated by the template."""
 

linkinpycli-0.0.2/tests/test_LinkinPyCLI.py

@@ -0,0 +1,2 @@
+def test_LinkinPyCLI() -> None:
+    pass

linkinpycli-0.0.1/tests/test_LinkinPyCLI.py

@@ -1,6 +0,0 @@
-from linkinpycli.linkinpycli import LinkinPyCLI
-
-def test_LinkinPyCLI() -> None:
-    my_class = LinkinPyCLI()
-    example_output = my_class.run()
-    assert example_output == 1