feat: standalone binary releases, auto-install sing-box from GitHub, install scripts, fix sb2p alias, bump to 0.3.2

Author: nichind

.github/workflows/build.yml

@@ -46,7 +46,7 @@ jobs:
         run: |
           python -m pytest tests/tun_test.py::TestTunConfig --tb=short --disable-warnings -v
       - name: Run TUN live test (Linux)
-        if: runner.os == 'Linux' && env.TEST_SINGBOX_LINK != ''
+        if: runner.os == 'Linux' && env.TEST_SINGBOX_LINK !=  ''
         run: |
           sudo -E env "PATH=$PATH" "TEST_SINGBOX_LINK=$TEST_SINGBOX_LINK" "$pythonLocation/bin/python" -m pytest tests/tun_test.py::TestTunLiveSystemVpn --tb=short --disable-warnings -v
       - name: Run TUN live test (Windows)

.github/workflows/release.yml

@@ -0,0 +1,120 @@
+name: Release Binaries
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Build ${{ matrix.os }}
+    runs-on: ${{ matrix.runs-on }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: linux-amd64
+            runs-on: ubuntu-22.04
+            artifact: sb2p-linux-amd64
+            ext: ""
+          - os: windows-amd64
+            runs-on: windows-latest
+            artifact: sb2p-windows-amd64.exe
+            ext: ".exe"
+          - os: macos-amd64
+            runs-on: macos-13
+            artifact: sb2p-macos-amd64
+            ext: ""
+          - os: macos-arm64
+            runs-on: macos-14
+            artifact: sb2p-macos-arm64
+            ext: ""
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build dependencies
+        shell: bash
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install nuitka ordered-set zstandard
+          python -m pip install -e ".[cli]"
+
+      - name: Install C compiler (Linux)
+        if: runner.os == 'Linux'
+        run: sudo apt-get update && sudo apt-get install -y gcc patchelf
+
+      - name: Build binary
+        shell: bash
+        run: |
+          python -m nuitka \
+            --onefile \
+            --output-filename="sb2p${{ matrix.ext }}" \
+            --output-dir=dist \
+            --remove-output \
+            --assume-yes-for-downloads \
+            --python-flag=no_docstrings \
+            --python-flag=-OO \
+            --include-package=singbox2proxy \
+            --include-module=qrcode \
+            --include-module=psutil \
+            --nofollow-import-to=tkinter \
+            --nofollow-import-to=unittest \
+            --nofollow-import-to=test \
+            --nofollow-import-to=distutils \
+            --nofollow-import-to=setuptools \
+            --nofollow-import-to=pydoc \
+            --nofollow-import-to=xmlrpc \
+            --nofollow-import-to=doctest \
+            --nofollow-import-to=pdb \
+            --nofollow-import-to=lib2to3 \
+            --nofollow-import-to=ensurepip \
+            singbox2proxy/__main__.py
+
+      - name: Compress with UPX (Linux)
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get install -y upx-ucl || sudo apt-get install -y upx
+          upx --best --lzma "dist/sb2p" || true
+
+      - name: Compress with UPX (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          Invoke-WebRequest -Uri "https://github.com/upx/upx/releases/download/v4.2.4/upx-4.2.4-win64.zip" -OutFile upx.zip
+          Expand-Archive upx.zip -DestinationPath upx
+          ./upx/upx-4.2.4-win64/upx.exe --best --lzma "dist/sb2p.exe" || echo "UPX compression skipped"
+
+      - name: Rename artifact
+        shell: bash
+        run: mv "dist/sb2p${{ matrix.ext }}" "dist/${{ matrix.artifact }}"
+
+      - name: Smoke test (non-Windows)
+        if: runner.os != 'Windows'
+        shell: bash
+        run: |
+          chmod +x "dist/${{ matrix.artifact }}"
+          "dist/${{ matrix.artifact }}" --version
+
+      - name: Smoke test (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          & "dist/${{ matrix.artifact }}" --version
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.artifact }}
+          path: dist/${{ matrix.artifact }}
+
+      - name: Upload to release
+        if: github.event_name == 'release'
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/${{ matrix.artifact }}

pyproject.toml

@@ -36,6 +36,13 @@ keywords = [
 ]
 dependencies = []
 
+[project.optional-dependencies]
+cli = ["qrcode", "psutil"]
+http = ["requests"]
+fast = ["curl-cffi"]
+socks = ["pysocks"]
+all = ["qrcode", "psutil", "requests", "curl-cffi", "pysocks"]
+
 [project.scripts]
 singbox2proxy = "singbox2proxy.__main__:main"
 sb2p = "singbox2proxy.__main__:main"

readme.md

@@ -31,7 +31,37 @@ This module supports these sing-box protocols:
 
 ### Installation
 
-with pip
+#### Quick Install (no Python required)
+
+**Linux / macOS:**
+```shell
+curl -fsSL https://raw.githubusercontent.com/nichind/singbox2proxy/main/scripts/install.sh | sh
+```
+
+**Windows (PowerShell):**
+```powershell
+irm https://raw.githubusercontent.com/nichind/singbox2proxy/main/scripts/install.ps1 | iex
+```
+
+By default this downloads a standalone binary. To install via Python/pip instead:
+```shell
+# Linux/macOS
+curl -fsSL https://raw.githubusercontent.com/nichind/singbox2proxy/main/scripts/install.sh | sh -s -- --python
+
+# Windows
+& ([scriptblock]::Create((irm https://raw.githubusercontent.com/nichind/singbox2proxy/main/scripts/install.ps1))) -Mode python
+```
+
+Both `sb2p` and `singbox2proxy` commands are created automatically.
+
+#### Standalone Binary (no Python, no pip)
+
+Download a pre-built binary from [Releases](https://github.com/nichind/singbox2proxy/releases) — just download, put anywhere in PATH, and use:
+```shell
+sb2p "vless://..."
+```
+
+#### With pip
 
 ```shell
 pip install singbox2proxy 

sb2p/README.md

@@ -0,0 +1,25 @@
+# sb2p
+
+This is an alias package for **[singbox2proxy](https://github.com/nichind/singbox2proxy)**.
+
+```shell
+pip install sb2p
+```
+
+is equivalent to:
+
+```shell
+pip install singbox2proxy
+```
+
+Both provide the `sb2p` and `singbox2proxy` CLI commands.
+
+## Usage
+
+```shell
+sb2p "vless://..."
+sb2p "vmess://..." --tun
+sb2p --check proxies.txt
+```
+
+For full documentation, see the [main project](https://github.com/nichind/singbox2proxy).

sb2p/pyproject.toml

@@ -4,13 +4,14 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sb2p"
-version = "0.3.0"
+version = "0.3.2"
 authors = [{name = "nichind", email = "nichind@proton.me"}]
 description = "Alias for singbox2proxy — pip install sb2p"
+readme = "readme.md"
 requires-python = ">=3.9"
 license = {text = "MIT"}
 keywords = ["sing-box", "proxy", "sb2p", "singbox2proxy"]
-dependencies = ["singbox2proxy==0.3.0"]
+dependencies = ["singbox2proxy"]
 
 [project.scripts]
 sb2p = "singbox2proxy.__main__:main"

singbox2proxy/__init__.py

@@ -3,7 +3,7 @@
 from .client import SingBoxClient, default_request_module  # noqa: F401
 from .parsers import parse_link  # noqa: F401
 
-VERSION = "0.3.1"
+VERSION = "0.3.2"
 
 __all__ = [
     "SingBoxCore",