{
  "id": "python/pip-egg-info-deprecated-setup-py",
  "signature": "DEPRECATION: Legacy setup.py install is deprecated. pip 24.1 will enforce this behaviour change. A possible replacement is to upgrade to a newer version of <pkg> or contact the author to suggest that they release a PEP 517 build backend.",
  "signature_zh": "DEPRECATION：旧式 setup.py install 已弃用。pip 24.1 将强制此行为变更。可能的替代方案是升级到更新版本的 <pkg>，或联系作者建议其发布 PEP 517 构建后端。",
  "regex": "DEPRECATION:\\ Legacy\\ setup\\.py\\ install\\ is\\ deprecated\\.\\ pip\\ 24\\.1\\ will\\ enforce\\ this\\ behaviour\\ change\\.\\ A\\ possible\\ replacement\\ is\\ to\\ upgrade\\ to\\ a\\ newer\\ version\\ of\\ <pkg>\\ or\\ contact\\ the\\ author\\ to\\ suggest\\ that\\ they\\ release\\ a\\ PEP\\ 517\\ build\\ backend\\.",
  "domain": "python",
  "category": "install_error",
  "subcategory": null,
  "root_cause": "The package ships only a legacy `setup.py` without `pyproject.toml`, so pip must invoke `setup.py install` instead of a PEP 517 backend.",
  "root_cause_type": "generic",
  "root_cause_zh": "该包仅提供旧式 `setup.py` 而缺少 `pyproject.toml`，因此 pip 必须调用 `setup.py install` 而非 PEP 517 后端。",
  "versions": [
    {
      "version": "3.8",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "3.9",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "3.10",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "3.11",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "3.12",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "The deprecation is about the missing PEP 517 metadata, not build isolation.",
      "fail_rate": 0.85,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "If the upstream project has not yet migrated, the newest release still triggers the same deprecation.",
      "fail_rate": 0.6,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "",
      "success_rate": 0.85,
      "how": "Pin a version that has migrated to pyproject.toml, or vendor the source and add a minimal pyproject.toml with `[build-system] requires=['setuptools>=61'] build-backend='setuptools.build_meta'`.",
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "success_rate": 0.7,
      "how": "Silence locally with `PYTHONWARNINGS=ignore::DeprecationWarning` for CI noise only (does NOT fix the underlying issue).",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": null,
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.84,
  "fix_success_rate": 0.8,
  "resolvable": "partial",
  "first_seen": "2024-02-01",
  "last_confirmed": "2025-01-01",
  "last_updated": "2025-01-01",
  "evidence_count": 0,
  "tags": [],
  "locale": "en",
  "aliases": []
}