{"id":27783,"library":"ga4gh-va-spec","title":"GA4GH Variant Annotation (VA) Spec Python","description":"GA4GH Variant Annotation (VA) reference implementation providing Pydantic models for the VA specification. Current version 0.4.3, uses VRS-Python for variant representation and pydantic for validation. Release cadence is irregular, tied to VA spec releases.","status":"active","version":"0.4.3","language":"python","source_language":"en","source_url":"https://github.com/ga4gh/va-spec-python","tags":["GA4GH","variant annotation","Pydantic","VA Spec","bioinformatics"],"install":[{"cmd":"pip install ga4gh-va-spec","lang":"bash","label":"pip"}],"dependencies":[{"reason":"Core dependency for variant representation models (VRS/GA4GH)","package":"vrs-python","optional":false},{"reason":"Data validation and serialization","package":"pydantic","optional":false}],"imports":[{"note":"Statement is in base submodule, not top-level.","wrong":"from ga4gh.va_spec import Statement","symbol":"Statement","correct":"from ga4gh.va_spec.base import Statement"}],"quickstart":{"code":"from ga4gh.va_spec.base import Statement\nfrom pydantic import ValidationError\n\ntry:\n    stmt = Statement(id='test:1', type='Statement', description='Example')\n    print(stmt.model_dump(exclude_unset=True))\nexcept ValidationError as e:\n    print(e)","lang":"python","description":"Create a minimal Statement object."},"warnings":[{"fix":"Update imports to use submodules (e.g., base, aac_2017).","message":"Version 0.2.0 changed base model namespace; imports from ga4gh.va_spec.base are required, not ga4gh.va_spec directly.","severity":"breaking","affected_versions":">=0.2.0"},{"fix":"Review VA spec 1.0.0 changelog. Use new model names like 'Statement' with standard GA4GH types.","message":"Version 0.4.0 updated VA spec to 1.0.0, removing deprecated fields and renaming models.","severity":"breaking","affected_versions":"<0.4.0"},{"fix":"Ensure all fields match the model schema exactly. Use model_dump() with exclude_unset to inspect.","message":"Models enforce additionalProperties=False by default; extra fields cause validation errors.","severity":"gotcha","affected_versions":">=0.4.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Use: from ga4gh.va_spec.base import Statement","cause":"Trying to import Statement from top-level instead of submodule.","error":"ImportError: cannot import name 'Statement' from 'ga4gh.va_spec'"},{"fix":"Remove any fields not defined in the model, or update model to include them.","cause":"Model has additionalProperties=False and extra fields are provided.","error":"pydantic_core._pydantic_core.ValidationError: 1 validation error for Statement\n extra_forbidden"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}