2018-07-06 05:29:12 +02:00
|
|
|
gendoc: &gendoc
|
|
|
|
|
name: Generate the docs
|
|
|
|
|
command: |
|
|
|
|
|
source /env/bin/activate
|
|
|
|
|
scripts/gendoc.py
|
|
|
|
|
|
2018-07-06 05:39:45 +02:00
|
|
|
gendoc: &genswagger
|
|
|
|
|
name: Generate the swagger
|
|
|
|
|
command: |
|
|
|
|
|
source /env/bin/activate
|
|
|
|
|
scripts/dump-swagger.py
|
|
|
|
|
|
2018-07-06 05:18:28 +02:00
|
|
|
version: 2
|
|
|
|
|
jobs:
|
|
|
|
|
build-docs:
|
|
|
|
|
docker:
|
2018-07-06 05:29:12 +02:00
|
|
|
- image: uhoreg/matrix-doc-build
|
2018-07-06 05:18:28 +02:00
|
|
|
steps:
|
|
|
|
|
- checkout
|
2018-07-06 05:29:12 +02:00
|
|
|
- run: *gendoc
|
2018-07-06 05:31:57 +02:00
|
|
|
- store_artifacts:
|
|
|
|
|
path: scripts/gen
|
|
|
|
|
- run:
|
|
|
|
|
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
|
2018-07-06 05:18:28 +02:00
|
|
|
|
2018-07-06 05:39:45 +02:00
|
|
|
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
|
|
|
|
|
|
2018-07-06 05:18:28 +02:00
|
|
|
workflows:
|
|
|
|
|
version: 2
|
|
|
|
|
|
2018-07-06 05:39:45 +02:00
|
|
|
build-spec:
|
2018-07-06 05:18:28 +02:00
|
|
|
jobs:
|
|
|
|
|
- build-docs
|
2018-07-06 05:39:45 +02:00
|
|
|
- build-swagger
|
2018-07-06 05:18:28 +02:00
|
|
|
|
|
|
|
|
notify:
|
|
|
|
|
webhooks:
|
|
|
|
|
- url: https://giles.cadair.com/circleci
|
