On Jan 11, 2015, at 08:51 AM, Andrew Stuart wrote:
>Attached is a first pass at a Swagger spec for the REST API.
>
>You can find out about Swagger at http://swagger.io
>
>The Swagger spec that I am working on is attached to this message or can be
>found here: http://www.mailripper.com/api-docs.jso
On Jan 11, 2015, at 06:23 AM, Andrew Stuart wrote:
>Happy to do so if you like. Would you mind pointing me in the direction of
>some instructions for filing bugs please?
>
>FWIW I’d probably favor a REST API that is behaving improperly by returning
>plain text error responses (i.e. the current si
Yes I’d favor leave as is, and at some stage in future convert the error
messages to JSON.
On 12 Jan 2015, at 12:22 pm, Barry Warsaw wrote:
On Jan 11, 2015, at 06:23 AM, Andrew Stuart wrote:
> Happy to do so if you like. Would you mind pointing me in the direction of
> some instructions for
Barry Warsaw writes:
> My big question is how to make sure that the swagger spec doesn't
> get out of date to the implementation.
Doesn't Andrew's use case answer that? I mean, if the Swagger spec is
out of date, the tests based on it should fail. If the tests don't
fail, they're incomplete a
With Swagger you can either:
1: integrate the spec into the API source code
or
2: have one single standalone JSON file that contains the whole specification
(api-docs.json in this case)
I’m not a fan of integrating the Swagger specification into the code - seems to
make for a VERY large amount
" as soon as Andrew loses interest in keeping it up to date.”
;-) I was never interested in keeping it up to date in the first place but I
can’t stand doing development without API documentation, a necessary first step
to coding to the API.
I do like your idea about changes to the API not being
errr…. is this someone saying they would prefer I wasn’t on this list? I’d
rather hear directly from someone if you feel that way.
Begin forwarded message:
From:
mailman-developers-confirm+e1a7bed1fbf00db07dc7590dcbdba1e364ecc...@python.org
To: andrew.stu...@supercoders.com.au
Subject: Your
On 01/11/2015 06:27 PM, Andrew Stuart wrote:
> errr…. is this someone saying they would prefer I wasn’t on this list? I’d
> rather hear directly from someone if you feel that way.
Unlikely it's that. More likely, its because you've replied to posts
without removing the msg_footer from the quoted
