just-cli 0.1.0__tar.gz

just_cli-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,37 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  build-and-publish:
+    name: Build and publish
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write 
+      contents: read
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.10"
+
+    - name: Install build tools
+      run: |
+        python -m pip install --upgrade pip
+        pip install build
+
+    - name: Build package
+      run: python -m build
+
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1

just_cli-0.1.0/.gitignore

@@ -0,0 +1,22 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# IDE-specific files
+.vscode
+.idea
+.claude
+.qoder
+
+# Environment configuration
+.env
+workspace/
+extensions/
+CLAUDE.md

just_cli-0.1.0/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: just-cli
+Version: 0.1.0
+Summary: Add your description here
+Author-email: zzzcb <zjxs.zzzcb@gmail.com>
+Requires-Python: >=3.10
+Requires-Dist: httpx
+Requires-Dist: py7zr
+Requires-Dist: python-dotenv
+Requires-Dist: rich>=14.2.0
+Requires-Dist: textual>=6.4.0
+Requires-Dist: typer>=0.20.0
+Requires-Dist: zstandard
+Description-Content-Type: text/markdown
+
+# 🛠️ JUST CLI
+
+## The simple stuff should be simple.
+
+Sick of Googling *"how to install X on XXX"* for the 47th time, only to end up copying and pasting similar commands from various official docs?
+
+Tired of copy-pasting giant commands and tapping arrow keys forever just to change one little thing?
+
+Just want an all-in-one toolkit for everyday simple tasks, instead of endlessly searching and testing Deep Research results one by one?
+
+## 📦 Installation
+
+```shell
+pip install just-cli
+```
+
+## 🚀 The Good Stuff
+
+### 1. The Toolkit
+
+#### Download Files
+```bash
+# Download with resume support and custom headers
+just download https://example.com/file.zip
+just download https://example.com/file.zip -H "Authorization: Bearer token" -o myfile.zip
+```
+
+#### Extract Archives
+```bash
+# Automatic format detection - ZIP, TAR, GZ, BZ2, XZ, ZSTD, 7Z
+just extract archive.tar.gz
+just extract data.7z -o out/
+```
+
+#### Edit Files
+```bash
+# Beautiful TUI editor
+just edit README.md
+```
+
+#### View Files
+```bash
+# Preview markdown with syntax highlighting
+just view README.md
+```
+
+#### Linux Commands (for Windows users)
+```bash
+just ls
+just cat
+just mkdir
+just cp
+just mv
+just rm
+```
+
+### 2. The Extension System
+
+This is where the magic happens. You can turn *any* complex shell command into a beautiful, typed `just` command.
+
+Imagine you have a command you use all the time, like checking a Docker container's IP:
+```bash
+docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' f523e75ca4ef
+```
+*Gross.*
+
+Now, wave your wand:
+```bash
+just ext add docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' f523e75ca4ef
+> just docker ip f523e75ca4ef[container_id:str#The container ID]
+```
+
+Now you have a new command:
+```bash
+just docker ip my-container
+```
+
+It even generates help messages!
+```bash
+just docker ip --help
+```
+
+## 🤝 Contributing
+
+Found a bug? Want to add a new installer?
+Fork it, fix it, ship it. We love PRs.
+Just keep it cool, keep it simple, and don't break the "just works" vibe.
+
+## 📄 License
+
+MIT. Go wild.
+

just_cli-0.1.0/README.md

@@ -0,0 +1,92 @@
+# 🛠️ JUST CLI
+
+## The simple stuff should be simple.
+
+Sick of Googling *"how to install X on XXX"* for the 47th time, only to end up copying and pasting similar commands from various official docs?
+
+Tired of copy-pasting giant commands and tapping arrow keys forever just to change one little thing?
+
+Just want an all-in-one toolkit for everyday simple tasks, instead of endlessly searching and testing Deep Research results one by one?
+
+## 📦 Installation
+
+```shell
+pip install just-cli
+```
+
+## 🚀 The Good Stuff
+
+### 1. The Toolkit
+
+#### Download Files
+```bash
+# Download with resume support and custom headers
+just download https://example.com/file.zip
+just download https://example.com/file.zip -H "Authorization: Bearer token" -o myfile.zip
+```
+
+#### Extract Archives
+```bash
+# Automatic format detection - ZIP, TAR, GZ, BZ2, XZ, ZSTD, 7Z
+just extract archive.tar.gz
+just extract data.7z -o out/
+```
+
+#### Edit Files
+```bash
+# Beautiful TUI editor
+just edit README.md
+```
+
+#### View Files
+```bash
+# Preview markdown with syntax highlighting
+just view README.md
+```
+
+#### Linux Commands (for Windows users)
+```bash
+just ls
+just cat
+just mkdir
+just cp
+just mv
+just rm
+```
+
+### 2. The Extension System
+
+This is where the magic happens. You can turn *any* complex shell command into a beautiful, typed `just` command.
+
+Imagine you have a command you use all the time, like checking a Docker container's IP:
+```bash
+docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' f523e75ca4ef
+```
+*Gross.*
+
+Now, wave your wand:
+```bash
+just ext add docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' f523e75ca4ef
+> just docker ip f523e75ca4ef[container_id:str#The container ID]
+```
+
+Now you have a new command:
+```bash
+just docker ip my-container
+```
+
+It even generates help messages!
+```bash
+just docker ip --help
+```
+
+## 🤝 Contributing
+
+Found a bug? Want to add a new installer?
+Fork it, fix it, ship it. We love PRs.
+Just keep it cool, keep it simple, and don't break the "just works" vibe.
+
+## 📄 License
+
+MIT. Go wild.
+

