Cleanup py27 support

Make a few cleanups:
- Remove python 2.7 stanza from setup.py
- Add requires on python >= 3.6 to setup.cfg so that pypi and pip
  know about the requirement
- Remove obsolete sections from setup.cfg
- Update classifiers
- Switch to using sphinx-build, fix doc problems

Change-Id: I2db738820744e1931949e4618299cdb2e7832d2a

doc/source/archive/building_and_deploying_docker_images.rst

@@ -1,3 +1,5 @@
+:orphan:
+
 Introduction
 ============
 The Swift account manager can supply a Docker image in which the account's storlets

doc/source/archive/invoking_storlets.rst

@@ -1,3 +1,5 @@
+:orphan:
+
 ===================
 Storlets Invocation
 ===================

doc/source/archive/storlet_api.rst

@@ -1,3 +1,5 @@
+:orphan:
+
 ===============
 Storlets API v1
 ===============

doc/source/archive/storlets_docker_gateway.rst

@@ -1,3 +1,5 @@
+:orphan:
+
 =====================
 StorletsDockerGateway
 =====================

doc/source/archive/storlets_management.rst

@@ -1,3 +1,5 @@
+:orphan:
+
 ============
 Introduction
 ============

doc/source/index.rst

@@ -52,6 +52,7 @@ Overview and Concepts
    storlet_engine_overview
    api/overview_api
    ipython_integration
+   installation
 
 Related Projects
 ~~~~~~~~~~~~~~~~
@@ -71,6 +72,7 @@ Storlets Developers
 .. toctree::
    :maxdepth: 1
 
+   contributing
    writing_and_deploying_storlets
    writing_and_deploying_java_storlets
    writing_and_deploying_python_storlets

doc/source/ipython_integration.rst

@@ -8,9 +8,9 @@ Set up IPython to work with storlets
 Setting up an IPython notebook to work with storlets involves:
 
 #. Providing the authentication information of a storlet enabled Swift account.
-    This is done by setting environment variables similar to those used by swift
-    client. The exact variables that need to be set are dependent on the auth middleware
-    used and the auth protocol version. For more details please refer to:
+   This is done by setting environment variables similar to those used by swift
+   client. The exact variables that need to be set are dependent on the auth middleware
+   used and the auth protocol version. For more details please refer to:
    `python-swiftclient docs
    <https://docs.openstack.org/python-swiftclient/latest/cli/index.html#authentication>`_.
 

doc/source/readme.rst

@@ -1 +1,3 @@
+:orphan:
+
 .. include:: ../../README.rst

setup.cfg

@@ -6,6 +6,7 @@ description-file =
 author = OpenStack
 author-email = openstack-discuss@lists.openstack.org
 home-page = https://docs.openstack.org/storlets/latest/
+python-requires = >=3.6
 classifier =
     Environment :: OpenStack
     Intended Audience :: Information Technology
@@ -13,6 +14,8 @@ classifier =
     License :: OSI Approved :: Apache Software License
     Operating System :: POSIX :: Linux
     Programming Language :: Python
+    Programming Language :: Python :: Implementation :: CPython
+    Programming Language :: Python :: 3 :: Only
     Programming Language :: Python :: 3
     Programming Language :: Python :: 3.6
     Programming Language :: Python :: 3.7
@@ -38,14 +41,6 @@ console_scripts =
     storlets-daemon = storlets.agent.daemon.server:main
     storlets-daemon-factory = storlets.agent.daemon_factory.server:main
 
-[build_sphinx]
-source-dir = doc/source
-build-dir = doc/build
-all_files = 1
-
-[upload_sphinx]
-upload-dir = doc/build/html
-
 [compile_catalog]
 directory = storlets/locale
 domain = storlets

setup.py

@@ -13,17 +13,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# THIS FILE IS MANAGED BY THE GLOBAL REQUIREMENTS REPO - DO NOT EDIT
 import setuptools
 
-# In python < 2.7.4, a lazy loading of package `pbr` will break
-# setuptools if some other modules registered functions in `atexit`.
-# solution from: http://bugs.python.org/issue15881#msg170215
-try:
-    import multiprocessing  # noqa
-except ImportError:
-    pass
-
 setuptools.setup(
     setup_requires=['pbr>=1.9', 'setuptools>=17.1'],
     pbr=True)

tox.ini

@@ -63,7 +63,8 @@ commands =
    coverage xml -o cover/coverage.xml
 
 [testenv:docs]
-commands = python setup.py build_sphinx
+commands =
+  sphinx-build -a -W -E -b html doc/source doc/build/html
 
 [testenv:debug]
 commands = oslo_debug_helper {posargs}