indico-cli 0.1.0__tar.gz

indico_cli-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+__pycache__/
+*.pyc
+*.egg-info/
+dist/
+build/
+downloads/
+*.pdf
+*.pptx
+skill/indico-cli-workspace/
+.env
+.env.*

indico_cli-0.1.0/.gitlab-ci.yml

@@ -0,0 +1,15 @@
+stages:
+  - publish
+
+publish-pypi:
+  stage: publish
+  image: python:3.12-slim
+  rules:
+    - if: $CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+/
+  script:
+    - pip install build twine
+    - python -m build
+    - twine upload dist/*
+  variables:
+    TWINE_USERNAME: __token__
+    TWINE_PASSWORD: $PYPI_API_TOKEN

indico_cli-0.1.0/CLAUDE.md

@@ -0,0 +1,36 @@
+# CLAUDE.md
+
+## Project Overview
+
+Python CLI tool for interacting with Indico event management systems. Extracted from the `indico-mcp` MCP server. Run via `uvx indico-cli` or install with `pip install indico-cli`.
+
+## Architecture
+
+- `indico_cli/cli.py`: Click CLI entry point with 15 subcommands
+- `indico_cli/indico_api.py`: HTTP API client (`IndicoAPI` for low-level requests, `IndicoClient` for high-level operations)
+- `indico_cli/utils.py`: Utility functions for building Indico API request data
+- `skill/`: Claude Code skill package (14 skills mapping to CLI commands)
+
+## Development
+
+```bash
+# Install in dev mode
+uv pip install -e .
+
+# Run CLI
+indico-cli --help
+
+# Run with uvx from source
+uvx --from . indico-cli --help
+```
+
+## Configuration
+
+Requires env vars `INDICO_BASE_URL` and `INDICO_API_TOKEN`, or use `indico-cli configure`. A `.env` file is supported but must never be committed.
+
+## Key Technical Details
+
+- All API calls are async (httpx). The CLI wraps them with `asyncio.run()`.
+- Bearer token auth only (tokens starting with `indp_`). No `Content-Type` header on GET requests (Indico returns 403 for file downloads if `Content-Type: application/json` is set).
+- The Indico export API returns local sequential contribution IDs (e.g., 1, 2, 3) not database IDs. Always use `download_url` from API responses for file downloads, not reconstructed paths.
+- Room booking is excluded (needs separate fix).

indico_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 indico-cli contributors
+
+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.

indico_cli-0.1.0/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: indico-cli
+Version: 0.1.0
+Summary: CLI tool for interacting with Indico event management systems
+Project-URL: Repository, https://gitlab.cern.ch/cern-agent-skills/indico-cli
+License: MIT
+License-File: LICENSE
+Keywords: cern,cli,conferences,events,indico
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.12
+Requires-Dist: click>=8.0
+Requires-Dist: httpx>=0.25
+Description-Content-Type: text/markdown
+
+# indico-cli
+
+Command line interface for interacting with [Indico](https://getindico.io/) event management systems.
+
+## Installation
+
+```bash
+# Run directly with uvx (recommended)
+uvx indico-cli --help
+
+# Or install with pip
+pip install indico-cli
+```
+
+## Configuration
+
+Set environment variables:
+
+```bash
+export INDICO_BASE_URL="https://indico.cern.ch"
+export INDICO_API_TOKEN="indp_..."  # Bearer token from Indico preferences
+```
+
+Or use the `configure` command to save credentials:
+
+```bash
+indico-cli configure --base-url https://indico.cern.ch --token indp_...
+```
+
+API tokens can be generated at `<your-indico-url>/user/preferences/api`. Required scopes: `read:legacy_api`, `write:legacy_api` (for create operations), `read:user` (optional).
+
+## Usage
+
+### Search
+
+```bash
+# Full-text search across all content types
+indico-cli search-by-term --term "machine learning"
+
+# Search events in a category
+indico-cli search-events --category-id 4648 --from-date 2025-01-01
+
+# Browse categories
+indico-cli search-categories --category-id 0
+```
+
+### Event Details
+
+```bash
+# Get event info with contributions and sessions
+indico-cli event-details --event-id 137346 --contributions --sessions
+
+# List contributions/talks
+indico-cli contributions --event-id 137346 --subcontributions
+```
+
+### Files
+
+```bash
+# List and download all event files
+indico-cli files --event-id 137346
+
+# List files without downloading
+indico-cli files --event-id 137346 --no-download
+
+# Download a single attachment
+indico-cli download --url "https://indico.cern.ch/event/.../file.pdf"
+```
+
+### Create Events
+
+```bash
+# Create a simple meeting
+indico-cli create-event --title "Team Meeting" --category-id 4648 --type meeting \
+  --start 2025-06-15T09:00:00 --end 2025-06-15T10:00:00
+
+# Create event with full agenda from JSON file
+indico-cli create-event-with-agenda --title "Workshop" --category-id 4648 \
+  --type meeting --start 2025-06-15T09:00:00 --end 2025-06-15T17:00:00 \
+  --agenda-file agenda.json
+```
+
+### All Commands
+
+Run `indico-cli --help` to see all available commands, or `indico-cli <command> --help` for command-specific options.
+
+## Claude Code Skill
+
+A Claude Code skill package is available in `skill/` for AI-assisted Indico workflows. Install it with:
+
+```bash
+claude plugin install ./skill
+```
+
+## Documentation
+
+- [Indico HTTP API docs](https://docs.getindico.io/en/stable/http-api/)
+- [Indico platform](https://getindico.io/)

indico_cli-0.1.0/README.md

@@ -0,0 +1,98 @@
+# indico-cli
+
+Command line interface for interacting with [Indico](https://getindico.io/) event management systems.
+
+## Installation
+
+```bash
+# Run directly with uvx (recommended)
+uvx indico-cli --help
+
+# Or install with pip
+pip install indico-cli
+```
+
+## Configuration
+
+Set environment variables:
+
+```bash
+export INDICO_BASE_URL="https://indico.cern.ch"
+export INDICO_API_TOKEN="indp_..."  # Bearer token from Indico preferences
+```
+
+Or use the `configure` command to save credentials:
+
+```bash
+indico-cli configure --base-url https://indico.cern.ch --token indp_...
+```
+
+API tokens can be generated at `<your-indico-url>/user/preferences/api`. Required scopes: `read:legacy_api`, `write:legacy_api` (for create operations), `read:user` (optional).
+
+## Usage
+
+### Search
+
+```bash
+# Full-text search across all content types
+indico-cli search-by-term --term "machine learning"
+
+# Search events in a category
+indico-cli search-events --category-id 4648 --from-date 2025-01-01
+
+# Browse categories
+indico-cli search-categories --category-id 0
+```
+
+### Event Details
+
+```bash
+# Get event info with contributions and sessions
+indico-cli event-details --event-id 137346 --contributions --sessions
+
+# List contributions/talks
+indico-cli contributions --event-id 137346 --subcontributions
+```
+
+### Files
+
+```bash
+# List and download all event files
+indico-cli files --event-id 137346
+
+# List files without downloading
+indico-cli files --event-id 137346 --no-download
+
+# Download a single attachment
+indico-cli download --url "https://indico.cern.ch/event/.../file.pdf"
+```
+
+### Create Events
+
+```bash
+# Create a simple meeting
+indico-cli create-event --title "Team Meeting" --category-id 4648 --type meeting \
+  --start 2025-06-15T09:00:00 --end 2025-06-15T10:00:00
+
+# Create event with full agenda from JSON file
+indico-cli create-event-with-agenda --title "Workshop" --category-id 4648 \
+  --type meeting --start 2025-06-15T09:00:00 --end 2025-06-15T17:00:00 \
+  --agenda-file agenda.json
+```
+
+### All Commands
+
+Run `indico-cli --help` to see all available commands, or `indico-cli <command> --help` for command-specific options.
+
+## Claude Code Skill
+
+A Claude Code skill package is available in `skill/` for AI-assisted Indico workflows. Install it with:
+
+```bash
+claude plugin install ./skill
+```
+
+## Documentation
+
+- [Indico HTTP API docs](https://docs.getindico.io/en/stable/http-api/)
+- [Indico platform](https://getindico.io/)

indico_cli-0.1.0/indico_cli/__init__.py

@@ -0,0 +1,3 @@
+"""Indico CLI - Command line interface for Indico event management systems."""
+
+__version__ = "0.1.0"

indico_cli-0.1.0/indico_cli/cli.py

@@ -0,0 +1,326 @@
+#!/usr/bin/env python3
+"""CLI entry point for interacting with Indico event management systems."""
+
+import asyncio
+import json
+import os
+import sys
+from pathlib import Path
+from typing import Optional
+
+import click
+
+from indico_cli.indico_api import IndicoAPI, IndicoClient
+
+CONFIG_DIR = Path.home() / ".config" / "indico-cli"
+CONFIG_FILE = CONFIG_DIR / "config.json"
+
+
+def load_config() -> dict:
+    """Load saved configuration from disk, returning empty dict on failure."""
+    if CONFIG_FILE.exists():
+        try:
+            return json.loads(CONFIG_FILE.read_text())
+        except (json.JSONDecodeError, OSError):
+            return {}
+    return {}
+
+
+def save_config(base_url: str, token: str) -> None:
+    """Persist configuration to ~/.config/indico-cli/config.json."""
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    CONFIG_FILE.write_text(json.dumps({"base_url": base_url, "token": token}, indent=2))
+
+
+def get_client(base_url: Optional[str], token: Optional[str]) -> IndicoClient:
+    """Create an IndicoClient from CLI args, env vars, or saved config."""
+    saved_config = load_config()
+    resolved_url = base_url or os.getenv("INDICO_BASE_URL") or saved_config.get("base_url", "")
+    resolved_token = token or os.getenv("INDICO_API_TOKEN") or saved_config.get("token", "")
+
+    if not resolved_url:
+        click.echo("Error: --base-url, INDICO_BASE_URL, or saved config required", err=True)
+        sys.exit(1)
+
+    api = IndicoAPI(resolved_url, bearer_token=resolved_token if resolved_token else None)
+    return IndicoClient(api)
+
+
+def run_async(coro):
+    """Run an async coroutine and return its result."""
+    return asyncio.run(coro)
+
+
+def parse_speakers_json(speakers_string: Optional[str]):
+    """Parse a JSON string of speakers into a list of dicts."""
+    if not speakers_string:
+        return None
+    return json.loads(speakers_string)
+
+
+@click.group()
+@click.option("--base-url", envvar="INDICO_BASE_URL", help="Indico instance URL")
+@click.option("--token", envvar="INDICO_API_TOKEN", help="API bearer token")
+@click.pass_context
+def cli(ctx, base_url, token):
+    """CLI for interacting with Indico event management systems."""
+    ctx.ensure_object(dict)
+    ctx.obj["base_url"] = base_url
+    ctx.obj["token"] = token
+
+
+@cli.command()
+@click.option("--base-url", required=True, help="Indico instance URL")
+@click.option("--token", default="", help="API bearer token")
+def configure(base_url, token):
+    """Configure connection to an Indico instance and test it."""
+    api = IndicoAPI(base_url, bearer_token=token if token else None)
+    client = IndicoClient(api)
+    try:
+        result = run_async(client.get_user_info())
+        click.echo("Connection successful!")
+        click.echo(result)
+        save_config(base_url, token)
+        click.echo(f"Configuration saved to {CONFIG_FILE}")
+    except Exception as error:
+        click.echo(f"Connection test failed: {error}", err=True)
+        sys.exit(1)
+
+
+@cli.command("user-info")
+@click.pass_context
+def user_info(ctx):
+    """Get current user information."""
+    client = get_client(ctx.obj["base_url"], ctx.obj["token"])
+    result = run_async(client.get_user_info())
+    click.echo(result)
+
+
+@cli.command("search-events")
+@click.option("--category-id", required=True, help="Category ID to search in")
+@click.option("--from-date", default=None, help="Start date filter (e.g. 2024-01-01)")
+@click.option("--to-date", default=None, help="End date filter (e.g. 2024-12-31)")
+@click.option("--limit", type=int, default=None, help="Maximum number of results")
+@click.option("--only-public", is_flag=True, default=False, help="Only show public events")
+@click.pass_context
+def search_events(ctx, category_id, from_date, to_date, limit, only_public):
+    """Search for events in a category."""
+    client = get_client(ctx.obj["base_url"], ctx.obj["token"])
+    result = run_async(client.search_events(category_id, from_date, to_date, limit, only_public))
+    click.echo(result)
+
+
+@cli.command("search-by-term")
+@click.option("--term", required=True, help="Search term")
+@click.option("--limit", type=int, default=50, help="Maximum number of results")
+@click.pass_context
+def search_by_term(ctx, term, limit):
+    """Search for events by keyword/term."""
+    client = get_client(ctx.obj["base_url"], ctx.obj["token"])
+    result = run_async(client.search_events_by_term(term, limit))
+    click.echo(result)
+
+
+@cli.command("search-categories")
+@click.option("--category-id", default="0", help="Parent category ID (default: root)")
+@click.option("--limit", type=int, default=None, help="Maximum number of results")
+@click.pass_context
+def search_categories(ctx, category_id, limit):
+    """Search for event categories."""
+    client = get_client(ctx.obj["base_url"], ctx.obj["token"])
+    result = run_async(client.search_categories(category_id, limit))
+    click.echo(result)
+
+
+@cli.command("event-details")
+@click.option("--event-id", required=True, help="Event ID")
+@click.option("--contributions", is_flag=True, default=False, help="Include contributions")
+@click.option("--sessions", is_flag=True, default=False, help="Include sessions")
+@click.pass_context
+def event_details(ctx, event_id, contributions, sessions):
+    """Get detailed information about a specific event."""
+    client = get_client(ctx.obj["base_url"], ctx.obj["token"])
+    result = run_async(client.get_event_details(event_id, contributions, sessions))
+    click.echo(result)
+
+
+@cli.command()
+@click.option("--event-id", required=True, help="Event ID")
+@click.option("--subcontributions", is_flag=True, default=False, help="Include subcontributions")
+@click.option("--limit", type=int, default=None, help="Maximum number of results")
+@click.pass_context
+def contributions(ctx, event_id, subcontributions, limit):
+    """Get contributions for a specific event."""
+    client = get_client(ctx.obj["base_url"], ctx.obj["token"])
+    result = run_async(client.get_event_contributions(event_id, subcontributions, limit))
+    click.echo(result)
+
+
+@cli.command()
+@click.option("--event-id", required=True, help="Event ID")
+@click.option("--download/--no-download", default=True, help="Download files (default: yes)")
+@click.option("--download-dir", default=None, help="Directory to save downloaded files")
+@click.pass_context
+def files(ctx, event_id, download, download_dir):
+    """Get and optionally download files for an event."""
+    client = get_client(ctx.obj["base_url"], ctx.obj["token"])
+    result = run_async(client.get_files(event_id, download_files=download, download_dir=download_dir))
+    click.echo(result)
+
+
+@cli.command()
+@click.option("--url", required=True, help="Download URL for the attachment")
+@click.option("--filename", default=None, help="Save as this filename")
+@click.pass_context
+def download(ctx, url, filename):
+    """Download a single file attachment."""
+    client = get_client(ctx.obj["base_url"], ctx.obj["token"])
+    result = run_async(client.download_single_attachment(url, filename))
+    click.echo(result)
+
+
+@cli.command("create-event")
+@click.option("--title", required=True, help="Event title")
+@click.option("--category-id", required=True, help="Category ID")
+@click.option("--type", "event_type", required=True, type=click.Choice(["lecture", "meeting", "conference"]), help="Event type")
+@click.option("--start", default=None, help="Start date/time (ISO format)")
+@click.option("--end", default=None, help="End date/time (ISO format)")
+@click.option("--timezone", default=None, help="Timezone (e.g. Europe/Zurich)")
+@click.option("--description", default=None, help="Event description")
+@click.option("--location", default=None, help="Event location")
+@click.option("--room", default=None, help="Room name")
+@click.option("--speakers", default=None, help="Speakers as JSON string")
+@click.pass_context
+def create_event(ctx, title, category_id, event_type, start, end, timezone, description, location, room, speakers):
+    """Create a new event."""
+    client = get_client(ctx.obj["base_url"], ctx.obj["token"])
+    parsed_speakers = parse_speakers_json(speakers)
+    result = run_async(client.create_event(
+        title=title,
+        category_id=category_id,
+        event_type=event_type,
+        start_date=start,
+        end_date=end,
+        timezone=timezone,
+        description=description,
+        location=location,
+        room=room,
+        speakers=parsed_speakers,
+    ))
+    click.echo(result)
+
+
+@cli.command("create-session")
+@click.option("--event-id", required=True, help="Event ID")
+@click.option("--title", required=True, help="Session title")
+@click.option("--description", default=None, help="Session description")
+@click.pass_context
+def create_session(ctx, event_id, title, description):
+    """Create a session in an event."""
+    client = get_client(ctx.obj["base_url"], ctx.obj["token"])
+    result = run_async(client.create_session(
+        event_id=event_id,
+        title=title,
+        description=description,
+    ))
+    click.echo(result)
+
+
+@cli.command("create-contribution")
+@click.option("--event-id", required=True, help="Event ID")
+@click.option("--title", required=True, help="Contribution title")
+@click.option("--description", default=None, help="Contribution description")
+@click.option("--duration", type=int, default=None, help="Duration in minutes")
+@click.option("--speakers", default=None, help="Speakers as JSON string")
+@click.option("--session-id", default=None, help="Session ID to add contribution to")
+@click.pass_context
+def create_contribution(ctx, event_id, title, description, duration, speakers, session_id):
+    """Create a contribution in an event."""
+    client = get_client(ctx.obj["base_url"], ctx.obj["token"])
+    parsed_speakers = parse_speakers_json(speakers)
+    result = run_async(client.create_contribution(
+        event_id=event_id,
+        title=title,
+        description=description,
+        duration_minutes=duration,
+        speakers=parsed_speakers,
+        session_id=session_id,
+    ))
+    click.echo(result)
+
+
+@cli.command("add-timetable-entry")
+@click.option("--event-id", required=True, help="Event ID")
+@click.option("--type", "entry_type", required=True, type=click.Choice(["session_block", "contribution"]), help="Entry type")
+@click.option("--object-id", required=True, help="Object ID (session or contribution)")
+@click.option("--start", required=True, help="Start date/time (ISO format)")
+@click.option("--duration", type=int, default=None, help="Duration in minutes")
+@click.pass_context
+def add_timetable_entry(ctx, event_id, entry_type, object_id, start, duration):
+    """Add an entry to the event timetable."""
+    client = get_client(ctx.obj["base_url"], ctx.obj["token"])
+    result = run_async(client.add_timetable_entry(
+        event_id=event_id,
+        entry_type=entry_type,
+        object_id=object_id,
+        start_date=start,
+        duration_minutes=duration,
+    ))
+    click.echo(result)
+
+
+@cli.command("delete-timetable-entry")
+@click.option("--event-id", required=True, help="Event ID")
+@click.option("--entry-id", required=True, help="Timetable entry ID")
+@click.pass_context
+def delete_timetable_entry(ctx, event_id, entry_id):
+    """Delete a timetable entry from an event."""
+    client = get_client(ctx.obj["base_url"], ctx.obj["token"])
+    result = run_async(client.delete_timetable_entry(
+        event_id=event_id,
+        entry_id=entry_id,
+    ))
+    click.echo(result)
+
+
+@cli.command("create-event-with-agenda")
+@click.option("--title", required=True, help="Event title")
+@click.option("--category-id", required=True, help="Category ID")
+@click.option("--type", "event_type", required=True, type=click.Choice(["lecture", "meeting", "conference"]), help="Event type")
+@click.option("--start", required=True, help="Start date/time (ISO format)")
+@click.option("--end", required=True, help="End date/time (ISO format)")
+@click.option("--timezone", default=None, help="Timezone (e.g. Europe/Zurich)")
+@click.option("--description", default=None, help="Event description")
+@click.option("--location", default=None, help="Event location")
+@click.option("--room", default=None, help="Room name")
+@click.option("--speakers", default=None, help="Speakers as JSON string")
+@click.option("--agenda-file", type=click.Path(exists=True), default=None, help="Path to JSON file with agenda array")
+@click.pass_context
+def create_event_with_agenda(ctx, title, category_id, event_type, start, end, timezone, description, location, room, speakers, agenda_file):
+    """Create an event with a full agenda from a JSON file."""
+    client = get_client(ctx.obj["base_url"], ctx.obj["token"])
+    parsed_speakers = parse_speakers_json(speakers)
+
+    agenda_data = None
+    if agenda_file:
+        with open(agenda_file) as agenda_fh:
+            agenda_data = json.load(agenda_fh)
+
+    result = run_async(client.create_event_with_agenda(
+        title=title,
+        category_id=category_id,
+        event_type=event_type,
+        start_date=start,
+        end_date=end,
+        timezone=timezone,
+        description=description,
+        location=location,
+        room=room,
+        speakers=parsed_speakers,
+        agenda=agenda_data,
+    ))
+    click.echo(result)
+
+
+if __name__ == "__main__":
+    cli()