Re: [Openstack] Feedback on HTTP APIs

2011-05-29 Thread Mark Nottingham
and/or request headers are omitted. IME this often causes confusion and bugs, because developers don't understand the context of the request or response. - Finally, could you possibly make the PDF version NOT have grey backgrounds for all of the examples? It wastes a lot of ink... Cheers, -- Mark

Re: [Openstack] Feedback on HTTP APIs

2011-05-31 Thread Mark Nottingham
change the output. In the meantime, I'm able to build PDFs that use no grey background for examples, and I'll send those your way. Thanks, Anne Anne Gentle a...@openstack.org my blog | my book | LinkedIn | Delicious | Twitter On Sun, May 29, 2011 at 8:01 PM, Mark Nottingham m...@mnot.net

Re: [Openstack] XML and JSON for API's

2011-06-02 Thread Mark Nottingham
___ Mailing list: https://launchpad.net/~openstack Post to : openstack@lists.launchpad.net Unsubscribe : https://launchpad.net/~openstack More help : https://help.launchpad.net/ListHelp -- Mark Nottingham http://www.mnot.net

Re: [Openstack] XML and JSON for API's

2011-06-11 Thread Mark Nottingham
me anything else.). See: http://tools.ietf.org/html/draft-ietf-httpbis-p2-semantics-14#section-8.4.16 vs http://tools.ietf.org/html/draft-ietf-httpbis-p2-semantics-14#section-8.4.7 Cheers, -- Mark Nottingham http://www.mnot.net/ ___ Mailing

Re: [Openstack] XML and JSON for API's

2011-06-11 Thread Mark Nottingham
Hey, Sorry it took a while to get back; other things intervened. On 03/06/2011, at 11:56 PM, Jorge Williams wrote: On Jun 2, 2011, at 10:41 PM, Mark Nottingham wrote: The problem I mentioned before, though, is that XML Schema brings more issues to the table than it solves. 1) People

Re: [Openstack] Status of Git/Gerrit Code Hosting/Review

2011-08-09 Thread Mark Nottingham
___ Mailing list: https://launchpad.net/~openstack Post to : openstack@lists.launchpad.net Unsubscribe : https://launchpad.net/~openstack More help : https://help.launchpad.net/ListHelp -- Mark Nottingham http://www.mnot.net

Re: [Openstack] Proposal: URIs for X-Auth-Header Keystone tokens

2011-09-04 Thread Mark Nottingham
@lists.launchpad.net Unsubscribe : https://launchpad.net/~openstack More help : https://help.launchpad.net/ListHelp -- Mark Nottingham http://www.mnot.net/ ___ Mailing list: https://launchpad.net/~openstack Post to : openstack

Re: [Openstack] Proposal: URIs for X-Auth-Header Keystone tokens

2011-09-04 Thread Mark Nottingham
/tokens/fa8426a0-8eaf-4d22-8e13-7c1b16a9370c; rel=keystone-token Fixed: s/tenants/tokens/ (my bad). On 9/4/11 7:40 PM, Mark Nottingham m...@mnot.net wrote: Still getting up to speed on the finer points of keystone, but makes sense to me. Is X-Auth-Token keystone-specific? If so

Re: [Openstack] Proposal: URIs for X-Auth-Header Keystone tokens

2011-09-07 Thread Mark Nottingham
On 9/4/11 9:51 PM, Mark Nottingham m...@mnot.net wrote: Good point; Link makes more sense on a response. Cheers, On 05/09/2011, at 12:49 PM, Bryan Taylor wrote: Hmmm, I'm thinking more about this. Would using the Link: header break the ability to use the Vary header? I can't

Re: [Openstack] Creating openstack-dev mailing list

2011-10-10 Thread Mark Nottingham
My .02 - Pretty much every Open Source project I've been involved in has two lists set up like this, once they get off the ground. Like others have said, it doesn't mean the groups separate, only that the discussions are easier to follow... Cheers, -- Mark Nottingham http://www.mnot.net

Re: [Openstack] OpenStack API Versioning Conventions

2011-10-10 Thread Mark Nottingham
/ListHelp -- Mark Nottingham http://www.mnot.net/ ___ Mailing list: https://launchpad.net/~openstack Post to : openstack@lists.launchpad.net Unsubscribe : https://launchpad.net/~openstack More help : https://help.launchpad.net/ListHelp

