devs-cli 1.1.3__tar.gz

devs_cli-1.1.3/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_cli-1.1.3/PKG-INFO

@@ -0,0 +1,185 @@
+Metadata-Version: 2.4
+Name: devs-cli
+Version: 1.1.3
+Summary: DevContainer Management Tool - Manage multiple named devcontainers for any project
+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/cli
+Keywords: devcontainer,docker,vscode,development
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+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
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0.0
+Requires-Dist: devs-common>=0.1.0
+Requires-Dist: rich>=12.0.0
+Requires-Dist: pathspec>=0.10.0
+Requires-Dist: PyYAML>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: build>=0.10.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Dynamic: license-file
+
+# devs - DevContainer Management Tool
+
+A Python command-line tool that simplifies managing multiple named devcontainers for any project.
+
+## Features
+
+- **Multiple Named Containers**: Start multiple devcontainers with custom names (e.g., "sally", "bob", "charlie")
+- **VS Code Integration**: Open containers in separate VS Code windows with clear titles
+- **Project Isolation**: Containers are prefixed with git repository names (org-repo format)
+- **Environment Variable Management**: Layered DEVS.yml configuration with user-specific overrides
+- **Shared Authentication**: Claude credentials are shared between containers for the same project
+- **Cross-Platform**: Works on any project with devcontainer configuration
+
+## Installation
+
+```bash
+pip install devs
+```
+
+## Usage
+
+```bash
+# Start development environments
+devs start frontend backend
+
+# Open both in VS Code (separate windows)
+devs vscode frontend backend
+
+# Work in a specific container
+devs shell frontend
+
+# Run Claude in a container
+devs claude frontend "Summarize this codebase"
+
+# Run tests in a container
+devs runtests frontend
+
+# Environment variables support
+devs start frontend --env DEBUG=true --env API_URL=http://localhost:3000
+devs claude frontend "Fix the tests" --env NODE_ENV=test
+
+# Set up Claude authentication (once per host)
+devs claude --auth
+# Or with API key
+devs claude --auth --api-key <YOUR_API_KEY>
+
+# Clean up when done
+devs stop frontend backend
+
+# List active containers
+devs list
+```
+
+## Configuration
+
+### Environment Variables
+
+devs supports layered environment variable configuration through DEVS.yml files:
+
+**Priority order (highest to lowest):**
+1. CLI `--env` flags
+2. `~/.devs/envs/{org-repo}/DEVS.yml` (user-specific project overrides)
+3. `~/.devs/envs/default/DEVS.yml` (user defaults)
+4. `{project-root}/DEVS.yml` (repository configuration)
+
+**Example DEVS.yml in your project:**
+```yaml
+env_vars:
+  default:
+    NODE_ENV: development
+    API_URL: https://api.example.com
+    DEBUG: "false"
+  
+  frontend:  # Container-specific overrides
+    DEBUG: "true"
+    FRONTEND_PORT: "3000"
+    
+  backend:
+    NODE_ENV: production
+    API_URL: https://prod-api.example.com
+```
+
+**User-specific configuration:**
+```bash
+# Global user defaults
+mkdir -p ~/.devs/envs/default
+echo 'env_vars:
+  default:
+    GLOBAL_SETTING: "user_preference"
+    MY_SECRET: "user_secret"' > ~/.devs/envs/default/DEVS.yml
+
+# Project-specific overrides (org-repo format)
+mkdir -p ~/.devs/envs/myorg-myproject
+echo 'env_vars:
+  frontend:
+    DEBUG: "true"
+    LOCAL_SECRET: "dev_secret"' > ~/.devs/envs/myorg-myproject/DEVS.yml
+```
+
+📖 **[See ../../example-usage.md for detailed examples and scenarios](../../example-usage.md)**
+
+## Requirements
+
+- **Docker**: Container runtime
+- **VS Code**: With `code` command in PATH
+- **DevContainer CLI**: `npm install -g @devcontainers/cli`
+- **Project Requirements**: `.devcontainer/devcontainer.json` in target projects
+
+## Architecture
+
+### Container Naming
+Containers follow the pattern: `dev-<org>-<repo>-<dev-name>`
+
+Example: `dev-ideonate-devs-sally`, `dev-ideonate-devs-bob`
+
+### VS Code Window Management
+Each container gets unique workspace paths to ensure VS Code treats them as separate sessions.
+
+### Claude Authentication Sharing
+The tool creates symlinks so all containers for the same project share Claude authentication.
+
+## Development
+
+```bash
+# Clone repository
+git clone https://github.com/ideonate/devs.git
+cd devs/python-devs
+
+# Install in development mode
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Format code
+black devs tests
+
+# Type checking
+mypy devs
+```
+
+## License
+
+MIT License

