0c1eb50ef4
Merge pull request #26 from matrix-org/macaroons
...
Spec macaroons and token refresh
9 years ago
f5d436bd80
Remove extraneous )
9 years ago
6c1491b3ba
Respond to some review comments
9 years ago
5c4398c181
Remove superfluous comma
9 years ago
fc87f4cdb0
Remove unused keys
9 years ago
6c89e6ea67
Wrap refresh_token in `s
9 years ago
15308ab435
Merge pull request #62 from matrix-org/markjh/check_request_schema
...
Check the request example JSON matches the schema
9 years ago
078dd0165f
Update the room creation API spec to include new keys: 'preset' and 'initial_state'
9 years ago
f34722485f
Check the request example JSON matches the schema
9 years ago
a31a446661
Fix the POST example for the v2 filter API
9 years ago
69298b9612
Check "v2_alpha" in jenkins
9 years ago
883105eae6
Document the v2 filter GET API
9 years ago
2f039a1142
Add swagger docs for the v2 filter POST API
9 years ago
ca9f30a7fd
Merge pull request #61 from matrix-org/markjh/node_swagger_validator
...
Only validate a file if it ends with ".yaml".
9 years ago
385b6c4759
Only validate a file if it ends with ".yaml".
...
Otherwise we try to validate vim .swp files.
9 years ago
0346568519
Merge pull request #60 from matrix-org/gendoc-logging
...
Gendoc logging
9 years ago
6afdfc0771
Add more logging and make logging context clearer
...
This is now actually useful if you want to debug why your swagger YAML
isn't producing a table you think it should be.
9 years ago
f1adad5fb3
Add more logging with file prefixes
...
This makes the handoff between gendoc and batesian clearer in the logs.
9 years ago
064a2c9172
Use argparse and log functions for gendoc.py
...
gendoc.py has become more complex such that we actually want to pass things
to it like `--verbose`, `--nodelete`, `--target`, so use `argparse` to do this
like we have `build.py`. Pass through `-v` flags to `build.py`.
9 years ago
14e77b09ab
Merge pull request #59 from matrix-org/spec-restructure-modules
...
Add spec build targets; restructure spec
9 years ago
1da64db302
Use relative depths for groups instead of absolute ones
...
This means the group can be agnostic to how deeply nested it is,
improving reusability of groups.
9 years ago
29bae15790
Fix typo
9 years ago
5115346297
Add instant_messaging module; modify batesian section rules
...
Previously, all `m.room.*` events were wodged into `{{room_events}}` which
isn't great when you want to pull specific ones out. Batesian had a 1:1
mapping of `render_foo()` to a section `{{foo}}`, and having to constantly
add functions for new types is a PITA. Batesian now supports returning a
`dict` instead of a section `string` where the keys are the `{{foo}}` and
the value is what will be inserted. Also add conflicting section key checks
to avoid multiple definitions of the same `{{foo}}`. Define dicts for
event schemata and swagger HTTP APIs.
Using this new feature, split out the instant messaging stuff from the events
section, and replace `{{room_events}}` with a list of specific events e.g.
`{{m_room_member_event}}`.
9 years ago
5b134119bd
Add presence module; fix relative title bug
...
If a relative title appeared after an HTTP API table, it
would insert the wrong level because it thought that part
of the table was a title.
9 years ago
b49cb57fe5
Move events sections to CS API
9 years ago
16693a644a
Various review fixes
9 years ago
b21859836d
Print stdout of build.py in verbose mode
9 years ago
388aeefac0
Remove obsolete key
9 years ago
b0eb985523
Merge branch 'master' into spec-restructure-modules
9 years ago
895ffcfcde
Merge pull request #56 from matrix-org/markjh/document_v1_rooms_api
...
Document the getters for the /rooms/{roomId} APIs
9 years ago
056b5eba22
Partially handle representing top-level array responses
...
If an HTTP API returned a top-level array response, the templating system
would fail to create a table for it. This is now partially fixed by pulling
out the type of the elements (no recursion is done to populate nested tables)
9 years ago
0c0ac3e814
Fix common event fields template to use subtitle char
9 years ago
e8cdfcbba2
Rename spec files to not have numbers everywhere; update targets.yaml
9 years ago
f71763b0d3
Implement relative title styles
...
Templates don't know at what level they will be inserted. Previously, we
hard-coded the title style which is not compatible with the build target
system. Define a set of styles which will be replaced by the gendoc script
when it encounters them:
'<' : Make this title a sub-heading
'/' : Make this title a heading at the same level
'>' : Make this title a super-heading
The build target system is now basically complete and functioning.
9 years ago
98d91d0c2b
Make the example room id more "random" so that people are less likely to think that it is supposed to be human readable
9 years ago
f60190086a
Describe the behaviour of /rooms/{roomId}/member when the user has left the room
9 years ago
067363c629
Get the desired title levels right; print out the actual level used to stdout
9 years ago
ba6c7d267c
SPEC-216: Document the behaviour of the room getters when the user has left the room
9 years ago
615a9575cb
SPEC-216: Clarify when the room getters will return 403
9 years ago
cb41adee70
Fix the swagger host to be "localhost:8008" so that it can be used in a "Try it now" setup against localhost
9 years ago
d5e0115e42
Merge branch 'master' into spec-restructure-modules
9 years ago
65ce95249f
cat the spec according to the build target. Remove old checks as they are now obsolete since we don't care about the filename
9 years ago
2efadea583
Merge branch 'master' into markjh/document_v1_rooms_api
9 years ago
8590cc84b5
Process and extract targets in gendoc.py
9 years ago
83ee385543
Merge pull request #55 from matrix-org/markjh/codehighlighting
...
Turn on code highlighting for HTTP api responses
9 years ago
a64125772f
Merge pull request #58 from matrix-org/markjh/jenkins
...
Add the jenkins command to git so that we can update it
9 years ago
2c31731262
Add the jenkins command to source control so that we can update
...
it without having to fiddle with the jenkins UI.
It also allow us to move files without breaking the CI since we
won't be hard coding the locations of scripts in the jenkins UI.
9 years ago
738b24d028
Merge pull request #57 from matrix-org/markjh/example_checker
...
Python script for checking that the examples match the event schema.
9 years ago
8974b2b67b
Skip files that start with ".", e.g. vim swp files.
9 years ago
6ba9b29b3b
Report all the errors in schemas/check_examples, not just the first error.
9 years ago
Daniel Wagner-Hall