just-cli 0.3.1__tar.gz → 0.5.0__tar.gz

just_cli-0.5.0/.claude/settings.local.json

@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(just install:*)",
+      "mcp__plugin_context7_context7__resolve-library-id"
+    ]
+  }
+}

{just_cli-0.3.1 → just_cli-0.5.0}/.gitignore

@@ -21,4 +21,7 @@ workspace/
 extensions/
 CLAUDE.md
 
-.DS_Store
+.DS_Store
+
+.claude/worktrees
+.claude/settings.json

just_cli-0.5.0/PKG-INFO

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: just-cli
+Version: 0.5.0
+Summary: Your all-in-one CLI Toolkit
+Author-email: zzzcb <zjxs.zzzcb@gmail.com>
+Requires-Python: >=3.10
+Requires-Dist: httpx
+Requires-Dist: prompt-toolkit>=3.0.0
+Requires-Dist: py7zr
+Requires-Dist: python-dotenv
+Requires-Dist: rich>=14.2.0
+Requires-Dist: textual>=6.4.0
+Requires-Dist: typer>=0.26.0
+Requires-Dist: zstandard
+Provides-Extra: dev
+Requires-Dist: loguru; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<h1 align="center">🛠️ JUST CLI</h1>
+
+<p align="center"><strong>The simple stuff should be simple.</strong></p>
+
+<p align="center">
+<a href="https://pypi.org/project/just-cli/"> <img src="https://img.shields.io/pypi/v/just-cli?color=blue" alt="PyPI"></a>
+<a href="https://pypi.org/project/just-cli/"> <img src="https://img.shields.io/pypi/pyversions/just-cli" alt="Python"></a>
+<img src="https://img.shields.io/badge/license-MIT-purple.svg" alt="License: MIT">
+</p>
+
+<p align="center">
+Tired of Googling "how to install X" for the 47th time, just to end up copy-pasting from official docs?
+</p>
+<p align="center">
+Tired of copy-pasting giant commands every time, just to change one little parameter?
+</p>
+<p align="center">
+Start using <b>Just</b> — an all-in-one CLI toolkit that makes everyday developer tasks <i>actually simple</i>.
+</p>
+
+---
+
+## Installation
+
+```bash
+uv tool install just-cli
+```
+
+Or with pip:
+
+```bash
+pip install just-cli
+```
+
+---
+
+## Features
+
+### 📦 Archive & Extract
+
+Create and extract archives with automatic format detection.
+
+```bash
+# Create archives — format is determined by output extension
+just archive mydir -o backup.zip
+just archive mydir -o backup.tar.gz
+just archive mydir -o backup.7z
+just archive myfile.txt -o myfile.txt.gz    # single-file compression
+
+# Extract archives — magic bytes detection, works even with wrong extensions
+just extract backup.zip
+just extract data.tar.gz -o ./output_dir
+```
+
+<details>
+<summary><strong>Supported formats</strong></summary>
+
+| Format | Archive | Extract |
+|--------|:-------:|:-------:|
+| `.zip` | ✅ | ✅ |
+| `.tar` | ✅ | ✅ |
+| `.tar.gz` / `.tgz` | ✅ | ✅ |
+| `.tar.bz2` / `.tbz2` | ✅ | ✅ |
+| `.tar.xz` / `.txz` | ✅ | ✅ |
+| `.tar.zst` / `.tzst` | ✅ | ✅ |
+| `.gz` | ✅ | ✅ |
+| `.bz2` | ✅ | ✅ |
+| `.xz` | ✅ | ✅ |
+| `.zst` | ✅ | ✅ |
+| `.7z` | ✅ | ✅ |
+
+</details>
+
+### 📥 Download
+
+Like `wget` or `curl`, but with auto-resume **by default** and a progress bar.
+
+```bash
+# Filename is automatically extracted from URL, resume is on by default
+just download https://example.com/big-file.zip
+
+# Custom headers and output name
+just download https://api.example.com/data -H "Authorization: Bearer token" -o data.json
+```
+
+### 📝 Edit
+
+A lightweight TUI text editor built right in.
+
+```bash
+just edit README.md
+```
+
+![Editor Screenshot](docs/images/editor_demo.png)
+
+### 📖 View
+
+Smart file viewer with syntax highlighting, TOC, and structured rendering.
+
+```bash
+just view README.md          # Markdown
+just view data.json          # JSON
+just view config.xml         # XML
+```
+
+![Viewer Screenshot](docs/images/viewer_demo.png)
+
+### 🌐 Tunnel
+
+Expose your local server to the internet via Cloudflare Tunnel.
+
+```bash
+just tunnel http://localhost:8000
+```
+
+### 🐧 File Operations
+
+Common file commands, cross-platform, no syntax surprises.
+
+```bash
+just cat file.txt
+just ls
+just cp src dst
+just mv old new
+just rm file
+just mkdir dir
+```
+
+### 📒 Notes
+
+Quick notes stored in `~/.just/notes`.
+
+```bash
+just note
+```
+
+![Note Screenshot](docs/images/note_demo.png)
+
+### 🧩 Extension System
+
+Turn any long command into a reusable, type-safe CLI in 2 steps.
+
+**1. Register the base command:**
+```bash
+just ext add docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' f523e75ca4ef
+```
+
+**2. Define your CLI by marking dynamic parts:**
+```text
+Enter extension commands: just docker ip f523e75ca4ef[container_id:str#The Container ID]
+```
+
+**Done.** Now use it:
+```bash
+just docker ip <container_id>
+```
+
+Under the hood, `just` generates a native Python script using typer — with auto-completion, type validation, and help messages. All from simple **string replacement**.
+
+### 💿 Installer Framework
+
+Automate installation scripts with system probing and binary/archive helpers.
+
+```python
+@just.installer(check="cloudflared --version")
+def install_cloudflared():
+    if just.system.pms.brew.is_available():
+        just.execute_commands("brew install cloudflared")
+    elif just.system.platform == 'linux':
+        just.BinaryInstaller(
+            url='https://github.com/cloudflare/cloudflared/releases/.../cloudflared-linux-amd64',
+            alias='cloudflared'
+        ).run()
+```
+
+Built-in system info:
+- `just.system.platform` → `linux`, `windows`, `darwin`
+- `just.system.arch` → `x86_64`, `aarch64`
+- `just.system.pms` → detects `winget`, `brew`, `apt`, etc.
+
+---
+
+## Contributing
+
+Found a bug? Want a new feature?
+Fork it, fix it, ship it. Keep it cool, keep it simple, don't break the *"just works"* vibe.
+
+## License
+
+[MIT](LICENSE)

