scale-tone / az-func-as-a-graph

Visualizes your Azure Functions project in form of a graph

💡 “A software architect who does not code is like a cook who does not eat” © Grady Booch.

So I do eat. And I do code. And here is some of the code I do.

Projects

• Durable Functions Monitor - a monitoring/debugging UI tool for Azure Durable Functions.
• ThrottlingTroll - rate limiting/throttling middleware for ASP.NET Core and Azure Functions.
• KeeShepherd - this VsCode extension takes care of credentials (secrets, access keys, connection strings etc.), which are typically spread across numerous config files on your devbox(es). Also includes UI for Azure Key Vault and GitHub Secrets.
• Azure Resource Explorer for VsCode - a clone of Azure Resource Explorer in form of a VsCode extension.
• az-func-as-a-graph - this tool visualizes your Azure Functions in form of interactive graphs, giving you a quick architecture overview and a code map.
• AzFunc4DevOps - a set of Azure DevOps Triggers and Bindings for Azure Functions.
• durable-mvc-starter - basic project setup and scaffolding for creating serverless web applications based on Azure Durable Entities, Azure SignalR Service, React+MobX and TypeScript.
• Cognitive Search Static Web Apps sample - a simple sample UI for your Azure Cognitive Search index. Built with React, TypeScript and Azure Static Web Apps.
• LINQ2DynamoDB - a type-safe data context for AWS DynamoDB with LINQ and in-memory caching support. Allows to combine DynamoDB's durability with cache speed and read consistency.

Profiles

• Personal blog: scale-tone.github.io
• GitHub: scale-tone
• Mastodon: @scale_tone
• Twitter: @tino_scale_tone
• LinkedIn: www.linkedin.com/in/lepeshenkov

Fun facts

List of Volvo car models I owned:

• (1998-2000) 340, 5-door hatchback, 1.7 L, manual, rear-wheel-drive with transaxle, dark grey.
• (2000-2003) 440, 5-door hatchback, 1.8 L, manual, light grey.
• (2003-2006) s40, 4-door sedan, 1.6 L, manual, dark green.
• (2006-2020) ... was going through some things ...
• (2020-now) c30, 3-door hatchback, 1.6 L, manual, dark grey.

Also I bear two 🚗 licenses (for both sides of the road) and four ⛵ licenses (for various Globe regions).

az-func-as-a-graph's Issues

Better support for Java

It should work for a compiled Java Functions project, but it cannot compile it by itself yet. Would be nice to teach it how to do so.

Support for markdown files as output

Since GitHub now natively supports embedded mermaid diagrams in markdown.

Correlate suborchestrators with their parents

in the same way activities are now correlated

Python V2 support

Powershell support

Error generating json from cli

I am getting this error no matter how I try to run the command:

Does not work with either single quotes or double quotes, or even if a remove the quotes.

I cloned the project and ran npm install.

Node Version: 10.16.0.

Thanks.

Visualize proxies

as well

Some bindings are duplicated

In recent AzFunctions version they started placing all the bindings in function.json files for .NET projects.
This produces duplicates, since az-func-as-a-graph tries to parse the sources to find out missing bindings.
Need to implement some merging logic.

Upgrade to mermaid > 9.1.3

So far had to lock mermaid's version to 9.1.3, since there're some breaking changes in newer versions that make diagrams render incorrectly.
Need to investigate, migrate the code and then bump up to recent mermaid version.

Find a way to run mermaid on the server

So far it is not happy under node.js (compilation errors) and only works well inside browser.

If we manage to overcome this issue, we could then produce diagram SVGs on the server, which would allow to host and expose this tool as a UI-less service API.

Could be a simple fix...

Function graph is empty, if functions are placed in separate Project

Functions can be moved to a separate project if you add the following property to the function project file.
<FunctionsInDependencies>true</FunctionsInDependencies>. Unfortunatly those functions are not displayed in the graph.

Bindings for activities are not shown

Activities also can have bindings. Need to parse their code to infer and render those bindings as well.

Visualize events

There shouldn't be a problem to regex WaitForExternalEvent() and RaiseEvent().
The only question is how to better visualize this relationship...

Add '?' to the list of allowed symbols in generic params

subj

Better icons

subj

Find a way to inject icons as SVG, not as <image href="xxx.svg">

So that they don't get lost after saving the diagram as .SVG