fere-cli 0.2.0.dev14__tar.gz → 0.2.0.dev17__tar.gz

{fere_cli-0.2.0.dev14 → fere_cli-0.2.0.dev17}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: fere-cli
-Version: 0.2.0.dev14
+Version: 0.2.0.dev17
 Summary: Terminal CLI for FereAI crypto trading and research
 Author-email: Fere AI <info@fere.ai>
 License-Expression: MIT
 Requires-Python: >=3.10
 Requires-Dist: click>=8.1
-Requires-Dist: fere-sdk>=0.2.0.dev14
+Requires-Dist: fere-sdk>=0.2.0.dev17
 Requires-Dist: rich>=13.0
 Provides-Extra: dev
 Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
@@ -19,11 +19,13 @@ Terminal-first interface for FereAI crypto trading and research. Wraps the [Fere
 
 ## Install
 
+Recommended (script installer, handles pipx/pip and PATH setup):
+
 ```bash
 curl -fsSL https://api.fereai.xyz/install.sh | sh
 ```
 
-Or with pip:
+Manual (advanced, for humans in controlled environments only):
 
 ```bash
 pip install fere-cli

{fere_cli-0.2.0.dev14 → fere_cli-0.2.0.dev17}/README.md

@@ -4,11 +4,13 @@ Terminal-first interface for FereAI crypto trading and research. Wraps the [Fere
 
 ## Install
 
+Recommended (script installer, handles pipx/pip and PATH setup):
+
 ```bash
 curl -fsSL https://api.fereai.xyz/install.sh | sh
 ```
 
-Or with pip:
+Manual (advanced, for humans in controlled environments only):
 
 ```bash
 pip install fere-cli

fere_cli-0.2.0.dev17/install.sh

@@ -0,0 +1,272 @@
+#!/bin/sh
+# FereAI CLI Installer
+# Usage (recommended):
+#   curl -fsSL https://api.fereai.xyz/install.sh | sh
+# Install a specific version or channel:
+#   curl -fsSL https://api.fereai.xyz/install.sh | sh -s -- 1.2.3
+#   curl -fsSL https://api.fereai.xyz/install.sh | sh -s -- latest
+# Or manual install:
+#   pipx install fere-cli
+#   python -m pip install --user fere-cli
+#
+# Installs the `fere` CLI tool via pipx (recommended) or pip.
+# Supports macOS and Linux.
+#
+# Note: uses `local` keyword which is not in POSIX but is supported by
+# all target shells (dash, bash, zsh, ash) on macOS and Linux.
+
+set -eu
+
+PACKAGE="fere-cli"
+
+# Optional target/channel argument: stable (default), latest, or explicit version (X.Y.Z)
+TARGET="${1:-stable}"
+
+print_usage_and_exit() {
+    echo "Usage: install.sh [stable|latest|X.Y.Z]" >&2
+    exit 1
+}
+
+case "$TARGET" in
+    stable) ;;
+    latest) ;;
+    *)
+        echo "$TARGET" | grep -qE '^[0-9]+\.[0-9]+\.[0-9]+$' || print_usage_and_exit
+        ;;
+esac
+
+# Colors (disabled if not a TTY)
+if [ -t 1 ]; then
+    RED='\033[0;31m'
+    GREEN='\033[0;32m'
+    YELLOW='\033[0;33m'
+    DIM='\033[2m'
+    RESET='\033[0m'
+else
+    RED=''
+    GREEN=''
+    YELLOW=''
+    DIM=''
+    RESET=''
+fi
+
+info() {
+    printf "%s%s%s\n" "$DIM" "$1" "$RESET"
+}
+
+success() {
+    printf "%s%s%s\n" "$GREEN" "$1" "$RESET"
+}
+
+warn() {
+    printf "%s%s%s\n" "$YELLOW" "$1" "$RESET" >&2
+}
+
+error() {
+    printf "%sError: %s%s\n" "$RED" "$1" "$RESET" >&2
+    exit 1
+}
+
+# Detect OS
+OS="$(uname -s)"
+case "$OS" in
+    Darwin) OS_NAME="macOS" ;;
+    Linux)  OS_NAME="Linux" ;;
+    *)      error "Unsupported OS: $OS. Use 'pip install $PACKAGE' instead." ;;
+esac
+
+info "Installing FereAI CLI on ${OS_NAME} (target: ${TARGET})..."
+
+# Check Python 3.10+
+check_python() {
+    local checked="" ver major minor cmd
+    for cmd in python3 python; do
+        if command -v "$cmd" >/dev/null 2>&1; then
+            ver=$("$cmd" -c 'import sys; print("{}.{}".format(sys.version_info.major, sys.version_info.minor))' 2>/dev/null || true)
+            if [ -n "$ver" ]; then
+                major=$(printf "%s" "$ver" | cut -d. -f1)
+                minor=$(printf "%s" "$ver" | cut -d. -f2)
+                checked="${checked} $cmd($ver)"
+                if [ "$major" -gt 3 ] || { [ "$major" -eq 3 ] && [ "$minor" -ge 10 ]; }; then
+                    echo "$cmd"
+                    return 0
+                fi
+            fi
+        fi
+    done
+    warn "Checked Python interpreters:${checked}"
+    return 1
+}
+
+PYTHON=$(check_python) || error "Python 3.10+ is required. Install it from https://python.org"
+info "Found Python: $("$PYTHON" --version 2>/dev/null || echo "$PYTHON")"
+
+# Derive package spec and extra args from target
+PKG_SPEC="$PACKAGE"
+PIP_EXTRA_ARGS=""
+PIPX_EXTRA_ARGS=""
+
+case "$TARGET" in
+    stable)
+        PKG_SPEC="$PACKAGE"
+        ;;
+    latest)
+        PKG_SPEC="$PACKAGE"
+        PIP_EXTRA_ARGS="--pre"
+        # Single-token form (--opt=value) required; pipx receives it as one arg.
+        PIPX_EXTRA_ARGS="--pip-args=--pre"
+        ;;
+    *)
+        # Explicit version
+        PKG_SPEC="$PACKAGE==$TARGET"
+        ;;
+esac
+
+# Prefer pipx for isolated installs.
+# Always use --force for idempotent behavior (fresh install or reinstall).
+# This matches the pattern used by Deno, Bun, and uv installers, and avoids
+# the fragile try-then-force-retry pattern with stderr suppression.
+install_with_pipx() {
+    if command -v pipx >/dev/null 2>&1; then
+        info "Installing with pipx..."
+        if [ -n "$PIPX_EXTRA_ARGS" ]; then
+            pipx install --force "$PIPX_EXTRA_ARGS" "$PKG_SPEC" || return 1
+        else
+            pipx install --force "$PKG_SPEC" || return 1
+        fi
+        return 0
+    fi
+    return 1
+}
+
+install_pipx() {
+    info "Installing pipx..."
+    local _pipx_install_ok=0
+    if command -v brew >/dev/null 2>&1; then
+        brew install pipx && _pipx_install_ok=1
+    fi
+    # pip fallback for both macOS (if brew failed) and other systems
+    if [ "$_pipx_install_ok" != "1" ]; then
+        "$PYTHON" -m pip install --user pipx 2>/dev/null || {
+            "$PYTHON" -m ensurepip --default-pip 2>/dev/null &&
+            "$PYTHON" -m pip install --user pipx 2>/dev/null
+        } && _pipx_install_ok=1
+    fi
+    return $((1 - _pipx_install_ok))
+}
+
+install_with_pip() {
+    # Note: PIP_EXTRA_ARGS must be a single token; see PIPX_EXTRA_ARGS comment.
+    info "Installing with pip (user install)..."
+    if [ -n "$PIP_EXTRA_ARGS" ]; then
+        "$PYTHON" -m pip install --user "$PIP_EXTRA_ARGS" "$PKG_SPEC"
+    else
+        "$PYTHON" -m pip install --user "$PKG_SPEC"
+    fi
+}
+
+detect_user_bin() {
+    local user_base dir
+    # Prefer Python's user base if available
+    if command -v "$PYTHON" >/dev/null 2>&1; then
+        user_base=$("$PYTHON" -c 'import site, sys; sys.stdout.write(site.getuserbase())' 2>/dev/null || echo "")
+        if [ -n "$user_base" ] && [ -d "$user_base/bin" ]; then
+            echo "$user_base/bin"
+            return 0
+        fi
+    fi
+
+    # Common fallbacks
+    for dir in "$HOME/.local/bin" "$HOME/bin"; do
+        if [ -d "$dir" ]; then
+            echo "$dir"
+            return 0
+        fi
+    done
+
+    return 1
+}
+
+detect_shell_rc() {
+    local shell_path
+    shell_path="${SHELL:-}"
+    case "$shell_path" in
+        *zsh) echo "~/.zshrc" ;;
+        *bash)
+            if [ "$OS" = "Darwin" ]; then
+                echo "~/.bash_profile"
+            else
+                echo "~/.bashrc"
+            fi
+            ;;
+        *fish) echo "~/.config/fish/config.fish" ;;
+        *) echo "~/.profile" ;;
+    esac
+}
+
+installed_with=""
+
+# Try pipx first, then install pipx, then fall back to pip
+if install_with_pipx; then
+    installed_with="pipx"
+elif install_pipx; then
+    # Freshly-installed pipx may not be on PATH yet; resolve its location.
+    _user_base=$("$PYTHON" -c 'import site; print(site.getuserbase())' 2>/dev/null || echo "")
+    if [ -n "$_user_base" ] && [ -x "$_user_base/bin/pipx" ]; then
+        export PATH="$_user_base/bin:$PATH"
+        pipx ensurepath 2>/dev/null || true
+    fi
+    if install_with_pipx; then
+        installed_with="pipx"
+    else
+        warn "pipx not available, falling back to pip..."
+        install_with_pip || error "Installation failed. Please install manually: pip install $PACKAGE"
+        installed_with="pip"
+    fi
+else
+    warn "pipx not available, falling back to pip..."
+    install_with_pip || error "Installation failed. Please install manually: pip install $PACKAGE"
+    installed_with="pip"
+fi
+
+info "Installed $PKG_SPEC using: $installed_with"
+
+# Verify installation
+if command -v fere >/dev/null 2>&1; then
+    version_str=$(fere --version 2>/dev/null || echo "")
+    success "FereAI CLI installed successfully!"
+    if [ -n "$version_str" ]; then
+        info "Installed version: $version_str"
+    fi
+    echo ""
+    info "Get started:"
+    echo "  fere auth --name my-agent   # Set up your agent"
+    echo "  fere chat \"hello\"          # Chat with the AI"
+    echo "  fere --help                 # See all commands"
+else
+    warn "Installation complete, but 'fere' is not in PATH."
+    user_bin=$(detect_user_bin || echo "")
+    rc_file=$(detect_shell_rc)
+    echo ""
+    if [ -n "$user_bin" ]; then
+        case "$rc_file" in
+            *fish*)
+                echo "Run this command in your fish shell:"
+                echo ""
+                echo "  fish_add_path \"$user_bin\""
+                echo ""
+                echo "This takes effect immediately in all fish sessions."
+                ;;
+            *)
+                echo "To fix this, add the following line to $rc_file:"
+                echo ""
+                echo "  export PATH=\"$user_bin:\$PATH\""
+                echo ""
+                echo "Then restart your terminal or reload your shell (e.g. 'source $rc_file')."
+                ;;
+        esac
+    else
+        echo "Could not detect your user bin directory automatically."
+        echo "Make sure the directory containing the 'fere' executable is on your PATH."
+    fi
+fi

