Skip to main content
https://img.shields.io/pypi/v/fhir-core.svg Supported Python Versions https://img.shields.io/travis/com/nazrulworld/fhir-core.svg Windows Build https://codecov.io/gh/nazrulworld/fhir.resources/branch/master/graph/badge.svg https://img.shields.io/badge/code%20style-black-000000.svg Downloads HL7® FHIR®

Powered by Pydantic V2. This library is developed for the support of the another libray fhir.resources but you are more than welcome to use it for your own purpose. It provides an abstract base class for any FHIR resource model and Primitive Datatypes along with factories to create FHIR resource model and other complex datatypes.

Installation

Just a simple pip install fhir-core. But if you want development version, just clone from https://github.com/nazrulworld/fhir-core and pip install -e .[dev].

Usages

Example: 1: This example creates an Organization class with some of its attributes (id, active, name, address):

>>> from typing import List
>>> from pydantic import Field
>>> from fhir_core.fhirabstractmodel import FHIRAbstractModel
>>> from fhir_core.types import IdType, BooleanType, StringType
>>> data = {
...     "id": "f001",
...     "active": True,
...     "name": "Acme Corporation",
...     "address": ["Road 10": "Acme corporation", "2390", "USA"}]
... }
>>> class Organization(FHIRAbstractModel):
...     __resource_type__ = "Organization"
...     id: IdType = Field(None, title="Id", alias="id", json_schema_extra={"element_property": True})
...     active: BooleanType = Field(None, title="Active", alias="active", json_schema_extra={"element_property": True})
...     name: StringType = Field(None, title="Name", alias="name", json_schema_extra={"element_property": True})
...     address: ListType[StringType] = Field(None, title="Address lines", alias="address", json_schema_extra={"element_property": True})
...
...     @classmethod
        def elements_sequence(cls):
            return ["id", "active", "name", "address"]
...
>>> org = Organization.model_validate(data)
>>> org.active is True
True
>>> org_json_str = org.model_dump_json()
>>> Organization.model_validate_json(org_json_str).model_dump() == org.model_dump()
True

Complex examples

  1. https://github.com/nazrulworld/fhir-core/blob/main/tests/fixtures/resources/extension.py

  2. https://github.com/nazrulworld/fhir-core/blob/main/tests/fixtures/resources/fhirtypes.py

  3. https://github.com/nazrulworld/fhir-core/blob/main/tests/fixtures/resources/codesystem.py

© Copyright HL7® logo, FHIR® logo and the flaming fire are registered trademarks owned by Health Level Seven International

History

1.1.10 (2026-07-25)

  • Fix issue #23 with annotated_types package after 0.8.0

1.1.9 (2026-06-28)

  • Fix regression where input to Decimal type can lose exponent i.e. 1.0 remains 1.0 not 1 #20

  • For primitive type’s value required validation, empty extension is now acceptable.

1.1.8 (2026-04-30)

  • Fixes: Decimal values lose precision during serialization — Decimal(‘19’) becomes 19.0 in both model_dump() and model_dump_json() fhir.resources#203 [cmodevcodes]

1.1.7 (2026-03-22)

  • Fixes error in supporting multiple fhir version into xml utilities.

1.1.6 (2026-03-19)

1.1.5 (2026-01-29)

  • Fixes the issue #16 “Encounter.class missing when serializing to XML”.

  • Fixes the issue #14 “Wrong serialization of Instant type” [dhallam].

1.1.4 (2025-07-11)

  • Fixes the issue #13 “pyright struggles with default position args”.

1.1.3 (2025-07-10)

  • Fixes business logic for xml serializer, when summary move is active.

1.1.2 (2025-07-09)

  • Fixes nested ignoring (non primitive field serialization), if summary mode is enabled.

  • Issue #12 missing xmlparser argument for FHIRAbstractModel.model_validate_xml.

1.1.1 (2025-07-04)

  • Extra field property name is_summery_element has been renamed to summary_element_property

1.1.0 (2025-07-01)

New features

1.0.2 (2025-06-23)

Fixes

1.0.1 (2025-03-23)

Fixes

1.0.0 (2024-12-25)

  • XML serialization/deserialization support has been added.

  • Remove dependency on typed-ast as it is not needed and won’t work in later Python versions.

  • Fix typo in test case.

  • Raising ‘ValueError’ has been suspended inside Fhir Model Validation ‘fhir_model_validator()’, if None value is provided.

0.1.3 (2024-10-24)

  • Improves missing value validation message, as error type is now model_field_validation.missing.

0.1.2 (2024-10-09)

  • Improve validation error message.

0.1.1 (2024-10-09)

  • Version policy updated, now .bx suffix has been removed.

Fixes

  • Business logic for None type validation against FHIR Model validator as None value is acceptable! Instead, you should make Pydantic field optional.

0.1.0b9 (2024-10-02)

Fixes

0.1.0b8 (2024-08-04)

  • YAML dump & validate options are added into FHIRAbstractModel.

0.1.0b7 (2024-07-31)

  • typing hint added for the function ´´create_fhir_type´´ and ´´create_fhir_element_or_resource_type´´.

0.1.0b6 (2024-07-30)

  • Core configurations for types Id & String are coming from constraint module.

  • Default maximum char length Id is now 255.

0.1.0b5 (2024-07-28)

  • Fixes the function that is checking is_primitive, as missing bytes and bytesarray are added.

  • Encoding is handled for Base64Binary type.

0.1.0b4 (2024-07-28)

  • Fixes extension serialization.

0.1.0b3 (2024-07-28)

  • Fixes the function that is checking is_primitive.

  • Fixes validator for Resource & Element types.

0.1.0b2 (2024-07-27)

Bugfixes

  • Fixes pattern as string for some of primitives types. fx UriType.

  • Fixes model serializer.

0.1.0b1 (2024-07-26)

  • The first beta release! and this release is not stable enough to use in production.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fhir_core-1.1.10.tar.gz (35.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fhir_core-1.1.10-py2.py3-none-any.whl (30.7 kB view details)

Uploaded Python 2Python 3

File details

Details for the file fhir_core-1.1.10.tar.gz.

File metadata

  • Download URL: fhir_core-1.1.10.tar.gz
  • Upload date:
  • Size: 35.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.10

File hashes

Hashes for fhir_core-1.1.10.tar.gz
Algorithm Hash digest
SHA256 de8ee2ff7c14854641b7ad12e23fb5c53d9b3a99ebaeaad360d1d40a086629c3
MD5 466990ff820c66993a9df6ebe51a3d85
BLAKE2b-256 93194debca62dce6602c7e5f284600e4cbd3faf2383d2081b7f21b8005da9482

See more details on using hashes here.

File details

Details for the file fhir_core-1.1.10-py2.py3-none-any.whl.

File metadata

  • Download URL: fhir_core-1.1.10-py2.py3-none-any.whl
  • Upload date:
  • Size: 30.7 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.10

File hashes

Hashes for fhir_core-1.1.10-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 bdbe6164e26843e7e63559a08961e44df54b1ed8bd52a1df415ee8c02f7ec965
MD5 8f218a2843b2fb86f2793185e7f10243
BLAKE2b-256 468f004089ac25fddc6b839e58bdfba0f9a97f56889e4f80715105d91994f1eb

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

1.1.10 This release

2 files

1.1.9

2 files

1.1.8

2 files

1.1.7

2 files

1.1.6

2 files

1.1.5

2 files

1.1.4

2 files

1.1.3

2 files

1.1.2

2 files

1.1.1

2 files

1.1.0

2 files

1.0.2

2 files

1.0.1

2 files

1.0.0

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page