runspec-gitlab-core 0.5.0__tar.gz → 0.6.0__tar.gz

{runspec_gitlab_core-0.5.0 → runspec_gitlab_core-0.6.0}/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to `runspec-gitlab-core` are documented here.
 
+## [0.6.0] — 2026-10-25
+
+- New `list_projects`: the token user's member (or owned) projects, optionally
+  filtered by a term that also matches the namespace path, in GitLab's short
+  form unless `full`.
+- `search_projects` adds the namespace match (`search_namespaces`) only within
+  the user's own projects. Across every visible project it made gitlab.com
+  time out with a 500 after about 16 seconds (0.5.0 regression). New `simple`
+  parameter.
+
 ## [0.5.0] — 2026-10-25
 
 - `search_projects` can list the token user's projects: `search` is now

{runspec_gitlab_core-0.5.0 → runspec_gitlab_core-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: runspec-gitlab-core
-Version: 0.5.0
+Version: 0.6.0
 Summary: Pure-Python GitLab REST helpers — the importable core behind runspec-gitlab (no runspec dependency, no runnables)
 Requires-Python: >=3.10
 Requires-Dist: httpx

{runspec_gitlab_core-0.5.0 → runspec_gitlab_core-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "runspec-gitlab-core"
-version = "0.5.0"
+version = "0.6.0"
 requires-python = ">=3.10"
 description = "Pure-Python GitLab REST helpers — the importable core behind runspec-gitlab (no runspec dependency, no runnables)"
 dependencies = [

{runspec_gitlab_core-0.5.0 → runspec_gitlab_core-0.6.0}/runspec_gitlab_core/__init__.py

@@ -56,7 +56,14 @@ from runspec_gitlab_core.pipelines import (
     retry_job,
     retry_pipeline,
 )
-from runspec_gitlab_core.projects import get_project, resolve_project_path, resolve_user_ids, search_projects, whoami
+from runspec_gitlab_core.projects import (
+    get_project,
+    list_projects,
+    resolve_project_path,
+    resolve_user_ids,
+    search_projects,
+    whoami,
+)
 from runspec_gitlab_core.repository import (
     create_branch,
     delete_branch,
@@ -80,6 +87,7 @@ __all__ = [
     # identity / projects
     "whoami",
     "get_project",
+    "list_projects",
     "search_projects",
     # issues
     "list_issues",

{runspec_gitlab_core-0.5.0 → runspec_gitlab_core-0.6.0}/runspec_gitlab_core/projects.py

@@ -52,29 +52,59 @@ def search_projects(
     per_page: int = 20,
     page: int = 1,
     owned: bool = False,
+    simple: bool = False,
 ) -> list[dict[str, Any]]:
     """Search or list projects, most recently active first.
 
-    ``search`` matches the project name or path, including its group/namespace
-    path (so ``"finejason"`` finds projects under that user's namespace). GitLab
-    matches a term shorter than 3 characters only as an exact name. With no
-    ``search`` the call lists the token user's projects: ``membership`` is
-    implied, since listing every visible project on a public instance is
-    useless. ``owned`` limits results to projects the user owns.
+    ``search`` matches the project name or path. GitLab matches a term shorter
+    than 3 characters only as an exact name. With no ``search`` the call lists
+    the token user's projects: ``membership`` is implied, since listing every
+    visible project on a public instance is useless. ``owned`` limits results
+    to projects the user owns. Within the user's own projects (``membership``
+    or ``owned``) a term also matches the group/namespace path; across every
+    visible project that match times out on gitlab.com, so it is left off.
+    ``simple`` asks GitLab for its short project representation.
     """
+    mine = membership or owned or not search
     params: dict[str, Any] = {
-        "membership": membership or not search or None,
+        "membership": mine or None,
         "owned": owned or None,
+        "simple": simple or None,
         "order_by": "last_activity_at",
         "per_page": per_page,
         "page": page,
     }
     if search:
         params["search"] = search
-        params["search_namespaces"] = True
+        if mine:
+            params["search_namespaces"] = True
     return gitlab_request("GET", "/projects", config=config, params=params)
 
 
+def list_projects(
+    config: GitlabConfig,
+    search: str | None = None,
+    owned: bool = False,
+    per_page: int = 20,
+    page: int = 1,
+    full: bool = False,
+) -> list[dict[str, Any]]:
+    """List the projects the token user is a member of (or owns), most recently
+    active first, optionally filtered by ``search`` (name, path or namespace).
+
+    Returns GitLab's short project representation unless ``full``.
+    """
+    return search_projects(
+        config,
+        search=search,
+        membership=True,
+        per_page=per_page,
+        page=page,
+        owned=owned,
+        simple=not full,
+    )
+
+
 def resolve_user_ids(config: GitlabConfig, usernames: list[str] | None) -> list[int] | None:
     """Map GitLab usernames to numeric user ids (the write APIs take ids).
 

{runspec_gitlab_core-0.5.0 → runspec_gitlab_core-0.6.0}/tests/test_api.py

@@ -19,6 +19,7 @@ from runspec_gitlab_core import (
     get_merge_request_pipelines,
     list_issues,
     list_pipelines,
+    list_projects,
     list_tree,
     search_projects,
     whoami,
@@ -65,11 +66,29 @@ def test_search_projects_without_term_lists_member_projects(monkeypatch):
     assert "search_namespaces" not in seen["query"]
 
 
-def test_search_projects_term_without_membership_leaves_it_off(monkeypatch):
+def test_search_projects_plain_term_searches_everything_by_name(monkeypatch):
+    # search_namespaces across every public gitlab.com project times out (500)
     seen = _capture(monkeypatch, httpx.Response(200, json=[]))
-    search_projects(CFG, "runspec", owned=True)
+    search_projects(CFG, "runspec")
+    assert seen["query"]["search"] == "runspec"
     assert "membership" not in seen["query"]
+    assert "search_namespaces" not in seen["query"]
+
+
+def test_list_projects_is_mine_and_short(monkeypatch):
+    seen = _capture(monkeypatch, httpx.Response(200, json=[]))
+    list_projects(CFG, "cli", owned=True)
+    assert seen["query"]["membership"] == "true"
     assert seen["query"]["owned"] == "true"
+    assert seen["query"]["simple"] == "true"
+    assert seen["query"]["search_namespaces"] == "true"
+
+
+def test_list_projects_full(monkeypatch):
+    seen = _capture(monkeypatch, httpx.Response(200, json=[]))
+    list_projects(CFG, full=True)
+    assert "simple" not in seen["query"]
+    assert "search" not in seen["query"]
 
 
 def test_list_issues_uses_default_project_and_filters(monkeypatch):