feat(forms): add create, edit, and embed commands

Add full CRUD support for forms (create via POST /forms/new, edit via
PATCH /forms/{id}/edit) and an embed command that generates JS script
tag, iframe, or raw HTML embed codes matching the Mautic UI output.

Bump version to 0.1.4.

Author: introfini

README.md

@@ -24,7 +24,7 @@
 | **Segments** | List, create, edit, delete, add/remove contacts |
 | **Emails** | List, create, edit, send to contact, send to segment |
 | **Campaigns** | List, create, edit, delete, clone (7+), add/remove contacts |
-| **Forms** | List, get, submissions, delete |
+| **Forms** | List, create, edit, delete, submissions, embed code |
 | **Companies** | List, get, create, edit, delete, add/remove contacts |
 | **Notes** | List (per contact), get, create |
 | **Stages** | List, set contact stage |
@@ -111,7 +111,13 @@ mautic campaigns clone 1    # Mautic 7+ only
 ```bash
 mautic forms list
 mautic forms get 1
+mautic forms create --json @form.json
+mautic forms edit 1 --json '{"name":"Updated Form"}'
 mautic forms submissions 1
+mautic forms embed 1                    # show JS + iframe embed codes
+mautic forms embed 1 --type js          # script tag only
+mautic forms embed 1 --type iframe      # iframe only
+mautic forms embed 1 --type html        # raw cached HTML
 mautic forms delete 1
 ```
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mautic-cli"
-version = "0.1.3"
+version = "0.1.4"
 description = "Control Mautic from the command line or any AI coding agent."
 readme = "README.md"
 license = "MIT"

skills/mautic/SKILL.md

@@ -118,7 +118,10 @@ mautic campaigns remove-contact <CAMPAIGN_ID> <CONTACT_ID>
 ```bash
 mautic forms list [--search QUERY] [--limit N] [--offset N]
 mautic forms get <ID>
+mautic forms create --json '<DATA>'
+mautic forms edit <ID> --json '<DATA>'
 mautic forms submissions <ID> [--limit N]
+mautic forms embed <ID> [--type js|iframe|html]
 mautic forms delete <ID>
 ```
 

src/mautic_cli/commands/forms.py

@@ -1,9 +1,13 @@
 from __future__ import annotations
 
+import json as json_mod
+from urllib.parse import urlparse
+
 import click
 
 from mautic_cli.context import pass_context, MauticContext
 from mautic_cli.client import MauticApiError
+from mautic_cli.json_input import parse_json_input
 
 
 @click.group()
@@ -58,6 +62,72 @@ def submissions(mctx: MauticContext, id, limit):
         raise SystemExit(1)
 
 
+@forms.command()
+@click.option("--json", "json_str", required=True, help="JSON data or @file.")
+@pass_context
+def create(mctx: MauticContext, json_str):
+    """Create a new form."""
+    try:
+        payload = parse_json_input(json_str)
+        data = mctx.client.post("/forms/new", json=payload)
+        mctx.output(data)
+    except MauticApiError as e:
+        mctx.error(e)
+        raise SystemExit(1)
+
+
+@forms.command()
+@click.argument("id", type=int)
+@click.option("--json", "json_str", required=True, help="JSON data or @file.")
+@pass_context
+def edit(mctx: MauticContext, id, json_str):
+    """Edit an existing form."""
+    try:
+        payload = parse_json_input(json_str)
+        data = mctx.client.patch(f"/forms/{id}/edit", json=payload)
+        mctx.output(data)
+    except MauticApiError as e:
+        mctx.error(e)
+        raise SystemExit(1)
+
+
+@forms.command()
+@click.argument("id", type=int)
+@click.option("--type", "embed_type", default=None, type=click.Choice(["js", "iframe", "html"]),
+              help="Embed type: js (script tag), iframe, or html (raw cachedHtml). Omit to show all.")
+@pass_context
+def embed(mctx: MauticContext, id, embed_type):
+    """Get form embed code."""
+    base = mctx.client.base_url.rstrip("/")
+    parsed = urlparse(base)
+    host = parsed.hostname
+    if parsed.port and parsed.port not in (80, 443):
+        host = f"{host}:{parsed.port}"
+
+    js_code = f'<script type="text/javascript" src="//{host}/form/generate.js?id={id}"></script>'
+    iframe_code = (f'<iframe src="//{host}/form/{id}" width="300" height="300">'
+                   f"<p>Your browser does not support iframes.</p></iframe>")
+
+    if embed_type == "js":
+        click.echo(js_code)
+    elif embed_type == "iframe":
+        click.echo(iframe_code)
+    elif embed_type == "html":
+        try:
+            data = mctx.client.get(f"/forms/{id}")
+            form = data.get("form", data)
+            click.echo(form.get("cachedHtml", ""))
+        except MauticApiError as e:
+            mctx.error(e)
+            raise SystemExit(1)
+    else:
+        click.echo("Via Javascript (recommended)")
+        click.echo(js_code)
+        click.echo()
+        click.echo("Via iframe")
+        click.echo(iframe_code)
+
+
 @forms.command()
 @click.argument("id", type=int)
 @pass_context

