@@ -4,6 +4,10 @@ All notable changes to miniver will be documented in this file.

 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),

 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

+## [Unreleased]

+### Changed

+- Replace tool "install-miniver" with a tool "miniver" with a command "install"

+

 ## [0.6.0] - 2019-02-17

 ### Fixed

 - Typos in generated files (comments only)

@@ -35,7 +35,7 @@ works with Python 2](https://github.com/cmarquardt/miniver2)

 ## Usage

 The simplest way to use Miniver is to run the following in your project root:

 ```

-curl https://raw.githubusercontent.com/jbweston/miniver/master/install-miniver | python - <your_package_directory>

+curl https://raw.githubusercontent.com/jbweston/miniver/master/bin/miniver | python - install <your_package_directory>

 ```

 This will grab the latest files from GitHub and set up Miniver for your project.

@@ -52,10 +52,10 @@ curl https://raw.githubusercontent.com/jbweston/miniver/master/unannotated-tags.

 ```

 ### I don't want to type that URL every time I use this

-You can `pip install miniver`, which will give you the `install-miniver` script.

+You can `pip install miniver`, which will give you the `miniver` command.

 Then you can simply run the following from your project root to use Miniver:

 ```

-install-miniver <your_package_directory>

+miniver install <your_package_directory>

 ```

 ### Can I use this without executing random code from the internet?

similarity index 86%

rename from install-miniver

rename to bin/miniver

@@ -132,19 +132,24 @@ def extract_miniver_from_local():

     ]

-def get_args():

-    parser = argparse.ArgumentParser(

-        description="Install 'miniver' into the current Python package"

-    )

+def get_parser():

+    parser = argparse.ArgumentParser(description="Interact with miniver")

     parser.add_argument("-v", "--version", action="version", version=_miniver_version)

-    parser.add_argument(

+    # TODO: when we can depend on Python 3.7 make this "add_subparsers(required=True)"

+    subparsers = parser.add_subparsers()

+    # 'install' command

+    install_parser = subparsers.add_parser(

+        "install", help="Install miniver into the current Python package"

+    )

+    install_parser.add_argument(

         "package_directory", help="Directory to install 'miniver' into."

     )

-    return parser.parse_args().package_directory

+    install_parser.set_defaults(dispatch=install)

+    return parser

-def main():

-    package_dir = get_args()

+def install(args):

+    package_dir = args.package_directory

     if not os.path.isdir(package_dir):

         _fail("Directory '{}' does not exist".format(package_dir))

     if package_dir != os.path.relpath(package_dir):

@@ -186,5 +191,16 @@ def main():

     print("\n".join((msg, _setup_template)).format(package_dir=package_dir))

+def main():

+    parser = get_parser()

+    args = parser.parse_args()

+    # TODO: remove this check when we can rely on Python 3.7 and

+    #       can make subparsers required.

+    if "dispatch" in args:

+        args.dispatch(args)

+    else:

+        parser.parse_args(['-h'])

+

+

 if __name__ == "__main__":

     main()

@@ -43,5 +43,5 @@ setup(

     ],

     packages=find_packages('.'),

     cmdclass=cmdclass,

-    scripts=['install-miniver']

+    scripts=['bin/miniver']

 )