pesa-cli 1.0.1__tar.gz → 1.0.2__tar.gz

{pesa_cli-1.0.1 → pesa_cli-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pesa-cli
-Version: 1.0.1
+Version: 1.0.2
 Summary: Command-line tool for M-Pesa Daraja v3 — STK Push, B2C, balance, config management.
 Author-email: Gabriel Mahia <contact@aikungfu.dev>
 License: CC-BY-NC-ND-4.0
@@ -183,3 +183,7 @@ if scripting against pesa-cli output is needed.
 
 *Part of the [nairobi-stack](https://github.com/gabrielmahia/nairobi-stack) East Africa engineering ecosystem.*
 *Maintained by [Gabriel Mahia](https://github.com/gabrielmahia). Kenya × USA.*
+
+## Getting sandbox credentials
+
+New to Daraja, or on a new machine? Follow [the sandbox setup guide](https://github.com/gabrielmahia/mpesa-python/blob/main/docs/SANDBOX_SETUP.md): it creates a free sandbox app and runs OAuth, an STK Push and a status query, with exact portal labels. Set `DARAJA_CALLBACK_URL` to a public HTTPS address you can watch (for example a webhook.site URL); without it the CLI uses a placeholder and tells you so.

{pesa_cli-1.0.1 → pesa_cli-1.0.2}/README.md

@@ -156,3 +156,7 @@ if scripting against pesa-cli output is needed.
 
 *Part of the [nairobi-stack](https://github.com/gabrielmahia/nairobi-stack) East Africa engineering ecosystem.*
 *Maintained by [Gabriel Mahia](https://github.com/gabrielmahia). Kenya × USA.*
+
+## Getting sandbox credentials
+
+New to Daraja, or on a new machine? Follow [the sandbox setup guide](https://github.com/gabrielmahia/mpesa-python/blob/main/docs/SANDBOX_SETUP.md): it creates a free sandbox app and runs OAuth, an STK Push and a status query, with exact portal labels. Set `DARAJA_CALLBACK_URL` to a public HTTPS address you can watch (for example a webhook.site URL); without it the CLI uses a placeholder and tells you so.

{pesa_cli-1.0.1 → pesa_cli-1.0.2}/pesa_cli/cli.py

@@ -240,7 +240,8 @@ def stk_push(
     consumer_secret = require_credential("consumer_secret", "Consumer Secret")
     shortcode       = require_credential("shortcode",       "Shortcode")
     passkey         = require_credential("passkey",         "Passkey")
-    callback_url    = get_credential("callback_url") or "https://example.com/mpesa/callback"
+    callback_given  = get_credential("callback_url")
+    callback_url    = callback_given or "https://example.com/mpesa/callback"
     ref = ref[:12]  # Daraja hard limit
 
     timestamp = datetime.now().strftime("%Y%m%d%H%M%S")
@@ -268,6 +269,11 @@ def stk_push(
 
     if response.get("ResponseCode") == "0":
         checkout_id = response.get("CheckoutRequestID", "")
+        # Without a callback URL Safaricom posts the result to a placeholder you cannot see; say so instead of failing silently.
+        notice = "" if callback_given else (
+            "\n\n[yellow]No callback URL set (DARAJA_CALLBACK_URL). Safaricom will post the result to "
+            f"{callback_url}, which you cannot see. Use 'pesa stk query' to check the outcome.[/yellow]"
+        )
         rprint(Panel(
             f"[green]✓ STK Push sent[/green]\n"
             f"Phone:       [cyan]+{phone}[/cyan]\n"
@@ -275,7 +281,7 @@ def stk_push(
             f"Reference:   [cyan]{ref}[/cyan]\n"
             f"Checkout ID: [dim]{checkout_id}[/dim]\n\n"
             f"[dim]The customer will receive a PIN prompt on their phone.[/dim]\n"
-            f"[dim]Run: pesa stk query {checkout_id}[/dim]",
+            f"[dim]Run: pesa stk query {checkout_id}[/dim]{notice}",
             title="STK Push", border_style="green",
         ))
     else:

{pesa_cli-1.0.1 → pesa_cli-1.0.2}/pesa_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pesa-cli
-Version: 1.0.1
+Version: 1.0.2
 Summary: Command-line tool for M-Pesa Daraja v3 — STK Push, B2C, balance, config management.
 Author-email: Gabriel Mahia <contact@aikungfu.dev>
 License: CC-BY-NC-ND-4.0
@@ -183,3 +183,7 @@ if scripting against pesa-cli output is needed.
 
 *Part of the [nairobi-stack](https://github.com/gabrielmahia/nairobi-stack) East Africa engineering ecosystem.*
 *Maintained by [Gabriel Mahia](https://github.com/gabrielmahia). Kenya × USA.*
+
+## Getting sandbox credentials
+
+New to Daraja, or on a new machine? Follow [the sandbox setup guide](https://github.com/gabrielmahia/mpesa-python/blob/main/docs/SANDBOX_SETUP.md): it creates a free sandbox app and runs OAuth, an STK Push and a status query, with exact portal labels. Set `DARAJA_CALLBACK_URL` to a public HTTPS address you can watch (for example a webhook.site URL); without it the CLI uses a placeholder and tells you so.

{pesa_cli-1.0.1 → pesa_cli-1.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pesa-cli"
-version = "1.0.1"
+version = "1.0.2"
 description = "Command-line tool for M-Pesa Daraja v3 — STK Push, B2C, balance, config management."
 readme = "README.md"
 license = {text = "CC-BY-NC-ND-4.0"}

{pesa_cli-1.0.1 → pesa_cli-1.0.2}/tests/test_cli_e2e.py

@@ -112,3 +112,17 @@ def test_invalid_phone_is_rejected():
 
     with pytest.raises(typer.Exit):
         importlib.import_module("pesa_cli.cli")._normalise_phone("12345")
+
+
+def test_a_missing_callback_url_is_announced_not_silent(mock, env):
+    """Without DARAJA_CALLBACK_URL the CLI substitutes https://example.com/mpesa/callback, so the user never sees the result and had no hint why."""
+    r = runner.invoke(_app(), ["stk", "push", "0712345678", "10", "--ref", "NOCB"], env=env)
+    assert r.exit_code == 0 and "No callback URL" in r.output
+    body = _posts(mock, "/mpesa/stkpush/v1/processrequest")[-1]["body"]
+    assert body["CallBackURL"] == "https://example.com/mpesa/callback"
+
+
+def test_a_configured_callback_url_is_used_and_not_warned_about(mock, env):
+    r = runner.invoke(_app(), ["stk", "push", "0712345678", "10", "--ref", "WITHCB"], env={**env, "DARAJA_CALLBACK_URL": "https://webhook.site/abc"})
+    assert r.exit_code == 0 and "No callback URL" not in r.output
+    assert _posts(mock, "/mpesa/stkpush/v1/processrequest")[-1]["body"]["CallBackURL"] == "https://webhook.site/abc"