dyngle 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

dyngle/command/run_command.py

@@ -19,24 +19,33 @@ class RunCommand(DyngleCommand):
         if not self.provided('flow'):
             self.flow = self.app.ui.get_input('Enter flow name: ')
 
-    @DyngleCommand.wrap
-    def execute(self):
-        flows = self.app.config.get('dyngle-flows')
-
+    def _validate_flow_exists(self, flows):
+        """Validate that the requested flow exists in configuration"""
         if not flows:
             raise RuntimeError('No flows configured')
 
         if self.flow not in flows:
-            raise RuntimeError(f'Flow "{self.flow}" not found')
+            available_flows = ', '.join(flows.keys())
+            raise RuntimeError(
+                f'Flow "{self.flow}" not found. " + \
+                    f"Available flows: {available_flows}')
 
-        tasks = flows[self.flow]
+    def _execute_task(self, task_str):
+        """Execute a single task and handle errors"""
+        task_parts = task_str.split()
+        result = subprocess.run(task_parts)
 
-        for task_str in tasks:
-            # Split task string at spaces and pass to subprocess
-            task_parts = task_str.split()
-            result = subprocess.run(task_parts)
+        if result.returncode != 0:
+            raise RuntimeError(
+                f'Task failed with code {result.returncode}: {task_str}')
 
-            if result.returncode != 0:
-                raise RuntimeError(f'Task failed: {task_str}')
+    @DyngleCommand.wrap
+    def execute(self):
+        flows = self.app.config.get('dyngle-flows')
+        self._validate_flow_exists(flows)
+
+        tasks = flows[self.flow]
+        for task_str in tasks:
+            self._execute_task(task_str)
 
         return f'Flow "{self.flow}" completed successfully'

dyngle-0.1.2.dist-info/METADATA

@@ -0,0 +1,87 @@
+Metadata-Version: 2.3
+Name: dyngle
+Version: 0.1.2
+Summary: Run lightweight local workflows
+License: MIT
+Author: Steampunk Wizard
+Author-email: dyngle@steamwiz.io
+Requires-Python: >=3.11,<3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Requires-Dist: requests (>=2.32.3,<3.0.0)
+Requires-Dist: wizlib (>=3.1.4,<4.0.0)
+Description-Content-Type: text/markdown
+
+# Dyngle
+
+## Run lightweight local workflows
+
+Dyngle is a simple workflow runner that executes sequences of commands defined in configuration files. It's like a lightweight combination of Make and a task runner, designed for automating common development and operational tasks.
+
+## Basic usage
+
+Create a configuration file (e.g., `config.yml`) with your workflows:
+
+```yaml
+dyngle:
+  flows:
+    build:
+      - python -m pip install -e .
+      - python -m pytest
+    deploy:
+      - docker build -t myapp .
+      - docker push myapp
+    clean:
+      - rm -rf __pycache__
+      - rm -rf .pytest_cache
+```
+
+Run a workflow:
+
+```bash
+dyngle --config config.yml run build
+```
+
+## Configuration
+
+Dyngle reads configuration from YAML files. You can specify the config file location using:
+
+- `--config` command line option
+- `DYNGLE_CONFIG` environment variable  
+- `.dyngle.yml` in current directory
+- `~/.dyngle.yml` in home directory
+
+## Workflow structure
+
+Each workflow (called a "flow") is defined as a list of tasks under `dyngle.flows`. Tasks are executed sequentially using Python's subprocess module for security.
+
+Example with multiple flows:
+
+```yaml
+dyngle:
+  flows:
+    test:
+      - python -m unittest discover
+      - python -m coverage report
+    docs:
+      - sphinx-build docs docs/_build
+      - open docs/_build/index.html
+    setup:
+      - python -m venv venv
+      - source venv/bin/activate
+      - pip install -r requirements.txt
+```
+
+## Security
+
+Commands are executed using Python's `subprocess.run()` with arguments split by spaces. The shell is not used, preventing shell injection attacks.
+
+## Quick installation (MacOS)
+
+```bash
+brew install python@3.11
+python3.11 -m pip install pipx
+pipx install kwark
+```
+

