make dist -> for release

Add extras to make it releasable

.gitignore

@@ -4,7 +4,8 @@ __pycache__
 .coverage
 pip-selfcheck.json
 .Python
-example_service.egg-info
+*.egg-info
+dist/
 docs/build/
 src
 bin

Makefile

@@ -5,7 +5,7 @@ PYTHON = $(BIN)/python
 
 INSTALL = $(BIN)/pip install --no-deps
 
-.PHONY: all test docs build_extras
+.PHONY: all test docs build_extras dist build
 
 all: build
 
@@ -26,4 +26,8 @@ test: build test_dependencies
 	$(BIN)/tox
 
 run:
-	FLASK_APP=example_service bin/flask run
+	FLASK_APP=example_service bin/flask run
+
+dist:
+	$(INSTALL) wheel
+	$(PYTHON) setup.py sdist bdist_wheel

example_service/__init__.py

@@ -1 +1,3 @@
-from example_service.app import app  # NOQA
+# from example_service.app import app  # NOQA
+
+__version__ = '0.1'

example_service/app.py

@@ -3,12 +3,22 @@
 from konfig import Config
 from example_service.endpoints import blueprints
 
-settings = os.path.join(os.path.dirname(__file__), 'settings.ini')
-settings = os.environ.get('FLASK_SETTINGS', settings)
 
-app = Flask(__name__)
-app.config_file = Config(settings)
-app.config.update(app.config_file.get_map('flask'))
+def create():
+    settings = os.path.join(os.path.dirname(__file__), 'settings.ini')
+    settings = os.environ.get('FLASK_SETTINGS', settings)
 
-for blueprint in blueprints:
-    app.register_blueprint(blueprint['pkg'], url_prefix=blueprint['prefix'])
+    app = Flask(__name__)
+    app.config_file = Config(settings)
+    app.config.update(app.config_file.get_map('flask'))
+
+    for blueprint in blueprints:
+        app.register_blueprint(blueprint['pkg'],
+                               url_prefix=blueprint['prefix'])
+
+    return app
+
+
+if __name__ == '__main__':
+    app = create()
+    app.run()

example_service/run.py

@@ -0,0 +1,39 @@
+import argparse
+import sys
+import os
+import signal
+from .app import create
+
+
+def _quit(signal, frame):
+    print('Shutting down!')
+    sys.exit(0)
+
+
+def main(args=sys.argv[1:]):
+    parser = argparse.ArgumentParser(description='Service Example')
+    parser.add_argument('--config-file', help='Config file',
+                        type=str, default=None)
+    args = parser.parse_args(args=args)
+
+    if args.config_file is not None:
+        os.environ.set('FLASK_SETTINGS', args.config_file)
+
+    app = create()
+
+    host = app.config.get('host', '0.0.0.0')
+    host = os.environ.get('HOST', host)
+
+    port = app.config.get('port', 5000)
+    port = os.environ.get('PORT', port)
+
+    debug = app.config.get('DEBUG', False)
+
+    signal.signal(signal.SIGINT, _quit)
+    signal.signal(signal.SIGTERM, _quit)
+
+    app.run(debug=debug, host=host, port=port)
+
+
+if __name__ == "__main__":
+    main()

setup.py

@@ -1,5 +1,5 @@
 from setuptools import setup, find_packages
-
+from example_service import __version__
 
 def requirements():
     with open('requirements.txt') as f:
@@ -8,8 +8,12 @@ def requirements():
 
 
 setup(name='example_service',
-      version="0.1",
+      version=__version__,
       packages=find_packages(),
       zip_safe=False,
       include_package_data=True,
-      install_requires=requirements())
+      install_requires=requirements(),
+      entry_points="""
+      [console_scripts]
+      example-service = example_service.run:main
+      """)

tests/endpoints/test_main.py

@@ -1,10 +1,11 @@
 import os
 import unittest
-from example_service import app
+from example_service.app import create
 
 
 class TestMain(unittest.TestCase):
     def setUp(self):
+        app = create()
         app.config['TESTING'] = True
         app.config['WTF_CSRF_ENABLED'] = False
         app.config['DEBUG'] = False
@@ -26,4 +27,4 @@ def test_index(self):
 
 
 if __name__ == "__main__":
-    unittest.main()
+    unittest.main()