just-cli 0.4.0__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.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.4.0 → just_cli-0.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "just-cli"
-version = "0.4.0"
+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.4.0 → 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")

{just_cli-0.4.0 → just_cli-0.5.0}/src/just/commands/ext/add.py

@@ -1,6 +1,6 @@
-import shlex
 import subprocess
 import typer
+from typing import List
 
 from just import echo
 from just.core.extension.generator import generate_extension_script
@@ -14,11 +14,12 @@ def show_success(script_path, commands):
     echo.green(f"\n✅ Extension created successfully!")
     echo.cyan(f"   File: {script_path}")
     echo.echo("")
-    
+
     # Run -h to show help
     echo.echo("Help for the new extension:")
     echo.echo("-" * 40)
-    subprocess.run(['just'] + commands + ['-h'], shell=True)
+    cmd_str = ' '.join(['just'] + commands + ['-h'])
+    subprocess.run(cmd_str, shell=True)
 
 
 def add_extension(
@@ -32,6 +33,13 @@ def add_extension(
         False,
         "--tui",
         help="Launch TUI to configure the command"
+    ),
+    command: List[str] = typer.Option(
+        None,
+        "--command", "-c",
+        help="Shell command to register. May be repeated for sequential "
+             "commands (run in order, stop on first failure). "
+             "Mutually exclusive with positional command args."
     )
 ):
     """
@@ -40,6 +48,7 @@ def add_extension(
     \b
     USAGE:
         just ext add <command> [args...]
+        just ext add -c "<command>" [-c "<command>" ...]
         Enter: just <name> <syntax...>
 
     \b
@@ -60,14 +69,27 @@ def add_extension(
        -s/--source[target:type]
        → User runs --target, appends --source to command
     """
-    # Get all arguments after 'just ext add'
-    commands = ctx.args
-    
-    # If no command provided or TUI mode requested, launch TUI
-    if not commands or tui:
+    # Get all arguments after 'just ext add' (positional command tokens)
+    positional_commands = ctx.args
+
+    # -c/--command and positional args are mutually exclusive
+    if command and positional_commands:
+        echo.red("Error: -c/--command cannot be combined with positional command args.")
+        raise typer.Exit(code=1)
+
+    # If no command provided either way, or TUI mode requested, launch TUI
+    if not command and (not positional_commands or tui):
         launch_tui()
         return
 
+    # Normalize into a list of command strings.
+    # Positional tokens form a single command (joined as-is, no escaping);
+    # each -c is one complete command string as the user typed it.
+    if command:
+        commands = command
+    else:
+        commands = [' '.join(positional_commands)]
+
     # Prompt for extension syntax
     just_extension_commands = get_input("Enter extension commands: ")
     # Split the command line to handle annotations with spaces properly
@@ -76,7 +98,7 @@ def add_extension(
     # Generate the extension script, with overwrite confirmation if exists
     try:
         script_path, ext_commands = generate_extension_script(
-            shlex.join(commands),
+            commands,
             just_extension_commands,
         )
         show_success(script_path, ext_commands)
@@ -84,7 +106,7 @@ def add_extension(
         echo.yellow(f"Warning: {e}")
         if yes or confirm_action("Do you want to overwrite the existing extension?"):
             script_path, ext_commands = generate_extension_script(
-                shlex.join(commands),
+                commands,
                 just_extension_commands,
                 overwrite=True
             )