{"record":{"id":"4f19f33d3799d328","repo":"pypa/pip","slug":"dev-must-be-non-negative-integer-got-value","errorCode":null,"errorMessage":"dev must be non-negative integer, got {value}","messagePattern":"dev must be non-negative integer, got (.+?)","errorType":"validation","errorClass":"InvalidVersion","httpStatus":null,"severity":"error","filePath":"src/pip/_vendor/packaging/version.py","lineNumber":318,"sourceCode":"    raise InvalidVersion(msg)\n\n\ndef _validate_post(value: object, /) -> tuple[Literal[\"post\"], int] | None:\n    if value is None:\n        return value\n    if isinstance(value, int) and value >= 0:\n        return (\"post\", value)\n    msg = f\"post must be non-negative integer, got {value}\"\n    raise InvalidVersion(msg)\n\n\ndef _validate_dev(value: object, /) -> tuple[Literal[\"dev\"], int] | None:\n    if value is None:\n        return value\n    if isinstance(value, int) and value >= 0:\n        return (\"dev\", value)\n    msg = f\"dev must be non-negative integer, got {value}\"\n    raise InvalidVersion(msg)\n\n\ndef _validate_local(value: object, /) -> LocalType | None:\n    if value is None:\n        return value\n    if isinstance(value, str) and _LOCAL_PATTERN.fullmatch(value):\n        return _parse_local_version(value)\n    msg = f\"local must be a valid version string, got {value!r}\"\n    raise InvalidVersion(msg)\n\n\n# Backward compatibility for internals before 26.0. Do not use.\nclass _Version(NamedTuple):\n    epoch: int\n    release: tuple[int, ...]\n    dev: tuple[Literal[\"dev\"], int] | None\n    pre: tuple[Literal[\"a\", \"b\", \"rc\"], int] | None\n    post: tuple[Literal[\"post\"], int] | None","sourceCodeStart":300,"sourceCodeEnd":336,"githubUrl":"https://github.com/pypa/pip/blob/f399c3718970b1b0e2478dac5296eb62679a9b86/src/pip/_vendor/packaging/version.py#L300-L336","documentation":"Raised by _validate_dev() (version.py:312-318) when the dev-release value passed to Version.from_parts() or Version.__replace__() is not a non-negative integer. Passing None is allowed (means no dev-release). Strings, floats, and negative ints trigger this.","triggerScenarios":"Calling Version.from_parts(release=(1,), dev=-1), Version.from_parts(release=(1,), dev=2.0), or Version.from_parts(release=(1,), dev='3').","commonSituations":"Passing a dev-release value as a string from a build environment variable, a negative number, or a float.","solutions":["Pass dev as a non-negative int (0, 1, 2, ...).","Convert with int(value) and validate >= 0 before calling.","Pass None or omit the argument if there is no dev-release segment."],"exampleFix":"// before\nVersion.from_parts(release=(1, 0), dev='3')\n// after\nVersion.from_parts(release=(1, 0), dev=3)","handlingStrategy":"type-guard","validationCode":"from packaging.version import Version, InvalidVersion\n\ndef safe_from_parts(*, release, dev=None, **kwargs):\n    if dev is not None and (not isinstance(dev, int) or dev < 0):\n        raise TypeError(f\"dev must be a non-negative int, got {dev!r}\")\n    return Version.from_parts(release=release, dev=dev, **kwargs)","typeGuard":"def is_valid_dev(value) -> bool:\n    return value is None or (isinstance(value, int) and value >= 0)","tryCatchPattern":"from packaging.version import InvalidVersion\n\ntry:\n    v = Version.from_parts(release=(1,), dev=dev)\nexcept InvalidVersion as e:\n    if \"dev must be\" in str(e):\n        logger.error(\"Invalid dev value: %s\", dev)\n    raise","preventionTips":["Pass dev as a non-negative int","Convert string values with int() before calling","Pass None or omit to clear the dev-release segment"],"tags":["version","dev-release","packaging","pep440"],"backgroundTag":null,"analyzedSha":"f399c3718970b1b0e2478dac5296eb62679a9b86","analyzedAt":"2026-08-08T23:01:42.227Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}