From c2c41b9d3889d5f445a0b5fc7e178e15651120de Mon Sep 17 00:00:00 2001
From: fangjinxing <fang.jinxing@99cloud.net>
Date: Wed, 21 Dec 2016 17:28:55 +0800
Subject: [PATCH] Add python-valenceclient for valence

Add python-valenceclient for user to call the valence api gracefully
or get information conveniently in console as other OpenStack "Big Tent"
project.

Change-Id: I4952ff26091330d5600c51e7f941a672b3e9b4d6
---
 specs/ocata/approved/python-valenceclient.rst | 138 ++++++++++++++++++
 1 file changed, 138 insertions(+)
 create mode 100644 specs/ocata/approved/python-valenceclient.rst

diff --git a/specs/ocata/approved/python-valenceclient.rst b/specs/ocata/approved/python-valenceclient.rst
new file mode 100644
index 0000000..cd65e87
--- /dev/null
+++ b/specs/ocata/approved/python-valenceclient.rst
@@ -0,0 +1,138 @@
+..
+
+ This work is licensed under a Creative Commons Attribution 3.0 Unported
+ License.
+
+http://creativecommons.org/licenses/by/3.0/legalcode
+
+=====================================================
+Provide Python client library API and CLI for valence
+=====================================================
+
+https://blueprints.launchpad.net/openstack-valence/+spec/python-valenceclient
+
+As we known, valence project is a collection of all things Rack Scale Control,
+which can consider computer, storage and network as disaggregated resource
+that can be composed on the fly to meet various needs in a data center or
+cloud.
+
+But there hava no valence client for user to call the valence api gracefully
+or get information conveniently in console as other OpenStack "Big Tent"
+project. So not only it's necessary to provide a valence client for user but
+also for valence developer.
+
+Problem description
+===================
+There have no valence client for user to call the valence api by python
+client library API or command-line script.
+
+Proposed change
+===============
+
+Create a new project named python-valenceclient for valence on the OpenStack
+API to support gracefully and conveniently Python API call and command-line.
+
+So this blueprint will be implemented into 2 phases.
+
+**Phase I.** Support Python client library API
+
+- In this phase, add the Python client library API support. So developer can
+  call the Python client library API to get valence information directly.
+
+**Phase II.** Support command-line
+
+- Base on the phase I, the python-valenceclient will support the
+  command-line for user to get the valence information.
+
+Alternatives
+------------
+
+None
+
+Data model impact
+-----------------
+
+None
+
+REST API impact
+---------------
+
+None
+
+Versioning impact
+-----------------
+
+None
+
+Other end user impact
+---------------------
+
+To use the python-valenceclient need to install the python-valenceclient package
+by pip or other repo management tool.
+
+Deployer impact
+---------------
+
+None
+
+Developer impact
+----------------
+
+None
+
+Implementation
+==============
+
+Assignee(s)
+-----------
+
+Primary Assignees
+-----------------
+
+Primary assignee:
+  Jinxing Fang <fang.jinxing@99cloud.net>
+  Yufei Zhang <zhang.yufei@99cloud.net>
+  Shuquan Huang <huan.shuquan@99coud.net>
+
+Other contributors:
+
+Work Items
+----------
+
+* Add python-valenceclient initially file to openstack repo
+* Add the abstract and base http request(PUT,POST,GET,DELETE...) process
+* Add the RSD power API
+
+  - power off
+  - power on
+  - soft power off
+  - soft power on
+  - inject NMI
+
+* Add nodes API
+* Add flavor API
+* Add storage API
+* Add systems API
+
+Dependencies
+============
+
+Depends on valence project, only the package is installed that the valence
+client can work.
+
+Testing
+=======
+
+- write functional tests to cover all REST API
+- unit tests
+
+Documentation
+=============
+
+- Python client library Reference
+- Python client library API User's Guide
+
+References
+==========
+
+None