gulp-cli 1.0.9__tar.gz → 1.1.2__tar.gz

gulp_cli-1.1.2/.github/workflows/portable-bundles.yml

@@ -0,0 +1,179 @@
+name: Portable bundles
+
+"on":
+  push:
+    tags: ['v*', 'test-v*']
+  release:
+    types: [published]
+  workflow_dispatch: {}
+
+permissions:
+  contents: write
+
+jobs:
+  build-portable:
+    name: Build portable bundle (${{ matrix.bundle_name }})
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 90
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            bundle_name: gulp-cli-portable-linux-x64
+            launcher_path: portable/launch-linux.sh
+          - os: windows-latest
+            bundle_name: gulp-cli-portable-windows-x64
+            launcher_path: portable/launch-windows.bat
+          - os: macos-14
+            bundle_name: gulp-cli-portable-macos-arm64
+            launcher_path: portable/launch-macos.sh
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install . pyinstaller
+
+      - name: Build executable
+        run: |
+          pyinstaller --noconfirm --clean gulp-cli.spec
+
+      - name: Assemble portable layout
+        shell: python
+        env:
+          BUNDLE_NAME: ${{ matrix.bundle_name }}
+          LAUNCHER_PATH: ${{ matrix.launcher_path }}
+        run: |
+          import os
+          import shutil
+          from pathlib import Path
+
+          dist_dir = Path("dist")
+          source_dir = dist_dir / "gulp-cli"
+          bundle_dir = dist_dir / os.environ["BUNDLE_NAME"]
+          launcher_path = Path(os.environ["LAUNCHER_PATH"])
+
+          if bundle_dir.exists():
+              shutil.rmtree(bundle_dir)
+
+          shutil.copytree(source_dir, bundle_dir)
+          (bundle_dir / "data" / "extension").mkdir(parents=True, exist_ok=True)
+          shutil.copy2(launcher_path, bundle_dir / launcher_path.name)
+          shutil.copy2("README.md", bundle_dir / "README.md")
+
+      - name: Upload portable artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.bundle_name }}
+          path: dist/${{ matrix.bundle_name }}
+          if-no-files-found: error
+
+      - name: Create release archive
+        shell: python
+        env:
+          BUNDLE_NAME: ${{ matrix.bundle_name }}
+        run: |
+          import os
+          import shutil
+          from pathlib import Path
+
+          dist_dir = Path("dist")
+          bundle_name = os.environ["BUNDLE_NAME"]
+          bundle_dir = dist_dir / bundle_name
+          archive_base = dist_dir / bundle_name
+          shutil.make_archive(str(archive_base), "zip", root_dir=bundle_dir.parent, base_dir=bundle_dir.name)
+
+      - name: Upload release asset
+        if: github.event_name == 'release'
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.event.release.tag_name }}
+          files: dist/${{ matrix.bundle_name }}.zip
+          fail_on_unmatched_files: true
+
+  build-portable-macos-x64:
+    name: Build portable bundle (gulp-cli-portable-macos-x64)
+    if: github.event_name == 'workflow_dispatch' || github.event_name == 'release'
+    continue-on-error: ${{ github.event_name == 'release' }}
+    runs-on: macos-15-intel
+    timeout-minutes: 90
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install . pyinstaller
+
+      - name: Build executable
+        run: |
+          pyinstaller --noconfirm --clean gulp-cli.spec
+
+      - name: Assemble portable layout
+        shell: python
+        env:
+          BUNDLE_NAME: gulp-cli-portable-macos-x64
+          LAUNCHER_PATH: portable/launch-macos.sh
+        run: |
+          import os
+          import shutil
+          from pathlib import Path
+
+          dist_dir = Path("dist")
+          source_dir = dist_dir / "gulp-cli"
+          bundle_dir = dist_dir / os.environ["BUNDLE_NAME"]
+          launcher_path = Path(os.environ["LAUNCHER_PATH"])
+
+          if bundle_dir.exists():
+              shutil.rmtree(bundle_dir)
+
+          shutil.copytree(source_dir, bundle_dir)
+          (bundle_dir / "data" / "extension").mkdir(parents=True, exist_ok=True)
+          shutil.copy2(launcher_path, bundle_dir / launcher_path.name)
+          shutil.copy2("README.md", bundle_dir / "README.md")
+
+      - name: Upload portable artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: gulp-cli-portable-macos-x64
+          path: dist/gulp-cli-portable-macos-x64
+          if-no-files-found: error
+
+      - name: Create release archive
+        shell: python
+        env:
+          BUNDLE_NAME: gulp-cli-portable-macos-x64
+        run: |
+          import os
+          import shutil
+          from pathlib import Path
+
+          dist_dir = Path("dist")
+          bundle_name = os.environ["BUNDLE_NAME"]
+          bundle_dir = dist_dir / bundle_name
+          archive_base = dist_dir / bundle_name
+          shutil.make_archive(str(archive_base), "zip", root_dir=bundle_dir.parent, base_dir=bundle_dir.name)
+
+      - name: Upload release asset
+        if: github.event_name == 'release'
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.event.release.tag_name }}
+          files: dist/gulp-cli-portable-macos-x64.zip
+          fail_on_unmatched_files: true

