FHIR SDK
This is a FHIR library in its early stages. The models are generated from the FHIR StructureDefinitions (see FHIR downloads). It aims to be:
- fully compliant
- as safe as possibe
- as easy to use as possible
- fully featured
Features
- Generated FHIR codes, types and resources
- Serialization and deserialization to and from JSON
- Optional builders for types and resources
- Implementation of base traits
- (Base)Resource for accessing common fields
- NamedResource for getting the resource type in const time
- DomainResource for accessing common fields
- IdentifiableResource for all resources with an identifier field
- Client implementation
- Create, Read, Update, Delete
- Search + Paging
- Batch operations / Transactions
- Authentication callback
- Operations
- Patch
- GraphQL
- FHIRpath implementation
- Resource validation using FHIRpath and regular expressions
Not Planned
- XML (fhirbolt implements it though)
Example
use Patient;
use ;
use TryStreamExt;
async
For more examples, see the tests or below.
Testing
Simply set up the FHIR test environment using cargo xtask docker -- up -d
and then run cargo xtask test
.
If you need sudo to run docker, use the --sudo
or just -s
flag on cargo xtask docker
.
Known Problems
- The compile time and its memory usage are really high. This is due to the big serde derives being highly generic. It might be possible to shave some off by manually implementing Deserialize and Serialize, but that is complex.
Vec<Option<T>>
is annoying, but sadly is required to allow[null, {...}, null]
for using FHIR resources with extensions..- It is not supported to replace required fields by an extension.
More examples
Reading a resource from string/file
use Resource;
Authentication callback
use Patient;
use *;
async
async
Resource identifier access
use ;
async
License
Licensed under the MIT license. All contributors agree to license under this license.