Metadata-Version: 2.1
Name: fhir-parse-qs
Version: 0.2.0
Summary: Parse FHIR query string
Home-page: https://github.com/teffalump/fhir_parse_qs
Author: teffalump
Author-email: chris@teffalump.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Requires-Dist: pendulum

A library to parse FHIR query strings.

-  Validates type and returns correct object
-  Built-in search parameters from FHIR standard
-  Parses modifiers and prefixes

Generally only have included relevant Resources with maturity greater
than 2. Some exceptions.

Usage
^^^^^

::

   from fhir_parse_qs import Search
   search = Search('Patient', 'name=bob') # Search(<endpoint>, <query_string>)

   # endpoint
   search.endpoint --> 'Patient'

   # all the namedtuples
   search.parsed --> [FHIRSearch(...)]

   # index as key; each parameter/value pair gets parsed into a namedtuple
   search[0] --> FHIRSearch(...)
   search[0].modifier --> None
   search[0].prefix --> None
   search[0].value --> 'bob'
   search[0].paramater --> 'name'
   search[0].type_ --> 'string'

   # act like dict with parameter as key (list if non-unique parameter)
   search['name'] --> FHIRSearch(...)

   # can iterate over the paramater/value pairs
   for x in search:
        print(x) --> FHIRSearch(...)

   # unrecognized parameter, ignore and log it
   search = Search('Patient', 'random=test')
   search.error --> [...]

   # chains, does not verify target types yet
   search = Search('Observation', 'subject.name=peter')
   search[0].parameter --> 'subject'
   search[0].value --> 'peter'
   search[0].chain --> ['name']


