feat(perforce): Add backend support for Perforce integration

This commit adds backend support for Perforce version control integration:

- New Perforce integration with P4 client support
- Repository and code mapping functionality
- Stacktrace linking for Perforce depot paths
- Tests for integration, code mapping, and stacktrace linking
- Updated dependencies in pyproject.toml

The integration supports:
- Authentication via P4PORT, P4USER, P4PASSWD
- Code mapping between depot paths and project structure
- Source URL generation for stacktrace frames
- Integration with Sentry's repository and code mapping systems

Author: mujacica

pyproject.toml

@@ -53,6 +53,7 @@ dependencies = [
     "objectstore-client>=0.0.5",
     "openai>=1.3.5",
     "orjson>=3.10.10",
+    "p4python>=2025.1.2767466",
     "packaging>=24.1",
     "parsimonious>=0.10.0",
     "petname>=2.6",
@@ -295,6 +296,7 @@ module = [
     "onelogin.saml2.auth.*",
     "onelogin.saml2.constants.*",
     "onelogin.saml2.idp_metadata_parser.*",
+    "P4",
     "rb.*",
     "statsd.*",
     "tokenizers.*",

src/sentry/conf/server.py

@@ -2149,6 +2149,7 @@ def custom_parameter_sort(parameter: dict) -> tuple[str, int]:
     "sentry.integrations.discord.DiscordIntegrationProvider",
     "sentry.integrations.opsgenie.OpsgenieIntegrationProvider",
     "sentry.integrations.cursor.integration.CursorAgentIntegrationProvider",
+    "sentry.integrations.perforce.integration.PerforceIntegrationProvider",
 )
 
 

src/sentry/integrations/api/bases/external_actor.py

@@ -34,6 +34,7 @@
     ExternalProviders.SLACK,
     ExternalProviders.MSTEAMS,
     ExternalProviders.JIRA_SERVER,
+    ExternalProviders.PERFORCE,
     ExternalProviders.CUSTOM,
 }
 

src/sentry/integrations/api/endpoints/organization_code_mappings.py

@@ -42,7 +42,8 @@ class RepositoryProjectPathConfigSerializer(CamelSnakeModelSerializer):
     source_root = gen_path_regex_field()
     default_branch = serializers.RegexField(
         r"^(^(?![\/]))([\w\.\/-]+)(?<![\/])$",
-        required=True,
+        required=False,  # Validated in validate_default_branch based on integration type
+        allow_blank=True,  # Perforce allows empty streams
         error_messages={"invalid": _(BRANCH_NAME_ERROR_MESSAGE)},
     )
     instance: RepositoryProjectPathConfig | None
@@ -98,6 +99,24 @@ def validate_project_id(self, project_id):
             raise serializers.ValidationError("Project does not exist")
         return project_id
 
+    def validate_default_branch(self, default_branch):
+        # Get the integration to check if it's Perforce
+        integration = integration_service.get_integration(
+            integration_id=self.org_integration.integration_id
+        )
+
+        # For Perforce, allow empty branch (streams are part of depot path)
+        if integration and integration.provider == "perforce":
+            # Allow empty string for Perforce
+            if not default_branch:
+                return default_branch
+        else:
+            # For other integrations, branch is required
+            if not default_branch:
+                raise serializers.ValidationError("This field is required.")
+
+        return default_branch
+
     def create(self, validated_data):
         return RepositoryProjectPathConfig.objects.create(
             organization_integration_id=self.org_integration.id,

src/sentry/integrations/models/external_actor.py

@@ -41,6 +41,7 @@ class ExternalActor(ReplicatedRegionModel):
             (ExternalProviders.GITHUB_ENTERPRISE, IntegrationProviderSlug.GITHUB_ENTERPRISE.value),
             (ExternalProviders.GITLAB, IntegrationProviderSlug.GITLAB.value),
             (ExternalProviders.JIRA_SERVER, IntegrationProviderSlug.JIRA_SERVER.value),
+            (ExternalProviders.PERFORCE, IntegrationProviderSlug.PERFORCE.value),
             # TODO: do migration to delete this from database
             (ExternalProviders.CUSTOM, "custom_scm"),
         ),

src/sentry/integrations/perforce/__init__.py

@@ -0,0 +1,6 @@
+from __future__ import annotations
+
+from .integration import PerforceIntegration, PerforceIntegrationProvider
+from .repository import PerforceRepositoryProvider
+
+__all__ = ["PerforceIntegration", "PerforceIntegrationProvider", "PerforceRepositoryProvider"]