Repository navigation
Conversation
The migration guide is also published on posthog.com, where the relative link resolves to a missing page. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> (cherry picked from commit f143283)
The posthog.com Python SDK pages redirect to this reference once 8.0.0 ships, so their setup, how-to, and configuration sections now live in docs/getting-started.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> (cherry picked from commit 9db7014)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> (cherry picked from commit 0e9f755)
…d page" This reverts commit 7abca08.
This reverts commit bc7bc9c.
…other page has Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The reference renders each docstring under its entry, per major, so the tracing, ASGI, keepalive, and AsyncPosthog facts now live there. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Keeps both new generator functions (migration_page, getting_started) and their tests. The guide keeps this branch's text; its Celery eager line already carries #1232's wording. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…rted guide The sorted 8.0.0 guide dropped facts the v1 guide states: the self-hosted capture v1 route check, the 404 hint, the 400 duplicate_event_uuid on older PostHog, the legacy path removal, and NaN as null since 7.75.0. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…rted guide Identify-style events now default process_person_profile to true unless the call sets it or the SDK generated the distinct ID, so layered false no longer reaches them. Replaces the old reach rules and opt-in sample, and updates the checklist row, precedence step 1 and the before_send section. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
start_span evicts spans older than max_span_age first and returns an unrecorded span only if still at max_live_spans. A full span keeps the exception message in its status and loses only the type and stack trace. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Generated with bin/docs_scripts/generate_markdown.py --major 8. The migration page now carries the sorted guide, which it had not before. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…onless Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…he option Only capture and capture_ai take event properties. The properties of set, set_once and group_identify are person and group properties. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Each entry is now a CaptureDroppedEvent named tuple with uuid and details, so code that unpacks or compares (uuid, details) tuples keeps working. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
PR overviewNo security issues were found in this pull request. Reviews
|
SDK performance: posthog-pythonBenchmarks completed. No changes flagged for review. Flags require at least a 5% change in the median and all six pairs agreeing on direction. This is a noise filter, not proof of a performance change or a CI gate. View all results
Values are medians of paired measurements. Not flagged does not mean unchanged. Unavailable means a measurement could not be provided, not zero. Estimated allocation measurements retain their instrumentation uncertainty. RSS measures the whole process, not just SDK allocations; observed peaks are sampled checkpoints. Paired ranges in the diagnostics describe variability, not confidence intervals. Each shard uses its own runner; compare Before PR against With PR within a row, not across shards. Compared 102 metric rows; 102 rows shown in all results. Omitted or shortened data remain in |
…-structure Stacks the sorted guide on the identify-style person processing default and the CaptureDroppedEvent change. The guide keeps the sorted text, which already describes the default. References regenerated. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
…he guide Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Compression formats including zstd, the proxy pass-through rule, and that a `$set` in a global or context layer reaches every event. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
…es and semicolons Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The 8.x page is titled "PostHog Python SDK 8.x" before and after the release. Regenerating also picks up the self-hosted paragraph the migration guide's source already dropped. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…identify "so set the option there" read as setting it in properties, where the SDK treats it as a person property. set, set_once, and group_identify take options, so the guide now names them. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Vincent ruled out self-hosted framing in the guides, and the endpoint and 404 sentences read as self-host framing. The retry tables and the proxy notes stay. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
5b249fb
into
eli/v1-identify-style-person-default
💡 Motivation and Context
CaptureError.dropsis a list of bare(uuid, details)tuples, so anon_errorhandler has to index them by position. 8.0 renames the error type, which makes this the right release to name the fields. Stacked on #1247.CaptureError.dropsis now aCaptureDroppedEventnamed tuple withuuidanddetails, exported fromposthog.capture_sendnext toCaptureEventResult.(uuid, details)pairs is unaffected.CaptureError(drops=...)still accepts plain tuples and converts them.duplicate-event-uuidchangeset gains one sentence, with no new changeset, because this lands in 8.0.💚 How did you test it?
test_capture_send.py: the send path and a hand-builtCaptureErrorboth exposeuuidanddetails. Removing the conversion fails both new assertions.dropsto plain tuples pass unchanged.pytest: 7,750 passed; 3 failed, the macOS-only fork tests intest_metrics_autocapture.py, which fail identically onv1;ruff check,ruff format --check, mypy,make public_api_check: all pass.📝 Checklist
If releasing new changes
sampo addto generate a changeset file (not needed: an existing 8.0 changeset is updated)🤖 Agent context
Autonomy: Human-driven (agent-assisted)
Written with Claude Code (Claude Fable 5.2) at Eli's direction, from a public API review of the 8.0 branch. A named tuple was chosen over a dataclass so existing tuple handling, including the compliance adapter, keeps working.
🤖 Generated with Claude Code