Merge branch 'master' into dependabot/github_actions/codecov/codecov-action-5.4.0

Author: antonpirker

.github/PULL_REQUEST_TEMPLATE.md

@@ -4,4 +4,4 @@
 
 Thank you for contributing to `sentry-python`! Please add tests to validate your changes, and lint your code using `tox -e linters`.
 
-Running the test suite on your PR might require maintainer approval. The AWS Lambda tests additionally require a maintainer to add a special label, and they will fail until this label is added.
+Running the test suite on your PR might require maintainer approval.

.github/workflows/scripts/trigger_tests_on_label.py

@@ -35,6 +35,10 @@ jobs:
         # ubuntu-20.04 is the last version that supported python3.6
         # see https://github.com/actions/setup-python/issues/544#issuecomment-1332535877
         os: [ubuntu-20.04]
+    services:
+      docker:
+        image: docker:dind  # Required for Docker network management
+        options: --privileged  # Required for Docker-in-Docker operations
     steps:
       - uses: actions/[email protected]
       - uses: actions/setup-python@v5
@@ -47,6 +51,10 @@ jobs:
       - name: Erase coverage
         run: |
           coverage erase
+      - name: Test aws_lambda latest
+        run: |
+          set -x # print commands that are executed
+          ./scripts/runtox.sh "py${{ matrix.python-version }}-aws_lambda-latest"
       - name: Test boto3 latest
         run: |
           set -x # print commands that are executed
@@ -97,12 +105,16 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.6","3.7","3.9","3.11","3.12","3.13"]
+        python-version: ["3.6","3.7","3.8","3.9","3.11","3.12","3.13"]
         # python3.6 reached EOL and is no longer being supported on
         # new versions of hosted runners on Github Actions
         # ubuntu-20.04 is the last version that supported python3.6
         # see https://github.com/actions/setup-python/issues/544#issuecomment-1332535877
         os: [ubuntu-20.04]
+    services:
+      docker:
+        image: docker:dind  # Required for Docker network management
+        options: --privileged  # Required for Docker-in-Docker operations
     steps:
       - uses: actions/[email protected]
       - uses: actions/setup-python@v5
@@ -115,6 +127,10 @@ jobs:
       - name: Erase coverage
         run: |
           coverage erase
+      - name: Test aws_lambda pinned
+        run: |
+          set -x # print commands that are executed
+          ./scripts/runtox.sh --exclude-latest "py${{ matrix.python-version }}-aws_lambda"
       - name: Test boto3 pinned
         run: |
           set -x # print commands that are executed

.github/workflows/test-integrations-cloud.yml

@@ -28,3 +28,6 @@ relay
 pip-wheel-metadata
 .mypy_cache
 .vscode/
+
+# for running AWS Lambda tests using AWS SAM
+sam.template.yaml

.gitignore

@@ -1,19 +1,32 @@
 <a href="https://sentry.io/?utm_source=github&utm_medium=logo" target="_blank">
   <img src="https://sentry-brand.storage.googleapis.com/github-banners/github-sdk-python.png" alt="Sentry for Python">
 </a>
+<div align="center">
 
