gancio-py 0.1.0__tar.gz

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

@@ -0,0 +1,27 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  test:
+    uses: ./.github/workflows/test.yml
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

gancio_py-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,53 @@
+name: Tests
+
+on:
+  push:
+    paths-ignore:
+      - '*.md'
+      - LICENSE
+  workflow_call:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+      - name: Lint
+        run: uvx ruff check
+
+  integration:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Start Gancio
+        run: >-
+          docker run -d
+          --name gancio
+          --restart unless-stopped
+          -e NODE_ENV=development
+          -p 13120:13120
+          cisti/gancio:1.28.2
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --extra test
+
+      - name: Run tests
+        run: uv run pytest -m integration -v --cov --cov-branch --cov-report=term-missing --cov-report=xml
+
+      - name: Upload coverage to Coveralls
+        if: matrix.python-version == '3.13'
+        uses: coverallsapp/github-action@v2
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}

gancio_py-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+coverage.xml
+*.egg
+.DS_Store
+.idea/

gancio_py-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,6 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.9.7
+    hooks:
+      - id: ruff
+        args: [--fix]

gancio_py-0.1.0/CHANGELOG.md

@@ -0,0 +1,8 @@
+# 0.1.0 (20-10-2026)
+
+## Initial version
+Supports first-run setup, events, places, settings, pages, collections, filters
+[#1](https://github.com/tboye/gancio-py/pull/1)
+[#2](https://github.com/tboye/gancio-py/pull/2)
+[#3](https://github.com/tboye/gancio-py/pull/3)
+[#4](https://github.com/tboye/gancio-py/pull/4)

gancio_py-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tboye
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gancio_py-0.1.0/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.5
+Name: gancio-py
+Version: 0.1.0
+Summary: Python client for the Gancio event platform API
+Project-URL: Homepage, https://github.com/tboye/gancio-py
+Project-URL: Repository, https://github.com/tboye/gancio-py
+Project-URL: Issues, https://github.com/tboye/gancio-py/issues
+Author-email: tboye <me@tboye.dev>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: api-client,events,gancio
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: requests<3,>=2.34
+Provides-Extra: dev
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Provides-Extra: test
+Requires-Dist: pillow<13,>=12; extra == 'test'
+Requires-Dist: pytest-cov<8,>=7; extra == 'test'
+Requires-Dist: pytest-sugar<2,>=1.1.1; extra == 'test'
+Requires-Dist: pytest<10,>=9; extra == 'test'
+Description-Content-Type: text/markdown
+
+# gancio-py
+
+[![Tests](https://github.com/tboye/gancio-py/actions/workflows/test.yml/badge.svg)](https://github.com/tboye/gancio-py/actions/workflows/test.yml)
+[![PyPI](https://img.shields.io/pypi/v/gancio-py)](https://pypi.org/project/gancio-py/)
+[![Python](https://img.shields.io/pypi/pyversions/gancio-py)](https://pypi.org/project/gancio-py/)
+[![Coverage Status](https://coveralls.io/repos/github/tboye/gancio-py/badge.svg?branch=main)](https://coveralls.io/github/tboye/gancio-py?branch=main)
+
+Python client for the [Gancio](https://gancio.org) event platform API.
+
+## Installation
+
+```bash
+pip install gancio-py
+```
+
+## Usage
+
+```python
+from gancio_py import Gancio
+
+# Connect and log in
+gancio = Gancio("https://your-gancio-instance.org")
+gancio.login("user@example.com", "password")
+
+# Or use a pre-existing token
+gancio = Gancio("https://your-gancio-instance.org", access_token="your-token")
+
+# Create an event
+event = gancio.create_event(title="My Event",
+                            start_datetime=1700000000,
+                            place_name="The Venue",
+                            place_address="123 Main St",
+                            tags=["music", "live"])
+
+# List events
+events = gancio.get_events(tags=["music"])
+
+# Get a specific event
+event = gancio.get_event("my-event")
+
+# Update an event
+gancio.update_event(event_id=1, title="Updated Title")
+
+# Delete an event
+gancio.delete_event(event_id=1)
+
+# Search places
+places = gancio.search_place("Venue")
+```
+
+### Error handling
+
+```python
+from gancio_py import Gancio, GancioError
+
+gancio = Gancio("https://your-gancio-instance.org")
+
+try:
+    event = gancio.get_event("nonexistent-slug")
+except GancioError as e:
+    print(e.status_code)     # 404
+    print(e.response_body)   # error details from the server
+```
+
+## Development
+
+Run integration tests locally with Docker:
+
+```bash
+uv sync --extra test
+
+# Fresh container (runs first-time setup automatically):
+docker compose down -v && docker compose up -d
+uv run pytest -m integration -v --cov
+
+# Or against an existing instance with known credentials:
+GANCIO_URL=http://localhost:13120 \
+GANCIO_ADMIN_EMAIL=admin \
+GANCIO_ADMIN_PASSWORD=yourpassword \
+uv run pytest -m integration -v --cov
+```
+
+### Linting
+
+```bash
+uvx ruff check
+uvx ruff check --fix  # auto-fix
+```
+
+## License
+
+[MIT](LICENSE)

gancio_py-0.1.0/README.md

@@ -0,0 +1,92 @@
+# gancio-py
+
+[![Tests](https://github.com/tboye/gancio-py/actions/workflows/test.yml/badge.svg)](https://github.com/tboye/gancio-py/actions/workflows/test.yml)
+[![PyPI](https://img.shields.io/pypi/v/gancio-py)](https://pypi.org/project/gancio-py/)
+[![Python](https://img.shields.io/pypi/pyversions/gancio-py)](https://pypi.org/project/gancio-py/)
+[![Coverage Status](https://coveralls.io/repos/github/tboye/gancio-py/badge.svg?branch=main)](https://coveralls.io/github/tboye/gancio-py?branch=main)
+
+Python client for the [Gancio](https://gancio.org) event platform API.
+
+## Installation
+
+```bash
+pip install gancio-py
+```
+
+## Usage
+
+```python
+from gancio_py import Gancio
+
+# Connect and log in
+gancio = Gancio("https://your-gancio-instance.org")
+gancio.login("user@example.com", "password")
+
+# Or use a pre-existing token
+gancio = Gancio("https://your-gancio-instance.org", access_token="your-token")
+
+# Create an event
+event = gancio.create_event(title="My Event",
+                            start_datetime=1700000000,
+                            place_name="The Venue",
+                            place_address="123 Main St",
+                            tags=["music", "live"])
+
+# List events
+events = gancio.get_events(tags=["music"])
+
+# Get a specific event
+event = gancio.get_event("my-event")
+
+# Update an event
+gancio.update_event(event_id=1, title="Updated Title")
+
+# Delete an event
+gancio.delete_event(event_id=1)
+
+# Search places
+places = gancio.search_place("Venue")
+```
+
+### Error handling
+
+```python
+from gancio_py import Gancio, GancioError
+
+gancio = Gancio("https://your-gancio-instance.org")
+
+try:
+    event = gancio.get_event("nonexistent-slug")
+except GancioError as e:
+    print(e.status_code)     # 404
+    print(e.response_body)   # error details from the server
+```
+
+## Development
+
+Run integration tests locally with Docker:
+
+```bash
+uv sync --extra test
+
+# Fresh container (runs first-time setup automatically):
+docker compose down -v && docker compose up -d
+uv run pytest -m integration -v --cov
+
+# Or against an existing instance with known credentials:
+GANCIO_URL=http://localhost:13120 \
+GANCIO_ADMIN_EMAIL=admin \
+GANCIO_ADMIN_PASSWORD=yourpassword \
+uv run pytest -m integration -v --cov
+```
+
+### Linting
+
+```bash
+uvx ruff check
+uvx ruff check --fix  # auto-fix
+```
+
+## License
+
+[MIT](LICENSE)

gancio_py-0.1.0/docker-compose.yml

@@ -0,0 +1,8 @@
+services:
+  gancio:
+    image: cisti/gancio
+    restart: unless-stopped
+    environment:
+      - NODE_ENV=development
+    ports:
+      - "13120:13120"

gancio_py-0.1.0/gancio_py/__init__.py

@@ -0,0 +1,5 @@
+from gancio_py.client import Gancio as Gancio
+from gancio_py.exceptions import GancioError as GancioError
+from gancio_py.settings import BoolSetting as BoolSetting
+from gancio_py.settings import JsonSetting as JsonSetting
+from gancio_py.settings import StrSetting as StrSetting