prefect-gitlab 0.3.1__tar.gz → 0.3.2__tar.gz

{prefect_gitlab-0.3.1/prefect_gitlab.egg-info → prefect_gitlab-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: prefect-gitlab
-Version: 0.3.1
+Version: 0.3.2
 Summary: A Prefect collection for working with GitLab repositories.
 Author-email: "Prefect Technologies, Inc." <help@prefect.io>
 License: Apache License 2.0
@@ -15,6 +15,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
@@ -22,21 +23,7 @@ License-File: LICENSE
 Requires-Dist: prefect>=3.0.0
 Requires-Dist: python-gitlab>=3.12.0
 Requires-Dist: tenacity>=8.2.3
-Provides-Extra: dev
-Requires-Dist: aiohttp; extra == "dev"
-Requires-Dist: coverage; extra == "dev"
-Requires-Dist: interrogate; extra == "dev"
-Requires-Dist: mkdocs-gen-files; extra == "dev"
-Requires-Dist: mkdocs-material; extra == "dev"
-Requires-Dist: mkdocs; extra == "dev"
-Requires-Dist: mkdocstrings[python]; extra == "dev"
-Requires-Dist: mypy; extra == "dev"
-Requires-Dist: pillow; extra == "dev"
-Requires-Dist: pre-commit; extra == "dev"
-Requires-Dist: pytest-asyncio; extra == "dev"
-Requires-Dist: pytest>=8.3; extra == "dev"
-Requires-Dist: pytest-env; extra == "dev"
-Requires-Dist: pytest-xdist; extra == "dev"
+Dynamic: license-file
 
 # prefect-gitlab
 

prefect_gitlab-0.3.2/prefect_gitlab/_version.py

@@ -0,0 +1,34 @@
+# 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.3.2'
+__version_tuple__ = version_tuple = (0, 3, 2)
+
+__commit_id__ = commit_id = 'g8a37e7b1b'

prefect_gitlab-0.3.2/prefect_gitlab/credentials.py

@@ -0,0 +1,91 @@
+"""Module used to enable authenticated interactions with GitLab"""
+
+from typing import Optional
+from urllib.parse import urlparse, urlunparse
+
+from gitlab import Gitlab
+from pydantic import Field, SecretStr
+
+from prefect.blocks.core import Block
+
+
+class GitLabCredentials(Block):
+    """
+    Store a GitLab personal access token to interact with private GitLab
+    repositories.
+
+    Attributes:
+        token: The personal access token to authenticate with GitLab.
+        url: URL to self-hosted GitLab instances.
+
+    Examples:
+        Load stored GitLab credentials:
+        ```python
+        from prefect_gitlab import GitLabCredentials
+        gitlab_credentials_block = GitLabCredentials.load("BLOCK_NAME")
+        ```
+    """
+
+    _block_type_name = "GitLab Credentials"
+    _logo_url = "https://images.ctfassets.net/gm98wzqotmnx/55edIimT4g9gbjhkh5a3Sp/dfdb9391d8f45c2e93e72e3a4d350771/gitlab-logo-500.png?h=250"
+
+    token: Optional[SecretStr] = Field(
+        title="Personal Access Token",
+        default=None,
+        description="A GitLab Personal Access Token with read_repository scope.",
+    )
+    url: Optional[str] = Field(
+        default=None, title="URL", description="URL to self-hosted GitLab instances."
+    )
+
+    def format_git_credentials(self, url: str) -> str:
+        """
+        Format and return the full git URL with GitLab credentials embedded.
+
+        Handles both personal access tokens and deploy tokens correctly:
+        - Personal access tokens: prefixed with "oauth2:"
+        - Deploy tokens (username:token format): used as-is
+        - Already prefixed tokens: not double-prefixed
+
+        Args:
+            url: Repository URL (e.g., "https://gitlab.com/org/repo.git")
+
+        Returns:
+            Complete URL with credentials embedded
+
+        Raises:
+            ValueError: If token is not configured
+        """
+        if not self.token:
+            raise ValueError("Token is required for GitLab authentication")
+
+        token_value = self.token.get_secret_value()
+
+        # Deploy token detection: contains ":" but not "oauth2:" prefix
+        # Deploy tokens should not have oauth2: prefix (GitLab 16.3.4+ rejects them)
+        # See: https://github.com/PrefectHQ/prefect/issues/10832
+        if ":" in token_value and not token_value.startswith("oauth2:"):
+            credentials = token_value
+        # Personal access token: add oauth2: prefix
+        # See: https://github.com/PrefectHQ/prefect/issues/16836
+        elif not token_value.startswith("oauth2:"):
+            credentials = f"oauth2:{token_value}"
+        else:
+            # Already prefixed
+            credentials = token_value
+
+        # Insert credentials into URL
+        parsed = urlparse(url)
+        return urlunparse(parsed._replace(netloc=f"{credentials}@{parsed.netloc}"))
+
+    def get_client(self) -> Gitlab:
+        """
+        Gets an authenticated GitLab client.
+
+        Returns:
+            An authenticated GitLab client.
+        """
+        # ref: https://python-gitlab.readthedocs.io/en/stable/
+        gitlab = Gitlab(url=self.url, oauth_token=self.token.get_secret_value())
+        gitlab.auth()
+        return gitlab

{prefect_gitlab-0.3.1 → prefect_gitlab-0.3.2/prefect_gitlab.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: prefect-gitlab
-Version: 0.3.1
+Version: 0.3.2
 Summary: A Prefect collection for working with GitLab repositories.
 Author-email: "Prefect Technologies, Inc." <help@prefect.io>
 License: Apache License 2.0
@@ -15,6 +15,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
@@ -22,21 +23,7 @@ License-File: LICENSE
 Requires-Dist: prefect>=3.0.0
 Requires-Dist: python-gitlab>=3.12.0
 Requires-Dist: tenacity>=8.2.3
-Provides-Extra: dev
-Requires-Dist: aiohttp; extra == "dev"
-Requires-Dist: coverage; extra == "dev"
-Requires-Dist: interrogate; extra == "dev"
-Requires-Dist: mkdocs-gen-files; extra == "dev"
-Requires-Dist: mkdocs-material; extra == "dev"
-Requires-Dist: mkdocs; extra == "dev"
-Requires-Dist: mkdocstrings[python]; extra == "dev"
-Requires-Dist: mypy; extra == "dev"
-Requires-Dist: pillow; extra == "dev"
-Requires-Dist: pre-commit; extra == "dev"
-Requires-Dist: pytest-asyncio; extra == "dev"
-Requires-Dist: pytest>=8.3; extra == "dev"
-Requires-Dist: pytest-env; extra == "dev"
-Requires-Dist: pytest-xdist; extra == "dev"
+Dynamic: license-file
 
 # prefect-gitlab
 

prefect_gitlab-0.3.2/prefect_gitlab.egg-info/requires.txt

@@ -0,0 +1,3 @@
+prefect>=3.0.0
+python-gitlab>=3.12.0
+tenacity>=8.2.3

{prefect_gitlab-0.3.1 → prefect_gitlab-0.3.2}/pyproject.toml

@@ -20,12 +20,13 @@ classifiers = [
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
   "Topic :: Software Development :: Libraries",
 ]
 dependencies = ["prefect>=3.0.0", "python-gitlab>=3.12.0", "tenacity>=8.2.3"]
 dynamic = ["version"]
 
-[project.optional-dependencies]
+[dependency-groups]
 dev = [
   "aiohttp",
   "coverage",
@@ -74,3 +75,6 @@ show_missing = true
 asyncio_default_fixture_loop_scope = "session"
 asyncio_mode = "auto"
 env = ["PREFECT_TEST_MODE=1"]
+
+[tool.uv.sources]
+prefect = { path = "../../../" }

prefect_gitlab-0.3.2/tests/test_credentials.py

@@ -0,0 +1,46 @@
+from unittest.mock import MagicMock
+
+import pytest
+from prefect_gitlab.credentials import GitLabCredentials
+
+
+def test_gitlab_credentials_get_client(monkeypatch):
+    mock_gitlab = MagicMock()
+    monkeypatch.setattr("prefect_gitlab.credentials.Gitlab", mock_gitlab)
+    gitlab_credentials = GitLabCredentials(
+        url="https://gitlab.example.com", token="my-token"
+    )
+    gitlab_credentials.get_client()
+    mock_gitlab.assert_called_once_with(
+        url=gitlab_credentials.url,
+        oauth_token=gitlab_credentials.token.get_secret_value(),
+    )
+    mock_gitlab.assert_called_once()
+
+
+def test_format_git_credentials_personal_access_token():
+    """Test that personal access tokens get oauth2: prefix and are embedded in URL."""
+    credentials = GitLabCredentials(token="my-personal-token")
+    result = credentials.format_git_credentials("https://gitlab.com/org/repo.git")
+    assert result == "https://oauth2:my-personal-token@gitlab.com/org/repo.git"
+
+
+def test_format_git_credentials_deploy_token():
+    """Test that deploy tokens (username:token format) are used as-is in URL."""
+    credentials = GitLabCredentials(token="deploy-user:deploy-token-value")
+    result = credentials.format_git_credentials("https://gitlab.com/org/repo.git")
+    assert result == "https://deploy-user:deploy-token-value@gitlab.com/org/repo.git"
+
+
+def test_format_git_credentials_already_prefixed():
+    """Test that already-prefixed tokens don't get double-prefixed in URL."""
+    credentials = GitLabCredentials(token="oauth2:my-token")
+    result = credentials.format_git_credentials("https://gitlab.com/org/repo.git")
+    assert result == "https://oauth2:my-token@gitlab.com/org/repo.git"
+
+
+def test_format_git_credentials_no_token_raises():
+    """Test that missing token raises ValueError."""
+    credentials = GitLabCredentials()
+    with pytest.raises(ValueError, match="Token is required for GitLab authentication"):
+        credentials.format_git_credentials("https://gitlab.com/org/repo.git")

prefect_gitlab-0.3.1/prefect_gitlab/_version.py

@@ -1,16 +0,0 @@
-# file generated by setuptools_scm
-# don't change, don't track in version control
-TYPE_CHECKING = False
-if TYPE_CHECKING:
-    from typing import Tuple, Union
-    VERSION_TUPLE = Tuple[Union[int, str], ...]
-else:
-    VERSION_TUPLE = object
-
-version: str
-__version__: str
-__version_tuple__: VERSION_TUPLE
-version_tuple: VERSION_TUPLE
-
-__version__ = version = '0.3.1'
-__version_tuple__ = version_tuple = (0, 3, 1)

prefect_gitlab-0.3.1/prefect_gitlab/credentials.py

@@ -1,50 +0,0 @@
-"""Module used to enable authenticated interactions with GitLab"""
-
-from typing import Optional
-
-from gitlab import Gitlab
-from pydantic import Field, SecretStr
-
-from prefect.blocks.core import Block
-
-
-class GitLabCredentials(Block):
-    """
-    Store a GitLab personal access token to interact with private GitLab
-    repositories.
-
-    Attributes:
-        token: The personal access token to authenticate with GitLab.
-        url: URL to self-hosted GitLab instances.
-
-    Examples:
-        Load stored GitLab credentials:
-        ```python
-        from prefect_gitlab import GitLabCredentials
-        gitlab_credentials_block = GitLabCredentials.load("BLOCK_NAME")
-        ```
-    """
-
-    _block_type_name = "GitLab Credentials"
-    _logo_url = "https://images.ctfassets.net/gm98wzqotmnx/55edIimT4g9gbjhkh5a3Sp/dfdb9391d8f45c2e93e72e3a4d350771/gitlab-logo-500.png?h=250"
-
-    token: Optional[SecretStr] = Field(
-        title="Personal Access Token",
-        default=None,
-        description="A GitLab Personal Access Token with read_repository scope.",
-    )
-    url: Optional[str] = Field(
-        default=None, title="URL", description="URL to self-hosted GitLab instances."
-    )
-
-    def get_client(self) -> Gitlab:
-        """
-        Gets an authenticated GitLab client.
-
-        Returns:
-            An authenticated GitLab client.
-        """
-        # ref: https://python-gitlab.readthedocs.io/en/stable/
-        gitlab = Gitlab(url=self.url, oauth_token=self.token.get_secret_value())
-        gitlab.auth()
-        return gitlab

prefect_gitlab-0.3.1/prefect_gitlab.egg-info/requires.txt

@@ -1,19 +0,0 @@
-prefect>=3.0.0
-python-gitlab>=3.12.0
-tenacity>=8.2.3
-
-[dev]
-aiohttp
-coverage
-interrogate
-mkdocs-gen-files
-mkdocs-material
-mkdocs
-mkdocstrings[python]
-mypy
-pillow
-pre-commit
-pytest-asyncio
-pytest>=8.3
-pytest-env
-pytest-xdist

prefect_gitlab-0.3.1/tests/test_credentials.py

@@ -1,17 +0,0 @@
-from unittest.mock import MagicMock
-
-from prefect_gitlab.credentials import GitLabCredentials
-
-
-def test_gitlab_credentials_get_client(monkeypatch):
-    mock_gitlab = MagicMock()
-    monkeypatch.setattr("prefect_gitlab.credentials.Gitlab", mock_gitlab)
-    gitlab_credentials = GitLabCredentials(
-        url="https://gitlab.example.com", token="my-token"
-    )
-    gitlab_credentials.get_client()
-    mock_gitlab.assert_called_once_with(
-        url=gitlab_credentials.url,
-        oauth_token=gitlab_credentials.token.get_secret_value(),
-    )
-    mock_gitlab.assert_called_once()