just_cli-0.5.0/README.md

@@ -0,0 +1,190 @@
+<h1 align="center">🛠️ JUST CLI</h1>
+
+<p align="center"><strong>The simple stuff should be simple.</strong></p>
+
+<p align="center">
+<a href="https://pypi.org/project/just-cli/"> <img src="https://img.shields.io/pypi/v/just-cli?color=blue" alt="PyPI"></a>
+<a href="https://pypi.org/project/just-cli/"> <img src="https://img.shields.io/pypi/pyversions/just-cli" alt="Python"></a>
+<img src="https://img.shields.io/badge/license-MIT-purple.svg" alt="License: MIT">
+</p>
+
+<p align="center">
+Tired of Googling "how to install X" for the 47th time, just to end up copy-pasting from official docs?
+</p>
+<p align="center">
+Tired of copy-pasting giant commands every time, just to change one little parameter?
+</p>
+<p align="center">
+Start using <b>Just</b> — an all-in-one CLI toolkit that makes everyday developer tasks <i>actually simple</i>.
+</p>
+
+---
+
+## Installation
+
+```bash
+uv tool install just-cli
+```
+
+Or with pip:
+
+```bash
+pip install just-cli
+```
+
+---
+
+## Features
+
+### 📦 Archive & Extract
+
+Create and extract archives with automatic format detection.
+
+```bash
+# Create archives — format is determined by output extension
+just archive mydir -o backup.zip
+just archive mydir -o backup.tar.gz
+just archive mydir -o backup.7z
+just archive myfile.txt -o myfile.txt.gz    # single-file compression
+
+# Extract archives — magic bytes detection, works even with wrong extensions
+just extract backup.zip
+just extract data.tar.gz -o ./output_dir
+```
+
+<details>
+<summary><strong>Supported formats</strong></summary>
+
+| Format | Archive | Extract |
+|--------|:-------:|:-------:|
+| `.zip` | ✅ | ✅ |
+| `.tar` | ✅ | ✅ |
+| `.tar.gz` / `.tgz` | ✅ | ✅ |
+| `.tar.bz2` / `.tbz2` | ✅ | ✅ |
+| `.tar.xz` / `.txz` | ✅ | ✅ |
+| `.tar.zst` / `.tzst` | ✅ | ✅ |
+| `.gz` | ✅ | ✅ |
+| `.bz2` | ✅ | ✅ |
+| `.xz` | ✅ | ✅ |
+| `.zst` | ✅ | ✅ |
+| `.7z` | ✅ | ✅ |
+
+</details>
+
+### 📥 Download
+
+Like `wget` or `curl`, but with auto-resume **by default** and a progress bar.
+
+```bash
+# Filename is automatically extracted from URL, resume is on by default
+just download https://example.com/big-file.zip
+
+# Custom headers and output name
+just download https://api.example.com/data -H "Authorization: Bearer token" -o data.json
+```
+
+### 📝 Edit
+
+A lightweight TUI text editor built right in.
+
+```bash
+just edit README.md
+```
+
+![Editor Screenshot](docs/images/editor_demo.png)
+
+### 📖 View
+
+Smart file viewer with syntax highlighting, TOC, and structured rendering.
+
+```bash
+just view README.md          # Markdown
+just view data.json          # JSON
+just view config.xml         # XML
+```
+
+![Viewer Screenshot](docs/images/viewer_demo.png)
+
+### 🌐 Tunnel
+
+Expose your local server to the internet via Cloudflare Tunnel.
+
+```bash
+just tunnel http://localhost:8000
+```
+
+### 🐧 File Operations
+
+Common file commands, cross-platform, no syntax surprises.
+
+```bash
+just cat file.txt
+just ls
+just cp src dst
+just mv old new
+just rm file
+just mkdir dir
+```
+
+### 📒 Notes
+
+Quick notes stored in `~/.just/notes`.
+
+```bash
+just note
+```
+
+![Note Screenshot](docs/images/note_demo.png)
+
+### 🧩 Extension System
+
+Turn any long command into a reusable, type-safe CLI in 2 steps.
+
+**1. Register the base command:**
+```bash
+just ext add docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' f523e75ca4ef
+```
+
+**2. Define your CLI by marking dynamic parts:**
+```text
+Enter extension commands: just docker ip f523e75ca4ef[container_id:str#The Container ID]
+```
+
+**Done.** Now use it:
+```bash
+just docker ip <container_id>
+```
+
+Under the hood, `just` generates a native Python script using typer — with auto-completion, type validation, and help messages. All from simple **string replacement**.
+
+### 💿 Installer Framework
+
+Automate installation scripts with system probing and binary/archive helpers.
+
+```python
+@just.installer(check="cloudflared --version")
+def install_cloudflared():
+    if just.system.pms.brew.is_available():
+        just.execute_commands("brew install cloudflared")
+    elif just.system.platform == 'linux':
+        just.BinaryInstaller(
+            url='https://github.com/cloudflare/cloudflared/releases/.../cloudflared-linux-amd64',
+            alias='cloudflared'
+        ).run()
+```
+
+Built-in system info:
+- `just.system.platform` → `linux`, `windows`, `darwin`
+- `just.system.arch` → `x86_64`, `aarch64`
+- `just.system.pms` → detects `winget`, `brew`, `apt`, etc.
+
+---
+
+## Contributing
+
+Found a bug? Want a new feature?
+Fork it, fix it, ship it. Keep it cool, keep it simple, don't break the *"just works"* vibe.
+
+## License
+
+[MIT](LICENSE)