tests/test_cli.py

@@ -7,7 +7,7 @@ def test_version_flag():
     runner = CliRunner()
     result = runner.invoke(cli, ["--version"])
     assert result.exit_code == 0
-    assert "0.1.0" in result.output
+    assert "mautic-cli, version" in result.output
 
 
 def test_help_shows_global_flags():

tests/test_forms.py

@@ -51,6 +51,71 @@ def test_form_submissions(self):
         result = runner.invoke(cli, ["forms", "submissions", "1"])
         assert result.exit_code == 0
 
+    @respx.mock
+    def test_create_form(self):
+        respx.post("https://mautic.test/api/forms/new").mock(
+            return_value=httpx.Response(200, json={
+                "form": {"id": 5, "name": "New Form"},
+            })
+        )
+        runner = CliRunner(env=MOCK_ENV)
+        result = runner.invoke(cli, [
+            "forms", "create",
+            "--json", '{"name": "New Form", "formType": "standalone", "postAction": "message", "postActionProperty": "Thanks!"}'
+        ])
+        assert result.exit_code == 0
+        data = json.loads(result.output)
+        assert data["form"]["name"] == "New Form"
+
+    @respx.mock
+    def test_edit_form(self):
+        respx.patch("https://mautic.test/api/forms/5/edit").mock(
+            return_value=httpx.Response(200, json={
+                "form": {"id": 5, "name": "Updated Form"},
+            })
+        )
+        runner = CliRunner(env=MOCK_ENV)
+        result = runner.invoke(cli, [
+            "forms", "edit", "5",
+            "--json", '{"name": "Updated Form"}'
+        ])
+        assert result.exit_code == 0
+        data = json.loads(result.output)
+        assert data["form"]["name"] == "Updated Form"
+
+    def test_embed_default(self):
+        runner = CliRunner(env=MOCK_ENV)
+        result = runner.invoke(cli, ["forms", "embed", "4"])
+        assert result.exit_code == 0
+        assert "Via Javascript (recommended)" in result.output
+        assert "Via iframe" in result.output
+        assert "generate.js?id=4" in result.output
+        assert 'src="//mautic.test/form/4"' in result.output
+
+    def test_embed_js(self):
+        runner = CliRunner(env=MOCK_ENV)
+        result = runner.invoke(cli, ["forms", "embed", "4", "--type", "js"])
+        assert result.exit_code == 0
+        assert result.output.strip() == '<script type="text/javascript" src="//mautic.test/form/generate.js?id=4"></script>'
+
+    def test_embed_iframe(self):
+        runner = CliRunner(env=MOCK_ENV)
+        result = runner.invoke(cli, ["forms", "embed", "4", "--type", "iframe"])
+        assert result.exit_code == 0
+        assert 'src="//mautic.test/form/4"' in result.output
+
+    @respx.mock
+    def test_embed_html(self):
+        respx.get("https://mautic.test/api/forms/4").mock(
+            return_value=httpx.Response(200, json={
+                "form": {"id": 4, "name": "Test", "cachedHtml": "<div>form html</div>"},
+            })
+        )
+        runner = CliRunner(env=MOCK_ENV)
+        result = runner.invoke(cli, ["forms", "embed", "4", "--type", "html"])
+        assert result.exit_code == 0
+        assert result.output.strip() == "<div>form html</div>"
+
     @respx.mock
     def test_delete_form(self):
         respx.delete("https://mautic.test/api/forms/1/delete").mock(