{gulp_cli-1.0.9 → gulp_cli-1.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gulp-cli
-Version: 1.0.9
+Version: 1.1.2
 Summary: Command-line client for gULP
 Author-email: Mentat <info@mentat.is>
 Requires-Python: >=3.12
@@ -9,6 +9,8 @@ Requires-Dist: typer==0.23.1
 Requires-Dist: rich==15.0.0
 Requires-Dist: click==8.3.3
 Requires-Dist: gulp-sdk
+Provides-Extra: portable
+Requires-Dist: pyinstaller<7,>=6.11; extra == "portable"
 
 # 🚀 gulp-cli
 
@@ -41,6 +43,9 @@ All with **beautiful terminal output**, **automatic tab completion**, and **asyn
 # from pip
 pip install gulp-cli
 
+# or install local portable-build tooling
+pip install 'gulp-cli[portable]'
+
 # or, for the latest development version:
 python3 -m venv ./.venv
 source ./.venv/bin/activate
@@ -51,10 +56,20 @@ cd gulp-cli && pip install -e .
 gulp-cli --help
 ```
 
+### Portable Bundles
+
+For offline use from a USB stick, prefer the OS-specific portable bundles built with PyInstaller instead of `pip install`.
+
+- Each target OS needs its own bundle: Linux, Windows, macOS Intel, macOS Apple Silicon.
+- Portable bundles keep config and external extensions in a local `data/` directory next to the executable.
+- You can override that location with `GULP_CLI_HOME` or `--config-dir`.
+
+See **[Portable Usage](./docs/portable.md)** for the layout, local build command, and CI artifact details.
+
 ### Basic Usage
 
 > for the cli to work, set `"ws_ignore_missing": true` (should be default in the v1.6.51 backend, though ...) in your `gulp_cfg.json` to prevent the backend from halting operations when the CLI disconnects its websocket after sending an async request!
- 
+
 ```bash
 # Login to your gULP instance
 gulp-cli auth login --url http://localhost:8080 --username admin --password admin
@@ -71,6 +86,7 @@ gulp-cli ingest file my_operation win_evtx 'samples/win_evtx/*.evtx'
 # Query documents
 gulp-cli query raw my_operation --q '{"query":{"match_all":{}}}'
 ```
+
 ---
 
 ## 📚 Documentation
@@ -78,6 +94,7 @@ gulp-cli query raw my_operation --q '{"query":{"match_all":{}}}'
 - **[Getting Started Guide](./docs/getting-started.md)** — auth, first operation, first ingest
 - **[Command Reference](./docs/command-reference.md)** — all available commands and options
 - **[Extensions Guide](./docs/extensions.md)** — dynamic extension loading and custom command contract
+- **[Portable Usage](./docs/portable.md)** — offline bundles and USB-friendly layout
 - **[Resource Management Commands](./docs/resource-management.md)** — context, source, plugin, mapping, enhance-map, glyph
 - **[Practical Examples](./docs/examples.md)** — real-world workflows and recipes
 - **[Troubleshooting](./docs/troubleshooting-cli.md)** — common issues and solutions

gulp_cli-1.0.9/src/gulp_cli.egg-info/PKG-INFO → gulp_cli-1.1.2/README.md

@@ -1,15 +1,3 @@
-Metadata-Version: 2.4
-Name: gulp-cli
-Version: 1.0.9
-Summary: Command-line client for gULP
-Author-email: Mentat <info@mentat.is>
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-Requires-Dist: typer==0.23.1
-Requires-Dist: rich==15.0.0
-Requires-Dist: click==8.3.3
-Requires-Dist: gulp-sdk
-
 # 🚀 gulp-cli
 
 **A modern, powerful command-line interface for gULP** — manage forensic document ingestion, querying, enrichment, and collaboration entirely from your terminal.
@@ -41,6 +29,9 @@ All with **beautiful terminal output**, **automatic tab completion**, and **asyn
 # from pip
 pip install gulp-cli
 
+# or install local portable-build tooling
+pip install 'gulp-cli[portable]'
+
 # or, for the latest development version:
 python3 -m venv ./.venv
 source ./.venv/bin/activate
@@ -51,10 +42,20 @@ cd gulp-cli && pip install -e .
 gulp-cli --help
 ```
 
+### Portable Bundles
+
+For offline use from a USB stick, prefer the OS-specific portable bundles built with PyInstaller instead of `pip install`.
+
+- Each target OS needs its own bundle: Linux, Windows, macOS Intel, macOS Apple Silicon.
+- Portable bundles keep config and external extensions in a local `data/` directory next to the executable.
+- You can override that location with `GULP_CLI_HOME` or `--config-dir`.
+
+See **[Portable Usage](./docs/portable.md)** for the layout, local build command, and CI artifact details.
+
 ### Basic Usage
 
 > for the cli to work, set `"ws_ignore_missing": true` (should be default in the v1.6.51 backend, though ...) in your `gulp_cfg.json` to prevent the backend from halting operations when the CLI disconnects its websocket after sending an async request!
- 
+
 ```bash
 # Login to your gULP instance
 gulp-cli auth login --url http://localhost:8080 --username admin --password admin
@@ -71,6 +72,7 @@ gulp-cli ingest file my_operation win_evtx 'samples/win_evtx/*.evtx'
 # Query documents
 gulp-cli query raw my_operation --q '{"query":{"match_all":{}}}'
 ```
+
 ---
 
 ## 📚 Documentation
@@ -78,6 +80,7 @@ gulp-cli query raw my_operation --q '{"query":{"match_all":{}}}'
 - **[Getting Started Guide](./docs/getting-started.md)** — auth, first operation, first ingest
 - **[Command Reference](./docs/command-reference.md)** — all available commands and options
 - **[Extensions Guide](./docs/extensions.md)** — dynamic extension loading and custom command contract
+- **[Portable Usage](./docs/portable.md)** — offline bundles and USB-friendly layout
 - **[Resource Management Commands](./docs/resource-management.md)** — context, source, plugin, mapping, enhance-map, glyph
 - **[Practical Examples](./docs/examples.md)** — real-world workflows and recipes
 - **[Troubleshooting](./docs/troubleshooting-cli.md)** — common issues and solutions

gulp_cli-1.1.2/docs/portable.md

@@ -0,0 +1,76 @@
+# Portable gulp-cli
+
+Portable bundles are the recommended way to run `gulp-cli` from removable media or on machines without internet access.
+
+## What portable means here
+
+- You build one bundle per target OS and architecture.
+- The bundle already contains Python, `gulp-cli`, `gulp-sdk`, and runtime dependencies.
+- User state lives in a local `data/` folder instead of the user profile.
+
+There is no single executable that runs unchanged on Linux, Windows, and macOS. Build and ship one artifact for each platform:
+
+- Linux `x86_64`
+- Windows `x86_64`
+- macOS `x86_64`
+- macOS `arm64`
+
+## Portable layout
+
+The CI workflow produces a directory like this:
+
+```text
+gulp-cli-portable-<platform>/
+  gulp-cli[.exe]
+  _internal/
+  launch-linux.sh | launch-macos.sh | launch-windows.bat
+  data/
+    extension/
+  README.md
+```
+
+`gulp-cli` automatically uses `./data` when running from a frozen bundle and that directory exists.
+
+## Runtime overrides
+
+The CLI supports both of these overrides:
+
+```bash
+GULP_CLI_HOME=/path/to/portable-data gulp-cli auth whoami
+gulp-cli --config-dir /path/to/portable-data auth whoami
+```
+
+The overridden directory stores:
+
+- `config.json`
+- `extension/`
+
+## Local build
+
+Build a portable bundle locally from the repo root:
+
+```bash
+python -m pip install --upgrade pip
+python -m pip install '.[portable]'
+pyinstaller --noconfirm --clean gulp-cli.spec
+```
+
+The output is written under `dist/gulp-cli/`.
+
+## Notes for offline USB use
+
+- Build bundles on CI or on a machine with internet access first.
+- Copy the resulting platform-specific bundle folders to the USB stick.
+- The target machine does not need Python or internet access.
+- The target machine still needs network connectivity to the gULP server unless that server is local.
+
+## GitHub Actions
+
+The repository includes a matrix workflow that builds portable artifacts for:
+
+- Linux `x86_64`
+- Windows `x86_64`
+- macOS `x86_64`
+- macOS `arm64`
+
+Artifacts are uploaded from `.github/workflows/portable-bundles.yml`.