chore: regenerate events catalogue

Author: SahilJat

api/flagsmith_api.egg-info/PKG-INFO

@@ -0,0 +1,280 @@
+Metadata-Version: 2.4
+Name: flagsmith-api
+Version: 2.68.0
+Summary: The API component for the Flagsmith application.
+Author-email: Flagsmith <support@flagsmith.com>
+Requires-Python: <3.14,>=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: django<6,>=5
+Requires-Dist: rudder-sdk-python<2.1.0,>=2.0.2
+Requires-Dist: segment-analytics-python<2.3.0,>=2.2.3
+Requires-Dist: backoff<2.3.0,>=2.2.1
+Requires-Dist: appdirs<1.5.0,>=1.4.4
+Requires-Dist: django-cors-headers<3.6.0,>=3.5.0
+Requires-Dist: djangorestframework<3.16.0,>=3.15.2
+Requires-Dist: gunicorn<23.1.0,>=23.0.0
+Requires-Dist: pyparsing<2.5.0,>=2.4.7
+Requires-Dist: requests<2.34.0,>=2.33.0
+Requires-Dist: six<1.17.0,>=1.16.0
+Requires-Dist: whitenoise<6.1.0,>=6.0.0
+Requires-Dist: dj-database-url<3.1.0,>=3.0.1
+Requires-Dist: drf-nested-routers<0.93.0,>=0.92.1
+Requires-Dist: shortuuid<1.1.0,>=1.0.1
+Requires-Dist: sendgrid-django<4.3.0,>=4.2.0
+Requires-Dist: psycopg2-binary<2.10.0,>=2.9.5
+Requires-Dist: coreapi<2.4.0,>=2.3.3
+Requires-Dist: django-simple-history<2.13.0,>=2.12.0
+Requires-Dist: google-api-python-client<1.13.0,>=1.12.5
+Requires-Dist: oauth2client<4.2.0,>=4.1.3
+Requires-Dist: djangorestframework-recursive<0.2.0,>=0.1.2
+Requires-Dist: chargebee<4.0.0,>=3.10.0
+Requires-Dist: python-http-client<3.4.0,>=3.3.7
+Requires-Dist: django-health-check<3.19.0,>=3.18.2
+Requires-Dist: django-admin-sso<5.3.0,>=5.2.0
+Requires-Dist: drf-spectacular<0.29.0,>=0.28.0
+Requires-Dist: sentry-sdk<3,>=2.24.1
+Requires-Dist: environs<15.0.0,>=14.1.1
+Requires-Dist: django-lifecycle<1.3.0,>=1.2.4
+Requires-Dist: drf-writable-nested<0.7.0,>=0.6.2
+Requires-Dist: django-filter<2.5.0,>=2.4.0
+Requires-Dist: flagsmith-flag-engine<11.0.0,>=10.1.0
+Requires-Dist: boto3<1.36.0,>=1.35.95
+Requires-Dist: slack-sdk<3.10.0,>=3.9.0
+Requires-Dist: asgiref<3.9.0,>=3.8.1
+Requires-Dist: djangorestframework-api-key<2.3.0,>=2.2.0
+Requires-Dist: pymemcache<4.1.0,>=4.0.0
+Requires-Dist: google-re2<2.0.0,>=1.0
+Requires-Dist: django-softdelete<0.12.0,>=0.11.5
+Requires-Dist: simplejson<3.20.0,>=3.19.1
+Requires-Dist: djoser<3.0.0,>=2.3.0
+Requires-Dist: django-storages<1.11.0,>=1.10.1
+Requires-Dist: django-environ<0.5.0,>=0.4.5
+Requires-Dist: influxdb-client<1.51.0,>=1.50.0
+Requires-Dist: django-ordered-model<3.5.0,>=3.4.1
+Requires-Dist: django-ses<3.6.0,>=3.5.0
+Requires-Dist: django-axes<9.0.0,>=8.1.0
+Requires-Dist: pydantic<3.0.0,>=2.12.0
+Requires-Dist: pydantic-collections<0.7.0,>=0.6.0
+Requires-Dist: pyngo<2.5.0,>=2.4.1
+Requires-Dist: flagsmith<6.0.0,>=5.3.0
+Requires-Dist: openfeature-sdk<0.10.0,>=0.9.0
+Requires-Dist: openfeature-provider-flagsmith>=0.2.0
+Requires-Dist: python-gnupg<0.6.0,>=0.5.1
+Requires-Dist: django-redis<6.0.0,>=5.4.0
+Requires-Dist: pygithub<2.9.0,>=2.8
+Requires-Dist: hubspot-api-client<13.0.0,>=12.0.0
+Requires-Dist: djangorestframework-dataclasses<2.0.0,>=1.3.1
+Requires-Dist: pyotp<3.0.0,>=2.9.0
+Requires-Dist: flagsmith-common[common-core,flagsmith-schemas,task-processor]<4,>=3.9.0
+Requires-Dist: django-stubs<6.0.0,>=5.1.3
+Requires-Dist: tzdata<2025.0.0,>=2024.1
+Requires-Dist: djangorestframework-simplejwt<6.0.0,>=5.5.1
+Requires-Dist: structlog<25.0.0,>=24.4.0
+Requires-Dist: prometheus-client<0.22.0,>=0.21.1
+Requires-Dist: django-cockroachdb<4.3.0,>=4.2
+Requires-Dist: django-oauth-toolkit<4.0.0,>=3.0.1
+Provides-Extra: auth-controller
+Requires-Dist: auth-controller; extra == "auth-controller"
+Requires-Dist: django-multiselectfield<2,>=1.0.1; extra == "auth-controller"
+Provides-Extra: saml
+Requires-Dist: pysaml2<8.0.0,>=7.4.2; extra == "saml"
+Provides-Extra: ldap
+Requires-Dist: flagsmith-ldap; extra == "ldap"
+Requires-Dist: django-python3-ldap<1,>=0.15.6; extra == "ldap"
+Provides-Extra: workflows
+Requires-Dist: workflows-logic; extra == "workflows"
+Provides-Extra: licensing
+Requires-Dist: licensing; extra == "licensing"
+Requires-Dist: cryptography>=44.0.1; extra == "licensing"
+Provides-Extra: release-pipelines
+Requires-Dist: flagsmith-private<1,>=0.5.1; extra == "release-pipelines"
+Provides-Extra: scim
+Requires-Dist: flagsmith-private<1,>=0.5.1; extra == "scim"
+Provides-Extra: dev
+Requires-Dist: django-test-migrations<2.0.0,>=1.2.0; extra == "dev"
+Requires-Dist: responses<0.23.0,>=0.22.0; extra == "dev"
+Requires-Dist: pre-commit<5.0.0,>=4.0.1; extra == "dev"
+Requires-Dist: pytest-mock<3.11.0,>=3.10.0; extra == "dev"
+Requires-Dist: pytest-lazy-fixture<0.7.0,>=0.6.3; extra == "dev"
+Requires-Dist: moto<4.2.0,>=4.1.3; extra == "dev"
+Requires-Dist: pytest-freezegun<0.5.0,>=0.4.2; extra == "dev"
+Requires-Dist: setuptools; extra == "dev"
+Requires-Dist: pytest-xdist<3.7.0,>=3.6.1; extra == "dev"
+Requires-Dist: pylint<2.17.0,>=2.16.2; extra == "dev"
+Requires-Dist: pep8<1.8.0,>=1.7.1; extra == "dev"
+Requires-Dist: autopep8<2.1.0,>=2.0.1; extra == "dev"
+Requires-Dist: pytest<7.3.0,>=7.2.1; extra == "dev"
+Requires-Dist: pytest-django<5.0.0,>=4.8.0; extra == "dev"
+Requires-Dist: pytest-cov<4.2.0,>=4.1.0; extra == "dev"
+Requires-Dist: datamodel-code-generator<0.26.0,>=0.25; extra == "dev"
+Requires-Dist: requests-mock<2.0.0,>=1.11.0; extra == "dev"
+Requires-Dist: django-extensions<4.0.0,>=3.2.3; extra == "dev"
+Requires-Dist: pdbpp<0.11.0,>=0.10.3; extra == "dev"
+Requires-Dist: mypy-boto3-dynamodb<2.0.0,>=1.33.0; extra == "dev"
+Requires-Dist: pytest-structlog<2.0.0,>=1.1; extra == "dev"
+Requires-Dist: pyfakefs<6.0.0,>=5.7.4; extra == "dev"
+Requires-Dist: mypy<2.0.0,>=1.15.0; extra == "dev"
+Requires-Dist: djangorestframework-stubs<4.0.0,>=3.15.2; extra == "dev"
+Requires-Dist: boto3-stubs<2.0.0,>=1.36.20; extra == "dev"
+Requires-Dist: types-requests<3.0.0,>=2.32.0.20241016; extra == "dev"
+Requires-Dist: types-markdown<4.0.0,>=3.7.0.20241204; extra == "dev"
+Requires-Dist: types-pygments<3.0.0,>=2.19.0.20250107; extra == "dev"
+Requires-Dist: types-influxdb-client<2.0.0,>=1.45.0.20241221; extra == "dev"
+Requires-Dist: types-psycopg2<3.0.0,>=2.9.21.20250121; extra == "dev"
+Requires-Dist: types-python-dateutil<3.0.0,>=2.9.0.20241206; extra == "dev"
+Requires-Dist: types-pytz<2026.0.0,>=2025.1.0.20250204; extra == "dev"
+Requires-Dist: ruff<0.10.0,>=0.9.7; extra == "dev"
+Requires-Dist: flagsmith-common[test-tools]; extra == "dev"
+Requires-Dist: pytest-responses<0.6.0,>=0.5.1; extra == "dev"
+Requires-Dist: diff-cover<11.0.0,>=10.1.0; extra == "dev"
+Requires-Dist: django-debug-toolbar; extra == "dev"
+Requires-Dist: ipython<10.0.0,>=9.10.0; extra == "dev"
+Requires-Dist: email-validator>=2.0.0; extra == "dev"
+
+## Flagsmith API
+
+### Local development
+
+The project assumes the following tools installed:
+- [Python](https://www.python.org/downloads/). Any version allowed by `requires-python` in `pyproject.toml` is supported.
+- [GNU Make](https://www.gnu.org/software/make/).
+- Docker or a compatible tool like [Podman](https://podman.io/). We recommend [OrbStack](https://orbstack.dev/) for macOS.
+
+To install dev dependencies, run `make install`. Only Flagsmith maintainers can run `uv lock` due to private dependencies.
+
+To run linters, run `make lint`.
+
+To run tests, run `make test`.
+
+To run a subset of tests or an individual test, run `make test opts='<pytest args>'`. If the number of test is too low for xdist, consider adding `-n0` to pytest args.
+
+To prepare a dev database, run `make docker-up django-migrate`.
+
+To bring up a dev server, run `make serve`, or `make serve-with-task-processor` to run the Task processor alongside the server.
+
+### Code guidelines: testing
+
+The required diff test coverage for our backend PRs is 100%. This policy gives us more confidence to ship, helps us to find bugs earlier, and promotes the test-driven development (TDD) approach. We encourage you to add new tests, and modify existing ones, ahead of writing the code.
+
+This codebase includes two kinds of tests:
+- Black box API tests in `tests/integration` directory. Ideally, these are intended to only invoke API endpoints, and verify their output.
+- Tests for individual modules, classes and functions in `tests/unit` directory.
+
+We avoid class-based tests. To manage test lifecycle and dependencies, we rely on Pytest features such as fixtures, markers, parametrisation, and hooks. Read `conftest.py` for commonly used fixtures.
+
+We enforce the `test_{subject}__{condition}__{expected outcome}` template for test names, e.g. `test_get_version__valid_file_contents__returns_version_number`.
+
+We use the Given When Then structure in all our tests.
+
+### Code guidelines: metrics
+
+The Flagsmith backend exports Prometheus metrics. When planning a feature, consider which metrics should cover it — counters for domain events, histograms for latency or sizes, gauges for cardinalities. See [documentation for existing metrics](https://docs.flagsmith.com/deployment-self-hosting/observability/metrics). Metrics code is hosted in `metrics.py` modules.
+
+Name metrics `flagsmith_{domain}_{entity}_{unit}` and give them a comprehensive description.
+
+### Code guidelines: logs
+
+We use structured logging to mark up interesting operational and product events. Events emitted via structlog also flow through an OpenTelemetry pipeline and may be routed to a CDP or a data warehouse for product analytics.
+
+When planning a feature, decide which moments deserve an event: things a product manager would ask about (an integration set up, a workflow committed, an import completed), or that a future oncall engineer would need to debug an incident. One well-shaped event per moment beats a wall of free-form `logging.info` calls.
+
+```python
+import structlog
+
+# Use logger name as the event domain:
+logger = structlog.get_logger("workflows")
+
+# This will produce a `workflows.change_request.committed` OTLP log event
+# with the following attributes:
+#   - organisation.id
+#   - environment.id
+#   - feature_states.count
+logger.info(
+    "change_request.committed",
+    organisation__id=environment.project.organisation_id,
+    environment__id=environment.id,
+    feature_states__count=change_request.feature_states.count(),
+)
+```
+
+In your tests, verify your logs with the `caplog` fixture:
+
+```python
+from pytest_structlog import StructuredLogCapture
+
+def test_my_view__success__logs_expected(
+    log: StructuredLogCapture,
+) -> None:
+    # Given / When
+    ...
+
+    # Then
+    assert log.events == [
+        {
+            "level": "info",
+            "event": "action.succeeded",
+            "organisation__id": organisation.id,
+        }
+    ]
+```
+
+Conventions:
+
+- Logger name is the domain namespace — typically the app or package (`workflows`, `code_references`, `feature_health`).
+- Event name is `entity.action` in snake_case (`scan.created`, `change_request.committed`). Do not repeat the logger name in the event, i.e `get_logger("saml")` with `"saml.configuration.created"` is redundant.
+- Use double underscore to namespace event attributes, i.e. `namespace__property` will be emitted as `namespace.property`. Include the IDs of the entities the event is about (`organisation__id`, `project__id`, `environment__id`, `feature__id`) so events can be correlated with each other.
+- Bind shared context once with `logger.bind(...)` rather than repeating attributes at every call site.
+- Avoid PII — identify users and organisations by ID.
+
+For errors, use `logger.exception(...)` or pass `exc_info=exc`, and keep the event name actionable (`import.failed`, not `error`).
+
+### Code guidelines: feature flags (Flagsmith on Flagsmith)
+
+To gate and gradually roll out features in the backend, we use the [OpenFeature](https://openfeature.dev/) SDK with a Flagsmith provider running in local evaluation mode:
+
+```python
+from integrations.flagsmith.client import get_openfeature_client
+
+client = get_openfeature_client()
+ai_enabled = client.get_boolean_value(
+    "ai",
+    default_value=False,
+    evaluation_context=organisation.openfeature_evaluation_context,
+)
+```
+
+Organisations expose an `openfeature_evaluation_context` property carrying common traits — use it for org-scoped targeting. For other subjects, build an `EvaluationContext` with a stable `targeting_key` and the attributes your targeting rules need.
+
+Add your feature as early as possible to the Flagsmith on Flagsmith project, and run the `updateflagsmithenvironment` management command to synchronise the local cache. You can use [Flagsmith MCP](https://docs.flagsmith.com/integrating-with-flagsmith/mcp-server) to integrate Flagsmith in your development flow.
+
+### Code guidelines: migrations
+
+To auto-generate migrations for your new code, run `make docker-up django-make-migrations`.
+
+The prompt will ask you for a name and not generate one; we avoid auto-generated migration names.
+
+Squash newly added migrations whenever you can.
+
+### Code guidelines: typing
+
+This codebase, including tests, is fully type-checked by Mypy in strict mode. Resolving existing `# type: ignore` comments is always welcome. If you happen to bring a new `# type: ignore` comment, please document the reason, and consider fixing a small number of adjacent `# type: ignore` comments, if possible and appropriate for the scope of your task.
+
+To run a full type check, run `make typecheck`.
+
+### Code guidelines: design and architecture
+
+Core API consists of Django apps with usual Django submodules like:
+- `apps.py`
+- `middleware.py`
+- `models.py`
+- `serializers.py`
+- `views.py`
+- `urls.py`
+
+We tend to add our own layers in the following modules:
+- `constants.py` for app-wide constant variables.
+- `dataclasses.py` for dataclass definitions, typically used for internal data transfer objects (DTOs).
+- `mappers.py` for data mapping logic unrelated to API requests and responses.
+- `services.py` for encapsulated business logic. Our goal with this layer is to make the views, models and serialisers leaner, so that the business logic is more clearly defined and easier to compose.
+- `tasks.py` for defining asynchronous and recurring tasks.
+- `types.py` for custom type definitions, including typed dicts.