infrasketch 0.1.0__py3-none-any.whl

infrasketch/__init__.py

@@ -0,0 +1,55 @@
+"""Draw Azure architecture diagrams as SVG, with the official resource icons.
+
+Graphviz is not required. A diagram is a ``with`` block, resources are
+constructed inside it, and ``>>`` draws the arrow::
+
+    from infrasketch import Diagram, FrontDoor, FunctionApp, Redis, ResourceGroup
+
+    with Diagram("Orders", "orders.svg"):
+        with ResourceGroup("rg-app"):
+            web = FrontDoor("Frontend")
+            api = FunctionApp("API")
+            cache = Redis("Sessions")
+        web >> api >> cache
+
+The file is written when the block ends. ``python -m infrasketch search redis``
+finds the class for any other resource.
+
+The source code is MIT. The Azure icons are Microsoft artwork and are not
+covered by that license. See ``NOTICE``.
+"""
+
+from infrasketch.groups import (
+    Cluster,
+    Group,
+    PrivateNetwork,
+    Region,
+    ResourceGroup,
+    Subnet,
+    Subscription,
+    VNet,
+)
+from infrasketch.model import Async, Diagram, Edge, Https, Node, Private
+from infrasketch.search import categories, search
+from infrasketch.shortcuts import *  # noqa: F403
+from infrasketch.shortcuts import __all__ as _resources
+
+__all__ = [
+    "Async",
+    "Cluster",
+    "Diagram",
+    "Edge",
+    "Group",
+    "Https",
+    "Node",
+    "Private",
+    "PrivateNetwork",
+    "Region",
+    "ResourceGroup",
+    "Subnet",
+    "Subscription",
+    "VNet",
+    "categories",
+    "search",
+    *_resources,
+]

infrasketch/__main__.py

@@ -0,0 +1,44 @@
+"""``python -m infrasketch search <words>`` prints the import to use."""
+
+from __future__ import annotations
+
+import argparse
+import sys
+
+from infrasketch.search import categories, search
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(
+        prog="infrasketch",
+        description="Find Azure resource classes and draw architecture diagrams.",
+    )
+    sub = parser.add_subparsers(dest="command")
+
+    find = sub.add_parser("search", help="Find a resource by name")
+    find.add_argument("query", nargs="+", help="Words to match, such as: managed redis")
+
+    listed = sub.add_parser("categories", help="List resource categories")
+    listed.set_defaults(command="categories")
+
+    args = parser.parse_args(argv)
+    if args.command == "search":
+        hits = search(" ".join(args.query))
+        if not hits:
+            print("No matching resources.")
+            return 1
+        for hit in hits:
+            print(hit)
+            print()
+        print(f"{len(hits)} match{'es' if len(hits) != 1 else ''}.")
+        return 0
+    if args.command == "categories":
+        for name in categories():
+            print(name)
+        return 0
+    parser.print_help()
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

infrasketch/ai.py