Re: [Openstack] Guidelines for OpenStack APIs

2011-10-10 Thread Mark Nottingham
that are appropriate, but because of its escape-hatch nature, there really isn't anything it isn't allowed to do, semantically. Cheers, -- Mark Nottingham http://www.mnot.net/ ___ Mailing list: https://launchpad.net/~openstack Post to : openstack

Re: [Openstack] Guidelines for OpenStack APIs

2011-10-11 Thread Mark Nottingham
to be prescriptive, of course (e.g., to have a sane approach to versioning). Cheers, -- Mark Nottingham http://www.mnot.net/ ___ Mailing list: https://launchpad.net/~openstack Post to : openstack@lists.launchpad.net Unsubscribe : https

Re: [Openstack] OpenStack API Versioning Conventions

2011-10-11 Thread Mark Nottingham
versioning in the APIs, just that it fulfils a very different function (managing change in representation formats). Cheers, -- Mark Nottingham http://www.mnot.net/ ___ Mailing list: https://launchpad.net/~openstack Post to : openstack

Re: [Openstack] OpenStack API Versioning Conventions

2011-10-11 Thread Mark Nottingham
@lists.launchpad.net Unsubscribe : https://launchpad.net/~openstack More help : https://help.launchpad.net/ListHelp -- Mark Nottingham http://www.mnot.net/ ___ Mailing list: https://launchpad.net/~openstack Post to : openstack@lists.launchpad.net Unsubscribe

Re: [Openstack] Guidelines for OpenStack APIs

2011-10-11 Thread Mark Nottingham
I've started a list of proposed goals here: http://wiki.openstack.org/Governance/Proposed/APIGoals Please pile on... On 11/10/2011, at 11:53 PM, Jay Pipes wrote: On Tue, Oct 11, 2011 at 1:11 AM, Mark Nottingham m...@mnot.net wrote: +1 (sorry for the lag, been travelling). I'd like

Re: [Openstack] OpenStack API Versioning Conventions

2011-10-12 Thread Mark Nottingham
it. ___ Mailing list: https://launchpad.net/~openstack Post to : openstack@lists.launchpad.net Unsubscribe : https://launchpad.net/~openstack More help : https://help.launchpad.net/ListHelp -- Mark Nottingham http://www.mnot.net

Re: [Openstack] OpenStack API Versioning Conventions

2011-10-16 Thread Mark Nottingham
On 13/10/2011, at 5:42 PM, Bryan Taylor wrote: On 10/12/2011 07:55 PM, Mark Nottingham wrote: The duplication of effort can be solved by having an intermediary do the translation. Repose already does this. That's where there be dragons. Inferring that the user wants to go to version N

[Openstack] API Versioning and Extensibility

2011-10-24 Thread Mark Nottingham
also http://www.mnot.net/blog/2011/10/25/web_api_versioning_smackdown. -- Mark Nottingham http://www.mnot.net/ ___ Mailing list: https://launchpad.net/~openstack Post to : openstack@lists.launchpad.net Unsubscribe : https://launchpad.net

Re: [Openstack] API Versioning and Extensibility

2011-10-26 Thread Mark Nottingham
On 27/10/2011, at 5:19 AM, Bryan Taylor wrote: On 10/24/2011 11:20 PM, Mark Nottingham wrote: tl;dr Much omitted, since it's long... I agree strongly with 98% of what you are saying. I'll focus on the variants here. I'd rather just get rid of them. I think there's a discussion

Re: [Openstack] +1, All services should have WADLs

2011-10-27 Thread Mark Nottingham
with it. What do you mean by machine consumption -- are you saying that you want clients to automatically generate bindings? Cheers, -- Mark Nottingham http://www.mnot.net/ ___ Mailing list: https://launchpad.net/~openstack Post

Re: [Openstack] API Versioning and Extensibility

2011-10-27 Thread Mark Nottingham
On 27/10/2011, at 3:19 PM, Mark Nottingham wrote: I floated the idea a while back that we get rid of variants altogether and instead use an HTML representation to offer the user a choice of how to view the information that includes pre elements with JSON and XML formatted text. It could

Re: [Openstack] +1, All services should have WADLs

2011-10-27 Thread Mark Nottingham
on versioning and extensibility -- but WADL isn't really designed for this. I'm sketching up something more appropriate, and will be able to talk about it soon (hopefully). Cheers, -S From: Mark Nottingham [m...@mnot.net] Sent: Thursday, October 27

