# ERROR: setuptools.errors.VersionError: Version '1.0.0' is invalid: expected '.' or end of string after '1'

- **ID:** `python/setuptools-version-scheme-error`
- **Domain:** python
- **Category:** data_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

The version string contains invalid characters or format that setuptools cannot parse, e.g., using commas or spaces.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 3.8 | active | — | — |
| 3.9 | active | — | — |

## Workarounds

1. **Use a valid PEP 440 version string** (95% success)
   ```
   Change to '1.0.0' (ensure only dots and digits).
   ```
2. **Use setuptools_scm to auto-generate versions from git tags** (90% success)
   ```
   Install setuptools_scm and configure in setup.cfg: [tool:setuptools_scm]
   ```

## Dead Ends

- **Adding a trailing 'v' to the version** — Versions must start with a digit. (90% fail)
- **Using a version like '1,0,0' with commas** — Commas are not valid separators. (80% fail)