Initial version

Author: darkclouder

LICENSE

@@ -0,0 +1,25 @@
+BSD 2-Clause License
+
+Copyright (c) 2018, darkclouder
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

README.md

@@ -0,0 +1,3 @@
+# cli-context
+This is a library which supports CLI contexts for action hierarchies.
+For that, you have to use the `CliContext` class and create your own contexts.

cli-context/__init__.py

@@ -0,0 +1,42 @@
+class CliContext:
+    def __init__(self, description, action=None, sub_contexts=None):
+        self.description = description
+        self.action = action
+
+        if self.action is None:
+            self.sub_contexts = sub_contexts
+
+    def run(self, program, args):
+        if self.action is not None:
+            return self.action(program, args)
+        else:
+            if len(args) == 0:
+                self.print_help(program)
+            else:
+                cmd, sub_args = args[0], args[1:]
+
+                if cmd == "-h" or cmd == "--help":
+                    self.print_help(program)
+                elif cmd in self.sub_contexts:
+                    if self.sub_contexts[cmd].run(program + (cmd,), sub_args):
+                        self.print_help(program)
+                else:
+                    print("Invalid command %s" % cmd)
+                    self.print_help(program)
+
+    def print_help(self, program):
+        if self.sub_contexts is not None:
+            program_str = " ".join(program)
+
+            print("usage: %s <command> [<args>]" % program_str)
+
+            if len(self.sub_contexts) > 0:
+                print("\nCommands:")
+                for (cmd, context) in self.sub_contexts.items():
+                    print("%s - %s" % (cmd, context.description))
+
+                print(
+                    "\nFor detailed help of each command enter {0} <command> --help,\ne.g. {0} {1} --help".format(
+                        program_str, next(iter(self.sub_contexts))
+                    )
+                )

cli-context/cli_context.py

@@ -0,0 +1,21 @@
+from setuptools import setup, find_packages
+
+
+setup(
+    name="cli-context",
+    version="0.1.0",
+    description="Hierarchical CLI creator",
+    long_description="".join([
+        "Library which supports CLI contexts for action hierarchies",
+    ]),
+    url="https://github.com/darkclouder/cli-context",
+    author="darkclouder",
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: BSD License",
+        "Programming Language :: Python :: 3.6",
+        "Topic :: Software Development :: Libraries",
+    ],
+    packages=find_packages(exclude=["contrib", "docs", "tests*"]),
+)