Re: [Openstack] describing APIs for OpenStack consumers

2011-10-27 Thread Mark Nottingham
/~openstack More help : https://help.launchpad.net/ListHelp -- Mark Nottingham http://www.mnot.net/ ___ Mailing list: https://launchpad.net/~openstack Post to : openstack@lists.launchpad.net Unsubscribe : https://launchpad.net/~openstack More

Re: [Openstack] +1, All services should have WADLs

2011-10-27 Thread Mark Nottingham
for it in 10 different languages ... which is why XML/JSON hold such appeal (although JSON in C keeps me awake at night). -S From: Mark Nottingham [m...@mnot.net] Sent: Thursday, October 27, 2011 10:38 AM To: Sandy Walsh Cc: Mellquist, Peter; Joseph

Re: [Openstack] API Versioning and Extensibility

2011-10-27 Thread Mark Nottingham
On 28/10/2011, at 2:39 AM, Bryan Taylor wrote: On 10/26/2011 11:19 PM, Mark Nottingham wrote: To be truly RESTful at the level of the Fielding article (which I actually think is the best description of HATEOAS there is) you shouldn't have these variants at all. I worry about us trying

Re: [Openstack] +1, All services should have WADLs

2011-10-27 Thread Mark Nottingham
Example output at: http://mnot.github.com/wadl_stylesheets/ Cheers, On 28/10/2011, at 9:55 AM, Mark Nottingham wrote: FWIW, a long time ago* I wrote an XSLT to generate HTML docs from WADL -- see: https://github.com/mnot/wadl_stylesheets I haven't maintained them in some time; however

Re: [Openstack] API Versioning and Extensibility

2011-10-27 Thread Mark Nottingham
rather evaluate the tools based upon the use case, rather than arguing by assertion. Thanks, -- Mark Nottingham http://www.mnot.net/ ___ Mailing list: https://launchpad.net/~openstack Post to : openstack@lists.launchpad.net Unsubscribe

Re: [Openstack] +1, All services should have WADLs

2011-10-27 Thread Mark Nottingham
: Hi Mark This is cool! Could you apply this for OpenStack WADL? Could you generate parameter list from XSD with XSLT? 2011/10/27 Mark Nottingham m...@mnot.net: Example output at: http://mnot.github.com/wadl_stylesheets/ Cheers, On 28/10/2011, at 9:55 AM, Mark Nottingham wrote

Re: [Openstack] Swift Consistency Guarantees?

2012-01-27 Thread Mark Nottingham
://help.launchpad.net/ListHelp -- Mark Nottingham http://www.mnot.net/ ___ Mailing list: https://launchpad.net/~openstack Post to : openstack@lists.launchpad.net Unsubscribe : https://launchpad.net/~openstack More help : https://help.launchpad.net/ListHelp

Re: [Openstack] Swift Consistency Guarantees?

2012-01-30 Thread Mark Nottingham
On 31/01/2012, at 4:45 AM, Caitlin Bestler wrote: Mark Nottingham asked: Why not just use Cache-Control: no-cache? That way, intervening caches will do the right thing too... Even with no caching anywhere you still have N replicas (typically three) that will be updated

Re: [Openstack] Swift Consistency Guarantees?

2012-01-31 Thread Mark Nottingham
-Control: authoritative), next time things get revised. Anyway, not a big deal, as it's already out there. Cheers, -- Mark Nottingham http://www.mnot.net/ ___ Mailing list: https://launchpad.net/~openstack Post to : openstack

Re: [Openstack] Image API v2 Draft 4

2012-04-12 Thread Mark Nottingham
___ Mailing list: https://launchpad.net/~openstack Post to : openstack@lists.launchpad.net Unsubscribe : https://launchpad.net/~openstack More help : https://help.launchpad.net/ListHelp -- Mark Nottingham http://www.mnot.net

Re: [Openstack] I18n issue for OpenStack

2012-04-12 Thread Mark Nottingham
@lists.launchpad.net Unsubscribe : https://launchpad.net/~openstack More help : https://help.launchpad.net/ListHelp -- Mark Nottingham http://www.mnot.net/ ___ Mailing list: https://launchpad.net/~openstack Post to : openstack@lists.launchpad.net

[Openstack] Just JSON, and extensibility

