)]}'
{"specs/deprecate-cli.rst":[{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"0f77ff25d31cc1979b46c3167e6e132e27268be1","unresolved":false,"context_lines":[{"line_number":15,"context_line":"Problem description"},{"line_number":16,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"There is currently no standardard workflow for interacting with OpenStack"},{"line_number":19,"context_line":"services on the command line. In the begininng it made sense that there was a"},{"line_number":20,"context_line":"nova CLI for working with nova. As keystone, glance and cinder split out they"},{"line_number":21,"context_line":"cloned novaclient and adapted it to their needs. By the time neutron and the"}],"source_content_type":"text/x-rst","patch_set":1,"id":"da85f559_685fb1e5","line":18,"updated":"2015-11-10 15:44:44.000000000","message":"standardized?","commit_id":"f43b32ff70e4327583647bbef4ee889854730443"},{"author":{"_account_id":308,"name":"Thierry Carrez","email":"thierry@openstack.org","username":"ttx"},"change_message_id":"fe4dbc04fbd426cc28513c2133ca058781d605a5","unresolved":false,"context_lines":[{"line_number":2,"context_line":"Deprecate Individual CLIs"},{"line_number":3,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":4,"context_line":""},{"line_number":5,"context_line":"Include the URL of your launchpad blueprint:"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"https://blueprints.launchpad.net/+spec/deprecate-clis"},{"line_number":8,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba8a016a_f170a2de","line":5,"updated":"2015-11-17 11:01:40.000000000","message":"That is boilerplate, you should remove that line","commit_id":"f72cfa09e600eca1b9bbe2a3dc38d97dcfa350c2"},{"author":{"_account_id":18658,"name":"Jas Singh","email":"singhj@us.ibm.com","username":"singhj"},"change_message_id":"74be7602ed6d8631539f135743e59258cf3797d2","unresolved":false,"context_lines":[{"line_number":5,"context_line":"Include the URL of your launchpad blueprint:"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"https://blueprints.launchpad.net/+spec/deprecate-clis"},{"line_number":8,"context_line":""},{"line_number":9,"context_line":"Historically each service has offered a CLI application that is included with"},{"line_number":10,"context_line":"the python-\\*client that provides administrative and user control over the"},{"line_number":11,"context_line":"service. With the popularity of OpenStackClient and the majority of functions"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da85f559_e0a2239a","line":8,"updated":"2015-11-13 15:18:26.000000000","message":"Just wanted to make a few minute suggestions for this first paragraph:\n1) Historically each --\u003e Historically, each\n2) With the popularity of...there we should --\u003e With the popularity of...there, we should\n3) This first part here uses \"OpenStackClient\" while others use \"OpenStack Client\"","commit_id":"f72cfa09e600eca1b9bbe2a3dc38d97dcfa350c2"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"fc685e74d8d42c14478da1a9ba6689abb5790c14","unresolved":false,"context_lines":[{"line_number":16,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"There is currently no standard workflow for interacting with OpenStack services"},{"line_number":19,"context_line":"on the command line. In the begininng it made sense that there was a nova CLI"},{"line_number":20,"context_line":"for working with nova. As keystone, glance and cinder split out they cloned"},{"line_number":21,"context_line":"novaclient and adapted it to their needs. By the time neutron and the deluge of"},{"line_number":22,"context_line":"big tent services came along there was a clear pattern that each service would"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da85f559_fc8a3d63","line":19,"updated":"2015-11-11 21:49:07.000000000","message":"typo: beginning","commit_id":"f72cfa09e600eca1b9bbe2a3dc38d97dcfa350c2"},{"author":{"_account_id":1297,"name":"Joshua Harlow","email":"jxharlow@godaddy.com","username":"harlowja"},"change_message_id":"3b96c3d6fb3137b828b3fb3fccdd5033412f1ad2","unresolved":false,"context_lines":[{"line_number":33,"context_line":"the CLI as you have to continually switch between different formatting, command"},{"line_number":34,"context_line":"structures, capabilities and requires a deep knowledge of which service is"},{"line_number":35,"context_line":"responsible for different tasks - a pattern we have been trying to break in"},{"line_number":36,"context_line":"favour of a unified OpenStack interface."},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"To deal with this the OpenStack client project has now been around for nearly 2"},{"line_number":39,"context_line":"years. It provides a pluggable way to register CLI tasks and a common place to"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da85f559_72078818","line":36,"updated":"2015-11-11 01:48:33.000000000","message":"+100","commit_id":"f72cfa09e600eca1b9bbe2a3dc38d97dcfa350c2"},{"author":{"_account_id":5202,"name":"Erno Kuvaja","email":"jokke@usr.fi","username":"jokke"},"change_message_id":"32e3158fcd2401d3858497e55899040638c2a7e5","unresolved":false,"context_lines":[{"line_number":37,"context_line":""},{"line_number":38,"context_line":"To deal with this the OpenStack client project has now been around for nearly 2"},{"line_number":39,"context_line":"years. It provides a pluggable way to register CLI tasks and a common place to"},{"line_number":40,"context_line":"fix security and usability issues."},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"Proposed change"},{"line_number":43,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a740942_120c413a","line":40,"updated":"2015-12-10 15:08:35.000000000","message":"It also breaks the well established POSIX approach where you make a tool to do one thing well instead of trying to make tool that will do somewhat everything.","commit_id":"f72cfa09e600eca1b9bbe2a3dc38d97dcfa350c2"},{"author":{"_account_id":7191,"name":"Jamie Lennox","email":"jamielennox@gmail.com","username":"jamielennox"},"change_message_id":"2e749ac78e42b70caad3efaec4fa65c27d0ea882","unresolved":false,"context_lines":[{"line_number":37,"context_line":""},{"line_number":38,"context_line":"To deal with this the OpenStack client project has now been around for nearly 2"},{"line_number":39,"context_line":"years. It provides a pluggable way to register CLI tasks and a common place to"},{"line_number":40,"context_line":"fix security and usability issues."},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"Proposed change"},{"line_number":43,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3a7e1126_eea09fa1","line":40,"in_reply_to":"7a740942_120c413a","updated":"2015-12-17 23:23:09.000000000","message":"Particularly from a user point of view I want \"openstack\" to be the one thing not have to worry about the different components.","commit_id":"f72cfa09e600eca1b9bbe2a3dc38d97dcfa350c2"},{"author":{"_account_id":5202,"name":"Erno Kuvaja","email":"jokke@usr.fi","username":"jokke"},"change_message_id":"32e3158fcd2401d3858497e55899040638c2a7e5","unresolved":false,"context_lines":[{"line_number":47,"context_line":"and several newer services) there is no clear direction on whether our users"},{"line_number":48,"context_line":"should use it or continue using the project specific CLIs. Similarly there is"},{"line_number":49,"context_line":"no clear direction on whether developers should contribute new features in"},{"line_number":50,"context_line":"services to the service specific CLI or to OpenStack client."},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"This blueprint proposes that as a community we ratify that OpenStack Client is"},{"line_number":53,"context_line":"to be the default supported CLI application going forward. This will give"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a740942_f2b3b508","line":50,"updated":"2015-12-10 15:08:35.000000000","message":"Looking oslo or horizon as example I have hard time seeing developers moving to the common project. This will be more of a \"Yeii, one less thing we need to maintain\"","commit_id":"f72cfa09e600eca1b9bbe2a3dc38d97dcfa350c2"},{"author":{"_account_id":7191,"name":"Jamie Lennox","email":"jamielennox@gmail.com","username":"jamielennox"},"change_message_id":"2e749ac78e42b70caad3efaec4fa65c27d0ea882","unresolved":false,"context_lines":[{"line_number":47,"context_line":"and several newer services) there is no clear direction on whether our users"},{"line_number":48,"context_line":"should use it or continue using the project specific CLIs. Similarly there is"},{"line_number":49,"context_line":"no clear direction on whether developers should contribute new features in"},{"line_number":50,"context_line":"services to the service specific CLI or to OpenStack client."},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"This blueprint proposes that as a community we ratify that OpenStack Client is"},{"line_number":53,"context_line":"to be the default supported CLI application going forward. This will give"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3a7e1126_0e8deb7a","line":50,"in_reply_to":"7a740942_f2b3b508","updated":"2015-12-17 23:23:09.000000000","message":"I don\u0027t think i\u0027d characterize oslo like that, however re-horizon i think (hope?) this would be a different case. Most developers and even operators aren\u0027t overly interested in the graphical use case, however If you want your new feature to be used at all then you at least need to provide a CLI interface. I think the key to OSC gaining features there will be the projects saying no to adding new things to the project specific CLIs and say add it to OSC instead.","commit_id":"f72cfa09e600eca1b9bbe2a3dc38d97dcfa350c2"},{"author":{"_account_id":5202,"name":"Erno Kuvaja","email":"jokke@usr.fi","username":"jokke"},"change_message_id":"32e3158fcd2401d3858497e55899040638c2a7e5","unresolved":false,"context_lines":[{"line_number":58,"context_line":""},{"line_number":59,"context_line":"Given that various projects currently have different needs from their CLI I do"},{"line_number":60,"context_line":"not expect that we will be immediately able to deprecate all CLIs. There may be"},{"line_number":61,"context_line":"certain tasks for which there will always need to be a project specific CLI."},{"line_number":62,"context_line":"The intent of this blueprint initially is not to provide a timeline or force"},{"line_number":63,"context_line":"projects away from their own CLIs. Instead to provide direction to start"},{"line_number":64,"context_line":"deprecating the CLIs for which OpenStack Client already has functionality"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a740942_1201a16a","line":61,"updated":"2015-12-10 15:08:35.000000000","message":"This will make the whole situation even messier. We should ether stick with the decision and live with it or not make it if we know already that it won\u0027t work.","commit_id":"f72cfa09e600eca1b9bbe2a3dc38d97dcfa350c2"},{"author":{"_account_id":5202,"name":"Erno Kuvaja","email":"jokke@usr.fi","username":"jokke"},"change_message_id":"32e3158fcd2401d3858497e55899040638c2a7e5","unresolved":false,"context_lines":[{"line_number":72,"context_line":"in a cross service way. There may be an advantage to doing this anyway as there"},{"line_number":73,"context_line":"will likely always be tools that want to provide a CLI interface to an"},{"line_number":74,"context_line":"OpenStack API that do not belong in OpenStack Client and these should remain"},{"line_number":75,"context_line":"consistent."},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"Doing nothing is always an option. OpenStack client is steadily gaining"},{"line_number":78,"context_line":"adoption naturally because it can quickly provide new features across a range"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a740942_77aa571b","line":75,"updated":"2015-12-10 15:08:35.000000000","message":"I\u0027m very much pro of this approach instead.","commit_id":"f72cfa09e600eca1b9bbe2a3dc38d97dcfa350c2"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"17ff8ef477fa5d9fcf9686cdccf2933821a357dd","unresolved":false,"context_lines":[{"line_number":99,"context_line":"- Add a deprecation warning to clients that have OpenStack Client equivalent"},{"line_number":100,"context_line":"  functionality."},{"line_number":101,"context_line":"- Update documentation to use OpenStack Client commands instead of project"},{"line_number":102,"context_line":"  specific CLIs."},{"line_number":103,"context_line":"- Remove CLI components from CLIs after deprecation period complete."},{"line_number":104,"context_line":""},{"line_number":105,"context_line":"Dependencies"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a740942_7b851dcd","line":102,"updated":"2015-12-11 16:48:11.000000000","message":"This is a larger work item than a single bullet. Can you add a \"Documentation Impact\" section above? I\u0027d be happy to help you fill it in. Docs affected:\nInstall Guides\nUser Guide\nAdmin Guide\nOps Guide\nCLI Reference (could be deleted, would need redirects)","commit_id":"f72cfa09e600eca1b9bbe2a3dc38d97dcfa350c2"},{"author":{"_account_id":7191,"name":"Jamie Lennox","email":"jamielennox@gmail.com","username":"jamielennox"},"change_message_id":"2e749ac78e42b70caad3efaec4fa65c27d0ea882","unresolved":false,"context_lines":[{"line_number":99,"context_line":"- Add a deprecation warning to clients that have OpenStack Client equivalent"},{"line_number":100,"context_line":"  functionality."},{"line_number":101,"context_line":"- Update documentation to use OpenStack Client commands instead of project"},{"line_number":102,"context_line":"  specific CLIs."},{"line_number":103,"context_line":"- Remove CLI components from CLIs after deprecation period complete."},{"line_number":104,"context_line":""},{"line_number":105,"context_line":"Dependencies"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3a7e1126_ee4f3fbb","line":102,"in_reply_to":"7a740942_7b851dcd","updated":"2015-12-17 23:23:09.000000000","message":"Thanks, i wasn\u0027t sure of everything that would be affected here.","commit_id":"f72cfa09e600eca1b9bbe2a3dc38d97dcfa350c2"},{"author":{"_account_id":8410,"name":"Richard Theis","email":"rtheis@us.ibm.com","username":"rtheis"},"change_message_id":"cd9e3c0ba543d72318817dfb64081040f1b3c2ee","unresolved":false,"context_lines":[{"line_number":108,"context_line":"There have been many required steps to this goal such as os-client-config,"},{"line_number":109,"context_line":"keystoneauth, cliff, stevedore and the work that has already gone into"},{"line_number":110,"context_line":"OpenStack client. We are now at the point where we can move forward with the"},{"line_number":111,"context_line":"change."},{"line_number":112,"context_line":""},{"line_number":113,"context_line":"History"},{"line_number":114,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da85f559_4c2b2e34","line":111,"updated":"2015-11-13 14:15:20.000000000","message":"Should the OpenStack SDK also be listed as a dependency?","commit_id":"f72cfa09e600eca1b9bbe2a3dc38d97dcfa350c2"},{"author":{"_account_id":7191,"name":"Jamie Lennox","email":"jamielennox@gmail.com","username":"jamielennox"},"change_message_id":"2e749ac78e42b70caad3efaec4fa65c27d0ea882","unresolved":false,"context_lines":[{"line_number":108,"context_line":"There have been many required steps to this goal such as os-client-config,"},{"line_number":109,"context_line":"keystoneauth, cliff, stevedore and the work that has already gone into"},{"line_number":110,"context_line":"OpenStack client. We are now at the point where we can move forward with the"},{"line_number":111,"context_line":"change."},{"line_number":112,"context_line":""},{"line_number":113,"context_line":"History"},{"line_number":114,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3a7e1126_6edeef40","line":111,"in_reply_to":"7a740942_73aea1e7","updated":"2015-12-17 23:23:09.000000000","message":"@Anne: I think this is a common misconception that the purpose of the python-\u003cproject\u003eclient projects is to support the CLI. This was initially the case, however horizon, OSC, and most of the inter-project communication rely on the clients as a python library as well as the documentation for interacting with those services from python. \n\nI\u0027m not proposing we deprecate all the python-\u003cproject\u003e libraries, just the CLI component of them.","commit_id":"f72cfa09e600eca1b9bbe2a3dc38d97dcfa350c2"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"0e7769bc3169bc98471a53866c6af821d95e2cbe","unresolved":false,"context_lines":[{"line_number":108,"context_line":"There have been many required steps to this goal such as os-client-config,"},{"line_number":109,"context_line":"keystoneauth, cliff, stevedore and the work that has already gone into"},{"line_number":110,"context_line":"OpenStack client. We are now at the point where we can move forward with the"},{"line_number":111,"context_line":"change."},{"line_number":112,"context_line":""},{"line_number":113,"context_line":"History"},{"line_number":114,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da85f559_7e25735a","line":111,"in_reply_to":"da85f559_4c2b2e34","updated":"2015-11-13 16:06:26.000000000","message":"no, as it\u0027s not yet a dependency :)\n\neventually we would like to use only the SDK, but for now we will live with using the individual python-*clients","commit_id":"f72cfa09e600eca1b9bbe2a3dc38d97dcfa350c2"},{"author":{"_account_id":8410,"name":"Richard Theis","email":"rtheis@us.ibm.com","username":"rtheis"},"change_message_id":"8e88306b101f0621a474fcc433604a5490993565","unresolved":false,"context_lines":[{"line_number":108,"context_line":"There have been many required steps to this goal such as os-client-config,"},{"line_number":109,"context_line":"keystoneauth, cliff, stevedore and the work that has already gone into"},{"line_number":110,"context_line":"OpenStack client. We are now at the point where we can move forward with the"},{"line_number":111,"context_line":"change."},{"line_number":112,"context_line":""},{"line_number":113,"context_line":"History"},{"line_number":114,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da85f559_b09a24c4","line":111,"in_reply_to":"da85f559_7e25735a","updated":"2015-11-13 17:52:26.000000000","message":"Correct, I should clarify that I was wondering if the SDK should be listed as a future dependency important to allow the python-\\*client to be deprecated?","commit_id":"f72cfa09e600eca1b9bbe2a3dc38d97dcfa350c2"},{"author":{"_account_id":1112,"name":"Everett Toews","email":"everett.toews@rackspace.com","username":"everett-toews"},"change_message_id":"9d044eba308989ce2b5c686b49942f36bf2aa64d","unresolved":false,"context_lines":[{"line_number":108,"context_line":"There have been many required steps to this goal such as os-client-config,"},{"line_number":109,"context_line":"keystoneauth, cliff, stevedore and the work that has already gone into"},{"line_number":110,"context_line":"OpenStack client. We are now at the point where we can move forward with the"},{"line_number":111,"context_line":"change."},{"line_number":112,"context_line":""},{"line_number":113,"context_line":"History"},{"line_number":114,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a740942_332a5991","line":111,"in_reply_to":"da85f559_b09a24c4","updated":"2015-12-11 17:42:27.000000000","message":"In these comments stevemar mentions \"eventually we would like to use only the SDK\".\n\nIn the review discussion dtroyer mentions \"Eventually we\u0027ll not be using novaclient for the Python API once we switch to the SDK.\"\n\nRather than just have these as comments in a review I think it\u0027s worthwhile to have this sentiment in the spec itself by listing the SDK as a dependency and adding a brief paragraph about it as the way forward in the Proposed Change section.","commit_id":"f72cfa09e600eca1b9bbe2a3dc38d97dcfa350c2"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"e430ccf6fa46a313a59ada6a8530aab906863638","unresolved":false,"context_lines":[{"line_number":108,"context_line":"There have been many required steps to this goal such as os-client-config,"},{"line_number":109,"context_line":"keystoneauth, cliff, stevedore and the work that has already gone into"},{"line_number":110,"context_line":"OpenStack client. We are now at the point where we can move forward with the"},{"line_number":111,"context_line":"change."},{"line_number":112,"context_line":""},{"line_number":113,"context_line":"History"},{"line_number":114,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7a740942_73aea1e7","line":111,"in_reply_to":"da85f559_b09a24c4","updated":"2015-12-11 19:09:15.000000000","message":"Yes, this is a crucial point that prevents me from possibly approving this spec. \n\nWe cannot deprecate the python-\u003cproject\u003eclient projects if the openstack CLI depends on them. Right? How about using the OpenStack SDK and building the shared CLI from that, let\u0027s ensure that\u0027s in the spec.","commit_id":"f72cfa09e600eca1b9bbe2a3dc38d97dcfa350c2"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"49eb0b7e42453a1fef6b1e766ed651223564592c","unresolved":false,"context_lines":[{"line_number":8,"context_line":"the python-\\*client that provides administrative and user control over the"},{"line_number":9,"context_line":"service. With the popularity of OpenStack Client and the majority of functions"},{"line_number":10,"context_line":"having been implemented there we should look to officially deprecate the"},{"line_number":11,"context_line":"individual CLI applications."},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"Problem description"},{"line_number":14,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":4,"id":"3a7e1126_1af51782","line":11,"range":{"start_line":11,"start_character":27,"end_line":11,"end_character":28},"updated":"2015-12-18 07:17:58.000000000","message":"maybe add a bit at the end here to hopefully clear things up moreso:\n\n\"This does not imply that the entire python-*client will be deprecated, just the CLI portion of the library, the python bindings are expected to continue to work.\"","commit_id":"99dd5e84bdfee844d6c9c6acee1f155bcd6b735a"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"49eb0b7e42453a1fef6b1e766ed651223564592c","unresolved":false,"context_lines":[{"line_number":113,"context_line":"For most CLI applications we must first start emitting deprecation warnings for"},{"line_number":114,"context_line":"the CLI tools that ship with the deployment libraries."},{"line_number":115,"context_line":""},{"line_number":116,"context_line":"For core services most functionality is already present and maintained in the"},{"line_number":117,"context_line":"OpenStack client repositories so they would need to ensure feature parity"},{"line_number":118,"context_line":"however they would typically not require any additional code."},{"line_number":119,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"3a7e1126_5ad5dfb6","line":116,"range":{"start_line":116,"start_character":8,"end_line":116,"end_character":9},"updated":"2015-12-18 07:17:58.000000000","message":"it wouldn\u0027t hurt to enumerate the core services that OSC supports: nova/glance/cinder/swift/neutron/keystone","commit_id":"99dd5e84bdfee844d6c9c6acee1f155bcd6b735a"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"49eb0b7e42453a1fef6b1e766ed651223564592c","unresolved":false,"context_lines":[{"line_number":114,"context_line":"the CLI tools that ship with the deployment libraries."},{"line_number":115,"context_line":""},{"line_number":116,"context_line":"For core services most functionality is already present and maintained in the"},{"line_number":117,"context_line":"OpenStack client repositories so they would need to ensure feature parity"},{"line_number":118,"context_line":"however they would typically not require any additional code."},{"line_number":119,"context_line":""},{"line_number":120,"context_line":"For newer and optional services their CLI is implemented as a plugin that still"}],"source_content_type":"text/x-rst","patch_set":4,"id":"3a7e1126_3a8493d2","line":117,"range":{"start_line":117,"start_character":10,"end_line":117,"end_character":16},"updated":"2015-12-18 07:17:58.000000000","message":"nit: Client*\n\nnit: repository* singular\n\nnit: comma after parity.","commit_id":"99dd5e84bdfee844d6c9c6acee1f155bcd6b735a"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"49eb0b7e42453a1fef6b1e766ed651223564592c","unresolved":false,"context_lines":[{"line_number":119,"context_line":""},{"line_number":120,"context_line":"For newer and optional services their CLI is implemented as a plugin that still"},{"line_number":121,"context_line":"typically lives in the python library. A number of services have already"},{"line_number":122,"context_line":"implemented their CLI as an OpenStack Client plugin in this way. These services"},{"line_number":123,"context_line":"would need to implement an OpenStack Client plugin that handles the features"},{"line_number":124,"context_line":"they wish to expose via CLI."},{"line_number":125,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"3a7e1126_bae643b2","line":122,"range":{"start_line":122,"start_character":18,"end_line":122,"end_character":21},"updated":"2015-12-18 07:17:58.000000000","message":"wouldn\u0027t hurt to add examples of projects that implemented their CLI as an OSC plugin from the get-go, like zaqar and sahara","commit_id":"99dd5e84bdfee844d6c9c6acee1f155bcd6b735a"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"49eb0b7e42453a1fef6b1e766ed651223564592c","unresolved":false,"context_lines":[{"line_number":120,"context_line":"For newer and optional services their CLI is implemented as a plugin that still"},{"line_number":121,"context_line":"typically lives in the python library. A number of services have already"},{"line_number":122,"context_line":"implemented their CLI as an OpenStack Client plugin in this way. These services"},{"line_number":123,"context_line":"would need to implement an OpenStack Client plugin that handles the features"},{"line_number":124,"context_line":"they wish to expose via CLI."},{"line_number":125,"context_line":""},{"line_number":126,"context_line":"Documentation impact"}],"source_content_type":"text/x-rst","patch_set":4,"id":"3a7e1126_1a22f7b9","line":123,"range":{"start_line":123,"start_character":14,"end_line":123,"end_character":23},"updated":"2015-12-18 07:17:58.000000000","message":"This last sentence is confusing. how about:\n\nA number of projects (zaqar, sahara, etc) have already implemented their CLI as an OpenStack Client plugin, these projects will not be impacted. Projects that have not created OpenStack Client plugins (ceilometer, magnum, etc), would need to implement an OpenStack Client plugin that handles features they wish to expose via CLI.\n\nIt should be noted that OpenStack Client plugins will reside in the same library as the python bindings. For example: python-zaqarclient would have a package \"zaqarclient\" which contains python bindsings, and a package \"osc\" which contains the OpenStack Client plugin. This model makes it easy for projects to maintain control of their own CLI, whilst leveraging OpenStack Client\u0027s feature, consistency and common authentication handling.","commit_id":"99dd5e84bdfee844d6c9c6acee1f155bcd6b735a"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"0d3ba728b87f4b86a2e1663345f7931a6d702a1b","unresolved":false,"context_lines":[{"line_number":159,"context_line":""},{"line_number":160,"context_line":"The OpenStack Client is already in use and deployed as a part of most"},{"line_number":161,"context_line":"installations (it is required for keystone). Therefore changes to documentation"},{"line_number":162,"context_line":"would not be dependant on any work happening in the services. The spec attempts"},{"line_number":163,"context_line":"to ratify that this is the correct approach."},{"line_number":164,"context_line":""},{"line_number":165,"context_line":"Dependencies"}],"source_content_type":"text/x-rst","patch_set":5,"id":"3a7e1126_a084770a","line":162,"range":{"start_line":162,"start_character":13,"end_line":162,"end_character":22},"updated":"2015-12-21 14:11:38.000000000","message":"dependent (adjective in this case)","commit_id":"6d0b5b68b5a1ebbd1ce3a283029618576d81da1b"},{"author":{"_account_id":1112,"name":"Everett Toews","email":"everett.toews@rackspace.com","username":"everett-toews"},"change_message_id":"da5945bb8535ec0b6c84969ba73e564875caef6a","unresolved":false,"context_lines":[{"line_number":171,"context_line":"change."},{"line_number":172,"context_line":""},{"line_number":173,"context_line":"The OpenStack SDK is not listed as a dependency here because it is not"},{"line_number":174,"context_line":"currently a dependency of OpenStack Client. It is intended that when OpenStack"},{"line_number":175,"context_line":"SDK is released it will be consumed by OpenStack Client however that can be"},{"line_number":176,"context_line":"considered an implementation detail."},{"line_number":177,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"fa69d971_2c1e70bb","line":174,"updated":"2016-01-05 18:22:31.000000000","message":"Sorry to be pedantic but openstacksdk is a requirement http://git.openstack.org/cgit/openstack/python-openstackclient/tree/requirements.txt#n10\n\nI should have referenced that in my earlier comments.\n\nHowever, I understand that it\u0027s currently not a *big* dependency. Your call on whether or not to update the wording.","commit_id":"6d0b5b68b5a1ebbd1ce3a283029618576d81da1b"},{"author":{"_account_id":782,"name":"John Garbutt","email":"john@johngarbutt.com","username":"johngarbutt"},"change_message_id":"0ae80e4147911e484ec7de075ce16a0ced40560b","unresolved":false,"context_lines":[{"line_number":171,"context_line":"change."},{"line_number":172,"context_line":""},{"line_number":173,"context_line":"The OpenStack SDK is not listed as a dependency here because it is not"},{"line_number":174,"context_line":"currently a dependency of OpenStack Client. It is intended that when OpenStack"},{"line_number":175,"context_line":"SDK is released it will be consumed by OpenStack Client however that can be"},{"line_number":176,"context_line":"considered an implementation detail."},{"line_number":177,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"fa69d971_5a82b601","line":174,"in_reply_to":"fa69d971_2c1e70bb","updated":"2016-01-08 17:06:00.000000000","message":"maybe a follow up patch?","commit_id":"6d0b5b68b5a1ebbd1ce3a283029618576d81da1b"}]}