[openstack-dev] [api] [sdk] Proposal to achieve consistency in client side sorting

Rochelle Grober rochelle.grober at huawei.com
Wed Jan 7 02:37:07 UTC 2015


This sounds like a perfect place for a cross project spec.  It wouldn't have to be a big one, but all the projects would have a chance to review and the TC would oversee to ensure it gets proper review.

TCms, am I on point here?


From: Jay S. Bryant [mailto:jsbryant at electronicjungle.net]
Sent: Tuesday, January 06, 2015 10:41 AM
To: OpenStack Development Mailing List (not for usage questions)
Subject: Re: [openstack-dev] [api] [sdk] Proposal to achieve consistency in client side sorting


Thank you for continuing to pursue this.  Adding this functionality and having it consistent will be a good thing.

The plan for Cinder looks good to me and is consistent with Mike and Duncan's input.

I look forward to seeing patches for Cinder.

On 01/06/2015 10:03 AM, Steven Kaufer wrote:

This is a follow up thread to [1]

In order to have consistency across clients, I am proposing that the client side sorting has the following syntax: --sort <key>[:<direction>]

Where the --sort parameter is comma-separated and is used to specify one or more sort keys and directions. The direction defaults to 'desc' for each sort key and the user can supply 'asc' to override.

For example:

  nova list --sort display_name
  nova list --sort display_name,vm_state
  nova list --sort display_name:asc,vm_state:asc

If approved, then the following changes are needed for glance and cinder (note that nova already uses this syntax):

  Cinder: Deprecate --sort_key and --sort_dir and add support for --sort
  Glance: Modify [2] to this new syntax

I have not verified how all other projects handle sorting, there may be other projects that would also need to be changed.

Thoughts?  Objections?

Also, if there is a more formal way to propose/review this standard please let me know.

[1] http://www.mail-archive.com/openstack-dev@lists.openstack.org/msg42854.html
[2] https://review.openstack.org/#/c/120777/

Steven Kaufer


OpenStack-dev mailing list

OpenStack-dev at lists.openstack.org<mailto:OpenStack-dev at lists.openstack.org>


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20150107/dbf3e4c3/attachment.html>

More information about the OpenStack-dev mailing list