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

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

@@ -2,6 +2,14 @@
 
 All notable changes to `runspec-gitlab-core` are documented here.
 
+## [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.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: runspec-gitlab-core
-Version: 0.4.0
+Version: 0.5.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.5.0}/pyproject.toml

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

@@ -47,27 +47,32 @@ 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,
 ) -> list[dict[str, Any]]:
-    """Search visible projects by name/path.
-
-    ``membership`` limits results to projects the token's user is a member of.
+    """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.
     """
-    return gitlab_request(
-        "GET",
-        "/projects",
-        config=config,
-        params={
-            "search": search,
-            "membership": membership,
-            "order_by": "last_activity_at",
-            "per_page": per_page,
-            "page": page,
-        },
-    )
+    params: dict[str, Any] = {
+        "membership": membership or not search or None,
+        "owned": owned or None,
+        "order_by": "last_activity_at",
+        "per_page": per_page,
+        "page": page,
+    }
+    if search:
+        params["search"] = search
+        params["search_namespaces"] = True
+    return gitlab_request("GET", "/projects", config=config, params=params)
 
 
 def resolve_user_ids(config: GitlabConfig, usernames: list[str] | None) -> list[int] | None:

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

@@ -53,6 +53,23 @@ 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_term_without_membership_leaves_it_off(monkeypatch):
+    seen = _capture(monkeypatch, httpx.Response(200, json=[]))
+    search_projects(CFG, "runspec", owned=True)
+    assert "membership" not in seen["query"]
+    assert seen["query"]["owned"] == "true"
 
 
 def test_list_issues_uses_default_project_and_filters(monkeypatch):