{just_cli-0.3.1 → just_cli-0.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "just-cli"
-version = "0.3.1"
+version = "0.5.0"
 description = "Your all-in-one CLI Toolkit"
 readme = "README.md"
 authors = [
@@ -14,7 +14,7 @@ dependencies = [
     "py7zr",
     "rich>=14.2.0",
     "textual>=6.4.0",
-    "typer>=0.20.0",
+    "typer>=0.26.0",
     "zstandard",
 ]
 

just_cli-0.5.0/scripts/ai_coding/agents2claude.py

@@ -0,0 +1,41 @@
+"""Rename all AGENTS.md files to CLAUDE.md under a given workspace."""
+
+import argparse
+import os
+from pathlib import Path
+
+
+def agents_to_claude(workspace: str) -> list[Path]:
+    renamed = []
+    for dirpath, _, filenames in os.walk(workspace):
+        if "AGENTS.md" in filenames:
+            old_path = Path(dirpath) / "AGENTS.md"
+            new_path = Path(dirpath) / "CLAUDE.md"
+            old_path.rename(new_path)
+            renamed.append(new_path)
+    return renamed
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        description="Rename all AGENTS.md files to CLAUDE.md under a workspace."
+    )
+    parser.add_argument(
+        "workspace",
+        nargs="?",
+        default="./",
+        help="Root directory to search (default: current directory)",
+    )
+    args = parser.parse_args()
+
+    renamed = agents_to_claude(args.workspace)
+    if renamed:
+        for path in renamed:
+            print(f"Renamed: {path}")
+        print(f"\nTotal: {len(renamed)} file(s) renamed.")
+    else:
+        print("No AGENTS.md files found.")
+
+
+if __name__ == "__main__":
+    main()

just_cli-0.5.0/scripts/ai_coding/claude2agents.py

@@ -0,0 +1,41 @@
+"""Rename all CLAUDE.md files to AGENTS.md under a given workspace."""
+
+import argparse
+import os
+from pathlib import Path
+
+
+def claude_to_agents(workspace: str) -> list[Path]:
+    renamed = []
+    for dirpath, _, filenames in os.walk(workspace):
+        if "CLAUDE.md" in filenames:
+            old_path = Path(dirpath) / "CLAUDE.md"
+            new_path = Path(dirpath) / "AGENTS.md"
+            old_path.rename(new_path)
+            renamed.append(new_path)
+    return renamed
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        description="Rename all CLAUDE.md files to AGENTS.md under a workspace."
+    )
+    parser.add_argument(
+        "workspace",
+        nargs="?",
+        default="./",
+        help="Root directory to search (default: current directory)",
+    )
+    args = parser.parse_args()
+
+    renamed = claude_to_agents(args.workspace)
+    if renamed:
+        for path in renamed:
+            print(f"Renamed: {path}")
+        print(f"\nTotal: {len(renamed)} file(s) renamed.")
+    else:
+        print("No CLAUDE.md files found.")
+
+
+if __name__ == "__main__":
+    main()