2012-04-13 Thread Mark Nottingham
seriously more complex, hard to develop, understand, maintain, test, document, etc. in the meantime, just to allow static language users to have their IDEs help them. Something that the dynamic folks have gotten pretty used to living without. Cheers, -- Mark Nottingham http://www.mnot.net

Re: [Openstack] Just JSON, and extensibility

2012-04-13 Thread Mark Nottingham
effort on it), and 3. Put some considered caveats around our current use of WADL and XML Schema. Cheers, -- Mark Nottingham http://www.mnot.net/ ___ Mailing list: https://launchpad.net/~openstack Post to : openstack@lists.launchpad.net Unsubscribe

Re: [Openstack] Just JSON, and extensibility

2012-04-13 Thread Mark Nottingham
; should be an interesting discussion. Cheers, -- Mark Nottingham http://www.mnot.net/ ___ Mailing list: https://launchpad.net/~openstack Post to : openstack@lists.launchpad.net Unsubscribe : https://launchpad.net/~openstack More help : https

[Openstack] Fwd: Change in openstack/nova[master]: Improve API logging.

2012-04-17 Thread Mark Nottingham
-Owner: mnot m...@mnot.net Gerrit-Reviewer: Devin Carlen de...@openstack.org Gerrit-Reviewer: SmokeStack Gerrit-Reviewer: mnot m...@mnot.net -- Mark Nottingham http://www.mnot.net/ ___ Mailing list: https://launchpad.net/~openstack Post

Re: [Openstack] [Glance] Using HTTP PATCH

2012-05-24 Thread Mark Nottingham
. The IETF is currently working on one for JSON; it should be progressing soon. http://tools.ietf.org/html/draft-ietf-appsawg-json-patch Cheers, -- Mark Nottingham http://www.mnot.net/ ___ Mailing list: https://launchpad.net/~openstack Post

Re: [Openstack] [Glance] Using HTTP PATCH

2012-05-24 Thread Mark Nottingham
On 24/05/2012, at 10:06 PM, Brian Waldon wrote: On May 24, 2012, at 4:12 AM, Mark Nottingham wrote: The other limitation is having defined and registered patch formats. The IETF is currently working on one for JSON; it should be progressing soon. http://tools.ietf.org/html/draft-ietf

Re: [Openstack] [keystone] v3 API draft (update and questions to the community)

2012-06-12 Thread Mark Nottingham
it comes to API features... I feel *very* strongly. All the best, - Gabriel -Original Message- From: openstack-bounces+gabriel.hurley=nebula@lists.launchpad.net [mailto:openstack- bounces+gabriel.hurley=nebula@lists.launchpad.net] On Behalf Of Mark Nottingham Sent

Re: [Openstack] [keystone] v3 API draft (update and questions to the community)

2012-06-12 Thread Mark Nottingham
not building the APIs just for Horizon; they're for lots of folks, and subtle semantics -- even when well-documented, much less when they're not -- are often misunderstood. Cheers, -- Mark Nottingham http://www.mnot.net/ ___ Mailing list: https

Re: [Openstack] [keystone] v3 API draft (update and questions to the community)

2012-06-12 Thread Mark Nottingham
@lists.launchpad.net [mailto:openstack- bounces+gabriel.hurley=nebula@lists.launchpad.net] On Behalf Of Mark Nottingham Sent: Tuesday, June 12, 2012 7:20 PM To: Jay Pipes Cc: openstack@lists.launchpad.net Subject: Re: [Openstack] [keystone] v3 API draft (update and questions to the community) On 13

[Openstack] WADL [was: v3 API draft (update and questions to the community)]

2012-06-14 Thread Mark Nottingham
@lists.launchpad.net [mailto:openstack-bounces+liem_m_nguyen=hp@lists.launchpad.net] On Behalf Of Mark Nottingham Sent: Tuesday, June 12, 2012 8:43 PM To: Gabriel Hurley Cc: openstack@lists.launchpad.net Subject: Re: [Openstack] [keystone] v3 API draft (update and questions

[Openstack] PLOP profiler

2012-07-10 Thread Mark Nottingham
, the collected samples are aggregated and saved. There is a web-based viewer for the resulting call graphs (using d3.js) Cheers, -- Mark Nottingham http://www.mnot.net/ ___ Mailing list: https://launchpad.net/~openstack Post to : openstack