devs-common 1.1.5__tar.gz

devs_common-1.1.5/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Dan Lester
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

devs_common-1.1.5/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: devs-common
+Version: 1.1.5
+Summary: Shared utilities for devs package ecosystem
+Author: Dan Lester
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ideonate/devs
+Project-URL: Repository, https://github.com/ideonate/devs
+Project-URL: Issues, https://github.com/ideonate/devs/issues
+Project-URL: Documentation, https://github.com/ideonate/devs/tree/main/packages/common
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: docker>=6.0.0
+Requires-Dist: GitPython>=3.1.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pathspec>=0.11.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: isort>=5.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: build>=0.10.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Dynamic: license-file
+
+# devs-common
+
+Shared utilities and core classes for the devs package ecosystem.
+
+## Components
+
+- **Core Classes**: Project, WorkspaceManager, ContainerManager
+- **Configuration**: Base configuration classes  
+- **Exceptions**: Common exception hierarchy
+- **Utilities**: Docker, Git, and file operation utilities
+
+## Usage
+
+```python
+from devs_common.core import Project, WorkspaceManager, ContainerManager
+from devs_common.config import BaseConfig
+```
+
+This package provides the shared foundation for both the devs CLI and webhook packages.

devs_common-1.1.5/README.md

@@ -0,0 +1,19 @@
+# devs-common
+
+Shared utilities and core classes for the devs package ecosystem.
+
+## Components
+
+- **Core Classes**: Project, WorkspaceManager, ContainerManager
+- **Configuration**: Base configuration classes  
+- **Exceptions**: Common exception hierarchy
+- **Utilities**: Docker, Git, and file operation utilities
+
+## Usage
+
+```python
+from devs_common.core import Project, WorkspaceManager, ContainerManager
+from devs_common.config import BaseConfig
+```
+
+This package provides the shared foundation for both the devs CLI and webhook packages.

devs_common-1.1.5/devs_common/__init__.py

@@ -0,0 +1,3 @@
+"""Shared utilities for devs package ecosystem."""
+
+__version__ = "0.1.0"

devs_common-1.1.5/devs_common/config.py

@@ -0,0 +1,90 @@
+"""Base configuration for devs ecosystem."""
+
+import os
+from pathlib import Path
+from typing import Dict, Optional
+from abc import ABC, abstractmethod
+
+
+class BaseConfig(ABC):
+    """Base configuration class for devs ecosystem packages."""
+    
+    def __init__(self) -> None:
+        """Initialize base configuration."""
+        self._workspaces_dir: Optional[Path] = None
+        self._bridge_dir: Optional[Path] = None
+        self._project_prefix: Optional[str] = None
+    
+    @property
+    def workspaces_dir(self) -> Path:
+        """Get workspaces directory."""
+        if self._workspaces_dir is None:
+            # Default can be overridden by subclasses
+            workspaces_env = os.getenv("DEVS_WORKSPACES_DIR")
+            if workspaces_env:
+                self._workspaces_dir = Path(workspaces_env)
+            else:
+                self._workspaces_dir = self.get_default_workspaces_dir()
+        return self._workspaces_dir
+    
+    @workspaces_dir.setter
+    def workspaces_dir(self, value: Path) -> None:
+        """Set workspaces directory."""
+        self._workspaces_dir = value
+    
+    @property
+    def bridge_dir(self) -> Path:
+        """Get bridge directory."""
+        if self._bridge_dir is None:
+            # Default can be overridden by subclasses
+            bridge_env = os.getenv("DEVS_BRIDGE_DIR")
+            if bridge_env:
+                self._bridge_dir = Path(bridge_env)
+            else:
+                self._bridge_dir = self.get_default_bridge_dir()
+        return self._bridge_dir
+    
+    @bridge_dir.setter
+    def bridge_dir(self, value: Path) -> None:
+        """Set bridge directory."""
+        self._bridge_dir = value
+    
+    @property
+    def project_prefix(self) -> str:
+        """Get project prefix."""
+        if self._project_prefix is None:
+            self._project_prefix = os.getenv("DEVS_PROJECT_PREFIX", self.get_default_project_prefix())
+        return self._project_prefix
+    
+    @project_prefix.setter
+    def project_prefix(self, value: str) -> None:
+        """Set project prefix."""
+        self._project_prefix = value
+    
+    @abstractmethod
+    def get_default_workspaces_dir(self) -> Path:
+        """Get default workspaces directory. Override in subclasses."""
+        pass
+    
+    @abstractmethod
+    def get_default_bridge_dir(self) -> Path:
+        """Get default bridge directory. Override in subclasses."""
+        pass
+    
+    @abstractmethod
+    def get_default_project_prefix(self) -> str:
+        """Get default project prefix. Override in subclasses."""
+        pass
+    
+    @property
+    def container_labels(self) -> Dict[str, str]:
+        """Standard labels applied to containers."""
+        return {
+            "devs.managed": "true",
+            "devs.version": "0.1.0",
+        }
+    
+    def ensure_directories(self) -> None:
+        """Ensure required directories exist."""
+        self.workspaces_dir.mkdir(parents=True, exist_ok=True)
+        self.bridge_dir.mkdir(parents=True, exist_ok=True)

devs_common-1.1.5/devs_common/core/__init__.py

@@ -0,0 +1,13 @@
+"""Core classes for devs ecosystem."""
+
+from .project import Project, ProjectInfo
+from .workspace import WorkspaceManager
+from .container import ContainerManager, ContainerInfo
+
+__all__ = [
+    "Project",
+    "ProjectInfo", 
+    "WorkspaceManager",
+    "ContainerManager",
+    "ContainerInfo",
+]