feat: basic prototype of cli working

subcommands have been setup in accordance to the documentation with typer
routing the cardholder commands and then fetching the data via the client
rich is rendering tables to the terminal

REFS #13

gallagher/cli/__init__.py

@@ -15,14 +15,6 @@
 app.add_typer(cardholders_app, name="ch")
 
 
-@app.command()
-def echo(name: str):
-    """
-
-    """
-    typer.echo("Hello World")
-
-
 if __name__ == "__main__":
     """ In case you are invoking this via Python directly
 

gallagher/cli/cardholders.py

@@ -2,5 +2,39 @@
 
 """
 import typer
+from rich.console import Console
+from rich.table import Table
 
-app = typer.Typer()
+from gallagher.cc.cardholders.cardholders import Cardholder
+
+app = typer.Typer(help="query or manage cardholders")
+
+
+@app.command("summary")
+def summary():
+    """ list all cardholders
+    """
+    import os
+    api_key = os.environ.get("GACC_API_KEY")
+
+    from gallagher import cc
+    cc.api_key = api_key
+
+    cardholders = Cardholder.list()
+
+    table = Table(title="Cardholders")
+    for header in cardholders.cli_header:
+        table.add_column(header)
+
+    for row in cardholders.cli_repr:
+        table.add_row(*row)
+
+    console = Console()
+    console.print(table)
+
+
+@app.command("get")
+def get(id: int):
+    """ get a cardholder by id
+    """
+    typer.echo(f"Getting cardholder {id}")

gallagher/dto/cardholder.py

@@ -33,6 +33,16 @@ class CardholderSummary(
     description: Optional[str] = None
     authorised: bool
 
+    def cli_repr(self):
+        return [
+            self.first_name,
+            self.last_name,
+            "yes" if self.authorised else "no"
+        ]
+
+    def __str__(self):
+        return f"{self.id} {self.first_name} {self.last_name}"
+
 
 class CardholderDetail(
     CardholderSummary
@@ -63,3 +73,18 @@ class CardholderSummaryResponse(
 
     """
     results: list[CardholderSummary]
+
+    @property
+    def cli_header(self):
+        return [
+            "First name",
+            "Last name",
+            "Authorised"
+        ]
+
+    @property
+    def cli_repr(self):
+        return [x.cli_repr() for x in self.results]
+
+    def __str__(self):
+        return f"{len(self.results)} cardholders"

tests/__init__.py

@@ -5,6 +5,7 @@
 
 """
 
+
 def setup_module(module):
     """ The Gallagher API client requires a test key, this is 
     set in the environment variable GACC_API_KEY.
@@ -14,7 +15,7 @@ def setup_module(module):
     """
     import os
     api_key = os.environ.get("GACC_API_KEY")
-    
+
     from gallagher import cc
     cc.api_key = api_key