python config_error ai_generated true

error: Invalid version string: '1.0.0-beta'

ID: python/setuptools-version-string-invalid

Also available as: JSON · Markdown · 中文
80%Fix Rate
85%Confidence
0Evidence
2024-09-14First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
3.8 active — — —

Root Cause

Setuptools uses PEP 440 versioning; '1.0.0-beta' is not compliant; should be '1.0.0b1'.

generic

中文

Setuptools使用PEP 440版本规范；'1.0.0-beta'不符合规范；应为'1.0.0b1'。

Workarounds

  1. 95% success Use PEP 440 compliant version 
    version='1.0.0b1'
  2. 90% success Use setuptools_scm for automatic versioning 
    pip install setuptools_scm
# setup.py
setup(use_scm_version=True)

Dead Ends

Common approaches that don't work:

  1. Using '1.0.0-beta1' 80% fail

    Still not PEP 440 compliant; hyphen not allowed for pre-releases.

  2. Removing pre-release label entirely 60% fail

    Loses version semantics; may cause confusion.