Remove support for passing post data as arguments

Temporarily deprecate support for passing post data as arguments. This was mainly because of strange Typer error "RuntimeError: Type not yet supported: <class 'typer.models.Context'>" when elapi is run on Python 3.9. Upon diagnosing, the culprit turned out to be the use of typer.Context which elapi cli post command was using. typer.Context works fine on Python 3.11.

Support for said feature should be brought back once Python 3.11 becomes the default on Debian.

Author: mhxion

README.md

@@ -89,8 +89,7 @@ $ elapi get experiments --export ~/Downoads/experiments.json
 We can create a new user by the name 'John Doe'.
 
 ```shell
-$ elapi post users --firstname John --lastname Doe --email "test_test@example.com" --usergroup 4
-# usergroup 4 refers to the user's permission group
+$ elapi post users -d '{"firstname": "John", "lastname": "Doe", "email": "test_test@itnerd.de"}'
 ```
 
 ### Bill teams

src/elapi/cli/_doc.py

@@ -14,10 +14,12 @@
                    "ID will be returned. E.g., user ID, team ID, experiments ID.",
     "unit_id_post": "ID for one of the preceding endpoints. If provided, `POST` request will be made against that "
                     "specific ID. E.g., events ID,.",
-    "data": f"HTTP POST data. There are two ways to pass the data. 1. With `--data` or `-d` option followed "
-            f"by the JSON content like with `curl`. E.g., "
-            f"`{APP_NAME} post teams -d '{{\"name\": \"Alpha\"}}'`, 2. As regular options. E.g., "
-            f"`{APP_NAME} post teams --name Alpha`.",
+    # "data": f"HTTP POST data. There are two ways to pass the data. 1. With `--data` or `-d` option followed "
+    #         f"by the JSON content like with `curl`. E.g., "
+    #         f"`{APP_NAME} post teams -d '{{\"name\": \"Alpha\"}}'`, 2. As regular options. E.g., "
+    #         f"`{APP_NAME} post teams --name Alpha`.",
+    "data": f"HTTP POST data. This works similar to how data is passed to `curl`. E.g., "
+            f"`{APP_NAME} post teams -d '{{\"name\": \"Alpha\"}}'`,",
     "export": "Export output to a location.\n",
     "invoice_export": "Export output to a location. Invoices are **always exported** by default.\n",
     "export_details": f"- If _'--export'_ is passed without any following value, then it acts as a flag, and "

src/elapi/cli/elapi.py

@@ -173,8 +173,8 @@ def post(
     ] = None,
     json_: Annotated[
         str, typer.Option("--data", "-d", help=docs["data"], show_default=False)
-    ] = "",
-    data: typer.Context = None,
+    ],
+    # data: typer.Context = None,  TODO: To be re-enabled in Python 3.11
     data_format: Annotated[
         str,
         typer.Option("--format", "-F", help=docs["data_format"], show_default=False),
@@ -192,7 +192,7 @@ def post(
 
     With `elapi` you can do the following:
     <br/>
-    `$ elapi post users --firstname John --lastname Doe --email "john_doe@email.com"` will create a new user.
+    `$ elapi post users -d '{"firstname": "John", "lastname": "Doe", "email": "test_test@itnerd.de"}'` will create a new user.
     """
     import ast
     from ..api import POSTRequest
@@ -203,12 +203,14 @@ def post(
     validate_config = Validate(HostIdentityValidator())
     validate_config()
 
-    if json_:
-        valid_data: dict = ast.literal_eval(json_)
-    else:
-        data_keys: list[str, ...] = [_.removeprefix("--") for _ in data.args[::2]]
-        data_values: list[str, ...] = data.args[1::2]
-        valid_data: dict[str:str, ...] = dict(zip(data_keys, data_values))
+    # if json_:
+    valid_data: dict = ast.literal_eval(json_)
+    # else:
+    # TODO: Due to strange compatibility issue between typer.context and python 3.9,
+    #   passing json_ as arguments is temporarily deprecated.
+    # data_keys: list[str, ...] = [_.removeprefix("--") for _ in data.args[::2]]
+    # data_values: list[str, ...] = data.args[1::2]
+    # valid_data: dict[str:str, ...] = dict(zip(data_keys, data_values))
     session = POSTRequest()
     raw_response = session(endpoint, unit_id, **valid_data)
     format = Format(data_format)