init

Author: NicolasCARPi

.gitignore

@@ -0,0 +1 @@
+generated/

README.md

@@ -0,0 +1,6 @@
+# elabapi-python
+
+Python library to interact with [eLabFTW](https://github.com/elabftw/elabftw) REST API v2.
+
+## Generate
+docker run --rm -v /home/ktr/.dev/elabapi-python:/local swaggerapi/swagger-codegen-cli-v3 generate -i https://raw.githubusercontent.com/elabftw/elabftw/hypernext/apidoc/v2/openapi.yaml -l python -o /local/generated

config.json

@@ -0,0 +1,6 @@
+{
+  "packageName": "elabapi_python",
+  "projectName": "elabapi-python",
+  "packageVersion": "0.1.0",
+  "packageUrl": "https://github.com/elabftw/elabapi-python"
+}

examples/00.py

@@ -0,0 +1,24 @@
+#!/usr/bin/env python
+import time
+import elabapi_python
+from elabapi_python.rest import ApiException
+
+# replace with your api key
+my_api_key = 'apiKey4Test'
+
+# Config
+configuration = elabapi_python.Configuration()
+configuration.api_key['api_key'] = my_api_key
+configuration.api_key_prefix['api_key'] = 'Authorization'
+configuration.host = 'https://elab.local:3148/api/v2'
+configuration.debug = True
+configuration.verify_ssl = False
+
+# create an instance of the API class
+api_client = elabapi_python.ApiClient(configuration)
+# fix issue with Authorization header not being properly set by the generated lib
+api_client.set_default_header(header_name='Authorization', header_value='apiKey4Test')
+
+# create an instance of Items
+items = elabapi_python.ItemsApi(api_client)
+print(items.read_items())

helper.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+# This script will generate a python library from the openapi definition file.
+
+# the docker image used to generate the client code
+docker_image="swaggerapi/swagger-codegen-cli-v3"
+# where to grab the definition file
+openapi_yaml_url="https://raw.githubusercontent.com/elabftw/elabftw/hypernext/apidoc/v2/openapi.yaml"
+# folder with the generated python code
+lib="generated"
+
+function generate {
+    # clean up first
+    rm -rfv "$lib"
+    # now generate the lib
+    docker run --user "$(id -u)":"$(id -gn)" --rm -v "${PWD}":/local "$docker_image" generate -i "$openapi_yaml_url" -l python -o /local/"$lib" -c /local/config.json --git-user-id elabftw --git-repo-id elabapi-python
+}
+
+function build {
+    cd "$lib" || exit 1
+    python setup.py sdist bdist_egg bdist_wheel
+    cd ..
+}
+
+function publish {
+    build
+    cd "$lib" || exit 1
+    twine upload dist/*
+    cd ..
+}
+
+"$1"