{"adoption": {"forks": 10, "observed_at": "2026-08-28T04:06:13.493325+00:00", "stars": 2099}, "canonical_url": "https://ross.abutalabs.com/products/deprecation-contracts", "card": {"archived": false, "artifact_type": "library", "description": "A generic function and convention to trigger deprecation notices", "domain": ["developer-tools", "apis"], "enriched": true, "function": ["logging", "error-handling", "developer-tools"], "health_score": 93, "homepage": "https://symfony.com", "language": "PHP", "license": "MIT", "license_family": "permissive", "maturity": "stable", "member_repos": ["symfony/deprecation-contracts"], "name": "symfony/deprecation-contracts", "platform": ["php", "cli"], "pushed_at": "2026-06-27T21:46:30+00:00", "repo": "symfony/deprecation-contracts", "stars": 2099, "tags": ["deprecation-notices", "symfony-contracts", "php-library", "backward-compatibility", "php"], "topics": ["php", "symfony", "contracts", "symfony-contracts"], "urls": [], "use_cases": ["trigger deprecation notices in a php library", "warn users about deprecated api usage", "log silenced deprecations in dev and prod", "manage backward compatibility warnings across package versions", "standardize deprecation messages in composer packages"], "what_it_is": "A minimal PHP package providing a single global `trigger_deprecation()` function and convention for emitting deprecation notices from libraries. The notices can be captured and logged via a custom error handler such as Symfony's ErrorHandler component.", "when_to_avoid": ["you need a full deprecation detection or static analysis tool rather than a trigger convention", "your project is not PHP-based", "you want automatic code migration suggestions"], "when_to_choose": ["you maintain a PHP library or Symfony component and need a standard way to mark APIs as deprecated", "you want deprecations to be catchable and loggable by error handlers", "you need a tiny dependency with no runtime overhead"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/deprecation-contracts", "repo": "symfony/deprecation-contracts", "role": "main", "score": 87}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:06:13.493325+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-30T02:54:27.114315+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "174b9acbcf946eb18550a41ab70d0dfca43502b11da3cdd4d8452a31b20387a7", "fetched_at": "2026-08-28T04:06:13.493325+00:00", "kind": "readme", "missing": false, "url": "https://github.com/symfony/deprecation-contracts"}, {"content_hash": "68595089eb7355a2c1a714920fc9072e2c51536d1d0bb4b4491a2212710553a0", "fetched_at": "2026-08-29T10:34:44.333306+00:00", "kind": "homepage", "missing": false, "url": "https://symfony.com"}, {"content_hash": "44889134f4fb7667fc156f6aa19b524c32df208a02756d59eacc0262725f7bfd", "fetched_at": "2026-08-29T10:34:44.342417+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc"}, {"content_hash": "43441105b0a6494a16afb10fe8b55e408cb6a5f11bf5c04b00963b66c710004c", "fetched_at": "2026-08-29T10:34:44.344358+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc/current/contributing/community/releases.html"}, {"content_hash": "5bd749e2b6762e15759a7073bf28626338d35575d716f7564d4f7323e88c911b", "fetched_at": "2026-08-29T10:34:44.346201+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/releases"}, {"content_hash": "d8584ccbba1ce7413028ab7e84adc356b558d98bf7a99e84288f673926711471", "fetched_at": "2026-08-29T10:34:44.347975+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/blog/category/releases"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:06:13.493325+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-30T02:54:27.114315+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "174b9acbcf946eb18550a41ab70d0dfca43502b11da3cdd4d8452a31b20387a7", "fetched_at": "2026-08-28T04:06:13.493325+00:00", "kind": "readme", "missing": false, "url": "https://github.com/symfony/deprecation-contracts"}, {"content_hash": "68595089eb7355a2c1a714920fc9072e2c51536d1d0bb4b4491a2212710553a0", "fetched_at": "2026-08-29T10:34:44.333306+00:00", "kind": "homepage", "missing": false, "url": "https://symfony.com"}, {"content_hash": "44889134f4fb7667fc156f6aa19b524c32df208a02756d59eacc0262725f7bfd", "fetched_at": "2026-08-29T10:34:44.342417+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc"}, {"content_hash": "43441105b0a6494a16afb10fe8b55e408cb6a5f11bf5c04b00963b66c710004c", "fetched_at": "2026-08-29T10:34:44.344358+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc/current/contributing/community/releases.html"}, {"content_hash": "5bd749e2b6762e15759a7073bf28626338d35575d716f7564d4f7323e88c911b", "fetched_at": "2026-08-29T10:34:44.346201+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/releases"}, {"content_hash": "d8584ccbba1ce7413028ab7e84adc356b558d98bf7a99e84288f673926711471", "fetched_at": "2026-08-29T10:34:44.347975+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/blog/category/releases"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-30T02:54:27.114315+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "174b9acbcf946eb18550a41ab70d0dfca43502b11da3cdd4d8452a31b20387a7", "fetched_at": "2026-08-28T04:06:13.493325+00:00", "kind": "readme", "missing": false, "url": "https://github.com/symfony/deprecation-contracts"}, {"content_hash": "68595089eb7355a2c1a714920fc9072e2c51536d1d0bb4b4491a2212710553a0", "fetched_at": "2026-08-29T10:34:44.333306+00:00", "kind": "homepage", "missing": false, "url": "https://symfony.com"}, {"content_hash": "44889134f4fb7667fc156f6aa19b524c32df208a02756d59eacc0262725f7bfd", "fetched_at": "2026-08-29T10:34:44.342417+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc"}, {"content_hash": "43441105b0a6494a16afb10fe8b55e408cb6a5f11bf5c04b00963b66c710004c", "fetched_at": "2026-08-29T10:34:44.344358+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc/current/contributing/community/releases.html"}, {"content_hash": "5bd749e2b6762e15759a7073bf28626338d35575d716f7564d4f7323e88c911b", "fetched_at": "2026-08-29T10:34:44.346201+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/releases"}, {"content_hash": "d8584ccbba1ce7413028ab7e84adc356b558d98bf7a99e84288f673926711471", "fetched_at": "2026-08-29T10:34:44.347975+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/blog/category/releases"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:06:13.493325+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:06:13.493325+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:06:13.493325+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-30T02:54:27.114315+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "174b9acbcf946eb18550a41ab70d0dfca43502b11da3cdd4d8452a31b20387a7", "fetched_at": "2026-08-28T04:06:13.493325+00:00", "kind": "readme", "missing": false, "url": "https://github.com/symfony/deprecation-contracts"}, {"content_hash": "68595089eb7355a2c1a714920fc9072e2c51536d1d0bb4b4491a2212710553a0", "fetched_at": "2026-08-29T10:34:44.333306+00:00", "kind": "homepage", "missing": false, "url": "https://symfony.com"}, {"content_hash": "44889134f4fb7667fc156f6aa19b524c32df208a02756d59eacc0262725f7bfd", "fetched_at": "2026-08-29T10:34:44.342417+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc"}, {"content_hash": "43441105b0a6494a16afb10fe8b55e408cb6a5f11bf5c04b00963b66c710004c", "fetched_at": "2026-08-29T10:34:44.344358+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc/current/contributing/community/releases.html"}, {"content_hash": "5bd749e2b6762e15759a7073bf28626338d35575d716f7564d4f7323e88c911b", "fetched_at": "2026-08-29T10:34:44.346201+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/releases"}, {"content_hash": "d8584ccbba1ce7413028ab7e84adc356b558d98bf7a99e84288f673926711471", "fetched_at": "2026-08-29T10:34:44.347975+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/blog/category/releases"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:06:13.493325+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:06:13.493325+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-30T02:54:27.114315+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "174b9acbcf946eb18550a41ab70d0dfca43502b11da3cdd4d8452a31b20387a7", "fetched_at": "2026-08-28T04:06:13.493325+00:00", "kind": "readme", "missing": false, "url": "https://github.com/symfony/deprecation-contracts"}, {"content_hash": "68595089eb7355a2c1a714920fc9072e2c51536d1d0bb4b4491a2212710553a0", "fetched_at": "2026-08-29T10:34:44.333306+00:00", "kind": "homepage", "missing": false, "url": "https://symfony.com"}, {"content_hash": "44889134f4fb7667fc156f6aa19b524c32df208a02756d59eacc0262725f7bfd", "fetched_at": "2026-08-29T10:34:44.342417+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc"}, {"content_hash": "43441105b0a6494a16afb10fe8b55e408cb6a5f11bf5c04b00963b66c710004c", "fetched_at": "2026-08-29T10:34:44.344358+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc/current/contributing/community/releases.html"}, {"content_hash": "5bd749e2b6762e15759a7073bf28626338d35575d716f7564d4f7323e88c911b", "fetched_at": "2026-08-29T10:34:44.346201+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/releases"}, {"content_hash": "d8584ccbba1ce7413028ab7e84adc356b558d98bf7a99e84288f673926711471", "fetched_at": "2026-08-29T10:34:44.347975+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/blog/category/releases"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:06:13.493325+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:06:13.493325+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:06:13.493325+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-30T02:54:27.114315+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "174b9acbcf946eb18550a41ab70d0dfca43502b11da3cdd4d8452a31b20387a7", "fetched_at": "2026-08-28T04:06:13.493325+00:00", "kind": "readme", "missing": false, "url": "https://github.com/symfony/deprecation-contracts"}, {"content_hash": "68595089eb7355a2c1a714920fc9072e2c51536d1d0bb4b4491a2212710553a0", "fetched_at": "2026-08-29T10:34:44.333306+00:00", "kind": "homepage", "missing": false, "url": "https://symfony.com"}, {"content_hash": "44889134f4fb7667fc156f6aa19b524c32df208a02756d59eacc0262725f7bfd", "fetched_at": "2026-08-29T10:34:44.342417+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc"}, {"content_hash": "43441105b0a6494a16afb10fe8b55e408cb6a5f11bf5c04b00963b66c710004c", "fetched_at": "2026-08-29T10:34:44.344358+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc/current/contributing/community/releases.html"}, {"content_hash": "5bd749e2b6762e15759a7073bf28626338d35575d716f7564d4f7323e88c911b", "fetched_at": "2026-08-29T10:34:44.346201+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/releases"}, {"content_hash": "d8584ccbba1ce7413028ab7e84adc356b558d98bf7a99e84288f673926711471", "fetched_at": "2026-08-29T10:34:44.347975+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/blog/category/releases"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:06:13.493325+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:06:13.493325+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-30T02:54:27.114315+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "174b9acbcf946eb18550a41ab70d0dfca43502b11da3cdd4d8452a31b20387a7", "fetched_at": "2026-08-28T04:06:13.493325+00:00", "kind": "readme", "missing": false, "url": "https://github.com/symfony/deprecation-contracts"}, {"content_hash": "68595089eb7355a2c1a714920fc9072e2c51536d1d0bb4b4491a2212710553a0", "fetched_at": "2026-08-29T10:34:44.333306+00:00", "kind": "homepage", "missing": false, "url": "https://symfony.com"}, {"content_hash": "44889134f4fb7667fc156f6aa19b524c32df208a02756d59eacc0262725f7bfd", "fetched_at": "2026-08-29T10:34:44.342417+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc"}, {"content_hash": "43441105b0a6494a16afb10fe8b55e408cb6a5f11bf5c04b00963b66c710004c", "fetched_at": "2026-08-29T10:34:44.344358+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc/current/contributing/community/releases.html"}, {"content_hash": "5bd749e2b6762e15759a7073bf28626338d35575d716f7564d4f7323e88c911b", "fetched_at": "2026-08-29T10:34:44.346201+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/releases"}, {"content_hash": "d8584ccbba1ce7413028ab7e84adc356b558d98bf7a99e84288f673926711471", "fetched_at": "2026-08-29T10:34:44.347975+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/blog/category/releases"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-30T02:54:27.114315+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "174b9acbcf946eb18550a41ab70d0dfca43502b11da3cdd4d8452a31b20387a7", "fetched_at": "2026-08-28T04:06:13.493325+00:00", "kind": "readme", "missing": false, "url": "https://github.com/symfony/deprecation-contracts"}, {"content_hash": "68595089eb7355a2c1a714920fc9072e2c51536d1d0bb4b4491a2212710553a0", "fetched_at": "2026-08-29T10:34:44.333306+00:00", "kind": "homepage", "missing": false, "url": "https://symfony.com"}, {"content_hash": "44889134f4fb7667fc156f6aa19b524c32df208a02756d59eacc0262725f7bfd", "fetched_at": "2026-08-29T10:34:44.342417+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc"}, {"content_hash": "43441105b0a6494a16afb10fe8b55e408cb6a5f11bf5c04b00963b66c710004c", "fetched_at": "2026-08-29T10:34:44.344358+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc/current/contributing/community/releases.html"}, {"content_hash": "5bd749e2b6762e15759a7073bf28626338d35575d716f7564d4f7323e88c911b", "fetched_at": "2026-08-29T10:34:44.346201+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/releases"}, {"content_hash": "d8584ccbba1ce7413028ab7e84adc356b558d98bf7a99e84288f673926711471", "fetched_at": "2026-08-29T10:34:44.347975+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/blog/category/releases"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-30T02:54:27.114315+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "174b9acbcf946eb18550a41ab70d0dfca43502b11da3cdd4d8452a31b20387a7", "fetched_at": "2026-08-28T04:06:13.493325+00:00", "kind": "readme", "missing": false, "url": "https://github.com/symfony/deprecation-contracts"}, {"content_hash": "68595089eb7355a2c1a714920fc9072e2c51536d1d0bb4b4491a2212710553a0", "fetched_at": "2026-08-29T10:34:44.333306+00:00", "kind": "homepage", "missing": false, "url": "https://symfony.com"}, {"content_hash": "44889134f4fb7667fc156f6aa19b524c32df208a02756d59eacc0262725f7bfd", "fetched_at": "2026-08-29T10:34:44.342417+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc"}, {"content_hash": "43441105b0a6494a16afb10fe8b55e408cb6a5f11bf5c04b00963b66c710004c", "fetched_at": "2026-08-29T10:34:44.344358+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc/current/contributing/community/releases.html"}, {"content_hash": "5bd749e2b6762e15759a7073bf28626338d35575d716f7564d4f7323e88c911b", "fetched_at": "2026-08-29T10:34:44.346201+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/releases"}, {"content_hash": "d8584ccbba1ce7413028ab7e84adc356b558d98bf7a99e84288f673926711471", "fetched_at": "2026-08-29T10:34:44.347975+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/blog/category/releases"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-30T02:54:27.114315+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "174b9acbcf946eb18550a41ab70d0dfca43502b11da3cdd4d8452a31b20387a7", "fetched_at": "2026-08-28T04:06:13.493325+00:00", "kind": "readme", "missing": false, "url": "https://github.com/symfony/deprecation-contracts"}, {"content_hash": "68595089eb7355a2c1a714920fc9072e2c51536d1d0bb4b4491a2212710553a0", "fetched_at": "2026-08-29T10:34:44.333306+00:00", "kind": "homepage", "missing": false, "url": "https://symfony.com"}, {"content_hash": "44889134f4fb7667fc156f6aa19b524c32df208a02756d59eacc0262725f7bfd", "fetched_at": "2026-08-29T10:34:44.342417+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc"}, {"content_hash": "43441105b0a6494a16afb10fe8b55e408cb6a5f11bf5c04b00963b66c710004c", "fetched_at": "2026-08-29T10:34:44.344358+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc/current/contributing/community/releases.html"}, {"content_hash": "5bd749e2b6762e15759a7073bf28626338d35575d716f7564d4f7323e88c911b", "fetched_at": "2026-08-29T10:34:44.346201+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/releases"}, {"content_hash": "d8584ccbba1ce7413028ab7e84adc356b558d98bf7a99e84288f673926711471", "fetched_at": "2026-08-29T10:34:44.347975+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/blog/category/releases"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 89, "longevity": 100, "rhythm": 78}, "computed_at": "2026-09-03T02:20:16.233290+00:00", "flags": [], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 2398, "days_push": 67, "days_rel": 67, "gap_med": 52, "n_releases_24m": 2}, "score": 87, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}