tlpytools 0.2.0__tar.gz → 0.2.1__tar.gz

{tlpytools-0.2.0 → tlpytools-0.2.1}/.github/copilot-instructions.md

@@ -98,8 +98,8 @@ Interpretation for agent PRs:
 
 Observed result:
 - Build succeeds and produces:
-  - `dist/tlpytools-0.2.0.tar.gz`
-  - `dist/tlpytools-0.2.0-py3-none-any.whl`
+  - `dist/tlpytools-0.2.1.tar.gz`
+  - `dist/tlpytools-0.2.1-py3-none-any.whl`
 
 ### 5) Run
 - ORCA CLI (module form):

{tlpytools-0.2.0 → tlpytools-0.2.1}/.github/workflows/deploy.yml

@@ -4,7 +4,7 @@ on:
   workflow_dispatch:
     inputs:
       version:
-        description: 'Version number to release (e.g., 0.2.0)'
+        description: 'Version number to release (e.g., 0.2.1)'
         required: true
         type: string
       prerelease:

{tlpytools-0.2.0 → tlpytools-0.2.1}/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to TLPyTools will be documented in this file.
 
+## [0.2.1]
+
+### Changed
+- **ORCA logger naming improvement:**
+  - Replaced random UUID-based logger name with a git-aware identifier resolved from the ORCA project working directory
+  - Added `_resolve_logger_name()` method to `OrcaLogger` with the following priority:
+    1. Git tag pointing at HEAD → `orca_{tag}` (e.g. `orca_v0.3.0`)
+    2. Git short SHA (first 7 characters) → `orca_{sha}` (e.g. `orca_a1b2c3d`)
+    3. Random session UUID fallback → `session_{uuid8}` (e.g. `session_03d2bb45`)
+  - Git version is resolved from `os.getcwd()` (the user's project folder) rather than the tlpytools package directory
+
 ## [0.2.0]
 
 ### Changed

{tlpytools-0.2.0 → tlpytools-0.2.1}/DEVELOPER_GUIDE.md

@@ -200,7 +200,7 @@ make check-all
 4. Click **"Run workflow"** button
 5. Fill in the required information:
    - **Branch**: Select `main` (or your release branch)
-   - **Version number**: Enter the new version (e.g., `0.2.0`)
+   - **Version number**: Enter the new version (e.g., `0.2.1`)
    - **Is this a pre-release?**: Check if this is a pre-release version
 
 #### 3. Monitor the Release
@@ -219,7 +219,7 @@ After the workflow completes:
 
 ```bash
 # Verify the package is available on PyPI
-pip install tlpytools==0.2.0  # Replace with your version
+pip install tlpytools==0.2.1  # Replace with your version
 
 # Test installation in a fresh environment
 python -c "import tlpytools; print(tlpytools.__version__)"
@@ -235,8 +235,8 @@ TLPyTools follows semantic versioning (SemVer):
 
 Examples:
 - `0.1.7` → `0.1.8` (patch release)
-- `0.1.8` → `0.2.0` (minor release)
-- `0.2.0` → `1.0.0` (major release)
+- `0.1.8` → `0.2.1` (minor release)
+- `0.2.1` → `1.0.0` (major release)
 
 ### Pre-releases
 

{tlpytools-0.2.0 → tlpytools-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tlpytools
-Version: 0.2.0
+Version: 0.2.1
 Summary: TransLink's Python Tools - A comprehensive toolkit for transportation modeling and forecasting
 Project-URL: Homepage, https://github.com/TransLinkForecasting/tlpytools
 Project-URL: Bug Tracker, https://github.com/TransLinkForecasting/tlpytools/issues

{tlpytools-0.2.0 → tlpytools-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tlpytools"
-version = "0.2.0"
+version = "0.2.1"
 description = "TransLink's Python Tools - A comprehensive toolkit for transportation modeling and forecasting"
 readme = "README.md"
 requires-python = ">=3.10.0, <3.13"

{tlpytools-0.2.0 → tlpytools-0.2.1}/src/tlpytools/__init__.py

@@ -2,7 +2,7 @@
 TLPyTools - A set of tools for building models at the TransLink Forecasting Team
 """
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"
 
 # Core modules that should always be available (minimal dependencies)
 from . import log

{tlpytools-0.2.0 → tlpytools-0.2.1}/src/tlpytools/orca/orchestrator.py

@@ -120,10 +120,8 @@ class OrcaLogger:
 
     def _setup_logger(self):
         """Set up the logger with consistent formatting and handlers."""
-        # Create a unique logger name for each instance to avoid conflicts
-        import uuid
-
-        logger_name = f"orca_{uuid.uuid4().hex[:8]}"
+        # Determine logger name from git tag, git SHA, or random session ID
+        logger_name = self._resolve_logger_name()
 
         # Create logger
         self._logger = logging.getLogger(logger_name)
@@ -172,6 +170,53 @@ class OrcaLogger:
 
         self._logger.info("=" * 80)
 
+    def _resolve_logger_name(self) -> str:
+        """
+        Resolve a stable logger name using git metadata when available.
+
+        Priority:
+        1. Git tag pointing at HEAD -> f"orca_{tag}"
+        2. Git SHA (first 7 chars)  -> f"orca_{sha}"
+        3. Random session UUID      -> f"session_{uuid8}"
+        """
+        project_cwd = os.getcwd()
+        try:
+            # Priority 1: git tag pointing exactly at HEAD
+            tag_result = subprocess.run(
+                ["git", "describe", "--tags", "--exact-match", "HEAD"],
+                capture_output=True,
+                text=True,
+                timeout=5,
+                cwd=project_cwd,
+            )
+            if tag_result.returncode == 0:
+                git_version = tag_result.stdout.strip()
+                if git_version:
+                    return f"orca_{git_version}"
+        except Exception:
+            pass
+
+        try:
+            # Priority 2: short git SHA (7 characters)
+            sha_result = subprocess.run(
+                ["git", "rev-parse", "--short=7", "HEAD"],
+                capture_output=True,
+                text=True,
+                timeout=5,
+                cwd=project_cwd,
+            )
+            if sha_result.returncode == 0:
+                git_sha = sha_result.stdout.strip()
+                if git_sha:
+                    return f"orca_{git_sha}"
+        except Exception:
+            pass
+
+        # Priority 3: random session UUID fallback
+        import uuid
+
+        return f"session_{uuid.uuid4().hex[:8]}"
+
     def _log_system_info(self):
         """
         Log detailed system information.

{tlpytools-0.2.0 → tlpytools-0.2.1}/uv.lock

@@ -4601,7 +4601,7 @@ wheels = [
 
 [[package]]
 name = "tlpytools"
-version = "0.2.0"
+version = "0.2.1"
 source = { editable = "." }
 dependencies = [
     { name = "azure-core" },