devs_cli-1.1.3/README.md

@@ -0,0 +1,144 @@
+# devs - DevContainer Management Tool
+
+A Python command-line tool that simplifies managing multiple named devcontainers for any project.
+
+## Features
+
+- **Multiple Named Containers**: Start multiple devcontainers with custom names (e.g., "sally", "bob", "charlie")
+- **VS Code Integration**: Open containers in separate VS Code windows with clear titles
+- **Project Isolation**: Containers are prefixed with git repository names (org-repo format)
+- **Environment Variable Management**: Layered DEVS.yml configuration with user-specific overrides
+- **Shared Authentication**: Claude credentials are shared between containers for the same project
+- **Cross-Platform**: Works on any project with devcontainer configuration
+
+## Installation
+
+```bash
+pip install devs
+```
+
+## Usage
+
+```bash
+# Start development environments
+devs start frontend backend
+
+# Open both in VS Code (separate windows)
+devs vscode frontend backend
+
+# Work in a specific container
+devs shell frontend
+
+# Run Claude in a container
+devs claude frontend "Summarize this codebase"
+
+# Run tests in a container
+devs runtests frontend
+
+# Environment variables support
+devs start frontend --env DEBUG=true --env API_URL=http://localhost:3000
+devs claude frontend "Fix the tests" --env NODE_ENV=test
+
+# Set up Claude authentication (once per host)
+devs claude --auth
+# Or with API key
+devs claude --auth --api-key <YOUR_API_KEY>
+
+# Clean up when done
+devs stop frontend backend
+
+# List active containers
+devs list
+```
+
+## Configuration
+
+### Environment Variables
+
+devs supports layered environment variable configuration through DEVS.yml files:
+
+**Priority order (highest to lowest):**
+1. CLI `--env` flags
+2. `~/.devs/envs/{org-repo}/DEVS.yml` (user-specific project overrides)
+3. `~/.devs/envs/default/DEVS.yml` (user defaults)
+4. `{project-root}/DEVS.yml` (repository configuration)
+
+**Example DEVS.yml in your project:**
+```yaml
+env_vars:
+  default:
+    NODE_ENV: development
+    API_URL: https://api.example.com
+    DEBUG: "false"
+  
+  frontend:  # Container-specific overrides
+    DEBUG: "true"
+    FRONTEND_PORT: "3000"
+    
+  backend:
+    NODE_ENV: production
+    API_URL: https://prod-api.example.com
+```
+
+**User-specific configuration:**
+```bash
+# Global user defaults
+mkdir -p ~/.devs/envs/default
+echo 'env_vars:
+  default:
+    GLOBAL_SETTING: "user_preference"
+    MY_SECRET: "user_secret"' > ~/.devs/envs/default/DEVS.yml
+
+# Project-specific overrides (org-repo format)
+mkdir -p ~/.devs/envs/myorg-myproject
+echo 'env_vars:
+  frontend:
+    DEBUG: "true"
+    LOCAL_SECRET: "dev_secret"' > ~/.devs/envs/myorg-myproject/DEVS.yml
+```
+
+📖 **[See ../../example-usage.md for detailed examples and scenarios](../../example-usage.md)**
+
+## Requirements
+
+- **Docker**: Container runtime
+- **VS Code**: With `code` command in PATH
+- **DevContainer CLI**: `npm install -g @devcontainers/cli`
+- **Project Requirements**: `.devcontainer/devcontainer.json` in target projects
+
+## Architecture
+
+### Container Naming
+Containers follow the pattern: `dev-<org>-<repo>-<dev-name>`
+
+Example: `dev-ideonate-devs-sally`, `dev-ideonate-devs-bob`
+
+### VS Code Window Management
+Each container gets unique workspace paths to ensure VS Code treats them as separate sessions.
+
+### Claude Authentication Sharing
+The tool creates symlinks so all containers for the same project share Claude authentication.
+
+## Development
+
+```bash
+# Clone repository
+git clone https://github.com/ideonate/devs.git
+cd devs/python-devs
+
+# Install in development mode
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Format code
+black devs tests
+
+# Type checking
+mypy devs
+```
+
+## License
+
+MIT License

devs_cli-1.1.3/devs/__init__.py

@@ -0,0 +1,18 @@
+"""DevContainer Management Tool
+
+A command-line tool that simplifies managing multiple named devcontainers for any project.
+"""
+
+__version__ = "0.1.0"
+__author__ = "Dan Lester"
+__email__ = "dan@ideonate.com"
+
+from devs_common.core import Project, ContainerManager, WorkspaceManager
+from .core.integration import VSCodeIntegration
+
+__all__ = [
+    "Project",
+    "ContainerManager", 
+    "WorkspaceManager",
+    "VSCodeIntegration",
+]