Fabman API

Library for interfacing with the Fabman API. Created for Texas Inventionworks as part of the Cockrell School of Engineering at the University of Texas at Austin.

Official documentation for the Fabman API can be found here. Live interaction and description of all endpoints can further be found here. This library is currently targeting version 2.3.1 of the Fabman API.

Getting Started

To get started, simply install using pip:

pip install fabman

which will install the latest stable release for your use. Note that this library is in active, heavy development and the API may change with little warning. To use the latest state of this repo, use the following command:

pip install git+https://github.com/utexas-engr-tiw/fabman-api

To start interacting with the Fabman API, simply provide your API key:

from fabman import Fabman

API_KEY = 'abcdef-123456789-a1b2c3d4e5f6a7b8'
f = Fabman(API_KEY)
...

From there, you can begin interacting with api endpoints as described in the official documentation. Most top-level methods return an object which manages that object. For example, to get a single member and update that member's name,

member = f.get_member(12345)
member.update(firstName="Kira", lastName="Nerys")

All parameters except for IDs are taken in as kwargs and should follow the camelCase naming conventions found on the Fabman API. Moreover, the library performs minimal checking of parameters, leaving that to the Fabman API. For required fields for create and update fields, refer to the Live Fabman API Documentation. The one exception to this is the lockVersion requirement for update methods. All update methods will automatically add the current lockVersion parameter to the body.

Refer to the library documentation more information on this library.

Contributing

We would love contributions! We are a small development team. To contribute, familiarize yourself with the code, the layout, make your edits and a pull request. We currently need help with

• Real life testing of the API
• Documentation