api/flake/add: init

Adds an endpoint to memoize clans.
clan flakes can be added to the history either via the endpoint or by executing `clan flakes add`

pkgs/clan-cli/clan_cli/flakes/__init__.py

@@ -1,6 +1,8 @@
 # !/usr/bin/env python3
 import argparse
 
+from clan_cli.flakes.add import register_add_parser
+
 from .create import register_create_parser
 
 
@@ -14,3 +16,5 @@ def register_parser(parser: argparse.ArgumentParser) -> None:
     )
     create_parser = subparser.add_parser("create", help="Create a clan flake")
     register_create_parser(create_parser)
+    add_parser = subparser.add_parser("add", help="Add a clan flake")
+    register_add_parser(add_parser)

pkgs/clan-cli/clan_cli/flakes/add.py

@@ -0,0 +1,35 @@
+# !/usr/bin/env python3
+import argparse
+from pathlib import Path
+from typing import Dict
+
+from pydantic import AnyUrl
+from pydantic.tools import parse_obj_as
+
+from clan_cli.dirs import user_history_file
+
+from ..async_cmd import CmdOut, runforcli
+
+DEFAULT_URL: AnyUrl = parse_obj_as(
+    AnyUrl,
+    "git+https://git.clan.lol/clan/clan-core?new-clan",
+)
+
+
+async def add_flake(path: Path) -> Dict[str, CmdOut]:
+    user_history_file().parent.mkdir(parents=True, exist_ok=True)
+    # append line to history file
+    # TODO: Is this atomic?
+    with open(user_history_file(), "a+") as f:
+        f.write(f"{path}\n")
+    return {}
+
+
+def add_flake_command(args: argparse.Namespace) -> None:
+    runforcli(add_flake, args.path)
+
+
+# takes a (sub)parser and configures it
+def register_add_parser(parser: argparse.ArgumentParser) -> None:
+    parser.add_argument("path", type=Path, help="Path to the flake", default=Path("."))
+    parser.set_defaults(func=add_flake_command)