Expose geozones executable through setuptools

LISEZMOI.md

@@ -43,8 +43,8 @@ $ git clone https://github.com/etalab/geozones.git
 $ cd geozones
 $ virtualenv -p /bin/python3 .
 $ source bin/activate
-$ pip install -r requirements.pip
-$ ./geozones.py
+$ pip install -e .
+$ geozones -h
 ```
 
 ## Modèle

README.md

@@ -34,8 +34,8 @@ $ git clone https://github.com/etalab/geozones.git
 $ cd geozones
 $ virtualenv -p /bin/python3 .
 $ source bin/activate
-$ pip install -r requirements.pip
-$ ./geozones.py
+$ pip install -e .
+$ geozones -h
 ```
 
 ## Model
@@ -122,6 +122,8 @@ Level names and some territories are translatable. They are provided as _gettext
 Here’s the workflow:
 
 ```bash
+# Ensure you have the optionnal tools to process translations
+$ pip install -e .[i18n]
 # Extract translatabls labels
 $ pybabel extract -F babel.cfg -o geozones/translations/geozones.pot .
 # Push updated translations template to Transifex
@@ -144,7 +146,7 @@ $ tx push -t -l <language code>
 A set of commands are provided for the build process. You can list them all with:
 
 ```bash
-$ ./geozones.py --help
+$ geozones --help
 ```
 
 ### `download`
@@ -175,7 +177,7 @@ All in one task equivalent to:
 
 ```bash
 # Perform all tasks from download to distibution
-$ ./geozones.py download load aggregate postprocess dist
+$ geozones download load aggregate postprocess dist
 ```
 
 ### `explore`
@@ -190,7 +192,7 @@ Commands are chainable so you can write:
 
 ```bash
 # Perform all tasks from download to distibution
-$ ./geozones.py download load -d aggregate postprocess dist dist -s status
+$ geozones download load -d aggregate postprocess dist dist -s status
 ```
 
 ### `sourceslist`
@@ -202,7 +204,7 @@ This allows using an external download manager by example.
 **Ex:** using 10 parallels threads with curl:
 
 ```bash
-./geozones.py sourceslist | xargs -P 10 -n 1 curl -O
+mkdir download && cd download && geozones sourceslist | xargs -P 10 -n 1 curl -O
 ```
 
 ## Options

geozones/__main__.py

@@ -52,6 +52,7 @@ def downloadable_urls(ctx):
               help='Specify GeoZones working home')
 @click.pass_context
 def cli(ctx, level, home):
+    ctx.obj = {}
     if home:
         os.chdir(home)
     else:
@@ -408,4 +409,4 @@ def explore(debug, launch):
 
 
 if __name__ == '__main__':
-    cli(obj={})
+    cli()

setup.py

@@ -0,0 +1,25 @@
+from setuptools import setup, find_packages
+
+setup(
+    name='geozones',
+    version='1.0.0',
+    packages=find_packages(),
+    include_package_data=True,
+    install_requires=[
+        'click>=4.0',
+        'colorama>=0.3.3',
+        'Fiona==1.7.5',
+        'msgpack-python==0.4.7',
+        'pymongo>=3.0',
+        'Shapely==1.5.17',
+        'Flask',
+        'requests',
+    ],
+    extras_require={
+        'i18n': ['transifex-client==0.11.1b0', 'Babel>=1.3']
+    },
+    entry_points='''
+        [console_scripts]
+        geozones=geozones.__main__:cli
+    ''',
+)