{just_cli-0.3.1 → just_cli-0.5.0}/src/just/cli.py

@@ -9,7 +9,10 @@ from typing import Any, Callable, List, TypeVar, Optional
 
 from just.core.config import load_env_config, get_command_dir, get_extension_dir, ensure_extensions_dir_exists
 from just.utils import echo
-from just.utils.typer_utils import create_typer_app
+from just.utils.typer_utils import create_typer_app, get_just_version
+
+import typer
+from typing import Annotated
 
 
 just_cli = create_typer_app()
@@ -17,6 +20,27 @@ just_cli = create_typer_app()
 T = TypeVar('T')
 
 
+def _version_callback(value: Optional[bool]):
+    if value:
+        echo.echo(f"just {get_just_version()}")
+        raise SystemExit(0)
+
+
+@just_cli.callback()
+def _main_callback(
+    version: Annotated[
+        Optional[bool],
+        typer.Option(
+            "-v", "--version",
+            help="Show version and exit",
+            is_eager=True,
+            callback=_version_callback,
+        ),
+    ] = None,
+):
+    pass
+
+
 def capture_exception(func: Callable[..., T]) -> Callable[..., Optional[T]]:
     @functools.wraps(func)
     def wrapper(*args: Any, **kwargs: Any) -> Optional[T]:
