Add bin/ceilometer-api for convenience

This is a bit more obvious than running the module.
I have basically just moved api/__main__.py into bin/ceilometer-api.

Change-Id: I50d614ea98b278563b576e0b3b9df03b391e2152
Signed-off-by: Angus Salkeld <asalkeld@redhat.com>

bin/ceilometer-api

@@ -1,3 +1,4 @@
+#!/usr/bin/env python
 # -*- encoding: utf-8 -*-
 #
 # Copyright © 2012 New Dream Network, LLC (DreamHost)
@@ -17,11 +18,16 @@
 # under the License.
 """Set up the development API server.
 """
+import sys
 
 from ceilometer.api.app import app
 from ceilometer.openstack.common import cfg
+from ceilometer.openstack.common import log as logging
+
 
 if __name__ == '__main__':
-    cfg.CONF()
-    app.debug = True
+    cfg.CONF(sys.argv[1:])
+    logging.setup('ceilometer.api')
+    if cfg.CONF.verbose or cfg.CONF.debug:
+        app.debug = True
     app.run(host='0.0.0.0', port=cfg.CONF.metering_api_port)

doc/source/install.rst

@@ -61,15 +61,12 @@ ceilometer::
 Running the API Server
 ======================
 
-There is not currently a wrapper script for the ceilometer API server,
-so it must be started manually.
-
 .. index::
    double: installing; API
 
 ::
 
-  $ python -m ceilometer.api
+  $ ceilometer-api
 
 .. note::
 

setup.py

@@ -34,6 +34,7 @@ setuptools.setup(
     setup_requires=['setuptools-git>=0.4'],
     scripts=['bin/ceilometer-agent-compute',
              'bin/ceilometer-agent-central',
+             'bin/ceilometer-api',
              'bin/ceilometer-collector'],
     py_modules=[],
     entry_points=textwrap.dedent("""

tox.ini

@@ -18,7 +18,7 @@ commands = {toxinidir}/run_tests.sh --no-path-adjustment --with-coverage --cover
 
 [testenv:pep8]
 deps = pep8==1.1
-commands = pep8 --repeat --show-source ceilometer setup.py bin/ceilometer-agent-central bin/ceilometer-agent-compute bin/ceilometer-collector
+commands = pep8 --repeat --show-source ceilometer setup.py bin/ceilometer-agent-central bin/ceilometer-agent-compute bin/ceilometer-collector bin/ceilometer-api
 
 [testenv:py26-essex]
 deps = -r{toxinidir}/tools/pip-requires_essex