agostof/BrAPI-PyModels at experimental · GitHub

Implementation of the BrAPI v2.0 specification for Python using pydantic data models. Note: This project is a sibling to BrAPI-FastAPI, BrAPI implementation server stubs.

• Includes models for Core, Genotyping, Germplasm, and Phenotyping.
• Use models to create a BrAPI client (a.k.a BrAPP) or to create a client library.
• Integrate models with other Python frameworks.

These models can be used as a template for starting a new project. They could also be integrated into an already existing project (the pydantic models should work with other Python frameworks). It might be convenient to add these into your project as a submodule by running:

git submodule add https://github.com/agostof/BrAPI-PyModels [optional local_name]

Then use (by copying or modifying) the appropriate BrAPI module(s) models as needed.

Simple clients can be built using the Pydantic models. Using these models, clients can parse the responses returned by a BrAPI server with little effort. Note: A more capable BrAPI client library is also possible (coming soon), for now we provide a very basic client use case.

For example, to parse the serverInfo call response we could import the following ServerInfoResponse model:

from brapi_v2.core.models import ServerInfoResponse

then use it to construct an object usable by the client:

# [pseudo code]
# ... retrieve response using your favorite library ... 
# then parse response_obj using pydantic model
server_info = ServerInfoResponse.parse_obj(response_obj)
# access the BrAPI response metadata 
server_info.metadata
# For more details and *working* code, please check client's documentation linked below.

The code above is merely an introduction and omit several details. The steps necessary to get this process to work are demonstrated by a simple, barebones, brapi client implementation. This code calls and parses the demo endpoints defined by the BrAPI server, see the client's documentation for details.

OpenApi-compatible codegen tools were used to generate the foundational data models and servers stubs used on this project. The auto-generated models might still need some cleaning up. Also some models names are repeated across modules e.g. Metadata, AdditionalInfo. These repeated models were consolidated and they are uniquely imported from core.models e.g. core.models.Metadata, core.models.AdditionalInfo, etc.

These redundant Pydantic models occur because the BrAPI OpenAPI spec files were processed independently. Ideally, they should be consolidated as part of the Core module or in a commons package. Check the modelgen_utils directory for additional details.