just_cli-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[project]
+name = "just-cli"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+authors = [
+    { name = "zzzcb", email = "zjxs.zzzcb@gmail.com" }
+]
+requires-python = ">=3.10"
+dependencies = [
+    "httpx",
+    "python-dotenv",
+    "py7zr",
+    "rich>=14.2.0",
+    "textual>=6.4.0",
+    "typer>=0.20.0",
+    "zstandard",
+]
+
+[project.scripts]
+just = "just.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/just"]

just_cli-0.1.0/scripts/system/linux/proxy/proxy.sh

@@ -0,0 +1,137 @@
+#!/bin/bash
+
+# Proxy Control Functions
+# Source this file to use: source proxy.sh
+# Or install to ~/.bashrc for permanent availability
+
+# Set proxy variables from environment or use default
+HTTP_PROXY_URL=${HTTP_PROXY_URL:-"http://127.0.0.1:7890"}
+HTTPS_PROXY_URL=${HTTPS_PROXY_URL:-$HTTP_PROXY_URL}
+
+# Proxy control function
+proxy() {
+    case "${1,,}" in
+        on)
+            export HTTP_PROXY=$HTTP_PROXY_URL
+            export HTTPS_PROXY=$HTTPS_PROXY_URL
+            export http_proxy=$HTTP_PROXY_URL
+            export https_proxy=$HTTPS_PROXY_URL
+            echo -e "\033[32m[ON]\033[0m HTTP  Proxy $HTTP_PROXY enabled in Bash"
+            echo -e "\033[32m[ON]\033[0m HTTPS Proxy $HTTPS_PROXY enabled in Bash"
+            ;;
+        off)
+            if [[ -n "$HTTP_PROXY" ]]; then
+                echo -e "\033[31m[OFF]\033[0m HTTP  Proxy $HTTP_PROXY disabled in Bash"
+                echo -e "\033[31m[OFF]\033[0m HTTPS Proxy $HTTPS_PROXY disabled in Bash"
+            else
+                echo -e "\033[31m[OFF]\033[0m Proxy disabled in Bash"
+            fi
+            unset HTTP_PROXY HTTPS_PROXY http_proxy https_proxy
+            ;;
+        uninstall)
+            uninstall_proxy
+            ;;
+        -h|h|help|"")
+            echo
+            echo "Proxy Control Function"
+            echo "=========================================="
+            echo "Usage:"
+            echo "  proxy on         - Enable proxy"
+            echo "  proxy off        - Disable proxy"
+            echo "  proxy uninstall  - Uninstall CLI"
+            echo
+            echo "Current HTTP_PROXY : $HTTP_PROXY_URL"
+            echo "Current HTTPS_PROXY: $HTTPS_PROXY_URL"
+            echo "=========================================="
+            ;;
+        install)
+            echo -e "\033[31m[ERROR]\033[0m Use 'bash proxy.sh install' instead"
+            ;;
+        *)
+            echo "Invalid argument: $1"
+            echo
+            echo "Usage: proxy [on|off|uninstall|-h]"
+            ;;
+    esac
+}
+
+install_proxy() {
+    local bashrc="$HOME/.bashrc"
+
+    # Get absolute path in a more compatible way
+    local script_path="$0"
+    if [[ "$script_path" != /* ]]; then
+        script_path="$(pwd)/$script_path"
+    fi
+
+    # Normalize path to remove ./ components
+    script_path="${script_path//\/.\//\/}"
+
+    # Check if already installed
+    if grep -q "# Proxy Control Functions - Installed by proxy.sh" "$bashrc" 2>/dev/null; then
+        echo -e "\033[33m[WARN]\033[0m Proxy already installed in $bashrc"
+        return 1
+    fi
+
+    # Add installation marker and source command
+    echo "" >> "$bashrc"
+    echo "# Proxy Control Functions - Installed by proxy.sh" >> "$bashrc"
+    echo "source \"$script_path\"" >> "$bashrc"
+    echo "# End of Proxy Control Functions" >> "$bashrc"
+
+    echo -e "\033[32m[OK]\033[0m Proxy installed to $bashrc"
+    echo "Restart your terminal or run: source ~/.bashrc"
+}
+
+uninstall_proxy() {
+    local bashrc="$HOME/.bashrc"
+
+    # Check if installed
+    if ! grep -q "# Proxy Control Functions - Installed by proxy.sh" "$bashrc" 2>/dev/null; then
+        echo -e "\033[33m[WARN]\033[0m Proxy not found in $bashrc"
+        return 1
+    fi
+
+    # Remove installation
+    sed -i '/# Proxy Control Functions - Installed by proxy.sh/,/# End of Proxy Control Functions/d' "$bashrc"
+
+    echo -e "\033[32m[OK]\033[0m Proxy uninstalled from $bashrc"
+    echo "Restart your terminal or run: source ~/.bashrc"
+}
+
+# Show help when script is executed without arguments
+show_script_help() {
+    echo
+    echo "Proxy Control Script"
+    echo "=========================================="
+    echo "Usage:"
+    echo "  bash proxy.sh install    - Install CLI"
+    echo "  bash proxy.sh uninstall  - Uninstall CLI"
+    echo
+    echo "Current HTTP_PROXY : $HTTP_PROXY_URL"
+    echo "Current HTTPS_PROXY: $HTTPS_PROXY_URL"
+    echo "=========================================="
+}
+
+# Main execution logic
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    # Script is being executed directly
+    case "${1,,}" in
+        install)
+            install_proxy
+            ;;
+        uninstall)
+            uninstall_proxy
+            ;;
+        -h|h|help|"")
+            show_script_help
+            ;;
+        *)
+            proxy "$@"
+            ;;
+    esac
+else
+    # Script is being sourced
+    # Only define the proxy function, not install/uninstall
+    :
+fi

just_cli-0.1.0/scripts/system/windows/proxy/proxy.bat

@@ -0,0 +1,56 @@
+@echo off
+
+:: Set proxy variables from environment or use default
+if defined HTTP_PROXY_URL (
+    set HTTP_PROXY_URL=%HTTP_PROXY_URL%
+) else (
+    set HTTP_PROXY_URL=http://127.0.0.1:7890
+)
+
+if defined HTTPS_PROXY_URL (
+    set HTTPS_PROXY_URL=%HTTPS_PROXY_URL%
+) else (
+    set HTTPS_PROXY_URL=%HTTP_PROXY_URL%
+)
+
+if /i "%1"=="on" (
+    call :EnableProxy
+) else if /i "%1"=="off" (
+    call :DisableProxy
+) else (
+    call :ShowHelp
+    exit /b 0
+)
+
+exit /b 0
+
+:ShowHelp
+echo.
+echo Proxy Control Script
+echo ==========================================
+echo Usage:
+echo   %~nx0 on     - Enable proxy
+echo   %~nx0 off    - Disable proxy
+echo.
+echo Current HTTP_PROXY : %HTTP_PROXY_URL%
+echo Current HTTPS_PROXY: %HTTPS_PROXY_URL%
+echo ==========================================
+exit /b 0
+
+:EnableProxy
+set HTTP_PROXY=%HTTP_PROXY_URL%
+set HTTPS_PROXY=%HTTPS_PROXY_URL%
+echo [ON] HTTP  Proxy %HTTP_PROXY% enabled in CMD
+echo [ON] HTTPS Proxy %HTTPS_PROXY% enabled in CMD
+exit /b 0
+
+:DisableProxy
+if defined HTTP_PROXY (
+    echo [OFF] HTTP  Proxy %HTTP_PROXY% disabled in CMD
+    echo [OFF] HTTPS Proxy %HTTPS_PROXY% disabled in CMD
+    set HTTP_PROXY=
+    set HTTPS_PROXY=
+) else (
+    echo [OFF] Proxy disabled in CMD
+)
+exit /b 0

just_cli-0.1.0/scripts/system/windows/proxy/proxy.ps1

@@ -0,0 +1,58 @@
+# Parse command line arguments manually to handle -h properly
+$Action = $args[0]
+
+# Set proxy variables from environment or use default
+$HTTP_PROXY_URL = if ($env:HTTP_PROXY_URL) { $env:HTTP_PROXY_URL } else { "http://127.0.0.1:7890" }
+$HTTPS_PROXY_URL = if ($env:HTTPS_PROXY_URL) { $env:HTTPS_PROXY_URL } else { $HTTP_PROXY_URL }
+
+function Show-Help {
+    Write-Host ""
+    Write-Host "Proxy Control Script"
+    Write-Host "=========================================="
+    Write-Host "Usage:"
+    Write-Host "  proxy.ps1 on     - Enable proxy"
+    Write-Host "  proxy.ps1 off    - Disable proxy"
+    Write-Host ""
+    Write-Host "Current HTTP_PROXY : $HTTP_PROXY_URL"
+    Write-Host "Current HTTPS_PROXY: $HTTPS_PROXY_URL"
+    Write-Host "=========================================="
+}
+
+function Enable-Proxy {
+    $env:HTTP_PROXY = $HTTP_PROXY_URL
+    $env:HTTPS_PROXY = $HTTPS_PROXY_URL
+    Write-Host "[ON]" -ForegroundColor Green -NoNewline
+    Write-Host " HTTP  Proxy $env:HTTP_PROXY enabled in PowerShell"
+    Write-Host "[ON]" -ForegroundColor Green -NoNewline
+    Write-Host " HTTPS Proxy $env:HTTPS_PROXY enabled in PowerShell"
+}
+
+function Disable-Proxy {
+    $currentProxy = $env:HTTP_PROXY
+    if ($currentProxy) {
+        Write-Host "[OFF]" -ForegroundColor Red -NoNewline
+        Write-Host " HTTP  Proxy $env:HTTP_PROXY disabled in PowerShell"
+        Write-Host "[OFF]" -ForegroundColor Red -NoNewline
+        Write-Host " HTTPS Proxy $env:HTTPS_PROXY disabled in PowerShell"
+    } else {
+        Write-Host "[OFF]" -ForegroundColor Red -NoNewline
+        Write-Host " Proxy disabled in PowerShell"
+    }
+    Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue
+    Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue
+}
+
+# Main logic
+if (-not $Action -or $Action -eq "" -or $Action -eq "-h" -or $Action -eq "h" -or $Action -eq "help") {
+    Show-Help
+} else {
+    switch ($Action) {
+        "on" { Enable-Proxy }
+        "off" { Disable-Proxy }
+        default {
+            Write-Host "Invalid argument: $Action"
+            Write-Host ""
+            Show-Help
+        }
+    }
+}

just_cli-0.1.0/src/just/__init__.py

@@ -0,0 +1,40 @@
+from typing_extensions import Annotated
+from typer import Option, Argument
+
+from just.cli import just_cli,capture_exception
+from just.core.config import JustConfig, load_env_config, update_env_config, get_cache_dir
+from just.core.installer import installer, SimpleReleaseInstaller, BinaryInstaller
+from just.utils import (
+    SystemProbe,
+    create_typer_app,
+    confirm_action,
+    docstring,
+    download_with_resume,
+    echo,
+    extract,
+    execute_commands
+)
+
+
+config = JustConfig()
+system = SystemProbe()
+
+__all__ = [
+    "Annotated",
+    "Argument",
+    "Option",
+    "capture_exception",
+    "create_typer_app",
+    "docstring",
+    "echo",
+    "extract",
+    "execute_commands",
+    "config",
+    "just_cli",
+    "installer",
+    "SimpleReleaseInstaller",
+    "BinaryInstaller",
+    "load_env_config",
+    "update_env_config",
+    "system"
+]

just_cli-0.1.0/src/just/cli.py

@@ -0,0 +1,79 @@
+import functools
+import importlib
+import os
+import traceback
+
+from pathlib import Path
+from typer.core import TyperGroup
+from typing import Any, Callable, List, TypeVar, Optional
+
+from just.core.config import load_env_config, get_command_dir, get_extension_dir
+from just.utils import echo
+from just.utils.typer_utils import create_typer_app
+
+
+just_cli = create_typer_app()
+
+T = TypeVar('T')
+
+
+def capture_exception(func: Callable[..., T]) -> Callable[..., Optional[T]]:
+    @functools.wraps(func)
+    def wrapper(*args: Any, **kwargs: Any) -> Optional[T]:
+        try:
+            return func(*args, **kwargs)
+        except Exception as e:
+            echo.error(str(e))
+            exit(1)
+
+    return wrapper
+
+
+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)
+
+
+def traverse_script_dir(directory: str) -> List[str]:
+    script_modules = []
+    for root, dirs, files in os.walk(directory):
+        for file in files:
+            if not file.startswith('_') and file.endswith(".py"):
+                script_modules.append(
+                    "just." +
+                    '.'.join(Path(root).relative_to(Path(__file__).parent).parts) +
+                    f".{str(Path(file).stem)}"
+                )
+    return script_modules
+
+
+
+def main():
+    # Dynamically import all script modules to register their commands
+    script_modules = []
+    script_modules.extend(traverse_script_dir(get_command_dir().as_posix()))
+    script_modules.extend(traverse_script_dir(get_extension_dir().as_posix()))
+    script_modules.sort()
+    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
+    # Run the CLI application
+    run_just_cli()