make-azure 0.4.0__py3-none-any.whl

make_azure/__init__.py

@@ -0,0 +1,36 @@
+"""Azure tasks for mkrun -- the `azure` group.
+
+One thing: a virtual machine on Azure's free tier, in the nearest region that
+will build it, optionally with a DuckDNS name, and removed with everything it
+made. Sign-in is azure-identity (a browser, MFA up front, an encrypted token
+cache); the rest is plain Resource Manager REST through `make.http`.
+
+From any shell, with no task file:
+
+    uv tool install mkrun
+    mk --install azure
+    mk azure.vm box
+
+Or in a task file, where importing is what registers it:
+
+    # Makefile.py
+    from make_azure import azure
+
+The group merges with a repo's own `azure.*` tasks -- groups are namespaces,
+and this package claims only its seven names.
+"""
+
+from __future__ import annotations
+
+__version__ = "0.4.0"
+
+__all__ = ["azure", "vm"]
+
+
+def __getattr__(name: str):
+    """Import on first access, keeping module scope import-free -- startup is a feature."""
+    if name in __all__:
+        import importlib
+
+        return importlib.import_module(f".{name}", __name__)
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

make_azure/azure.py

@@ -0,0 +1,113 @@
+"""The `azure` group: a free-tier virtual machine, made and removed.
+
+    mk azure.login --tenant T        sign in once (a browser opens)
+    mk azure.account                 which subscription, and whether it is free
+    mk azure.region                  the nearest regions, and the one azure.vm uses
+    mk azure.vm box                  Ubuntu 24.04, SSH open, in the nearest region
+    mk azure.vm box --duckdns mybox  ...and mybox.duckdns.org points at it
+    mk azure.vms                     what the subscription has
+    mk azure.dns box mybox           point mybox.duckdns.org at an existing VM
+    mk azure.delete box              the VM and everything it made
+    mk --dry-run azure.vm box        the plan; nothing is sent, no sign-in
+
+The work is in `make_azure.vm`, imported inside each task so `mk --list` never
+loads azure-identity. No `az` CLI is involved.
+"""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from make import arg, group
+
+__all__ = ["azure"]
+
+azure = group("azure")
+
+Subscription = Annotated[str, arg(help="subscription id or name, if the sign-in reaches several")]
+Size = Annotated[str, arg(help="Standard_B2ats_v2 (default), Standard_B2pts_v2 or Standard_B1s")]
+Origin = Annotated[str | None, arg(help="your position, LAT,LON; default: from the time zone")]
+
+
+@azure.task(name="login")
+def login(
+    *,
+    tenant: Annotated[str, arg(help="tenant id or domain; needed for a personal account")] = "organizations",
+) -> None:
+    """Sign in with a browser, MFA included; tokens go in the encrypted cache."""
+    from . import vm
+
+    vm.login(tenant)
+
+
+@azure.task(name="account")
+def account(*, subscription: Subscription = "") -> None:
+    """The subscription this sign-in acts in, and whether its offer carries free services."""
+    from . import vm
+
+    vm.account(subscription_name=subscription)
+
+
+@azure.task(name="region")
+def region(
+    *, size: Size = "Standard_B2ats_v2", origin: Origin = None, subscription: Subscription = ""
+) -> None:
+    """The regions nearest to you, and the first that sells the size."""
+    from . import vm
+
+    vm.region(size=size, origin=origin, subscription_name=subscription)
+
+
+@azure.task(name="vm", dangerous=True)
+def create(
+    name: Annotated[str, arg(help="the VM's name; its resource group is NAME-rg")],
+    *,
+    size: Size = "Standard_B2ats_v2",
+    origin: Origin = None,
+    location: Annotated[str | None, arg(help="skip the search and use this region")] = None,
+    duckdns: Annotated[
+        str | None, arg(help="point SUBDOMAIN.duckdns.org at it (needs DUCKDNS_TOKEN)")
+    ] = None,
+    user: Annotated[str, arg(help="the login user on the VM")] = "azureuser",
+    no_public_ip: Annotated[bool, arg(help="private network only; avoids the billed IPv4")] = False,
+    paid_ok: Annotated[bool, arg(help="allow a subscription without free services")] = False,
+    subscription: Subscription = "",
+) -> None:
+    """Create a free-tier Ubuntu VM in the nearest region that will build it."""
+    from . import vm
+
+    vm.create(
+        name,
+        size=size,
+        origin=origin,
+        location=location,
+        duckdns=duckdns,
+        user=user,
+        paid_ok=paid_ok,
+        public_ip=not no_public_ip,
+        subscription_name=subscription,
+    )
+
+
+@azure.task(name="vms")
+def vms(*, subscription: Subscription = "") -> None:
+    """The subscription's VMs: region, size, power state, address."""
+    from . import vm
+
+    vm.vms(subscription_name=subscription)
+
+
+@azure.task(name="dns")
+def dns(name: str, subdomain: str, *, subscription: Subscription = "") -> None:
+    """Point SUBDOMAIN.duckdns.org at an existing VM (needs DUCKDNS_TOKEN)."""
+    from . import vm
+
+    vm.dns(name, subdomain, subscription_name=subscription)
+
+
+@azure.task(name="delete", dangerous=True)
+def delete(name: str, *, subscription: Subscription = "") -> None:
+    """Delete a VM's resource group: the VM, its disk, network and IP, all at once."""
+    from . import vm
+
+    vm.delete(name, subscription_name=subscription)