|
|
|
@ -4,6 +4,12 @@ gendoc: &gendoc
|
|
|
|
|
source /env/bin/activate
|
|
|
|
|
scripts/gendoc.py
|
|
|
|
|
|
|
|
|
|
gendoc: &genswagger
|
|
|
|
|
name: Generate the swagger
|
|
|
|
|
command: |
|
|
|
|
|
source /env/bin/activate
|
|
|
|
|
scripts/dump-swagger.py
|
|
|
|
|
|
|
|
|
|
version: 2
|
|
|
|
|
jobs:
|
|
|
|
|
build-docs:
|
|
|
|
@ -18,12 +24,25 @@ jobs:
|
|
|
|
|
name: "Doc build is available at:"
|
|
|
|
|
command: DOCS_URL="${CIRCLE_BUILD_URL}/artifacts/${CIRCLE_NODE_INDEX}/${CIRCLE_WORKING_DIRECTORY/#\~/$HOME}/scripts/gen/index.html"; echo $DOCS_URL
|
|
|
|
|
|
|
|
|
|
build-swagger:
|
|
|
|
|
docker:
|
|
|
|
|
- image: uhoreg/matrix-doc-build
|
|
|
|
|
steps:
|
|
|
|
|
- checkout
|
|
|
|
|
- run: *genswagger
|
|
|
|
|
- store_artifacts:
|
|
|
|
|
path: scripts/swagger/api-docs.json
|
|
|
|
|
- run:
|
|
|
|
|
name: "Swagger UI is available at:"
|
|
|
|
|
command: SWAGGER_URL="${CIRCLE_BUILD_URL}/artifacts/${CIRCLE_NODE_INDEX}/${CIRCLE_WORKING_DIRECTORY/#\~/$HOME}/scripts/swagger/api-docs.json"; echo "https://matrix.org/docs/api/client-server/?url="$SWAGGER_URL
|
|
|
|
|
|
|
|
|
|
workflows:
|
|
|
|
|
version: 2
|
|
|
|
|
|
|
|
|
|
egg-info:
|
|
|
|
|
build-spec:
|
|
|
|
|
jobs:
|
|
|
|
|
- build-docs
|
|
|
|
|
- build-swagger
|
|
|
|
|
|
|
|
|
|
notify:
|
|
|
|
|
webhooks:
|
|
|
|
|