Support a custom root via '--root'

.appveyor.yml

@@ -23,3 +23,4 @@ build: off
 test_script:
   - make check
   - make test
+  - make demo

.travis.yml

@@ -20,6 +20,7 @@ install:
 script:
   - make check
   - make test
+  - make demo
 
 after_success:
   - pip install coveralls scrutinizer-ocular

Makefile

@@ -76,6 +76,14 @@ watch: install .clean-test ## Continuously run all CI tasks when files chanage
 run: install
 	$(PYTHON) $(PACKAGE)/__main__.py
 
+.PHONY: demo
+demo: install
+	$(BIN)/osmerge new --root=demo
+	# TODO: support these commands:
+	# $(BIN)/osmerge build --root=demo
+	# $(BIN)/osmerge update --root=demo
+	# $(BIN)/osmerge build --root=demo
+
 # SYSTEM DEPENDENCIES ##########################################################
 
 .PHONY: doctor

sample/Makefile → demo/Makefile

@@ -7,19 +7,19 @@ all: build
 build: docs/osmerge.geojson
 
 docs/osmerge.geojson: tmp/merged.json
-    osmerge convert $< $@
+	osmerge convert $< $@
 
 tmp/merged.json: tmp/filtered.json osmerge.csv
-    osmerge merge $< $@
+	osmerge merge $< $@
 
 tmp/filtered.json: tmp/base.json osmerge.yml
-    osmerge filter $< $@
+	osmerge filter $< $@
 
 tmp/base.json: osmerge.yml
-    osmerge download $@
+	osmerge download $@
 
 # CLEANUP ######################################################################
 
 .PHONY: clean
 clean:
-    rm -rf tmp
+	rm -rf tmp

osmerge/cli.py

@@ -1,6 +1,8 @@
 #!/usr/bin/env python
 
+import os
 import logging
+from pathlib import Path
 
 import click
 
@@ -11,19 +13,27 @@
 log = logging.getLogger(__name__)
 
 
-@click.group()
+@click.group(context_settings=dict(help_option_names=['-h', '--help']))
 @click.version_option(message=VERSION)
 def main():
     logging.basicConfig(level=logging.INFO)
     logging.getLogger('yorm').setLevel(logging.WARNING)
 
 
 @main.command()
-def new():
+@click.option('-r', '--root', type=Path, default=Path.cwd)
+def new(root):
+    _enter(root)
     Project.generate()
     Config.generate_example()
     Data.generate_example()
 
 
+def _enter(path):
+    """Create and enter the root directory."""
+    path.mkdir(parents=True, exist_ok=True)
+    os.chdir(str(path))
+
+
 if __name__ == '__main__':
     main()

tests/test_cli.py

@@ -50,3 +50,9 @@ def it_generates_a_sample_project(cli):
                 "osmerge.csv",  # data set
                 "osmerge.yml",  # config file
             ]
+
+        def it_can_be_run_from_a_custom_root(cli):
+            cmd = cli('new', '--root=foobar')
+
+            expect(cmd.returncode) == 0
+            expect(cmd.files_created).contains("foobar/docs/index.html")