lazyops-cli 1.0.0__tar.gz

lazyops_cli-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mridul Tiwari
+
+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.

lazyops_cli-1.0.0/PKG-INFO

@@ -0,0 +1,247 @@
+Metadata-Version: 2.4
+Name: lazyops-cli
+Version: 1.0.0
+Summary: CLI to discover, fetch, and run reusable automation workflows from remote plugin packs.
+Author: Mridul Tiwari
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/MridulTi/LazyOps
+Project-URL: Repository, https://github.com/MridulTi/LazyOps
+Project-URL: Issues, https://github.com/MridulTi/LazyOps/issues
+Project-URL: Documentation, https://github.com/MridulTi/LazyOps#readme
+Keywords: cli,automation,workflows,devops,ops
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.12.0
+Requires-Dist: PyYAML>=6.0
+Dynamic: license-file
+
+# LazyOps
+
+> Turn your scattered scripts into reusable, searchable, and shareable workflows.
+
+## Why LazyOps?
+
+Every engineer has a folder full of scripts:
+
+```text
+cleanup.sh
+restart-pods.py
+rotate_logs.sh
+debug-nginx.sh
+fix-permissions.sh
+```
+
+After a few months:
+
+* You forget they exist.
+* You can't remember their arguments.
+* They're undocumented.
+* They only work on your machine.
+* Your teammates rewrite the same automation.
+
+LazyOps solves this by adding a lightweight workflow layer on top of existing scripts.
+
+No rewrites. No proprietary language. Just structure.
+
+## Features
+
+* 🚀 Run scripts as named workflows (`lazyops run pack/plugin`)
+* 📦 Install workflow **packs** (aws, kubernetes, security, …) from a remote catalog
+* 🔍 Search and list workflows across installed packs
+* 🐍 Support multiple runtimes (Bash, Python, Node.js, executables)
+* 📝 Interactive picker when you run `lazyops run` with no arguments
+* ✅ Manifest validation before execution
+* 🔖 Pin catalog version by git branch or tag (`source.ref`)
+* 🤝 Workflows live in a separate repo — share and version them independently
+
+## Architecture
+
+LazyOps is a **CLI-only installer**. Workflows are fetched at runtime from a separate plugins repo:
+
+| Repo | Role |
+|------|------|
+| [LazyOps](https://github.com/MridulTi/LazyOps) | CLI, config, fetch & run |
+| [lazyops-plugins](https://github.com/MridulTi/lazyops-plugins) | Workflow catalog (packs + plugins) |
+
+Each **pack** is a bundle (e.g. `aws`, `kubernetes`). Each **plugin** is one workflow folder under that pack. The git **branch or tag** on the plugins repo is the catalog **version**.
+
+```text
+lazyops-plugins/
+└── plugins/
+    └── aws/
+        ├── pack.yaml
+        └── addpatchclasstag/
+            ├── workflow.yaml
+            ├── script.sh
+            └── README.md
+```
+
+Run a workflow:
+
+```bash
+lazyops run aws/addpatchclasstag
+```
+
+LazyOps fetches the plugin at your configured `source.ref`, validates the manifest, and executes the script.
+
+## Installation
+
+### From PyPI (recommended)
+
+The PyPI package is **`lazyops-cli`** (the name `lazyops` is taken by another project). The command is still `lazyops`:
+
+```bash
+pipx install lazyops-cli
+lazyops --help
+```
+
+Requires Python 3.10+ and `git` (used to fetch workflows at runtime).
+
+### From source (development)
+
+LazyOps runs from a project-local virtual environment (`.venv`). Do not install with system `pip`.
+
+```bash
+git clone https://github.com/MridulTi/LazyOps.git
+cd LazyOps
+bash setup.sh
+source ~/.zshrc   # or ~/.bashrc — loads the lazyops alias
+lazyops --help    # works from any directory
+```
+
+`setup.sh` adds a global shell alias pointing at the repo wrapper (which always uses `.venv`):
+
+```bash
+alias lazyops='/path/to/LazyOps/lazyops'
+export LAZYOPS_ROOT='/path/to/LazyOps'
+```
+
+You can also run from the repo without the alias:
+
+```bash
+./lazyops --help
+source .venv/bin/activate
+```
+
+## Quick start
+
+Point LazyOps at the plugins catalog, enable packs, and run workflows:
+
+```bash
+# 1. Configure the plugins source (branch = version)
+lazyops source init https://github.com/MridulTi/lazyops-plugins.git --ref v1.0.0
+
+# 2. Enable packs you need
+lazyops pack add aws
+lazyops pack add kubernetes
+
+# 3. Discover and run
+lazyops list
+lazyops search patch
+lazyops run aws/addpatchclasstag
+lazyops run                    # interactive: pick pack → pick plugin → confirm
+
+# 4. Upgrade catalog version
+lazyops source update --ref v1.2.0
+```
+
+For local development against a checkout of lazyops-plugins:
+
+```bash
+lazyops source init file:///path/to/lazyops-plugins --ref main
+```
+
+Config is stored at `~/.lazyops/config.yaml`:
+
+```yaml
+source:
+  url: https://github.com/MridulTi/lazyops-plugins.git
+  ref: v1.0.0
+  path_prefix: plugins
+packs:
+  - aws
+  - kubernetes
+```
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `lazyops source init <url> [--ref]` | Set plugins repo URL and version |
+| `lazyops source show` | Show current source config |
+| `lazyops source update --ref <ref>` | Bump catalog version |
+| `lazyops pack add <pack>` | Enable a pack |
+| `lazyops pack list` | List installed packs |
+| `lazyops pack list <pack>` | List plugins in a pack |
+| `lazyops pack remove <pack>` | Disable a pack |
+| `lazyops run <pack>/<plugin> [args...]` | Fetch and run a workflow |
+| `lazyops run` | Interactive workflow picker |
+| `lazyops list` | List workflows in installed packs |
+| `lazyops search <query>` | Search by name, id, or description |
+
+## Example manifest
+
+```yaml
+id: addpatchclasstag
+
+name: "Add Patch Class Tag"
+
+description: "Add patch class tags to instances. Required env: AWS_REGION or REGION."
+
+runtime: bash
+
+entrypoint: script.sh
+
+pack: aws
+
+version: 1.0.0
+
+inputs:
+  - name: instance_id
+    required: true
+```
+
+## Philosophy
+
+Scripts should remain scripts.
+
+LazyOps does not replace your automation. It makes it easier to organize, discover, document, and reuse — with a shared catalog your whole team can install and pin to a version.
+
+## Roadmap
+
+* [x] Workflow specification
+* [x] Remote plugin catalog (source + packs)
+* [x] Fetch and run workflows from git
+* [x] Interactive CLI
+* [x] Search and list
+* [ ] Input validation
+* [ ] Plugin runtimes
+* [ ] Optional web dashboard
+
+## Contributing
+
+Contributions are welcome.
+
+You can help by:
+
+* Adding workflows to [lazyops-plugins](https://github.com/MridulTi/lazyops-plugins)
+* Improving CLI documentation
+* Supporting additional runtimes
+* Reporting bugs
+* Suggesting new features
+
+## License
+
+MIT License

lazyops_cli-1.0.0/README.md

@@ -0,0 +1,218 @@
+# LazyOps
+
+> Turn your scattered scripts into reusable, searchable, and shareable workflows.
+
+## Why LazyOps?
+
+Every engineer has a folder full of scripts:
+
+```text
+cleanup.sh
+restart-pods.py
+rotate_logs.sh
+debug-nginx.sh
+fix-permissions.sh
+```
+
+After a few months:
+
+* You forget they exist.
+* You can't remember their arguments.
+* They're undocumented.
+* They only work on your machine.
+* Your teammates rewrite the same automation.
+
+LazyOps solves this by adding a lightweight workflow layer on top of existing scripts.
+
+No rewrites. No proprietary language. Just structure.
+
+## Features
+
+* 🚀 Run scripts as named workflows (`lazyops run pack/plugin`)
+* 📦 Install workflow **packs** (aws, kubernetes, security, …) from a remote catalog
+* 🔍 Search and list workflows across installed packs
+* 🐍 Support multiple runtimes (Bash, Python, Node.js, executables)
+* 📝 Interactive picker when you run `lazyops run` with no arguments
+* ✅ Manifest validation before execution
+* 🔖 Pin catalog version by git branch or tag (`source.ref`)
+* 🤝 Workflows live in a separate repo — share and version them independently
+
+## Architecture
+
+LazyOps is a **CLI-only installer**. Workflows are fetched at runtime from a separate plugins repo:
+
+| Repo | Role |
+|------|------|
+| [LazyOps](https://github.com/MridulTi/LazyOps) | CLI, config, fetch & run |
+| [lazyops-plugins](https://github.com/MridulTi/lazyops-plugins) | Workflow catalog (packs + plugins) |
+
+Each **pack** is a bundle (e.g. `aws`, `kubernetes`). Each **plugin** is one workflow folder under that pack. The git **branch or tag** on the plugins repo is the catalog **version**.
+
+```text
+lazyops-plugins/
+└── plugins/
+    └── aws/
+        ├── pack.yaml
+        └── addpatchclasstag/
+            ├── workflow.yaml
+            ├── script.sh
+            └── README.md
+```
+
+Run a workflow:
+
+```bash
+lazyops run aws/addpatchclasstag
+```
+
+LazyOps fetches the plugin at your configured `source.ref`, validates the manifest, and executes the script.
+
+## Installation
+
+### From PyPI (recommended)
+
+The PyPI package is **`lazyops-cli`** (the name `lazyops` is taken by another project). The command is still `lazyops`:
+
+```bash
+pipx install lazyops-cli
+lazyops --help
+```
+
+Requires Python 3.10+ and `git` (used to fetch workflows at runtime).
+
+### From source (development)
+
+LazyOps runs from a project-local virtual environment (`.venv`). Do not install with system `pip`.
+
+```bash
+git clone https://github.com/MridulTi/LazyOps.git
+cd LazyOps
+bash setup.sh
+source ~/.zshrc   # or ~/.bashrc — loads the lazyops alias
+lazyops --help    # works from any directory
+```
+
+`setup.sh` adds a global shell alias pointing at the repo wrapper (which always uses `.venv`):
+
+```bash
+alias lazyops='/path/to/LazyOps/lazyops'
+export LAZYOPS_ROOT='/path/to/LazyOps'
+```
+
+You can also run from the repo without the alias:
+
+```bash
+./lazyops --help
+source .venv/bin/activate
+```
+
+## Quick start
+
+Point LazyOps at the plugins catalog, enable packs, and run workflows:
+
+```bash
+# 1. Configure the plugins source (branch = version)
+lazyops source init https://github.com/MridulTi/lazyops-plugins.git --ref v1.0.0
+
+# 2. Enable packs you need
+lazyops pack add aws
+lazyops pack add kubernetes
+
+# 3. Discover and run
+lazyops list
+lazyops search patch
+lazyops run aws/addpatchclasstag
+lazyops run                    # interactive: pick pack → pick plugin → confirm
+
+# 4. Upgrade catalog version
+lazyops source update --ref v1.2.0
+```
+
+For local development against a checkout of lazyops-plugins:
+
+```bash
+lazyops source init file:///path/to/lazyops-plugins --ref main
+```
+
+Config is stored at `~/.lazyops/config.yaml`:
+
+```yaml
+source:
+  url: https://github.com/MridulTi/lazyops-plugins.git
+  ref: v1.0.0
+  path_prefix: plugins
+packs:
+  - aws
+  - kubernetes
+```
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `lazyops source init <url> [--ref]` | Set plugins repo URL and version |
+| `lazyops source show` | Show current source config |
+| `lazyops source update --ref <ref>` | Bump catalog version |
+| `lazyops pack add <pack>` | Enable a pack |
+| `lazyops pack list` | List installed packs |
+| `lazyops pack list <pack>` | List plugins in a pack |
+| `lazyops pack remove <pack>` | Disable a pack |
+| `lazyops run <pack>/<plugin> [args...]` | Fetch and run a workflow |
+| `lazyops run` | Interactive workflow picker |
+| `lazyops list` | List workflows in installed packs |
+| `lazyops search <query>` | Search by name, id, or description |
+
+## Example manifest
+
+```yaml
+id: addpatchclasstag
+
+name: "Add Patch Class Tag"
+
+description: "Add patch class tags to instances. Required env: AWS_REGION or REGION."
+
+runtime: bash
+
+entrypoint: script.sh
+
+pack: aws
+
+version: 1.0.0
+
+inputs:
+  - name: instance_id
+    required: true
+```
+
+## Philosophy
+
+Scripts should remain scripts.
+
+LazyOps does not replace your automation. It makes it easier to organize, discover, document, and reuse — with a shared catalog your whole team can install and pin to a version.
+
+## Roadmap
+
+* [x] Workflow specification
+* [x] Remote plugin catalog (source + packs)
+* [x] Fetch and run workflows from git
+* [x] Interactive CLI
+* [x] Search and list
+* [ ] Input validation
+* [ ] Plugin runtimes
+* [ ] Optional web dashboard
+
+## Contributing
+
+Contributions are welcome.
+
+You can help by:
+
+* Adding workflows to [lazyops-plugins](https://github.com/MridulTi/lazyops-plugins)
+* Improving CLI documentation
+* Supporting additional runtimes
+* Reporting bugs
+* Suggesting new features
+
+## License
+
+MIT License

lazyops_cli-1.0.0/commands/list.py

@@ -0,0 +1,22 @@
+import typer
+
+from registry.catalog import CatalogError, iter_installed_workflows
+
+
+def register(app:typer.Typer):
+    
+    @app.command("list",help="List all commands")
+    def list_workflows():
+        try:
+            items = iter_installed_workflows()
+        except CatalogError as exc:
+            typer.secho(str(exc), fg=typer.colors.RED, err=True)
+            raise typer.Exit(1)
+        if not items:
+            typer.echo("No workflows found.")
+            typer.echo("Install packs: lazyops pack add aws")
+            return
+        for i, item in enumerate(items, start=1):
+            wf = item["workflow"]
+            name = wf.get("name", item["plugin"])
+            typer.echo(f"{i}. {item['pack']}/{item['plugin']} — {name}")

lazyops_cli-1.0.0/commands/pack.py

@@ -0,0 +1,75 @@
+import typer
+
+from registry import packs as pack_registry
+from registry.fetch import FetchError, list_pack_plugins
+from registry.source import SourceError, get_source
+
+pack_app = typer.Typer(help="Manage installed workflow packs (aws,kubernetes,...)")
+
+def register(app: typer.Typer):
+    app.add_typer(pack_app,name="pack")
+
+@pack_app.command("add")
+def pack_add(name:str=typer.Argument(...,help="Pack id eg. aws")):
+    try:
+        pack_registry.add_pack(name)
+    except pack_registry.PackError as exc:
+        typer.secho(str(exc),fg=typer.colors.RED, err=True)
+        raise typer.Exit(1)
+
+    typer.secho(f"Installed pack: {name}", fg=typer.colors.GREEN)
+    typer.secho("Run workflow with: lazyops run <pack>/<plugin>")
+
+@pack_app.command("list")
+def pack_list(pack: str | None = typer.Argument(None, help="Optional pack id to list plugins")):
+    if pack is None:
+        items = pack_registry.list_packs()
+        if not items:
+            typer.echo("No packs installed.")
+            typer.echo("Install one: lazyops pack add aws")
+            return
+        try:
+            source = get_source()
+        except SourceError as exc:
+            typer.secho(str(exc), fg=typer.colors.RED, err=True)
+            raise typer.Exit(1)
+        for name in items:
+            try:
+                plugins = list_pack_plugins(
+                    source["url"],
+                    source["ref"],
+                    source.get("path_prefix", "plugins"),
+                    name,
+                )
+                typer.echo(f"{name} ({len(plugins)} plugins)")
+            except FetchError as exc:
+                typer.echo(f"{name} (failed to list: {exc})")
+    else:
+        try:
+            source = get_source()
+            plugins = list_pack_plugins(
+                source["url"],
+                source["ref"],
+                source.get("path_prefix", "plugins"),
+                pack,
+            )
+        except SourceError as exc:
+            typer.secho(str(exc), fg=typer.colors.RED, err=True)
+            raise typer.Exit(1)
+        except FetchError as exc:
+            typer.secho(str(exc), fg=typer.colors.RED, err=True)
+            raise typer.Exit(1)
+        if not plugins:
+            typer.echo(f"No plugins found in pack: {pack}")
+            return
+        for plugin in plugins:
+            typer.echo(f"{pack}/{plugin}")
+
+@pack_app.command("remove")
+def pack_remove(name: str = typer.Argument(..., help="Pack id to remove")):
+    try:
+        pack_registry.remove_pack(name)
+    except pack_registry.PackError as exc:
+        typer.secho(str(exc), fg=typer.colors.RED, err=True)
+        raise typer.Exit(1)
+    typer.secho(f"Removed pack: {name}", fg=typer.colors.GREEN)