dyngle-0.1.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+dyngle/__init__.py,sha256=2KD52sWHfMhk1g1wxHdnxjRtEKeYNJn7sTPkKRpSqNA,338
+dyngle/__main__.py,sha256=mXOQ5tiUi5mEfp1NG2viz5kW2DEeWg1oCPFhfXgxJ4U,92
+dyngle/command/__init__.py,sha256=1S86gbef8MYvG-TWD5JRIWzFg7qV5xKhp9QXx9zEx5c,94
+dyngle/command/run_command.py,sha256=89GMbVcjqLLTRLvF9fVr5ehzC-1aoznS-mN2L5zzpBk,1574
+dyngle-0.1.2.dist-info/METADATA,sha256=up7gMCVwJPMWk7gYRQxcf5X9fROikh9OpIgY9XepT_4,2197
+dyngle-0.1.2.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+dyngle-0.1.2.dist-info/entry_points.txt,sha256=rekiGhtweiHKm9g1jdGb3FhzqDrk1kigJDeSNollZSA,48
+dyngle-0.1.2.dist-info/RECORD,,

dyngle-0.1.2.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+dyngle=dyngle:DyngleApp.main
+

dyngle-0.1.0.dist-info/METADATA

@@ -1,51 +0,0 @@
-Metadata-Version: 2.3
-Name: dyngle
-Version: 0.1.0
-Summary: Template
-License: MIT
-Author: Steampunk Wizard
-Author-email: dyngle@steamwiz.io
-Requires-Python: >=3.11,<3.12
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Requires-Dist: requests (>=2.32.3,<3.0.0)
-Requires-Dist: wizlib (>=3.1.4,<4.0.0)
-Description-Content-Type: text/markdown
-
-# Dyngle
-
-## Run lightweight local workflows
-
-Agentic coding rules and guidelines in `GUIDE` - browsable at https://gitlab.com/steamwiz/workshop/agentic
-
-WizLib framework as git submodule at `REFERENCES/gitlab.com/steamwiz/wizlib` for reference with docs at `REFERENCES/gitlab.com/steamwiz/wizlib/docs` - browsable at https://wizlib.steamwiz.io
-
-## Development setup
-
-Requires Python 3.11.
-
-The `Makefile` is designed for local development environment use (not for CI/CD).
-
-- `make init` - Create the virtual environment and install poetry
-- `make dependencies` - Install the required packages using poetry
-- `make` - Perform the dull style check / test / coverage cycle same as in CI/CD
-- `make build` - Create a test build
-
-GitLab CI/CD performs the entire build/test/release cycle using ProCICD.
-
-## References
-
-The `REFERENCES` directory contains git submodules for use as read-only reference material from other projects. Refer to them as appropriate.
-
-The table below contains only _examples_ of useful reference material. View direcory listings and README files to discern which specific files to read, whether documentation or code examples.
-
-| Topic | Reference |
-| --- | --- |
-| Documentation for WizLib framework | `REFERENCES/gitlab.com/steamwiz/wizlib/docs` |
-| Important testing techniques for WizLib-based applications | `REFERENCES/gitlab.com/steamwiz/wizlib/docs/testing.md` |
-| WizLib framework code | `REFERENCES/gitlab.com/steamwiz/wizlib/wizlib` |
-
-Note that this application makes heavy use of WizLib and all code changes are expected to comply with, and take advantage of, the framework.
-
-

dyngle-0.1.0.dist-info/RECORD

@@ -1,7 +0,0 @@
-dyngle/__init__.py,sha256=2KD52sWHfMhk1g1wxHdnxjRtEKeYNJn7sTPkKRpSqNA,338
-dyngle/__main__.py,sha256=mXOQ5tiUi5mEfp1NG2viz5kW2DEeWg1oCPFhfXgxJ4U,92
-dyngle/command/__init__.py,sha256=1S86gbef8MYvG-TWD5JRIWzFg7qV5xKhp9QXx9zEx5c,94
-dyngle/command/run_command.py,sha256=Nc0whPMfVQbB2YgL6UwSpxFLA94RQGd8nZ_0TMX6ldY,1182
-dyngle-0.1.0.dist-info/METADATA,sha256=OqSBTC-420XLqHhkFlNHZegnPybiZxtudCoC6iDOjGs,2054
-dyngle-0.1.0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-dyngle-0.1.0.dist-info/RECORD,,