docs(cli[copy,delete,new,stop]): Add doctests to create_*_subparser functions

why: CLAUDE.md requires doctests on all functions; the 4 new CLI files
had none.
what:
- Add doctest to create_copy_subparser (source/destination args)
- Add doctest to create_delete_subparser (workspace_names, answer_yes)
- Add doctest to create_new_subparser (workspace_name arg)
- Add doctest to create_stop_subparser (session_name arg)

Author: tony

src/tmuxp/cli/copy.py

@@ -43,7 +43,16 @@
 def create_copy_subparser(
     parser: argparse.ArgumentParser,
 ) -> argparse.ArgumentParser:
-    """Augment :class:`argparse.ArgumentParser` with ``copy`` subcommand."""
+    """Augment :class:`argparse.ArgumentParser` with ``copy`` subcommand.
+
+    Examples
+    --------
+    >>> import argparse
+    >>> parser = create_copy_subparser(argparse.ArgumentParser())
+    >>> args = parser.parse_args(["src", "dst"])
+    >>> args.source, args.destination
+    ('src', 'dst')
+    """
     parser.add_argument(
         dest="source",
         metavar="source",

src/tmuxp/cli/delete.py

@@ -42,7 +42,18 @@
 def create_delete_subparser(
     parser: argparse.ArgumentParser,
 ) -> argparse.ArgumentParser:
-    """Augment :class:`argparse.ArgumentParser` with ``delete`` subcommand."""
+    """Augment :class:`argparse.ArgumentParser` with ``delete`` subcommand.
+
+    Examples
+    --------
+    >>> import argparse
+    >>> parser = create_delete_subparser(argparse.ArgumentParser())
+    >>> args = parser.parse_args(["proj1", "proj2", "-y"])
+    >>> args.workspace_names
+    ['proj1', 'proj2']
+    >>> args.answer_yes
+    True
+    """
     parser.add_argument(
         dest="workspace_names",
         metavar="workspace-name",

src/tmuxp/cli/new.py

@@ -50,7 +50,16 @@
 def create_new_subparser(
     parser: argparse.ArgumentParser,
 ) -> argparse.ArgumentParser:
-    """Augment :class:`argparse.ArgumentParser` with ``new`` subcommand."""
+    """Augment :class:`argparse.ArgumentParser` with ``new`` subcommand.
+
+    Examples
+    --------
+    >>> import argparse
+    >>> parser = create_new_subparser(argparse.ArgumentParser())
+    >>> args = parser.parse_args(["myproject"])
+    >>> args.workspace_name
+    'myproject'
+    """
     parser.add_argument(
         dest="workspace_name",
         metavar="workspace-name",

src/tmuxp/cli/stop.py

@@ -47,7 +47,16 @@ class CLIStopNamespace(argparse.Namespace):
 def create_stop_subparser(
     parser: argparse.ArgumentParser,
 ) -> argparse.ArgumentParser:
-    """Augment :class:`argparse.ArgumentParser` with ``stop`` subcommand."""
+    """Augment :class:`argparse.ArgumentParser` with ``stop`` subcommand.
+
+    Examples
+    --------
+    >>> import argparse
+    >>> parser = create_stop_subparser(argparse.ArgumentParser())
+    >>> args = parser.parse_args(["mysession"])
+    >>> args.session_name
+    'mysession'
+    """
     parser.add_argument(
         dest="session_name",
         metavar="session-name",