{fere_cli-0.2.0.dev14 → fere_cli-0.2.0.dev17}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "fere-cli"
-version = "0.2.0.dev14"
+version = "0.2.0.dev17"
 description = "Terminal CLI for FereAI crypto trading and research"
 readme = "README.md"
 requires-python = ">=3.10"
 license = "MIT"
 authors = [{ name = "Fere AI", email = "info@fere.ai" }]
 dependencies = [
-    "fere-sdk>=0.2.0.dev14",
+    "fere-sdk>=0.2.0.dev17",
     "click>=8.1",
     "rich>=13.0",
 ]

fere_cli-0.2.0.dev17/tests/test_install_sh.py

@@ -0,0 +1,599 @@
+import os
+import platform
+import stat
+import subprocess
+from pathlib import Path
+
+HERE = Path(__file__).resolve().parent  # tests/
+CLI_DIR = HERE.parent  # cli/
+INSTALL_SH = CLI_DIR / "install.sh"
+if not INSTALL_SH.exists():
+    import pytest
+
+    pytest.skip(
+        f"install.sh not found at {INSTALL_SH}", allow_module_level=True
+    )
+
+
+def _make_executable(path: Path, content: str) -> None:
+    path.write_text(content)
+    mode = path.stat().st_mode
+    path.chmod(mode | stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH)
+
+
+def test_install_fails_without_python(tmp_path: Path) -> None:
+    """Installer should fail when no Python is available."""
+    bin_dir = tmp_path / "bin"
+    bin_dir.mkdir(parents=True)
+    home_dir = tmp_path / "home"
+    home_dir.mkdir(parents=True)
+
+    # Symlink essential system utilities but NOT python
+    skip = {"python", "python3", "python3.11", "python3.12", "python3.13"}
+    for sysdir in ["/usr/bin", "/bin"]:
+        p = Path(sysdir)
+        if p.is_dir():
+            for entry in p.iterdir():
+                if (
+                    entry.name not in skip
+                    and not entry.name.startswith("python")
+                    and not (bin_dir / entry.name).exists()
+                ):
+                    try:
+                        (bin_dir / entry.name).symlink_to(entry)
+                    except OSError:
+                        pass
+
+    env = os.environ.copy()
+    env["PATH"] = str(bin_dir)
+    env["HOME"] = str(home_dir)
+
+    result = subprocess.run(
+        ["/bin/sh", str(INSTALL_SH)],
+        env=env,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+        text=True,
+    )
+    assert result.returncode != 0
+    out = result.stdout + result.stderr
+    assert "Python 3.10+" in out
+
+
+def test_install_prints_path_guidance_when_fere_missing(tmp_path: Path) -> None:
+    """Installer should print PATH guidance when fere is not on PATH."""
+    bin_dir = tmp_path / "bin"
+    bin_dir.mkdir(parents=True)
+    home_dir = tmp_path / "home"
+    home_dir.mkdir(parents=True)
+    # Create .local/bin so detect_user_bin finds it via getuserbase
+    local_bin = home_dir / ".local" / "bin"
+    local_bin.mkdir(parents=True)
+
+    fake_python = bin_dir / "python3"
+    _make_executable(
+        fake_python,
+        "#!/bin/sh\n"
+        'if [ "$1" = "--version" ]; then\n'
+        '  echo "Python 3.11.0"\n'
+        "  exit 0\n"
+        'elif [ "$1" = "-c" ]; then\n'
+        '  case "$2" in\n'
+        '    *version_info*) echo "3.11" ;;\n'
+        '    *getuserbase*)  printf "%s" "$HOME/.local" ;;\n'
+        '    *) echo "3.11" ;;\n'
+        "  esac\n"
+        "  exit 0\n"
+        'elif [ "$1" = "-m" ]; then\n'
+        "  exit 0\n"  # simulate successful pip/site invocations
+        "fi\n"
+        "exit 0\n",
+    )
+
+    fake_pipx = bin_dir / "pipx"
+    _make_executable(
+        fake_pipx,
+        "#!/bin/sh\n"
+        'if [ "$1" = "ensurepath" ]; then exit 0; fi\n'
+        "exit 1\n",
+    )
+
+    # Stub brew to prevent real package manager invocations on macOS
+    fake_brew = bin_dir / "brew"
+    _make_executable(fake_brew, "#!/bin/sh\nexit 1\n")
+
+    env = os.environ.copy()
+    env["PATH"] = f"{bin_dir}{os.pathsep}{env.get('PATH', '')}"
+    env["HOME"] = str(home_dir)
+    env["SHELL"] = "/bin/bash"
+
+    result = subprocess.run(
+        ["/bin/sh", str(INSTALL_SH)],
+        env=env,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+        text=True,
+    )
+    out = result.stdout + result.stderr
+    # Installer exits 0 (install succeeded) but warns fere isn't on PATH
+    assert result.returncode == 0
+    assert "Installation complete, but 'fere' is not in PATH." in out
+    # Verify specific PATH guidance (not the generic fallback)
+    assert "export PATH=" in out
+    expected_rc = (
+        ".bash_profile" if platform.system() == "Darwin" else ".bashrc"
+    )
+    assert expected_rc in out
+
+
+def test_invalid_version_argument(tmp_path: Path) -> None:
+    """Installer should reject invalid version arguments."""
+    bin_dir = tmp_path / "bin"
+    bin_dir.mkdir(parents=True)
+
+    env = os.environ.copy()
+    env["PATH"] = str(bin_dir)
+    env["HOME"] = str(tmp_path / "home")
+
+    result = subprocess.run(
+        ["/bin/sh", str(INSTALL_SH), "not-a-version"],
+        env=env,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+        text=True,
+    )
+    assert result.returncode != 0
+    out = result.stdout + result.stderr
+    assert "Usage:" in out
+
+
+def test_explicit_version_in_pkg_spec(tmp_path: Path) -> None:
+    """Passing X.Y.Z should produce fere-cli==X.Y.Z in output."""
+    bin_dir = tmp_path / "bin"
+    bin_dir.mkdir(parents=True)
+    home_dir = tmp_path / "home"
+    home_dir.mkdir(parents=True)
+    local_bin = home_dir / ".local" / "bin"
+    local_bin.mkdir(parents=True)
+
+    fake_python = bin_dir / "python3"
+    _make_executable(
+        fake_python,
+        "#!/bin/sh\n"
+        'if [ "$1" = "--version" ]; then\n'
+        '  echo "Python 3.11.0"\n'
+        "  exit 0\n"
+        'elif [ "$1" = "-c" ]; then\n'
+        '  case "$2" in\n'
+        '    *version_info*) echo "3.11" ;;\n'
+        '    *getuserbase*)  printf "%s" "$HOME/.local" ;;\n'
+        '    *) echo "3.11" ;;\n'
+        "  esac\n"
+        "  exit 0\n"
+        'elif [ "$1" = "-m" ]; then\n'
+        "  exit 0\n"
+        "fi\n"
+        "exit 0\n",
+    )
+
+    fake_pipx = bin_dir / "pipx"
+    _make_executable(
+        fake_pipx,
+        "#!/bin/sh\n"
+        'if [ "$1" = "ensurepath" ]; then exit 0; fi\n'
+        "exit 1\n",
+    )
+
+    fake_brew = bin_dir / "brew"
+    _make_executable(fake_brew, "#!/bin/sh\nexit 1\n")
+
+    env = os.environ.copy()
+    env["PATH"] = f"{bin_dir}{os.pathsep}{env.get('PATH', '')}"
+    env["HOME"] = str(home_dir)
+    env["SHELL"] = "/bin/bash"
+
+    result = subprocess.run(
+        ["/bin/sh", str(INSTALL_SH), "1.2.3"],
+        env=env,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+        text=True,
+    )
+    out = result.stdout + result.stderr
+    assert (
+        result.returncode == 0
+    ), f"Installer exited {result.returncode}:\n{out}"
+    assert "fere-cli==1.2.3" in out
+
+
+def test_install_succeeds_with_pipx(tmp_path: Path) -> None:
+    """Primary pipx install path should succeed end-to-end."""
+    bin_dir = tmp_path / "bin"
+    bin_dir.mkdir(parents=True)
+    home_dir = tmp_path / "home"
+    home_dir.mkdir(parents=True)
+
+    fake_python = bin_dir / "python3"
+    _make_executable(
+        fake_python,
+        "#!/bin/sh\n"
+        'if [ "$1" = "--version" ]; then\n'
+        '  echo "Python 3.11.0"\n'
+        "  exit 0\n"
+        'elif [ "$1" = "-c" ]; then\n'
+        '  case "$2" in\n'
+        '    *version_info*) echo "3.11" ;;\n'
+        '    *getuserbase*)  printf "%s" "$HOME/.local" ;;\n'
+        '    *) echo "3.11" ;;\n'
+        "  esac\n"
+        "  exit 0\n"
+        'elif [ "$1" = "-m" ]; then\n'
+        "  exit 0\n"
+        "fi\n"
+        "exit 0\n",
+    )
+
+    # Key difference: fake_pipx exits 0 for install (happy path)
+    fake_pipx = bin_dir / "pipx"
+    _make_executable(
+        fake_pipx,
+        "#!/bin/sh\n"
+        'if [ "$1" = "install" ]; then exit 0; fi\n'
+        'if [ "$1" = "ensurepath" ]; then exit 0; fi\n'
+        "exit 1\n",
+    )
+
+    # Provide a fake fere binary so post-install check succeeds
+    fake_fere = bin_dir / "fere"
+    _make_executable(
+        fake_fere,
+        "#!/bin/sh\n"
+        'if [ "$1" = "--version" ]; then echo "fere 0.1.0"; fi\n'
+        "exit 0\n",
+    )
+
+    fake_brew = bin_dir / "brew"
+    _make_executable(fake_brew, "#!/bin/sh\nexit 1\n")
+
+    env = os.environ.copy()
+    env["PATH"] = f"{bin_dir}{os.pathsep}{env.get('PATH', '')}"
+    env["HOME"] = str(home_dir)
+    env["SHELL"] = "/bin/bash"
+
+    result = subprocess.run(
+        ["/bin/sh", str(INSTALL_SH)],
+        env=env,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+        text=True,
+    )
+    out = result.stdout + result.stderr
+    assert (
+        result.returncode == 0
+    ), f"Installer exited {result.returncode}:\n{out}"
+    assert "Installed fere-cli using: pipx" in out
+    assert "FereAI CLI installed successfully!" in out
+    assert "falling back to pip" not in out
+
+
+def test_freshly_installed_pipx_is_found(tmp_path: Path) -> None:
+    """After install_pipx, the installer should resolve pipx in user base."""
+    bin_dir = tmp_path / "bin"
+    bin_dir.mkdir(parents=True)
+    home_dir = tmp_path / "home"
+    home_dir.mkdir(parents=True)
+    local_bin = home_dir / ".local" / "bin"
+    local_bin.mkdir(parents=True)
+
+    fake_python = bin_dir / "python3"
+    _make_executable(
+        fake_python,
+        "#!/bin/sh\n"
+        'if [ "$1" = "--version" ]; then\n'
+        '  echo "Python 3.11.0"\n'
+        "  exit 0\n"
+        'elif [ "$1" = "-c" ]; then\n'
+        '  case "$2" in\n'
+        '    *version_info*) echo "3.11" ;;\n'
+        '    *getuserbase*)  printf "%s" "$HOME/.local" ;;\n'
+        '    *site*) printf "%s" "$HOME/.local" ;;\n'
+        '    *) echo "3.11" ;;\n'
+        "  esac\n"
+        "  exit 0\n"
+        'elif [ "$1" = "-m" ]; then\n'
+        "  exit 0\n"
+        "fi\n"
+        "exit 0\n",
+    )
+
+    # No pipx on initial PATH — simulates fresh install scenario.
+    # Place pipx in ~/.local/bin (where pip --user puts it)
+    # so the installer's PATH resolution finds it after install_pipx.
+    fake_pipx = local_bin / "pipx"
+    _make_executable(
+        fake_pipx,
+        "#!/bin/sh\n"
+        'if [ "$1" = "install" ]; then exit 0; fi\n'
+        'if [ "$1" = "ensurepath" ]; then exit 0; fi\n'
+        "exit 1\n",
+    )
+
+    fake_fere = local_bin / "fere"
+    _make_executable(
+        fake_fere,
+        "#!/bin/sh\n"
+        'if [ "$1" = "--version" ]; then echo "fere 0.1.0"; fi\n'
+        "exit 0\n",
+    )
+
+    fake_brew = bin_dir / "brew"
+    _make_executable(fake_brew, "#!/bin/sh\nexit 1\n")
+
+    env = os.environ.copy()
+    # Only bin_dir on PATH — no local_bin, so pipx not initially found
+    env["PATH"] = f"{bin_dir}{os.pathsep}{env.get('PATH', '')}"
+    env["HOME"] = str(home_dir)
+    env["SHELL"] = "/bin/bash"
+
+    result = subprocess.run(
+        ["/bin/sh", str(INSTALL_SH)],
+        env=env,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+        text=True,
+    )
+    out = result.stdout + result.stderr
+    assert (
+        result.returncode == 0
+    ), f"Installer exited {result.returncode}:\n{out}"
+    assert "Installed fere-cli using: pipx" in out
+    assert "falling back to pip" not in out
+
+
+def test_latest_channel_passes_pre_flag(tmp_path: Path) -> None:
+    """Passing 'latest' should include --pre in the install invocation."""
+    bin_dir = tmp_path / "bin"
+    bin_dir.mkdir(parents=True)
+    home_dir = tmp_path / "home"
+    home_dir.mkdir(parents=True)
+    local_bin = home_dir / ".local" / "bin"
+    local_bin.mkdir(parents=True)
+
+    fake_python = bin_dir / "python3"
+    _make_executable(
+        fake_python,
+        "#!/bin/sh\n"
+        'if [ "$1" = "--version" ]; then\n'
+        '  echo "Python 3.11.0"\n'
+        "  exit 0\n"
+        'elif [ "$1" = "-c" ]; then\n'
+        '  case "$2" in\n'
+        '    *version_info*) echo "3.11" ;;\n'
+        '    *getuserbase*)  printf "%s" "$HOME/.local" ;;\n'
+        '    *) echo "3.11" ;;\n'
+        "  esac\n"
+        "  exit 0\n"
+        'elif [ "$1" = "-m" ]; then\n'
+        "  exit 0\n"
+        "fi\n"
+        "exit 0\n",
+    )
+
+    # pipx that logs its args so we can verify --pip-args=--pre
+    fake_pipx = bin_dir / "pipx"
+    _make_executable(
+        fake_pipx,
+        "#!/bin/sh\n"
+        'echo "pipx $*"\n'
+        'if [ "$1" = "install" ]; then exit 0; fi\n'
+        'if [ "$1" = "ensurepath" ]; then exit 0; fi\n'
+        "exit 1\n",
+    )
+
+    fake_fere = bin_dir / "fere"
+    _make_executable(
+        fake_fere,
+        "#!/bin/sh\n"
+        'if [ "$1" = "--version" ]; then echo "fere 0.2.0-pre"; fi\n'
+        "exit 0\n",
+    )
+
+    fake_brew = bin_dir / "brew"
+    _make_executable(fake_brew, "#!/bin/sh\nexit 1\n")
+
+    env = os.environ.copy()
+    env["PATH"] = f"{bin_dir}{os.pathsep}{env.get('PATH', '')}"
+    env["HOME"] = str(home_dir)
+    env["SHELL"] = "/bin/bash"
+
+    result = subprocess.run(
+        ["/bin/sh", str(INSTALL_SH), "latest"],
+        env=env,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+        text=True,
+    )
+    out = result.stdout + result.stderr
+    assert (
+        result.returncode == 0
+    ), f"Installer exited {result.returncode}:\n{out}"
+    assert "--pip-args=--pre" in out
+
+
+def test_pip_fallback_when_pipx_unavailable(tmp_path: Path) -> None:
+    """Freshly-installed pipx not found on PATH falls back to pip."""
+    bin_dir = tmp_path / "bin"
+    bin_dir.mkdir(parents=True)
+    home_dir = tmp_path / "home"
+    home_dir.mkdir(parents=True)
+    local_bin = home_dir / ".local" / "bin"
+    local_bin.mkdir(parents=True)
+
+    fake_python = bin_dir / "python3"
+    _make_executable(
+        fake_python,
+        "#!/bin/sh\n"
+        'if [ "$1" = "--version" ]; then\n'
+        '  echo "Python 3.11.0"\n'
+        "  exit 0\n"
+        'elif [ "$1" = "-c" ]; then\n'
+        '  case "$2" in\n'
+        '    *version_info*) echo "3.11" ;;\n'
+        '    *getuserbase*)  printf "%s" "$HOME/.local" ;;\n'
+        '    *) echo "3.11" ;;\n'
+        "  esac\n"
+        "  exit 0\n"
+        'elif [ "$1" = "-m" ]; then\n'
+        "  exit 0\n"
+        "fi\n"
+        "exit 0\n",
+    )
+
+    # No pipx binary on PATH — install_with_pipx returns 1;
+    # install_pipx succeeds (fake python -m exits 0) but the
+    # freshly-installed pipx binary is not found at
+    # _user_base/bin/pipx, so the inner else falls back to pip.
+    fake_brew = bin_dir / "brew"
+    _make_executable(fake_brew, "#!/bin/sh\nexit 1\n")
+
+    env = os.environ.copy()
+    env["PATH"] = f"{bin_dir}{os.pathsep}{env.get('PATH', '')}"
+    env["HOME"] = str(home_dir)
+    env["SHELL"] = "/bin/bash"
+
+    result = subprocess.run(
+        ["/bin/sh", str(INSTALL_SH)],
+        env=env,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+        text=True,
+    )
+    out = result.stdout + result.stderr
+    assert (
+        result.returncode == 0
+    ), f"Installer exited {result.returncode}:\n{out}"
+    assert "falling back to pip" in out
+    assert "Installed fere-cli using: pip" in out
+
+
+def test_pip_fallback_when_install_pipx_fails(tmp_path: Path) -> None:
+    """install_pipx returns 1 → else branch falls back to pip."""
+    bin_dir = tmp_path / "bin"
+    bin_dir.mkdir(parents=True)
+    home_dir = tmp_path / "home"
+    home_dir.mkdir(parents=True)
+    local_bin = home_dir / ".local" / "bin"
+    local_bin.mkdir(parents=True)
+
+    # Python that fails on -m for pipx/ensurepip
+    fake_python = bin_dir / "python3"
+    _make_executable(
+        fake_python,
+        "#!/bin/sh\n"
+        'if [ "$1" = "--version" ]; then\n'
+        '  echo "Python 3.11.0"\n'
+        "  exit 0\n"
+        'elif [ "$1" = "-c" ]; then\n'
+        '  case "$2" in\n'
+        '    *version_info*) echo "3.11" ;;\n'
+        '    *getuserbase*)  printf "%s" "$HOME/.local" ;;\n'
+        '    *) echo "3.11" ;;\n'
+        "  esac\n"
+        "  exit 0\n"
+        'elif [ "$1" = "-m" ]; then\n'
+        '  case "$2" in\n'
+        "    pip)\n"
+        '      case "$3" in\n'
+        "        install)\n"
+        "          # fail pipx install, allow fere-cli\n"
+        '          case "$*" in\n'
+        "            *pipx*) exit 1 ;;\n"
+        "            *) exit 0 ;;\n"
+        "          esac ;;\n"
+        "        *) exit 0 ;;\n"
+        "      esac ;;\n"
+        "    ensurepip) exit 1 ;;\n"
+        "    *) exit 0 ;;\n"
+        "  esac\n"
+        "fi\n"
+        "exit 0\n",
+    )
+
+    # No pipx on PATH, brew fails — install_pipx will return 1
+    fake_brew = bin_dir / "brew"
+    _make_executable(fake_brew, "#!/bin/sh\nexit 1\n")
+
+    env = os.environ.copy()
+    env["PATH"] = f"{bin_dir}{os.pathsep}{env.get('PATH', '')}"
+    env["HOME"] = str(home_dir)
+    env["SHELL"] = "/bin/bash"
+
+    result = subprocess.run(
+        ["/bin/sh", str(INSTALL_SH)],
+        env=env,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+        text=True,
+    )
+    out = result.stdout + result.stderr
+    assert (
+        result.returncode == 0
+    ), f"Installer exited {result.returncode}:\n{out}"
+    assert "falling back to pip" in out
+    assert "Installed fere-cli using: pip" in out
+
+
+def test_latest_channel_pip_fallback(tmp_path: Path) -> None:
+    """Latest channel via pip fallback should pass --pre flag."""
+    bin_dir = tmp_path / "bin"
+    bin_dir.mkdir(parents=True)
+    home_dir = tmp_path / "home"
+    home_dir.mkdir(parents=True)
+    local_bin = home_dir / ".local" / "bin"
+    local_bin.mkdir(parents=True)
+
+    # Python that logs pip args so we can verify --pre
+    fake_python = bin_dir / "python3"
+    _make_executable(
+        fake_python,
+        "#!/bin/sh\n"
+        'if [ "$1" = "--version" ]; then\n'
+        '  echo "Python 3.11.0"\n'
+        "  exit 0\n"
+        'elif [ "$1" = "-c" ]; then\n'
+        '  case "$2" in\n'
+        '    *version_info*) echo "3.11" ;;\n'
+        '    *getuserbase*)  printf "%s" "$HOME/.local" ;;\n'
+        '    *) echo "3.11" ;;\n'
+        "  esac\n"
+        "  exit 0\n"
+        'elif [ "$1" = "-m" ]; then\n'
+        "  shift\n"
+        '  echo "python -m $*"\n'
+        "  exit 0\n"
+        "fi\n"
+        "exit 0\n",
+    )
+
+    # No pipx — forces pip fallback
+    fake_brew = bin_dir / "brew"
+    _make_executable(fake_brew, "#!/bin/sh\nexit 1\n")
+
+    env = os.environ.copy()
+    env["PATH"] = f"{bin_dir}{os.pathsep}{env.get('PATH', '')}"
+    env["HOME"] = str(home_dir)
+    env["SHELL"] = "/bin/bash"
+
+    result = subprocess.run(
+        ["/bin/sh", str(INSTALL_SH), "latest"],
+        env=env,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+        text=True,
+    )
+    out = result.stdout + result.stderr
+    assert (
+        result.returncode == 0
+    ), f"Installer exited {result.returncode}:\n{out}"
+    assert "falling back to pip" in out
+    assert "--pre" in out

