Prepare the releas of distribution.

Author: elmar-hinz

MANIFEST.in

@@ -1,3 +1,4 @@
 include README.rst
-include docs/*.html
-
+include LICENSE
+include version.txt
+recursive-include docs *

challenges/__init__.py

@@ -1,5 +0,0 @@
-from os.path import dirname, realpath
-
-version_file = realpath(dirname(dirname(__file__))) + '/version.txt'
-with open(version_file) as f:
-    __version__ = f.read().strip()

release.py

@@ -0,0 +1,63 @@
+import os
+import shutil
+
+
+def main():
+    # pathes
+    here = os.path.abspath(os.path.dirname(__file__))
+    sphinx = os.path.join(here, 'sphinx/')
+    docs = os.path.join(here, 'docs/')
+    html_source = os.path.join(here, 'sphinx/_build/html/')
+    html_target = os.path.join(here, 'docs/html/')
+    epub_source = os.path.join(here, 'sphinx/_build/epub/')
+    epub_target = os.path.join(here, 'docs/epub/')
+    rst_challenges = os.path.join(sphinx, 'challenges.rst')
+    rst_modules = os.path.join(sphinx, 'modules.rst')
+    rst_hello = os.path.join(sphinx, 'HelloWorld.rst')
+
+    # commands
+    genapi = 'sphinx-apidoc --doc-project="API" --force -o sphinx . setup.py ' \
+             'release.py '
+    genhtml = 'make html'
+    genepub = 'make epub'
+
+    # execute
+    if os.path.exists(docs):
+        shutil.rmtree(docs)
+
+    if not os.path.exists(docs):
+        os.makedirs(docs)
+
+    with cd(here):
+        os.system(genapi)
+
+    with cd(sphinx):
+        os.system(genhtml)
+
+    os.rename(html_source, html_target)
+
+    with cd(sphinx):
+        os.system(genepub)
+
+    os.rename(epub_source, epub_target)
+
+    # cleanup autogenerated rst files
+    os.remove(rst_challenges)
+    os.remove(rst_hello)
+    os.remove(rst_modules)
+
+class cd:
+    """Context manager for changing the current working directory"""
+
+    def __init__(self, newPath):
+        self.newPath = os.path.realpath(newPath)
+
+    def __enter__(self):
+        self.savedPath = os.getcwd()
+        os.chdir(self.newPath)
+
+    def __exit__(self, etype, value, traceback):
+        os.chdir(self.savedPath)
+
+if __name__ == '__main__':
+    main()

setup.py

@@ -1,25 +1,35 @@
 #!/usr/bin/env  python3
 
-from os.path import dirname, realpath
-
 from setuptools import setup
+# To use a consistent encoding
+from codecs import open
+from os import path
 
-version_file = realpath(dirname(__file__)) + '/version.txt'
+here = path.abspath(path.dirname(__file__))
 
-with open(version_file) as f:
+# Read version from central version file
+with open(path.join(here, 'version.txt'), encoding='utf-8') as f:
     version = f.read().strip()
 
+# Get the long description from the README file
+with open(path.join(here, 'README.rst'), encoding='utf-8') as f:
+    long_description = f.read()
+
 setup(
     name='challenges',
     version=version,
     description='Library to assist programming, testing and execution '
                 + 'of solutions for coding challenges like those on '
                   'stepik.org',
+    long_description=long_description,
+    keywords='education stepik coursera bioinformatics challenges',
     url='https://github.com/elmar-hinz/Python.Challenges',
     author='Elmar Hinz',
     author_email='t3elmar@gmail.com',
     license='MIT',
     packages=['challenges', 'HelloWorld'],
+    package_data={ 'HelloWorld': ['sample.txt', 'result.txt'], },
+    include_package_data=True,
     entry_points={
         'console_scripts': [
             'challenge=challenges.main:main',