indico-cli 0.4.1__tar.gz → 0.4.2__tar.gz

{indico_cli-0.4.1 → indico_cli-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: indico-cli
-Version: 0.4.1
+Version: 0.4.2
 Summary: CLI tool for interacting with Indico event management systems
 Project-URL: Repository, https://gitlab.cern.ch/cern-agent-skills/indico-cli
 License: MIT
@@ -60,6 +60,9 @@ API tokens can be generated at `<your-indico-url>/user/preferences/api`. Require
 # Full-text search across all content types
 indico-cli search-by-term --term "machine learning"
 
+# Full-text search with date range
+indico-cli search-by-term --term "Smith" --type contribution --from-date 2025-01-01 --to-date 2025-03-31
+
 # Search events in a category
 indico-cli search-events --category-id 4648 --from-date 2025-01-01
 
@@ -90,6 +93,12 @@ indico-cli files --event-id 137346 --no-download
 indico-cli download --url "https://indico.cern.ch/event/.../file.pdf"
 ```
 
+The `files` command covers every file source attached to an event:
+
+- **Event materials** — legacy `event.material[]` entries.
+- **Event folder attachments** — generic files uploaded directly to the event page (not under any contribution). Typical for short meetings like the LHC morning meeting, where a single slide deck is attached to the event itself.
+- **Contribution attachments** — files attached to individual contributions/talks.
+
 ### Create Events
 
 ```bash
@@ -105,7 +114,25 @@ indico-cli create-event-with-agenda --title "Workshop" --category-id 4648 \
 
 ### All Commands
 
-Run `indico-cli --help` to see all available commands, or `indico-cli <command> --help` for command-specific options.
+| Command | Description |
+|---------|-------------|
+| `configure` | Save Indico base URL and API token, and verify the connection. |
+| `user-info` | Show the current user's name, email, and admin status. |
+| `search-events` | List events in a category, with optional date range and public-only filter. |
+| `search-by-term` | Full-text search across categories, events, contributions, attachments, and notes. |
+| `search-categories` | Browse sub-categories of a given category. |
+| `event-details` | Show event metadata, optionally with contributions and sessions. |
+| `contributions` | List contributions (and optionally subcontributions) of an event. |
+| `files` | List and download all files attached to an event — event-level materials, event-page folder attachments, and contribution attachments. |
+| `download` | Download a single attachment by its URL. |
+| `create-event` | Create a new event (lecture, meeting, or conference). |
+| `create-session` | Create a session inside an event. |
+| `create-contribution` | Create a contribution inside an event, optionally in a given session. |
+| `add-timetable-entry` | Add a session block or contribution entry to the event timetable. |
+| `delete-timetable-entry` | Remove an entry from the event timetable. |
+| `create-event-with-agenda` | Create an event and populate its timetable from a JSON agenda file. |
+
+Run `indico-cli --help` for the same list, or `indico-cli <command> --help` for command-specific options.
 
 ## Claude Code Skill
 

{indico_cli-0.4.1 → indico_cli-0.4.2}/README.md

@@ -37,6 +37,9 @@ API tokens can be generated at `<your-indico-url>/user/preferences/api`. Require
 # Full-text search across all content types
 indico-cli search-by-term --term "machine learning"
 
+# Full-text search with date range
+indico-cli search-by-term --term "Smith" --type contribution --from-date 2025-01-01 --to-date 2025-03-31
+
 # Search events in a category
 indico-cli search-events --category-id 4648 --from-date 2025-01-01
 
@@ -67,6 +70,12 @@ indico-cli files --event-id 137346 --no-download
 indico-cli download --url "https://indico.cern.ch/event/.../file.pdf"
 ```
 
+The `files` command covers every file source attached to an event:
+
+- **Event materials** — legacy `event.material[]` entries.
+- **Event folder attachments** — generic files uploaded directly to the event page (not under any contribution). Typical for short meetings like the LHC morning meeting, where a single slide deck is attached to the event itself.
+- **Contribution attachments** — files attached to individual contributions/talks.
+
 ### Create Events
 
 ```bash
@@ -82,7 +91,25 @@ indico-cli create-event-with-agenda --title "Workshop" --category-id 4648 \
 
 ### All Commands
 
-Run `indico-cli --help` to see all available commands, or `indico-cli <command> --help` for command-specific options.
+| Command | Description |
+|---------|-------------|
+| `configure` | Save Indico base URL and API token, and verify the connection. |
+| `user-info` | Show the current user's name, email, and admin status. |
+| `search-events` | List events in a category, with optional date range and public-only filter. |
+| `search-by-term` | Full-text search across categories, events, contributions, attachments, and notes. |
+| `search-categories` | Browse sub-categories of a given category. |
+| `event-details` | Show event metadata, optionally with contributions and sessions. |
+| `contributions` | List contributions (and optionally subcontributions) of an event. |
+| `files` | List and download all files attached to an event — event-level materials, event-page folder attachments, and contribution attachments. |
+| `download` | Download a single attachment by its URL. |
+| `create-event` | Create a new event (lecture, meeting, or conference). |
+| `create-session` | Create a session inside an event. |
+| `create-contribution` | Create a contribution inside an event, optionally in a given session. |
+| `add-timetable-entry` | Add a session block or contribution entry to the event timetable. |
+| `delete-timetable-entry` | Remove an entry from the event timetable. |
+| `create-event-with-agenda` | Create an event and populate its timetable from a JSON agenda file. |
+
+Run `indico-cli --help` for the same list, or `indico-cli <command> --help` for command-specific options.
 
 ## Claude Code Skill
 

indico_cli-0.4.2/indico_cli/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '0.4.2'
+__version_tuple__ = version_tuple = (0, 4, 2)
+
+__commit_id__ = commit_id = None

{indico_cli-0.4.1 → indico_cli-0.4.2}/indico_cli/cli.py

@@ -128,11 +128,13 @@ def search_events(ctx, category_id, from_date, to_date, limit, only_public):
 @click.option("--type", "type_filter", default=None,
               type=click.Choice(["category", "event", "contribution", "subcontribution", "attachment", "event_note"]),
               help="Filter to a specific content type")
+@click.option("--from-date", default=None, help="Start date filter (YYYY-MM-DD)")
+@click.option("--to-date", default=None, help="End date filter (YYYY-MM-DD)")
 @click.pass_context
-def search_by_term(ctx, term, limit, type_filter):
+def search_by_term(ctx, term, limit, type_filter, from_date, to_date):
     """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, type_filter))
+    result = run_async(client.search_events_by_term(term, limit, type_filter, from_date, to_date))
     click.echo(result)
 
 

{indico_cli-0.4.1 → indico_cli-0.4.2}/indico_cli/indico_api.py

@@ -365,7 +365,8 @@ class IndicoClient:
         return response
 
     async def search_events_by_term(
-        self, search_term: str, limit: int = 50, type_filter: Optional[str] = None
+        self, search_term: str, limit: int = 50, type_filter: Optional[str] = None,
+        from_date: Optional[str] = None, to_date: Optional[str] = None
     ) -> str:
         """Search for content by keyword/term using comprehensive Indico search API"""
         try:
@@ -387,6 +388,13 @@ class IndicoClient:
             else:
                 search_types = all_search_types
 
+            # Build start_range filter if date params provided
+            start_range = None
+            if from_date or to_date:
+                range_start = from_date or "*"
+                range_end = to_date or "*"
+                start_range = f"[{range_start} TO {range_end}]"
+
             all_results = {}
             total_found = 0
 
@@ -396,6 +404,8 @@ class IndicoClient:
                     params = {"q": search_term, "type": search_type}
                     if limit:
                         params["limit"] = str(limit)
+                    if start_range:
+                        params["start_range"] = start_range
 
                     # Use the new search API endpoint
                     result = await self.api.get(f"/search/api/search", params)
@@ -991,6 +1001,41 @@ class IndicoClient:
                         response += f"    - {filename} ({file_size})\n"
                 response += "\n"
 
+            # 1b. Check event-level folders/attachments (generic attachments uploaded to the event page)
+            event_folders = event.get("folders", [])
+            if event_folders:
+                event_folder_files_count = 0
+                for folder in event_folders:
+                    folder_title = folder.get("title", "Unknown Folder")
+                    folder_id = folder.get("id", "")
+                    attachments = folder.get("attachments", [])
+
+                    for attachment in attachments:
+                        filename = attachment.get(
+                            "filename",
+                            attachment.get("title", "unknown_file"),
+                        )
+                        attachment_id = attachment.get("id", "")
+                        file_size = attachment.get("size", "unknown size")
+                        download_url = attachment.get("download_url") or attachment.get("url")
+
+                        files_found.append(
+                            {
+                                "filename": filename,
+                                "attachment_id": attachment_id,
+                                "folder_id": folder_id,
+                                "size": file_size,
+                                "source": f"Event Folder: {folder_title}",
+                                "type": "event_attachment",
+                                "download_url": download_url,
+                                "api_path": f"/event/{event_id}/attachments/{attachment_id}/{filename}",
+                            }
+                        )
+                        event_folder_files_count += 1
+
+                if event_folder_files_count > 0:
+                    response += f"Event Attachments: {event_folder_files_count} files found\n\n"
+
             # 2. Check contribution-level materials/attachments
             contributions = event.get("contributions", [])
             if contributions:

{indico_cli-0.4.1 → indico_cli-0.4.2}/skills/indico-skill/SKILL.md

@@ -75,7 +75,7 @@ The goal is to answer the user's question, not just list metadata. If slides wer
 ### search-by-term — Full-text search across all Indico content
 
 ```bash
-uvx indico-cli search-by-term --term "<query>" [--limit N] [--type TYPE]
+uvx indico-cli search-by-term --term "<query>" [--limit N] [--type TYPE] [--from-date YYYY-MM-DD] [--to-date YYYY-MM-DD]
 ```
 
 | Parameter | Required | Description |
@@ -83,8 +83,10 @@ uvx indico-cli search-by-term --term "<query>" [--limit N] [--type TYPE]
 | `--term` | Yes | Search keyword or phrase |
 | `--limit` | No | Max results per content type (default: 50) |
 | `--type` | No | Filter to one content type: `event`, `contribution`, `subcontribution`, `attachment`, `event_note`, `category` |
+| `--from-date` | No | Start date filter (YYYY-MM-DD) |
+| `--to-date` | No | End date filter (YYYY-MM-DD) |
 
-Searches categories, events, contributions, subcontributions, attachments, and notes.
+Searches categories, events, contributions, subcontributions, attachments, and notes. Use `--from-date`/`--to-date` to narrow results to a specific time range.
 
 ### search-events — Search events in a category by date
 
@@ -159,6 +161,11 @@ uvx indico-cli files --event-id <ID> [--download | --no-download] [--download-di
 | `--download/--no-download` | No | Download files (default: download) |
 | `--download-dir` | No | Directory for downloads |
 
+Covers three sources of files:
+- Event-level legacy **materials** (`event.material[]`)
+- Event-level **folder attachments** — generic files uploaded to the event page itself, not tied to any contribution (e.g. the single slide deck of an LHC morning meeting)
+- **Contribution attachments** — files attached to individual talks/contributions
+
 If the built-in download fails (403), list with `--no-download` to get URLs, then use curl:
 
 ```bash

indico_cli-0.4.2/tests/test_get_files.py

@@ -0,0 +1,61 @@
+"""Tests for get_files discovery of the different Indico attachment sources."""
+
+import pytest
+from unittest.mock import AsyncMock
+
+from indico_cli.indico_api import IndicoAPI, IndicoClient
+
+
+def make_client():
+    return IndicoClient(IndicoAPI("https://indico.cern.ch"))
+
+
+EVENT_FOLDER_ATTACHMENT = {
+    "count": 1,
+    "results": [{
+        "title": "LHC morning meeting",
+        "folders": [{
+            "title": "Slides",
+            "id": 3254260,
+            "attachments": [{
+                "filename": "2026.04.13.morning-meeting.pdf",
+                "id": 5808485,
+                "size": 1073612,
+                "download_url": "https://indico.cern.ch/event/1649151/attachments/3254260/5808485/2026.04.13.morning-meeting.pdf",
+            }],
+        }],
+        "contributions": [],
+    }],
+}
+
+
+class TestEventFolderAttachments:
+    @pytest.mark.asyncio
+    async def test_lists_event_level_folder_attachment(self):
+        """Generic attachments uploaded to the event page (not a contribution) must be discovered."""
+        client = make_client()
+        client.api.get = AsyncMock(return_value=EVENT_FOLDER_ATTACHMENT)
+        result = await client.get_files("1649151", download_files=False, include_content=False)
+        assert "2026.04.13.morning-meeting.pdf" in result
+        assert "Event Attachments: 1 files found" in result
+        assert "Event Folder: Slides" in result
+        assert "Total files found: 1" in result
+
+    @pytest.mark.asyncio
+    async def test_event_folder_download_url_exposed(self):
+        """The attachment's download_url must be surfaced so downloads hit the correct path."""
+        client = make_client()
+        client.api.get = AsyncMock(return_value=EVENT_FOLDER_ATTACHMENT)
+        result = await client.get_files("1649151", download_files=False, include_content=False)
+        assert "/event/1649151/attachments/3254260/5808485/" in result
+
+    @pytest.mark.asyncio
+    async def test_no_folders_no_false_positive(self):
+        """Events without folder attachments must not report event attachments."""
+        client = make_client()
+        client.api.get = AsyncMock(return_value={
+            "count": 1,
+            "results": [{"title": "Empty", "folders": [], "contributions": []}],
+        })
+        result = await client.get_files("1", download_files=False, include_content=False)
+        assert "Event Attachments:" not in result

{indico_cli-0.4.1 → indico_cli-0.4.2}/uv.lock

@@ -99,10 +99,84 @@ dependencies = [
     { name = "httpx" },
 ]
 
+[package.optional-dependencies]
+dev = [
+    { name = "pytest" },
+    { name = "pytest-asyncio" },
+]
+
 [package.metadata]
 requires-dist = [
     { name = "click", specifier = ">=8.0" },
     { name = "httpx", specifier = ">=0.25" },
+    { name = "pytest", marker = "extra == 'dev'", specifier = ">=7.0" },
+    { name = "pytest-asyncio", marker = "extra == 'dev'", specifier = ">=0.21" },
+]
+provides-extras = ["dev"]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://acc-py-repo.cern.ch/repository/vr-py-releases/simple" }
+sdist = { url = "https://acc-py-repo.cern.ch/repository/vr-py-releases/resources/iniconfig/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43Z" }
+wheels = [
+    { url = "https://acc-py-repo.cern.ch/repository/vr-py-releases/resources/iniconfig/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41Z" },
+]
+
+[[package]]
+name = "packaging"
+version = "26.0"
+source = { registry = "https://acc-py-repo.cern.ch/repository/vr-py-releases/simple" }
+sdist = { url = "https://acc-py-repo.cern.ch/repository/vr-py-releases/resources/packaging/packaging-26.0.tar.gz", hash = "sha256:00243ae351a257117b6a241061796684b084ed1c516a08c48a3f7e147a9d80b4", size = 143416, upload-time = "2026-01-21T20:50:39Z" }
+wheels = [
+    { url = "https://acc-py-repo.cern.ch/repository/vr-py-releases/resources/packaging/packaging-26.0-py3-none-any.whl", hash = "sha256:b36f1fef9334a5588b4166f8bcd26a14e521f2b55e6b9de3aaa80d3ff7a37529", size = 74366, upload-time = "2026-01-21T20:50:37Z" },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://acc-py-repo.cern.ch/repository/vr-py-releases/simple" }
+sdist = { url = "https://acc-py-repo.cern.ch/repository/vr-py-releases/resources/pluggy/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07Z" }
+wheels = [
+    { url = "https://acc-py-repo.cern.ch/repository/vr-py-releases/resources/pluggy/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.20.0"
+source = { registry = "https://acc-py-repo.cern.ch/repository/vr-py-releases/simple" }
+sdist = { url = "https://acc-py-repo.cern.ch/repository/vr-py-releases/resources/pygments/pygments-2.20.0.tar.gz", hash = "sha256:6757cd03768053ff99f3039c1a36d6c0aa0b263438fcab17520b30a303a82b5f", size = 4955991, upload-time = "2026-03-29T13:29:33Z" }
+wheels = [
+    { url = "https://acc-py-repo.cern.ch/repository/vr-py-releases/resources/pygments/pygments-2.20.0-py3-none-any.whl", hash = "sha256:81a9e26dd42fd28a23a2d169d86d7ac03b46e2f8b59ed4698fb4785f946d0176", size = 1231151, upload-time = "2026-03-29T13:29:30Z" },
+]
+
+[[package]]
+name = "pytest"
+version = "9.0.3"
+source = { registry = "https://acc-py-repo.cern.ch/repository/vr-py-releases/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+]
+sdist = { url = "https://acc-py-repo.cern.ch/repository/vr-py-releases/resources/pytest/pytest-9.0.3.tar.gz", hash = "sha256:b86ada508af81d19edeb213c681b1d48246c1a91d304c6c81a427674c17eb91c", size = 1572165, upload-time = "2026-04-07T17:16:18Z" }
+wheels = [
+    { url = "https://acc-py-repo.cern.ch/repository/vr-py-releases/resources/pytest/pytest-9.0.3-py3-none-any.whl", hash = "sha256:2c5efc453d45394fdd706ade797c0a81091eccd1d6e4bccfcd476e2b8e0ab5d9", size = 375249, upload-time = "2026-04-07T17:16:16Z" },
+]
+
+[[package]]
+name = "pytest-asyncio"
+version = "1.3.0"
+source = { registry = "https://acc-py-repo.cern.ch/repository/vr-py-releases/simple" }
+dependencies = [
+    { name = "pytest" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://acc-py-repo.cern.ch/repository/vr-py-releases/resources/pytest-asyncio/pytest_asyncio-1.3.0.tar.gz", hash = "sha256:d7f52f36d231b80ee124cd216ffb19369aa168fc10095013c6b014a34d3ee9e5", size = 50087, upload-time = "2025-11-10T16:07:47Z" }
+wheels = [
+    { url = "https://acc-py-repo.cern.ch/repository/vr-py-releases/resources/pytest-asyncio/pytest_asyncio-1.3.0-py3-none-any.whl", hash = "sha256:611e26147c7f77640e6d0a92a38ed17c3e9848063698d5c93d5aa7aa11cebff5", size = 15075, upload-time = "2025-11-10T16:07:45Z" },
 ]
 
 [[package]]

indico_cli-0.4.1/indico_cli/_version.py

@@ -1,34 +0,0 @@
-# file generated by setuptools-scm
-# don't change, don't track in version control
-
-__all__ = [
-    "__version__",
-    "__version_tuple__",
-    "version",
-    "version_tuple",
-    "__commit_id__",
-    "commit_id",
-]
-
-TYPE_CHECKING = False
-if TYPE_CHECKING:
-    from typing import Tuple
-    from typing import Union
-
-    VERSION_TUPLE = Tuple[Union[int, str], ...]
-    COMMIT_ID = Union[str, None]
-else:
-    VERSION_TUPLE = object
-    COMMIT_ID = object
-
-version: str
-__version__: str
-__version_tuple__: VERSION_TUPLE
-version_tuple: VERSION_TUPLE
-commit_id: COMMIT_ID
-__commit_id__: COMMIT_ID
-
-__version__ = version = '0.4.1'
-__version_tuple__ = version_tuple = (0, 4, 1)
-
-__commit_id__ = commit_id = None