scholarinboxcli 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

scholarinboxcli/services/collections.py

@@ -0,0 +1,130 @@
+"""Collection name/ID resolution helpers."""
+
+from __future__ import annotations
+
+from scholarinboxcli.api.client import ApiError, ScholarInboxClient
+
+
+def normalize_name(name: str) -> str:
+    return name.strip().lower()
+
+
+def collection_candidates(items: object) -> list[tuple[str, str]]:
+    if not isinstance(items, list):
+        return []
+    candidates: list[tuple[str, str]] = []
+    for item in items:
+        if isinstance(item, dict):
+            name = item.get("name") or item.get("collection_name") or ""
+            cid = str(item.get("id") or item.get("collection_id") or "")
+        elif isinstance(item, str):
+            name = item
+            cid = ""
+        else:
+            continue
+        if name:
+            candidates.append((name, cid))
+    return candidates
+
+
+def collection_items_from_response(data: object) -> object:
+    if isinstance(data, dict):
+        for key in ("collections", "expanded_collections", "collection_names"):
+            if key in data:
+                return data.get(key)
+        return data
+    return data
+
+
+def collection_candidates_from_map(data: object) -> list[tuple[str, str]]:
+    if not isinstance(data, dict):
+        return []
+    mapping = data.get("collection_names_to_ids_dict")
+    if not isinstance(mapping, dict):
+        return []
+    return [(str(name), str(cid)) for name, cid in mapping.items() if name and cid is not None]
+
+
+def candidates_have_ids(candidates: list[tuple[str, str]]) -> bool:
+    return any(cid for _, cid in candidates)
+
+
+def match_collection_name(candidates: list[tuple[str, str]], identifier: str) -> str | None:
+    target = normalize_name(identifier)
+    names = [(name, cid) for name, cid in candidates if name]
+
+    for name, _ in names:
+        if normalize_name(name) == target:
+            return name
+
+    prefix = [c for c in names if normalize_name(c[0]).startswith(target)]
+    if len(prefix) == 1:
+        return prefix[0][0]
+    if len(prefix) > 1:
+        names_str = ", ".join([n for n, _ in prefix[:10]])
+        raise ApiError(f"Ambiguous collection name. Matches: {names_str}")
+
+    contains = [c for c in names if target in normalize_name(c[0])]
+    if len(contains) == 1:
+        return contains[0][0]
+    if len(contains) > 1:
+        names_str = ", ".join([n for n, _ in contains[:10]])
+        raise ApiError(f"Ambiguous collection name. Matches: {names_str}")
+
+    return None
+
+
+def resolve_collection_id(client: ScholarInboxClient, identifier: str) -> str:
+    """Resolve numeric IDs directly, otherwise match by collection name."""
+    if identifier.isdigit():
+        return identifier
+
+    data = client.collections_list()
+    items = collection_items_from_response(data)
+    candidates = collection_candidates(items)
+
+    if not candidates_have_ids(candidates):
+        try:
+            data = client.collections_expanded()
+            items = collection_items_from_response(data)
+            candidates = collection_candidates(items)
+        except ApiError:
+            pass
+
+    if not candidates_have_ids(candidates):
+        try:
+            data = client.collections_map()
+            mapped = collection_candidates_from_map(data)
+            if mapped:
+                candidates = mapped
+        except ApiError:
+            pass
+
+    if not candidates_have_ids(candidates):
+        matched = match_collection_name(candidates, identifier)
+        if matched:
+            return matched
+        raise ApiError("Unable to resolve collection name (no IDs available)")
+
+    candidates = [(name, cid) for name, cid in candidates if cid]
+    target = normalize_name(identifier)
+
+    for name, cid in candidates:
+        if normalize_name(name) == target:
+            return cid
+
+    prefix = [c for c in candidates if normalize_name(c[0]).startswith(target)]
+    if len(prefix) == 1:
+        return prefix[0][1]
+    if len(prefix) > 1:
+        names = ", ".join([f"{n}({cid})" for n, cid in prefix[:10]])
+        raise ApiError(f"Ambiguous collection name. Matches: {names}")
+
+    contains = [c for c in candidates if target in normalize_name(c[0])]
+    if len(contains) == 1:
+        return contains[0][1]
+    if len(contains) > 1:
+        names = ", ".join([f"{n}({cid})" for n, cid in contains[:10]])
+        raise ApiError(f"Ambiguous collection name. Matches: {names}")
+
+    raise ApiError("Collection name not found")