@@ -0,0 +1,282 @@
+"""Azure resource nodes.
+
+Generated from the Microsoft Azure Architecture Icons.
+The icons are Microsoft artwork and are not covered by the MIT license.
+See NOTICE and src/infrasketch/data/icons/LICENSE.txt.
+Regenerate with tools/import_icons.py rather than editing by hand.
+"""
+
+from __future__ import annotations
+
+from infrasketch.model import Node
+
+
+class BatchAI(Node):
+    """Batch AI."""
+
+    icon = "ai/BatchAI.svg"
+    service = "Batch AI"
+
+class MachineLearningStudioClassicWebServices(Node):
+    """Machine Learning Studio (Classic) Web Services."""
+
+    icon = "ai/MachineLearningStudioClassicWebServices.svg"
+    service = "Machine Learning Studio (Classic) Web Services"
+
+class Genomics(Node):
+    """Genomics."""
+
+    icon = "ai/Genomics.svg"
+    service = "Genomics"
+
+class ComputerVision(Node):
+    """Computer Vision."""
+
+    icon = "ai/ComputerVision.svg"
+    service = "Computer Vision"
+
+class CustomVision(Node):
+    """Custom Vision."""
+
+    icon = "ai/CustomVision.svg"
+    service = "Custom Vision"
+
+class FaceAPIs(Node):
+    """Face APIs."""
+
+    icon = "ai/FaceAPIs.svg"
+    service = "Face APIs"
+
+class ContentModerators(Node):
+    """Content Moderators."""
+
+    icon = "ai/ContentModerators.svg"
+    service = "Content Moderators"
+
+class Personalizers(Node):
+    """Personalizers."""
+
+    icon = "ai/Personalizers.svg"
+    service = "Personalizers"
+
+class SpeechServices(Node):
+    """Speech Services."""
+
+    icon = "ai/SpeechServices.svg"
+    service = "Speech Services"
+
+class QnAMakers(Node):
+    """QnA Makers."""
+
+    icon = "ai/QnAMakers.svg"
+    service = "QnA Makers"
+
+class TranslatorText(Node):
+    """Translator Text."""
+
+    icon = "ai/TranslatorText.svg"
+    service = "Translator Text"
+
+class LanguageUnderstanding(Node):
+    """Language Understanding."""
+
+    icon = "ai/LanguageUnderstanding.svg"
+    service = "Language Understanding"
+
+class ImmersiveReaders(Node):
+    """Immersive Readers."""
+
+    icon = "ai/ImmersiveReaders.svg"
+    service = "Immersive Readers"
+
+class AnomalyDetector(Node):
+    """Anomaly Detector."""
+
+    icon = "ai/AnomalyDetector.svg"
+    service = "Anomaly Detector"
+
+class FormRecognizers(Node):
+    """Form Recognizers."""
+
+    icon = "ai/FormRecognizers.svg"
+    service = "Form Recognizers"
+
+class AzureExperimentationStudio(Node):
+    """Azure Experimentation Studio."""
+
+    icon = "ai/AzureExperimentationStudio.svg"
+    service = "Azure Experimentation Studio"
+
+class AzureObjectUnderstanding(Node):
+    """Azure Object Understanding."""
+
+    icon = "ai/AzureObjectUnderstanding.svg"
+    service = "Azure Object Understanding"
+
+class MetricsAdvisor(Node):
+    """Metrics Advisor."""
+
+    icon = "ai/MetricsAdvisor.svg"
+    service = "Metrics Advisor"
+
+class AzureAppliedAIServices(Node):
+    """Azure Applied AI Services."""
+
+    icon = "ai/AzureAppliedAIServices.svg"
+    service = "Azure Applied AI Services"
+
+class Language(Node):
+    """Language."""
+
+    icon = "ai/Language.svg"
+    service = "Language"
+
+class FRDQA(Node):
+    """FRD QA."""
+
+    icon = "ai/FRDQA.svg"
+    service = "FRD QA"
+
+class CognitiveServicesDecisions(Node):
+    """Cognitive Services Decisions."""
+
+    icon = "ai/CognitiveServicesDecisions.svg"
+    service = "Cognitive Services Decisions"
+
+class ServerlessSearch(Node):
+    """Serverless Search."""
+
+    icon = "ai/ServerlessSearch.svg"
+    service = "Serverless Search"
+
+class Bonsai(Node):
+    """Bonsai."""
+
+    icon = "ai/Bonsai.svg"
+    service = "Bonsai"
+
+class ContentSafety(Node):
+    """Content Safety."""
+
+    icon = "ai/ContentSafety.svg"
+    service = "Content Safety"
+
+class AzureOpenAI(Node):
+    """Azure OpenAI."""
+
+    icon = "ai/AzureOpenAI.svg"
+    service = "Azure OpenAI"
+
+class AIStudio(Node):
+    """AI Studio."""
+
+    icon = "ai/AIStudio.svg"
+    service = "AI Studio"
+
+class AIFoundry(Node):
+    """AI Foundry."""
+
+    icon = "ai/AIFoundry.svg"
+    service = "AI Foundry"
+
+class FoundryApplication(Node):
+    """Foundry Application."""
+
+    icon = "ai/FoundryApplication.svg"
+    service = "Foundry Application"
+
+class FoundryProject(Node):
+    """Foundry Project."""
+
+    icon = "ai/FoundryProject.svg"
+    service = "Foundry Project"
+
+class PlanetaryComputerPro(Node):
+    """Planetary Computer Pro."""
+
+    icon = "ai/PlanetaryComputerPro.svg"
+    service = "Planetary Computer Pro"
+
+class AzureAIFoundryIQ(Node):
+    """Azure AI Foundry IQ."""
+
+    icon = "ai/AzureAIFoundryIQ.svg"
+    service = "Azure AI Foundry IQ"
+
+class AzureMachineLearning(Node):
+    """Azure Machine Learning."""
+
+    icon = "ai/AzureMachineLearning.svg"
+    service = "Azure Machine Learning"
+
+class FoundryAgentService(Node):
+    """Foundry Agent Service."""
+
+    icon = "ai/FoundryAgentService.svg"
+    service = "Foundry Agent Service"
+
+class FoundryControlPlane(Node):
+    """Foundry Control Plane."""
+
+    icon = "ai/FoundryControlPlane.svg"
+    service = "Foundry Control Plane"
+
+class FoundryLabs(Node):
+    """Foundry Labs."""
+
+    icon = "ai/FoundryLabs.svg"
+    service = "Foundry Labs"
+
+class FoundryLocal(Node):
+    """Foundry Local."""
+
+    icon = "ai/FoundryLocal.svg"
+    service = "Foundry Local"
+
+class FoundryModels(Node):
+    """Foundry Models."""
+
+    icon = "ai/FoundryModels.svg"
+    service = "Foundry Models"
+
+class CognitiveSearch(Node):
+    """AI Search."""
+
+    icon = "ai/CognitiveSearch.svg"
+    service = "AI Search"
+
+class CognitiveServices(Node):
+    """Cognitive Services."""
+
+    icon = "ai/CognitiveServices.svg"
+    service = "Cognitive Services"
+
+class GenomicsAccounts(Node):
+    """Genomics Accounts."""
+
+    icon = "ai/GenomicsAccounts.svg"
+    service = "Genomics Accounts"
+
+class BotServices(Node):
+    """Bot Services."""
+
+    icon = "ai/BotServices.svg"
+    service = "Bot Services"
+
+class MachineLearning(Node):
+    """Machine Learning."""
+
+    icon = "ai/MachineLearning.svg"
+    service = "Machine Learning"
+
+class MachineLearningStudioWorkspaces(Node):
+    """Machine Learning Studio Workspaces."""
+
+    icon = "ai/MachineLearningStudioWorkspaces.svg"
+    service = "Machine Learning Studio Workspaces"
+
+class MachineLearningStudioWebServicePlans(Node):
+    """Machine Learning Studio Web Service Plans."""
+
+    icon = "ai/MachineLearningStudioWebServicePlans.svg"
+    service = "Machine Learning Studio Web Service Plans"