+_Bad software is everywhere, and we're tired of it. Sentry is on a mission to help developers write better software faster, so we can get back to enjoying technology. If you want to join us
+[<kbd>**Check out our open positions**</kbd>](https://sentry.io/careers/)_.
+
+[![Discord](https://img.shields.io/discord/621778831602221064?logo=discord&labelColor=%20%235462eb&logoColor=%20%23f5f5f5&color=%20%235462eb)](https://discord.gg/wdNEHETs87)
+[![Twitter Follow](https://img.shields.io/twitter/follow/getsentry?label=@getsentry&style=social)](https://twitter.com/intent/follow?screen_name=getsentry)
+[![PyPi page link -- version](https://img.shields.io/pypi/v/sentry-sdk.svg)](https://pypi.python.org/pypi/sentry-sdk)
+<img src="https://img.shields.io/badge/python-3.7 | 3.8 | 3.9 | 3.10 | 3.11 | 3.12 | 3.13-blue.svg" alt="python">
+[![Build Status](https://github.com/getsentry/sentry-python/actions/workflows/ci.yml/badge.svg)](https://github.com/getsentry/sentry-python/actions/workflows/ci.yml)
+
+<br/>
+
+</div>
 
-_Bad software is everywhere, and we're tired of it. Sentry is on a mission to help developers write better software faster, so we can get back to enjoying technology. If you want to join us, [<kbd>**check out our open positions**</kbd>](https://sentry.io/careers/)_.
 
 # Official Sentry SDK for Python
 
-[![Build Status](https://github.com/getsentry/sentry-python/actions/workflows/ci.yml/badge.svg)](https://github.com/getsentry/sentry-python/actions/workflows/ci.yml)
-[![PyPi page link -- version](https://img.shields.io/pypi/v/sentry-sdk.svg)](https://pypi.python.org/pypi/sentry-sdk)
-[![Discord](https://img.shields.io/discord/621778831602221064)](https://discord.gg/cWnMQeA)
+Welcome to the official Python SDK for **[Sentry](http://sentry.io/)**.
+
+
+## 📦 Getting Started
 
-Welcome to the official Python SDK for **[Sentry](http://sentry.io/)**!
+### Prerequisites
 
-## Getting Started
+You need a Sentry [account](https://sentry.io/signup/) and [project](https://docs.sentry.io/product/projects/).
 
 ### Installation
 
@@ -25,7 +38,7 @@ pip install --upgrade sentry-sdk
 
 ### Basic Configuration
 
-Here’s a quick configuration example to get Sentry up and running:
+Here's a quick configuration example to get Sentry up and running:
 
 ```python
 import sentry_sdk
@@ -34,7 +47,7 @@ sentry_sdk.init(
     "https://[email protected]/1",  # Your DSN here
 
     # Set traces_sample_rate to 1.0 to capture 100%
-    # of transactions for performance monitoring.
+    # of traces for performance monitoring.
     traces_sample_rate=1.0,
 )
 ```
@@ -46,36 +59,26 @@ With this configuration, Sentry will monitor for exceptions and performance issu
 To generate some events that will show up in Sentry, you can log messages or capture errors:
 
 ```python
-from sentry_sdk import capture_message
-capture_message("Hello Sentry!")  # You'll see this in your Sentry dashboard.
+import sentry_sdk
+sentry_sdk.init(...)  # same as above
+
+sentry_sdk.capture_message("Hello Sentry!")  # You'll see this in your Sentry dashboard.
 
 raise ValueError("Oops, something went wrong!")  # This will create an error event in Sentry.
 ```
 
-#### Explore the Docs
-
-For more details on advanced usage, integrations, and customization, check out the full documentation:
-
-- [Official SDK Docs](https://docs.sentry.io/platforms/python/)
-- [API Reference](https://getsentry.github.io/sentry-python/)
 
-## Integrations
+## 📚 Documentation
 
-Sentry integrates with many popular Python libraries and frameworks, including:
+For more details on advanced usage, integrations, and customization, check out the full documentation on [https://docs.sentry.io](https://docs.sentry.io/).
 
-- [Django](https://docs.sentry.io/platforms/python/integrations/django/)
-- [Flask](https://docs.sentry.io/platforms/python/integrations/flask/)
-- [FastAPI](https://docs.sentry.io/platforms/python/integrations/fastapi/)
-- [Celery](https://docs.sentry.io/platforms/python/integrations/celery/)
-- [AWS Lambda](https://docs.sentry.io/platforms/python/integrations/aws-lambda/)
 
-Want more? [Check out the full list of integrations](https://docs.sentry.io/platforms/python/integrations/).
+## 🧩 Integrations
 
-### Rolling Your Own Integration?
+Sentry integrates with a ton of popular Python libraries and frameworks, including [FastAPI](https://docs.sentry.io/platforms/python/integrations/fastapi/), [Django](https://docs.sentry.io/platforms/python/integrations/django/), [Celery](https://docs.sentry.io/platforms/python/integrations/celery/), [OpenAI](https://docs.sentry.io/platforms/python/integrations/openai/) and many, many more.  Check out the [full list of integrations](https://docs.sentry.io/platforms/python/integrations/) to get the full picture.
 
-If you want to create a new integration or improve an existing one, we’d welcome your contributions! Please read our [contributing guide](https://github.com/getsentry/sentry-python/blob/master/CONTRIBUTING.md) before starting.
 
-## Migrating Between Versions?
+## 🚧 Migrating Between Versions?
 
 ### From `1.x` to `2.x`
 
@@ -85,30 +88,35 @@ If you're using the older `1.x` version of the SDK, now's the time to upgrade to
 
 Using the legacy `raven-python` client? It's now in maintenance mode, and we recommend migrating to the new SDK for an improved experience. Get all the details in our [migration guide](https://docs.sentry.io/platforms/python/migration/raven-to-sentry-sdk/).
 
-## Want to Contribute?
 
-We’d love your help in improving the Sentry SDK! Whether it’s fixing bugs, adding features, or enhancing documentation, every contribution is valuable.
+## 🙌 Want to Contribute?
 
-For details on how to contribute, please check out [CONTRIBUTING.md](CONTRIBUTING.md) and explore the [open issues](https://github.com/getsentry/sentry-python/issues).
+We'd love your help in improving the Sentry SDK! Whether it's fixing bugs, adding features, writing new integrations, or enhancing documentation, every contribution is valuable.
 
-## Need Help?
+For details on how to contribute, please read our [contribution guide](CONTRIBUTING.md) and explore the [open issues](https://github.com/getsentry/sentry-python/issues).
 
-If you encounter issues or need help setting up or configuring the SDK, don’t hesitate to reach out to the [Sentry Community on Discord](https://discord.com/invite/Ww9hbqr). There is a ton of great people there ready to help!
 
-## Resources
+## 🛟 Need Help?
 
-Here are additional resources to help you make the most of Sentry:
+If you encounter issues or need help setting up or configuring the SDK, don't hesitate to reach out to the [Sentry Community on Discord](https://discord.com/invite/Ww9hbqr). There is a ton of great people there ready to help!
 
-- [![Documentation](https://img.shields.io/badge/documentation-sentry.io-green.svg)](https://docs.sentry.io/quickstart/) – Official documentation to get started.
-- [![Discord](https://img.shields.io/discord/621778831602221064)](https://discord.gg/Ww9hbqr) – Join our Discord community.
-- [![Twitter Follow](https://img.shields.io/twitter/follow/getsentry?label=getsentry&style=social)](https://twitter.com/intent/follow?screen_name=getsentry) – Follow us on X (Twitter) for updates.
-- [![Stack Overflow](https://img.shields.io/badge/stack%20overflow-sentry-green.svg)](http://stackoverflow.com/questions/tagged/sentry) – Questions and answers related to Sentry.
 
-## License
+## 🔗 Resources
+
+Here are all resources to help you make the most of Sentry:
+
+- [Documentation](https://docs.sentry.io/platforms/python/) - Official documentation to get started.
+- [Discord](https://img.shields.io/discord/621778831602221064) - Join our Discord community.
+- [X/Twitter](https://twitter.com/intent/follow?screen_name=getsentry) -  Follow us on X (Twitter) for updates.
+- [Stack Overflow](https://stackoverflow.com/questions/tagged/sentry) - Questions and answers related to Sentry.
+
+<a name="license"></a>
+## 📃 License
 
 The SDK is open-source and available under the MIT license. Check out the [LICENSE](LICENSE) file for more information.
 
----
+
+## 😘 Contributors
 
 Thanks to everyone who has helped improve the SDK!
 

README.md

@@ -5,6 +5,14 @@ Top Level API
 This is the user facing API of the SDK. It's exposed as ``sentry_sdk``.
 With this API you can implement a custom performance monitoring or error reporting solution.
 
+Initializing the SDK
+====================
+
+.. autoclass:: sentry_sdk.client.ClientConstructor
+   :members:
+   :undoc-members:
+   :special-members: __init__
+   :noindex:
 
 Capturing Data
 ==============

docs/api.rst

@@ -14,3 +14,4 @@ socksio
 httpcore[http2]
 setuptools
 Brotli
+docker

requirements-testing.txt

@@ -1,6 +1,7 @@
 #!/usr/bin/env bash
 #
 # Deletes all versions of the layer specified in LAYER_NAME in one region.
+# Use with caution!
 #
 
 set -euo pipefail