Improve serve command

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+### 24.9.5 [#771](https://github.com/openfisca/openfisca-core/pull/771)
+
+- Improve serve command by documenting the bind option
+- Avoid crashing when no arguments are supplied
+
 ### 24.9.4 [#774](https://github.com/openfisca/openfisca-core/pull/774)
 
 - Clarify the error message when assigning a value larger than MaxInt32 to an 'int' variable

openfisca_core/scripts/openfisca_command.py

@@ -13,8 +13,9 @@
 def get_parser():
     parser = argparse.ArgumentParser()
 
-    subparsers = parser.add_subparsers(help='Available commands')
-    parser_serve = subparsers.add_parser('serve', help='Run the OpenFisca Web API')
+    subparsers = parser.add_subparsers(help = 'Available commands', dest = 'command')
+    subparsers.required = True  # Can be added as an argument of add_subparsers in Python 3
+    parser_serve = subparsers.add_parser('serve', help = 'Run the OpenFisca Web API')
     parser_serve = define_command_line_options(parser_serve)
 
     return parser

openfisca_web_api/scripts/serve.py

@@ -34,7 +34,7 @@ def define_command_line_options(parser):
     parser = add_tax_benefit_system_arguments(parser)
 
     # Define server configuration
-    parser.add_argument('-p', '--port', action = 'store', help = "port to serve on", type = int)
+    parser.add_argument('-p', '--port', action = 'store', help = "port to serve on (use --bind to specify host and port)", type = int)
     parser.add_argument('--tracker-url', action = 'store', help = "tracking service url", type = str)
     parser.add_argument('--tracker-idsite', action = 'store', help = "tracking service id site", type = int)
     parser.add_argument('--tracker-token', action = 'store', help = "tracking service authentication token", type = str)

setup.py

@@ -37,7 +37,7 @@
 
 setup(
     name = 'OpenFisca-Core',
-    version = '24.9.5',
+    version = '24.9.6',
     author = 'OpenFisca Team',
     author_email = 'contact@openfisca.org',
     classifiers = [