infrasketch/analytics.py

@@ -0,0 +1,114 @@
+"""Azure resource nodes.
+
+Generated from the Microsoft Azure Architecture Icons.
+The icons are Microsoft artwork and are not covered by the MIT license.
+See NOTICE and src/infrasketch/data/icons/LICENSE.txt.
+Regenerate with tools/import_icons.py rather than editing by hand.
+"""
+
+from __future__ import annotations
+
+from infrasketch.model import Node
+
+
+class LogAnalyticsWorkspaces(Node):
+    """Log Analytics."""
+
+    icon = "analytics/LogAnalyticsWorkspaces.svg"
+    service = "Log Analytics"
+
+class EventHubs(Node):
+    """Event Hubs."""
+
+    icon = "analytics/EventHubs.svg"
+    service = "Event Hubs"
+
+class StreamAnalyticsJobs(Node):
+    """Stream Analytics Jobs."""
+
+    icon = "analytics/StreamAnalyticsJobs.svg"
+    service = "Stream Analytics Jobs"
+
+class EndpointAnalytics(Node):
+    """Endpoint Analytics."""
+
+    icon = "analytics/EndpointAnalytics.svg"
+    service = "Endpoint Analytics"
+
+class AzureSynapseAnalytics(Node):
+    """Azure Synapse Analytics."""
+
+    icon = "analytics/AzureSynapseAnalytics.svg"
+    service = "Azure Synapse Analytics"
+
+class AzureWorkbooks(Node):
+    """Azure Workbooks."""
+
+    icon = "analytics/AzureWorkbooks.svg"
+    service = "Azure Workbooks"
+
+class PrivateLinkServices(Node):
+    """Private Link Service."""
+
+    icon = "analytics/PrivateLinkServices.svg"
+    service = "Private Link Service"
+
+class PowerBIEmbedded(Node):
+    """Power BI Embedded."""
+
+    icon = "analytics/PowerBIEmbedded.svg"
+    service = "Power BI Embedded"
+
+class PowerPlatform(Node):
+    """Power Platform."""
+
+    icon = "analytics/PowerPlatform.svg"
+    service = "Power Platform"
+
+class DataFactories(Node):
+    """Data Factory."""
+
+    icon = "analytics/DataFactories.svg"
+    service = "Data Factory"
+
+class HDInsightClusters(Node):
+    """HD Insight Clusters."""
+
+    icon = "analytics/HDInsightClusters.svg"
+    service = "HD Insight Clusters"
+
+class DataLakeAnalytics(Node):
+    """Data Lake Analytics."""
+
+    icon = "analytics/DataLakeAnalytics.svg"
+    service = "Data Lake Analytics"
+
+class AzureDataExplorerClusters(Node):
+    """Azure Data Explorer Clusters."""
+
+    icon = "analytics/AzureDataExplorerClusters.svg"
+    service = "Azure Data Explorer Clusters"
+
+class AnalysisServices(Node):
+    """Analysis Services."""
+
+    icon = "analytics/AnalysisServices.svg"
+    service = "Analysis Services"
+
+class EventHubClusters(Node):
+    """Event Hub Clusters."""
+
+    icon = "analytics/EventHubClusters.svg"
+    service = "Event Hub Clusters"
+
+class DataLakeStoreGen1(Node):
+    """Data Lake Store Gen1."""
+
+    icon = "analytics/DataLakeStoreGen1.svg"
+    service = "Data Lake Store Gen1"
+
+class AzureDatabricks(Node):
+    """Azure Databricks."""
+
+    icon = "analytics/AzureDatabricks.svg"
+    service = "Azure Databricks"