fere_cli-0.2.0.dev14/install.sh

@@ -1,114 +0,0 @@
-#!/bin/sh
-# FereAI CLI Installer
-# Usage: curl -fsSL https://api.fereai.xyz/install.sh | sh
-#
-# Installs the `fere` CLI tool via pipx (recommended) or pip.
-# Supports macOS and Linux.
-
-set -e
-
-VERSION="0.1.0"
-PACKAGE="fere-cli"
-
-# Colors (disabled if not a TTY)
-if [ -t 1 ]; then
-    RED='\033[0;31m'
-    GREEN='\033[0;32m'
-    YELLOW='\033[0;33m'
-    DIM='\033[2m'
-    RESET='\033[0m'
-else
-    RED=''
-    GREEN=''
-    YELLOW=''
-    DIM=''
-    RESET=''
-fi
-
-info() { printf "${DIM}%s${RESET}\n" "$1"; }
-success() { printf "${GREEN}%s${RESET}\n" "$1"; }
-warn() { printf "${YELLOW}%s${RESET}\n" "$1"; }
-error() { printf "${RED}Error: %s${RESET}\n" "$1" >&2; exit 1; }
-
-# Detect OS
-OS="$(uname -s)"
-case "$OS" in
-    Darwin) OS_NAME="macOS" ;;
-    Linux)  OS_NAME="Linux" ;;
-    *)      error "Unsupported OS: $OS. Use pip install $PACKAGE instead." ;;
-esac
-
-info "Installing FereAI CLI v${VERSION} on ${OS_NAME}..."
-
-# Check Python 3.10+
-check_python() {
-    for cmd in python3 python; do
-        if command -v "$cmd" >/dev/null 2>&1; then
-            ver=$("$cmd" -c 'import sys; print(f"{sys.version_info.major}.{sys.version_info.minor}")' 2>/dev/null)
-            major=$(echo "$ver" | cut -d. -f1)
-            minor=$(echo "$ver" | cut -d. -f2)
-            if [ "$major" -ge 3 ] && [ "$minor" -ge 10 ]; then
-                echo "$cmd"
-                return 0
-            fi
-        fi
-    done
-    return 1
-}
-
-PYTHON=$(check_python) || error "Python 3.10+ is required. Install it from https://python.org"
-info "Found Python: $($PYTHON --version)"
-
-# Prefer pipx for isolated installs
-install_with_pipx() {
-    if command -v pipx >/dev/null 2>&1; then
-        info "Installing with pipx..."
-        pipx install "$PACKAGE" || pipx upgrade "$PACKAGE"
-        return 0
-    fi
-    return 1
-}
-
-install_pipx() {
-    info "Installing pipx..."
-    if command -v brew >/dev/null 2>&1; then
-        brew install pipx
-    elif [ "$OS" = "Linux" ]; then
-        $PYTHON -m pip install --user pipx 2>/dev/null || \
-            $PYTHON -m ensurepip --default-pip 2>/dev/null && \
-            $PYTHON -m pip install --user pipx
-    else
-        $PYTHON -m pip install --user pipx
-    fi
-    pipx ensurepath 2>/dev/null || true
-}
-
-install_with_pip() {
-    info "Installing with pip..."
-    $PYTHON -m pip install --user "$PACKAGE"
-}
-
-# Try pipx first, then install pipx, then fall back to pip
-if install_with_pipx; then
-    : # success
-elif install_pipx && install_with_pipx; then
-    : # success
-else
-    warn "pipx not available, falling back to pip..."
-    install_with_pip
-fi
-
-# Verify installation
-if command -v fere >/dev/null 2>&1; then
-    success "FereAI CLI installed successfully!"
-    echo ""
-    info "Get started:"
-    echo "  fere auth          # Set up your agent"
-    echo "  fere chat \"hello\"  # Chat with the AI"
-    echo "  fere --help        # See all commands"
-else
-    warn "Installation complete, but 'fere' is not in PATH."
-    warn "You may need to restart your shell or add ~/.local/bin to PATH:"
-    echo ""
-    echo "  export PATH=\"\$HOME/.local/bin:\$PATH\""
-fi