OpenFlexure Microscope Server API Docs
+Select documentation:
+ + HTTP API (Swagger) + Python API +diff --git a/.gitignore b/.gitignore index d51d9650..582845f5 100644 --- a/.gitignore +++ b/.gitignore @@ -65,7 +65,8 @@ picamera_test_hashes.json *.log # Documentation -apidocs +apidocs/python +apidocs/http/*.json # PyBuilder target/ diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml index f46e56af..7f20d205 100644 --- a/.gitlab-ci.yml +++ b/.gitlab-ci.yml @@ -180,11 +180,13 @@ build-docs: - | pydoctor -W \ --docformat restructuredtext \ + --html-output apidocs/python \ --project-name "OpenFlexure Microscope Server" \ --project-version $CI_COMMIT_REF_NAME \ --theme readthedocs \ --html-viewsource-base https://gitlab.com/openflexure/openflexure-microscope-server/-/tree/$CI_COMMIT_SHA/ \ src/openflexure_microscope_server + - ./generate_http_api_data.py - echo "JOB_ID=$CI_JOB_ID" > build-docs.env artifacts: expire_in: 1 week diff --git a/apidocs/http/index.html b/apidocs/http/index.html new file mode 100644 index 00000000..bb34ec7c --- /dev/null +++ b/apidocs/http/index.html @@ -0,0 +1,87 @@ + + +
++ These docs are provided for reference only. They cannot control a running microscope. +
+ +
+ For interactive documentation on a live microscope, visit:
+
+ http://microscope.local:5000/docs
+
Select documentation:
+ + HTTP API (Swagger) + Python API +