feat(app-platform): integration feature models, serializer, endpoints (#13377)

* integration feature models, serializer, endpoints

Author: MeredithAnya

src/sentry/api/endpoints/sentry_app_features.py

@@ -0,0 +1,20 @@
+from __future__ import absolute_import
+
+from sentry.api.bases.sentryapps import SentryAppBaseEndpoint
+from sentry.api.serializers import serialize
+from sentry.api.paginator import OffsetPaginator
+from sentry.models import IntegrationFeature
+
+
+class SentryAppFeaturesEndpoint(SentryAppBaseEndpoint):
+    def get(self, request, sentry_app):
+        features = IntegrationFeature.objects.filter(
+            sentry_app_id=sentry_app.id,
+        )
+
+        return self.paginate(
+            request=request,
+            queryset=features,
+            paginator_cls=OffsetPaginator,
+            on_results=lambda x: serialize(x, request.user),
+        )

src/sentry/api/serializers/models/integration_feature.py

@@ -0,0 +1,14 @@
+from __future__ import absolute_import
+
+from sentry.api.serializers import Serializer, register
+from sentry.models import IntegrationFeature
+
+
+@register(IntegrationFeature)
+class IntegrationFeatureSerializer(Serializer):
+    def serialize(self, obj, attrs, user):
+        return {
+            'description': obj.description.strip(),
+            # feature gating work done in getsentry expects the format 'featureGate'
+            'featureGate': obj.feature_str(),
+        }

src/sentry/api/urls.py

@@ -189,6 +189,7 @@
 from .endpoints.debug_files import DebugFilesEndpoint, DifAssembleEndpoint, \
     UnknownDebugFilesEndpoint, AssociateDSymFilesEndpoint
 from .endpoints.sentry_apps import SentryAppsEndpoint
+from .endpoints.sentry_app_features import SentryAppFeaturesEndpoint
 from .endpoints.sentry_apps_stats import SentryAppsStatsEndpoint
 from .endpoints.sentry_app_components import SentryAppComponentsEndpoint, \
     OrganizationSentryAppComponentsEndpoint
@@ -1328,6 +1329,11 @@
         SentryAppDetailsEndpoint.as_view(),
         name='sentry-api-0-sentry-app-details'
     ),
+    url(
+        r'^sentry-apps/(?P<sentry_app_slug>[^\/]+)/features/$',
+        SentryAppFeaturesEndpoint.as_view(),
+        name='sentry-api-0-sentry-app-features'
+    ),
     url(
         r'^sentry-apps/(?P<sentry_app_slug>[^\/]+)/components/$',
         SentryAppComponentsEndpoint.as_view(),

src/sentry/features/__init__.py

@@ -65,6 +65,7 @@
 default_manager.add('organizations:incidents', OrganizationFeature)  # NOQA
 default_manager.add('organizations:integrations-issue-basic', OrganizationFeature)  # NOQA
 default_manager.add('organizations:integrations-issue-sync', OrganizationFeature)  # NOQA
+default_manager.add('organizations:integrations-event-hooks', OrganizationFeature)  # NOQA
 default_manager.add('organizations:internal-catchall', OrganizationFeature)  # NOQA
 default_manager.add('organizations:incidents', OrganizationFeature)  # NOQA
 default_manager.add('organizations:sentry-apps', OrganizationFeature)  # NOQA

src/sentry/models/integrationfeature.py

@@ -0,0 +1,70 @@
+from __future__ import absolute_import
+
+from django.db import models
+from django.utils import timezone
+
+from sentry.db.models import BoundedPositiveIntegerField, FlexibleForeignKey, Model
+
+
+class Feature(object):
+    API = 0
+    ISSUE_LINK = 1
+    STACKTRACE_LINK = 2
+    EVENT_HOOKS = 3
+
+    @classmethod
+    def as_choices(cls):
+        return (
+            (cls.API, 'integrations-api'),
+            (cls.ISSUE_LINK, 'integrations-issue-link'),
+            (cls.STACKTRACE_LINK, 'integrations-stacktrace-link'),
+            (cls.EVENT_HOOKS, 'integrations-event-hooks'),
+        )
+
+    @classmethod
+    def as_str(cls, feature):
+        if feature == cls.API:
+            return 'integrations-api'
+        elif feature == cls.ISSUE_LINK:
+            return 'integrations-issue-link'
+        elif feature == cls.STACKTRACE_LINK:
+            return 'integrations-stacktrace-link'
+        elif feature == cls.EVENT_HOOKS:
+            return 'integrations-event-hooks'
+
+    @classmethod
+    def description(cls, feature):
+        if feature == cls.API:
+            return "This integration can utilize the Sentry API (with the permissions granted) to pull data or update resources in Sentry!"
+        elif feature == cls.ISSUE_LINK:
+            return "This integration can allow your organization to create or link Sentry issues to another service!"
+        elif feature == cls.STACKTRACE_LINK:
+            return "This integration allows your organization to open a line in Sentry's stack trace in another service!"
+        elif feature == cls.EVENT_HOOKS:
+            return "This integration allows your organization to forward events to another service!"
+
+
+class IntegrationFeature(Model):
+    __core__ = False
+
+    sentry_app = FlexibleForeignKey('sentry.SentryApp')
+    user_description = models.TextField(null=True)
+    feature = BoundedPositiveIntegerField(
+        default=0,
+        choices=Feature.as_choices(),
+    )
+    date_added = models.DateTimeField(default=timezone.now)
+
+    class Meta:
+        app_label = 'sentry'
+        db_table = 'sentry_integrationfeature'
+
+    def feature_str(self):
+        return Feature.as_str(self.feature)
+
+    @property
+    def description(self):
+        if self.user_description:
+            return self.user_description
+        else:
+            return Feature.description(self.feature)