infrasketch/app_services.py

@@ -0,0 +1,60 @@
+"""Azure resource nodes.
+
+Generated from the Microsoft Azure Architecture Icons.
+The icons are Microsoft artwork and are not covered by the MIT license.
+See NOTICE and src/infrasketch/data/icons/LICENSE.txt.
+Regenerate with tools/import_icons.py rather than editing by hand.
+"""
+
+from __future__ import annotations
+
+from infrasketch.model import Node
+
+
+class AppServicePlans(Node):
+    """App Service Plan."""
+
+    icon = "app_services/AppServicePlans.svg"
+    service = "App Service Plan"
+
+class AppServiceCertificates(Node):
+    """App Service Certificates."""
+
+    icon = "app_services/AppServiceCertificates.svg"
+    service = "App Service Certificates"
+
+class AppServiceDomains(Node):
+    """App Service Domains."""
+
+    icon = "app_services/AppServiceDomains.svg"
+    service = "App Service Domains"
+
+class CDNProfiles(Node):
+    """CDN."""
+
+    icon = "app_services/CDNProfiles.svg"
+    service = "CDN"
+
+class AppServices(Node):
+    """App Service."""
+
+    icon = "app_services/AppServices.svg"
+    service = "App Service"
+
+class CognitiveSearch(Node):
+    """AI Search."""
+
+    icon = "app_services/CognitiveSearch.svg"
+    service = "AI Search"
+
+class NotificationHubs(Node):
+    """Notification Hubs."""
+
+    icon = "app_services/NotificationHubs.svg"
+    service = "Notification Hubs"
+
+class AppServiceEnvironments(Node):
+    """App Service Environments."""
+
+    icon = "app_services/AppServiceEnvironments.svg"
+    service = "App Service Environments"

infrasketch/blockchain.py

@@ -0,0 +1,48 @@
+"""Azure resource nodes.
+
+Generated from the Microsoft Azure Architecture Icons.
+The icons are Microsoft artwork and are not covered by the MIT license.
+See NOTICE and src/infrasketch/data/icons/LICENSE.txt.
+Regenerate with tools/import_icons.py rather than editing by hand.
+"""
+
+from __future__ import annotations
+
+from infrasketch.model import Node
+
+
+class BlockchainApplications(Node):
+    """Blockchain Applications."""
+
+    icon = "blockchain/BlockchainApplications.svg"
+    service = "Blockchain Applications"
+
+class OutboundConnection(Node):
+    """Outbound Connection."""
+
+    icon = "blockchain/OutboundConnection.svg"
+    service = "Outbound Connection"
+
+class AzureBlockchainService(Node):
+    """Azure Blockchain Service."""
+
+    icon = "blockchain/AzureBlockchainService.svg"
+    service = "Azure Blockchain Service"
+
+class AzureTokenService(Node):
+    """Azure Token Service."""
+
+    icon = "blockchain/AzureTokenService.svg"
+    service = "Azure Token Service"
+
+class ABSMember(Node):
+    """ABS Member."""
+
+    icon = "blockchain/ABSMember.svg"
+    service = "ABS Member"
+
+class Consortium(Node):
+    """Consortium."""
+
+    icon = "blockchain/Consortium.svg"
+    service = "Consortium"