openduck-cli 0.1.1__tar.gz → 0.1.2__tar.gz

{openduck_cli-0.1.1 → openduck_cli-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openduck-cli
-Version: 0.1.1
+Version: 0.1.2
 Summary: A flat file SQL client based on DuckDB
 Author: Bertatron
 License-Expression: MIT
@@ -82,33 +82,59 @@ OpenDuck automatically recognises and formats queries for:
 
 ### 1. Installation
 
-**Via PyPI:**
+**Recommended: Install via `pip3` from PyPI**
 ```bash
-pip install openduck-cli
+pip3 install openduck-cli
+```
+
+> **Tip:** If your system manages Python externally (e.g., Debian/Ubuntu PEP 668), install into a virtual environment or use `pipx`:
+> ```bash
+> python3 -m venv ~/.openduck-venv
+> ~/.openduck-venv/bin/pip3 install openduck-cli
+> # Create a symlink to run it from anywhere:
+> sudo ln -s ~/.openduck-venv/bin/openduck /usr/local/bin/openduck
+> ```
+
+**Via Docker (Zero local setup):**
+```bash
+# Run directly with Docker mounting your current data directory:
+docker run -it --rm -v "$(pwd):/data" python:3.12-slim sh -c "pip3 install --no-cache-dir openduck-cli && openduck"
+
+# Or build the included Dockerfile:
+docker build -t openduck .
+docker run -it --rm -v "$(pwd):/data" openduck
 ```
 
 **From source:**
 ```bash
 git clone https://github.com/klandermans/openduck.git
 cd openduck
-pip install -r requirements.txt
-# or: pip install -e .
+pip3 install -r requirements.txt
+# or install in editable mode:
+pip3 install -e .
 ```
 
 > **Note:** `textual[syntax]` installs the required `tree-sitter` and `tree-sitter-sql` engines for syntax highlighting out of the box.
 
+---
+
 ### 2. Run OpenDuck
 
+After installing with `pip3`, run it directly from any directory:
+
 ```bash
-python openduck.py
+openduck
 ```
+*(or `openduck-cli`)*
 
-Or make it available system-wide as a command:
+If you cloned the source repository:
 
 ```bash
-chmod +x openduck.sh
-sudo cp openduck.sh /usr/local/bin/openduck
-openduck
+python3 openduck.py
+# or
+python3 -m openduck
+# or with the shell wrapper:
+./openduck.sh
 ```
 
 ---

{openduck_cli-0.1.1 → openduck_cli-0.1.2}/README.md

@@ -64,33 +64,59 @@ OpenDuck automatically recognises and formats queries for:
 
 ### 1. Installation
 
-**Via PyPI:**
+**Recommended: Install via `pip3` from PyPI**
 ```bash
-pip install openduck-cli
+pip3 install openduck-cli
+```
+
+> **Tip:** If your system manages Python externally (e.g., Debian/Ubuntu PEP 668), install into a virtual environment or use `pipx`:
+> ```bash
+> python3 -m venv ~/.openduck-venv
+> ~/.openduck-venv/bin/pip3 install openduck-cli
+> # Create a symlink to run it from anywhere:
+> sudo ln -s ~/.openduck-venv/bin/openduck /usr/local/bin/openduck
+> ```
+
+**Via Docker (Zero local setup):**
+```bash
+# Run directly with Docker mounting your current data directory:
+docker run -it --rm -v "$(pwd):/data" python:3.12-slim sh -c "pip3 install --no-cache-dir openduck-cli && openduck"
+
+# Or build the included Dockerfile:
+docker build -t openduck .
+docker run -it --rm -v "$(pwd):/data" openduck
 ```
 
 **From source:**
 ```bash
 git clone https://github.com/klandermans/openduck.git
 cd openduck
-pip install -r requirements.txt
-# or: pip install -e .
+pip3 install -r requirements.txt
+# or install in editable mode:
+pip3 install -e .
 ```
 
 > **Note:** `textual[syntax]` installs the required `tree-sitter` and `tree-sitter-sql` engines for syntax highlighting out of the box.
 
+---
+
 ### 2. Run OpenDuck
 
+After installing with `pip3`, run it directly from any directory:
+
 ```bash
-python openduck.py
+openduck
 ```
+*(or `openduck-cli`)*
 
-Or make it available system-wide as a command:
+If you cloned the source repository:
 
 ```bash
-chmod +x openduck.sh
-sudo cp openduck.sh /usr/local/bin/openduck
-openduck
+python3 openduck.py
+# or
+python3 -m openduck
+# or with the shell wrapper:
+./openduck.sh
 ```
 
 ---

{openduck_cli-0.1.1 → openduck_cli-0.1.2}/openduck/__init__.py

@@ -1,6 +1,6 @@
 """OpenDuck - A flat file SQL client based on DuckDB."""
 
-__version__ = "0.1.1"
+__version__ = "0.1.2"
 
 from openduck.core.config import (
     CWD,

{openduck_cli-0.1.1 → openduck_cli-0.1.2}/openduck_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openduck-cli
-Version: 0.1.1
+Version: 0.1.2
 Summary: A flat file SQL client based on DuckDB
 Author: Bertatron
 License-Expression: MIT
@@ -82,33 +82,59 @@ OpenDuck automatically recognises and formats queries for:
 
 ### 1. Installation
 
-**Via PyPI:**
+**Recommended: Install via `pip3` from PyPI**
 ```bash
-pip install openduck-cli
+pip3 install openduck-cli
+```
+
+> **Tip:** If your system manages Python externally (e.g., Debian/Ubuntu PEP 668), install into a virtual environment or use `pipx`:
+> ```bash
+> python3 -m venv ~/.openduck-venv
+> ~/.openduck-venv/bin/pip3 install openduck-cli
+> # Create a symlink to run it from anywhere:
+> sudo ln -s ~/.openduck-venv/bin/openduck /usr/local/bin/openduck
+> ```
+
+**Via Docker (Zero local setup):**
+```bash
+# Run directly with Docker mounting your current data directory:
+docker run -it --rm -v "$(pwd):/data" python:3.12-slim sh -c "pip3 install --no-cache-dir openduck-cli && openduck"
+
+# Or build the included Dockerfile:
+docker build -t openduck .
+docker run -it --rm -v "$(pwd):/data" openduck
 ```
 
 **From source:**
 ```bash
 git clone https://github.com/klandermans/openduck.git
 cd openduck
-pip install -r requirements.txt
-# or: pip install -e .
+pip3 install -r requirements.txt
+# or install in editable mode:
+pip3 install -e .
 ```
 
 > **Note:** `textual[syntax]` installs the required `tree-sitter` and `tree-sitter-sql` engines for syntax highlighting out of the box.
 
+---
+
 ### 2. Run OpenDuck
 
+After installing with `pip3`, run it directly from any directory:
+
 ```bash
-python openduck.py
+openduck
 ```
+*(or `openduck-cli`)*
 
-Or make it available system-wide as a command:
+If you cloned the source repository:
 
 ```bash
-chmod +x openduck.sh
-sudo cp openduck.sh /usr/local/bin/openduck
-openduck
+python3 openduck.py
+# or
+python3 -m openduck
+# or with the shell wrapper:
+./openduck.sh
 ```
 
 ---

{openduck_cli-0.1.1 → openduck_cli-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "openduck-cli"
-version = "0.1.1"
+version = "0.1.2"
 description = "A flat file SQL client based on DuckDB"
 readme = "README.md"
 authors = [{ name = "Bertatron" }]