Merge pull request #281 from BrianPugh/app-update

Add App.update method.

cyclopts/core.py

@@ -1349,6 +1349,18 @@ def default_dispatcher(command, bound, _):
             except Exception:
                 print(traceback.format_exc())
 
+    def update(self, app: "App"):
+        """Copy over all commands from another :class:`App`.
+
+        Commands from the meta app will **not** be copied over.
+
+        Parameters
+        ----------
+        app: cyclopts.App
+            All commands from this application will be copied over.
+        """
+        self._commands.update(app._commands)
+
     def __repr__(self):
         """Only shows non-default values."""
         non_defaults = {}

docs/source/api.rst

@@ -5,7 +5,7 @@ API
 ===
 
 .. autoclass:: cyclopts.App
-   :members: default, command, version_print, help_print, interactive_shell, parse_commands, parse_known_args, parse_args, assemble_argument_collection
+   :members: default, command, version_print, help_print, interactive_shell, parse_commands, parse_known_args, parse_args, assemble_argument_collection, update
    :special-members: __call__, __getitem__, __iter__
 
    Cyclopts Application.

tests/test_app_utils.py

@@ -1,3 +1,6 @@
+from cyclopts import App
+
+
 def test_app_iter(app):
     """Like a dictionary, __iter__ of an App should yield keys (command names)."""
 
@@ -31,3 +34,20 @@ def fizz():
 
     actual = list(app.meta)
     assert actual == ["--help", "-h", "--version", "fizz", "foo", "bar"]
+
+
+def test_app_update():
+    app1 = App()
+    app2 = App()
+
+    @app1.command
+    def foo():
+        pass
+
+    @app2.command
+    def bar():
+        pass
+
+    app1.update(app2)
+
+    assert list(app1) == ["--help", "-h", "--version", "foo", "bar"]