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

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

@@ -2,6 +2,24 @@
 
 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
+  optional, and with no term the call asks for member projects only (listing
+  every visible project on gitlab.com is no use). A term also matches the
+  group/namespace path (`search_namespaces`), so a username or group name finds
+  the projects under it. New `owned` parameter limits results to owned projects.
+
 ## [0.4.0] — 2026-10-25
 
 - `config_from_env` reads the token from `GITLAB_TOKEN` or `GITLAB_PAT` (each

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: runspec-gitlab-core
-Version: 0.4.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.4.0 → runspec_gitlab_core-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "runspec-gitlab-core"
-version = "0.4.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.4.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.4.0 → runspec_gitlab_core-0.6.0}/runspec_gitlab_core/projects.py

@@ -47,26 +47,61 @@ def get_project(config: GitlabConfig, project: str | None = None) -> dict[str, A
 
 def search_projects(
     config: GitlabConfig,
-    search: str,
+    search: str | None = None,
     membership: bool = False,
     per_page: int = 20,
     page: int = 1,
+    owned: bool = False,
+    simple: bool = False,
 ) -> list[dict[str, Any]]:
-    """Search visible projects by name/path.
+    """Search or list projects, most recently active first.
+
+    ``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": 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
+        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).
 
-    ``membership`` limits results to projects the token's user is a member of.
+    Returns GitLab's short project representation unless ``full``.
     """
-    return gitlab_request(
-        "GET",
-        "/projects",
-        config=config,
-        params={
-            "search": search,
-            "membership": membership,
-            "order_by": "last_activity_at",
-            "per_page": per_page,
-            "page": page,
-        },
+    return search_projects(
+        config,
+        search=search,
+        membership=True,
+        per_page=per_page,
+        page=page,
+        owned=owned,
+        simple=not full,
     )
 
 

{runspec_gitlab_core-0.4.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,
@@ -53,6 +54,41 @@ def test_search_projects_encodes_membership(monkeypatch):
     assert seen["path"] == "/api/v4/projects"
     assert seen["query"]["search"] == "runspec"
     assert seen["query"]["membership"] == "true"
+    assert seen["query"]["search_namespaces"] == "true"
+    assert "owned" not in seen["query"]
+
+
+def test_search_projects_without_term_lists_member_projects(monkeypatch):
+    seen = _capture(monkeypatch, httpx.Response(200, json=[]))
+    search_projects(CFG)
+    assert seen["query"]["membership"] == "true"
+    assert "search" not in seen["query"]
+    assert "search_namespaces" not in seen["query"]
+
+
+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")
+    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):