scholarinboxcli/services/paper_sort.py

@@ -0,0 +1,54 @@
+"""Helpers for sorting paper-like API responses."""
+
+from __future__ import annotations
+
+from datetime import datetime, timezone
+from typing import Any
+
+
+def _year_from_paper(paper: dict[str, Any]) -> int:
+    year = paper.get("year") or paper.get("publication_year") or paper.get("conference_year")
+    if isinstance(year, int):
+        return year
+    if isinstance(year, float):
+        return int(year)
+    if isinstance(year, str) and year.isdigit():
+        return int(year)
+
+    publication_date = paper.get("publication_date")
+    if isinstance(publication_date, str) and len(publication_date) >= 4 and publication_date[:4].isdigit():
+        return int(publication_date[:4])
+    if isinstance(publication_date, (int, float)):
+        ts = float(publication_date)
+        if ts > 10_000_000_000:
+            ts /= 1000.0
+        try:
+            return datetime.fromtimestamp(ts, tz=timezone.utc).year
+        except Exception:
+            return 0
+    return 0
+
+
+def sort_paper_response(data: Any, sort_by: str | None, asc: bool) -> Any:
+    """Return a sorted copy of known paper-list structures."""
+    if not sort_by:
+        return data
+    if not isinstance(data, dict):
+        return data
+
+    for key in ("digest_df", "papers", "results", "items", "data"):
+        rows = data.get(key)
+        if not isinstance(rows, list) or not rows or not isinstance(rows[0], dict):
+            continue
+
+        if sort_by == "year":
+            sorted_rows = sorted(rows, key=_year_from_paper, reverse=not asc)
+        elif sort_by == "title":
+            sorted_rows = sorted(rows, key=lambda p: str(p.get("title") or p.get("paper_title") or "").lower(), reverse=not asc)
+        else:
+            return data
+
+        out = dict(data)
+        out[key] = sorted_rows
+        return out
+    return data

{scholarinboxcli-0.1.0.dist-info → scholarinboxcli-0.1.2.dist-info}/METADATA

@@ -1,8 +1,9 @@
 Metadata-Version: 2.4
 Name: scholarinboxcli
-Version: 0.1.0
+Version: 0.1.2
 Summary: CLI for Scholar Inbox (authenticated web API)
 License-Expression: MIT
+License-File: LICENSE
 Keywords: bibliography,cli,research,scholar
 Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
@@ -21,7 +22,7 @@ Description-Content-Type: text/markdown
 
 # scholarinboxcli
 
