{"id":24113,"library":"nipreps-versions","title":"NiPreps Versions","description":"Version schemes and utilities for NiPreps tools (NiPreps version 1.2.0). Provides standardized versioning logic (pep440, semver, git-based) for neuroimaging preprocessing workflows. Released irregularly as needed.","status":"active","version":"1.2.0","language":"python","source_language":"en","source_url":"https://github.com/nipreps/nipreps-versions","tags":["versioning","pep440","semver","neuroimaging","nipreps"],"install":[{"cmd":"pip install nipreps-versions","lang":"bash","label":"PyPI"}],"dependencies":[],"imports":[{"note":"Correct import path","symbol":"nipreps_versions","correct":"import nipreps_versions"},{"note":"VersionInfo is exposed at package level","wrong":"from nipreps_versions.version import VersionInfo","symbol":"VersionInfo","correct":"from nipreps_versions import VersionInfo"}],"quickstart":{"code":"from nipreps_versions import VersionInfo\n\n# Parse a version string\nver = VersionInfo('1.2.0')\nprint(ver)\n\n# Get version from a git repository (requires git)\n# ver = VersionInfo.from_git()\n\n# Check PEP 440 compliance\nprint(ver.is_pep440)","lang":"python","description":"Basic usage: parse version strings and check compliance."},"warnings":[{"fix":"Use VersionInfo version string directly or VersionInfo.from_installed() for installed packages.","message":"VersionInfo.from_git() requires the package to be in a git repository. In deployed/installed environments, use VersionInfo.from_installed() or plain constructor.","severity":"gotcha","affected_versions":"all"},{"fix":"Upgrade to Python >=3.10 or pin nipreps-versions to version <1.0.0 (if available).","message":"The library uses Python 3.10+ only. Projects on older Python versions will get ImportError.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use .version tuple property or explicit comparison methods.","message":"In version 1.0.0, the API changed: VersionInfo no longer inherits from tuple. Comparisons may behave differently.","severity":"breaking","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Install via pip install nipreps-versions; import uses underscores.","cause":"Package not installed or installed under different name (e.g., 'nipreps-versions' with hyphen).","error":"ModuleNotFoundError: No module named 'nipreps_versions'"},{"fix":"Use ver.version attribute (a tuple) instead of ver[0].","cause":"Trying to access VersionInfo like a tuple (common pre-1.0 behavior).","error":"TypeError: 'VersionInfo' object does not support indexing"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}