# SetuptoolsDeprecationWarning: 'license-file' is deprecated; use 'license-files' with glob patterns instead.

- **ID:** `python/setuptools-license-file-deprecated`
- **Domain:** python
- **Category:** config_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

setuptools 77+ deprecates the singular license-file key in favor of license-files (a list supporting globs) to align with PEP 639.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 3.x | active | — | — |

## Workarounds

1. **** (95% success)
   ```
   # pyproject.toml
[project]
license = "MIT"
license-files = ["LICENSE*", "COPYING*"]
   ```
2. **** (92% success)
   ```
   [project]
license = "MIT"  # or "Apache-2.0 OR MIT"
license-files = ["LICENSE"]
   ```

## Dead Ends

- **** — The key will be removed, breaking future builds. (70% fail)
- **** — Blocks security updates and may conflict with other build requirements. (80% fail)