-CLI for Scholar Inbox, for humans and agents alike.
+CLI for [Scholar Inbox](https://scholar-inbox.com), for humans and agents alike.
 
 ## Installation
 
@@ -121,6 +122,12 @@ scholarinboxcli collection papers 10759
 # Similar papers for one or more collections
 scholarinboxcli collection similar 10759 12345
 
+# Optional local sorting for display (e.g., newest first)
+scholarinboxcli collection similar "AIAgents" --sort year
+
+# Sort ascending instead
+scholarinboxcli collection similar "AIAgents" --sort year --asc
+
 # You can also use collection names (case-insensitive). The CLI will
 # automatically fetch collection ID mappings from the API when needed.
 scholarinboxcli collection papers "AIAgents"
@@ -128,6 +135,7 @@ scholarinboxcli collection similar "AIAgents" "Benchmark"
 ```
 
 Collection name matching is exact → prefix → contains. If multiple matches exist, the CLI reports ambiguity and shows candidate IDs.
+`collection similar` supports client-side sorting with `--sort year|title` and optional `--asc`.
 
 ## Search
 
@@ -184,53 +192,12 @@ scholarinboxcli collection papers "AIAgents" --json
 scholarinboxcli search "diffusion" --json
 ```
 
-## Tested (2026-02-01)
-
-The following commands were exercised against the live API (with a valid magic-link login) to confirm behavior:
-
-```bash
-scholarinboxcli --help
-scholarinboxcli auth status --json
-scholarinboxcli digest --date 01-30-2026 --json
-scholarinboxcli trending --category ALL --days 7 --json
-scholarinboxcli search "transformers" --limit 5 --json
-scholarinboxcli semantic "graph neural networks" --limit 5 --json
-scholarinboxcli interactions --type all --json
-scholarinboxcli bookmark list --json
-scholarinboxcli bookmark add 3302478 --json
-scholarinboxcli bookmark remove 3302478 --json
-scholarinboxcli collection list --json
-scholarinboxcli collection list --expanded --json
-scholarinboxcli collection papers "AIAgents" --json
-scholarinboxcli collection similar "AIAgents" --json
-scholarinboxcli conference list --json
-scholarinboxcli conference explore --json
-```
-
 ## Notes
 
 - Some collection mutations (create/rename/delete/add/remove) rely on best-effort endpoints that may change on the service side. If a mutation fails, try again or use the web UI to validate the current behavior.
+- Bookmarks are stored as a dedicated collection named "Bookmarks" in the web app; `bookmark list` pulls that collection via `/api/get_collections`.
 - Similar papers for collections uses the server endpoint used by the web UI. Results typically appear under `digest_df` in JSON responses.
 
-## Publish to PyPI
-
-```bash
-# 1) Build sdist + wheel
-uv run --with build python -m build
-
-# 2) Validate metadata/rendering
-uvx twine check dist/*
-
-# 3) (Optional) test publish first
-uvx twine upload --repository testpypi dist/*
+## License
 
-# 4) Publish to PyPI
-uvx twine upload dist/*
-```
-
-If using an API token:
-
-```bash
-export TWINE_USERNAME=__token__
-export TWINE_PASSWORD=<your-pypi-token>
-```
+MIT. See `LICENSE`.

scholarinboxcli-0.1.2.dist-info/RECORD

@@ -0,0 +1,23 @@
+scholarinboxcli/__init__.py,sha256=YvuYzWnKtqBb-IqG8HAu-nhIYAsgj9Vmc_b9o7vO-js,22
+scholarinboxcli/cli.py,sha256=BPXTPhBVO6mDoihXfDIp6zmbTqIcMJ8-VqKiF616DrI,1015
+scholarinboxcli/config.py,sha256=cxp1RzNwzT6Iu225EPvs8NhH2YTTMg9fQBjaYIRVDoc,1545
+scholarinboxcli/api/client.py,sha256=pEUMcoTauEmDdB7weV5m82-yyjUpdcvbRe8oY9Rj8Qo,15142
+scholarinboxcli/api/endpoints.py,sha256=lwSk3PAOITGurTliP9Ko8KSP-DFR8WqKrRxC760rpPc,1515
+scholarinboxcli/commands/__init__.py,sha256=aOPGu7M21finmICNxDSxNBpe1C3Vw2Iimh1UBESfekU,42
+scholarinboxcli/commands/auth.py,sha256=6iwFsuAqiwiRTJbaJFgEt4JXRo1HVrLEF3WSsMo3GHA,1024
+scholarinboxcli/commands/bookmarks.py,sha256=UbR99VrrCyCdu1EhyHIgwn3sPOYKfRc4jF4gUx1fU6w,1598
+scholarinboxcli/commands/collections.py,sha256=pBZFXi_e3Dto-4E2GS6pgIrcVMzWpWaGLNTLB5My5sQ,5634
+scholarinboxcli/commands/common.py,sha256=5EcH0RDuX8DKzyB6lrPqGEok5TKx8SSV37mXczD9dqI,1654
+scholarinboxcli/commands/conferences.py,sha256=e1QjX9R9WZhkSkPXKgoxuRPbl612qEVbsjX90zEgKSw,1183
+scholarinboxcli/commands/papers.py,sha256=mdb3-_iecy_pjavPL_K0cXfVnDsQMU93SbD8T3hJY10,3968
+scholarinboxcli/formatters/domain_tables.py,sha256=9RZcq-k9YycO64FvQAblE1dzYmytSj7NBasBEZeDW9I,4702
+scholarinboxcli/formatters/json_fmt.py,sha256=Ntcp4EqHugCXg79RIF62c7QHa-lexptLDDTT3IEP65U,197
+scholarinboxcli/formatters/table.py,sha256=G0ehvuGgo77XX5kw_9u5DEf8oUTIR-fOJ5rhYQvMEkc,4587
+scholarinboxcli/services/__init__.py,sha256=i-8EAvmxCDyYEjmfILYRcUHUh7ryY5hFS4PZARScFXo,56
+scholarinboxcli/services/collections.py,sha256=rz9rqgf-nfzBl-scBhweA-22--Z70qKEyBhW84os4bY,4353
+scholarinboxcli/services/paper_sort.py,sha256=HYoIHry14QIUsfd9D9kZvy7phVhvCnwEjKHv6zO-0IU,1809
+scholarinboxcli-0.1.2.dist-info/METADATA,sha256=oqmUh6jnAapWYtUA13efz3k4r1Q4kQutPP_nGEOzS00,5328
+scholarinboxcli-0.1.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+scholarinboxcli-0.1.2.dist-info/entry_points.txt,sha256=iescoEMF_CPwSNSmvlzNDl5pT2VpBL9_1bIq_FFIAKc,60
+scholarinboxcli-0.1.2.dist-info/licenses/LICENSE,sha256=sP1DPhQGvTFx1mH4JhNuczMMbApQgFvhBcVjZKM79gU,1068
+scholarinboxcli-0.1.2.dist-info/RECORD,,

scholarinboxcli-0.1.2.dist-info/licenses/LICENSE

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

scholarinboxcli-0.1.0.dist-info/RECORD

@@ -1,10 +0,0 @@
-scholarinboxcli/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
-scholarinboxcli/cli.py,sha256=bugBfT66k5EuVPashcG6Pz0IRM0KtRz_c6lNOalm4pk,19242
-scholarinboxcli/config.py,sha256=cxp1RzNwzT6Iu225EPvs8NhH2YTTMg9fQBjaYIRVDoc,1545
-scholarinboxcli/api/client.py,sha256=TE8pIRXh7pHhQGto9CvRpPPT61SJp9SzNhRnQ-2U4M4,13723
-scholarinboxcli/formatters/json_fmt.py,sha256=Ntcp4EqHugCXg79RIF62c7QHa-lexptLDDTT3IEP65U,197
-scholarinboxcli/formatters/table.py,sha256=GnzpmSJ7M_yq-R-c8no8SE9vXbycvWWPUu6hV4tcJAA,2133
-scholarinboxcli-0.1.0.dist-info/METADATA,sha256=JZISdlP49Ezyh-UoLv2FlJIrliHUvZrnj0IvFNWKCMw,6062
-scholarinboxcli-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-scholarinboxcli-0.1.0.dist-info/entry_points.txt,sha256=iescoEMF_CPwSNSmvlzNDl5pT2VpBL9_1bIq_FFIAKc,60
-scholarinboxcli-0.1.0.dist-info/RECORD,,