# 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.

- **ID:** `python/pip-egg-info-deprecated-setup-py`
- **Domain:** python
- **Category:** install_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## 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.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 3.8 | active | — | — |
| 3.9 | active | — | — |
| 3.10 | active | — | — |
| 3.11 | active | — | — |
| 3.12 | active | — | — |

## Workarounds

1. **** (85% success)
   ```
   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'`.
   ```
2. **** (70% success)
   ```
   Silence locally with `PYTHONWARNINGS=ignore::DeprecationWarning` for CI noise only (does NOT fix the underlying issue).
   ```

## Dead Ends

- **** — The deprecation is about the missing PEP 517 metadata, not build isolation. (85% fail)
- **** — If the upstream project has not yet migrated, the newest release still triggers the same deprecation. (60% fail)