@@ -32,8 +56,8 @@ def capture_exception(func: Callable[..., T]) -> Callable[..., Optional[T]]:
 class SortedGroup(TyperGroup):
     def list_commands(self, ctx):
         return sorted(super().list_commands(ctx))
-    
-    
+
+
 def run_just_cli(*args, **kwargs):
     load_env_config()
     just_cli(*args, **kwargs)
@@ -56,11 +80,11 @@ def load_extensions_dynamically():
     extensions_dir = get_extension_dir()
     if not extensions_dir.exists():
         return
-    
+
     import sys
     if str(extensions_dir.parent) not in sys.path:
         sys.path.insert(0, str(extensions_dir.parent))
-    
+
     for root, dirs, files in os.walk(extensions_dir):
         for file in files:
             if not file.startswith('_') and file.endswith(".py"):
@@ -72,11 +96,10 @@ def load_extensions_dynamically():
                     echo.warning(f"Failed to load extension {file}: {e}")
 
 
-
 def main():
     # Ensure extensions directory exists
     ensure_extensions_dir_exists()
-    
+
     # Dynamically import all script modules to register their commands
     script_modules = []
     commands_dir = get_command_dir()
@@ -85,22 +108,20 @@ def main():
     missing_packages = []
     for module_name in script_modules:
         try:
-            # echo.debug("Importing", module_name)
             importlib.import_module(module_name)
         except ImportError as e:
             traceback.print_exc()
             package_name = e.name
             if package_name not in missing_packages:
                 missing_packages.append(package_name)
-                # Handle the case where the module cannot be found
                 echo.warning(
                     f"`{package_name}` is not installed, some sub commands are disabled, "
                     f"refer to README.md for instructions."
                 )
             continue
-    
+
     # Load extensions from ~/.just/extensions
     load_extensions_dynamically()
-    
+
     # Run the CLI application
-    run_just_cli()
+    run_just_cli()

just_cli-0.5.0/src/just/commands/archive.py

@@ -0,0 +1,57 @@
+import typer
+from pathlib import Path
+from typing import Optional
+
+from just import Annotated, just_cli, capture_exception
+from just.utils import echo
+from just.utils.archive import archive as archive_create, detect_format_by_extension, ArchiveFormat
+
+
+@just_cli.command(name="archive")
+@capture_exception
+def archive_command(
+    source: Annotated[str, typer.Argument(
+        help="Path to the file or directory to archive"
+    )],
+    output: Annotated[str, typer.Option(
+        "-o", "--output",
+        help="Output archive file path (format detected from extension)"
+    )],
+) -> None:
+    """
+    Create archives and compressed files.
+
+    Supports: ZIP, TAR (with gz/bz2/xz/zst compression), GZIP, BZIP2, XZ, ZSTD, 7Z
+
+    Format is automatically determined by the output file extension.
+    Single-file formats (gz, bz2, xz, zst) only accept a single file source.
+
+    Optional dependencies:
+    - 7Z support: pip install py7zr
+    - ZSTD support: pip install zstandard
+
+    Examples:
+        just archive mydir -o backup.zip          # Create ZIP archive
+        just archive mydir -o backup.tar.gz       # Create tar.gz archive
+        just archive myfile.txt -o myfile.txt.gz  # Compress single file with gzip
+        just archive mydir -o backup.7z           # Create 7z archive
+    """
+    source_path = Path(source)
+
+    if not source_path.exists():
+        echo.error(f"Source not found: {source}")
+        raise typer.Exit(1)
+
+    fmt = detect_format_by_extension(output)
+    if fmt is None or fmt == ArchiveFormat.UNKNOWN:
+        echo.error(f"Unknown archive format for output: {output}")
+        echo.info("Supported: .zip, .tar, .tar.gz, .tgz, .tar.bz2, .tbz, "
+                  ".tar.xz, .txz, .tar.zst, .tzst, .gz, .bz2, .xz, .zst, .7z")
+        raise typer.Exit(1)
+
+    if fmt == ArchiveFormat.RAR:
+        echo.error("RAR format is not supported for archiving")
+        raise typer.Exit(1)
+
+    if not archive_create([str(source_path)], output, base_dir=str(source_path.parent)):
+        raise Exception("Failed to create archive")