stevebuik / stu Goto Github PK

Question: what percentage is this group of namespaces/functions adding to my artifact?

Answer: hover tooltip on legend can display total size and percentage of total size.

same as #10 but for cljs.main / deps.edn projects

Thank you so much for doing this! I was hoping I could see an example of faux-dom and d3 in Clojurescript after you mentioned it in shadow-cljs Slack. This is great!

After you mentioned faux-dom/d3 I did some Googling and came across https://vx-demo.now.sh, which supposedly uses d3/faux-dom approach in JS. It's in early stages, there's some pretty snazzy looking components. Just curious if you thought it might be helpful for some of your goals with the library.

Question: which small fns are included in my artifact? Labels are not visible for small cells.

Answer: to aid in visual scanning, support zoom to increase size of cells and make labels appear.

Note the label/name is already available in the tooltip so this is all about visual scanning.

Clicks on any cell in the treemap could Zoom into the group (using the legend grouping) using something like https://bost.ocks.org/mike/treemap. that example allows zoom to N levels deep but even just a single level zoom would help.

should happen after generation but be disabled by default.

this EDN file is useful for other CLI's to scan for invariants

this is pre-requisite for #9

Instead of Shadow snapshots, use whatever lein cljsbuild produces to create the same EDN (matching the core spec) so that the Stu app will work for it.

Probably best in a new namespace since "illumination" only makes sense for Shadow CLJS.

Question: how has my javascript artifact grown over the past N weeks?

Answer: configurable CLI to select specific commits and generate Shadow snapshots for them.

Following the technique seen here https://github.com/Datomic/codeq/blob/master/src/datomic/codeq/core.clj#L422

it should be possible to build a CLI/main fn using tools.cli which accepts args:

• target directory
• number (N) of commits to generate
• interval (maybe in days) between commits. default is subsequent commits i.e. no interval

It can then cycle through the N most recent commits, checking out each one and generating a shadow snapshot with the git hash as the tag name.

Running this tool in CI, before the Stu illumination CLI, will allow full automation.

covering essentials e.g. state change when bar is clicked

Question: has my artifact increased in size by N % in the last M days?

Answer: a CLI invoked in the CI server which scans the optional EDN file emitted by the generation CLI and throws exception if the threshold is exceeded.

This means CI can alert on large growth events

Question: why is this code in my artifact?

Answer: tooltip shows the dependency path that caused a fn/ns to be included in the artifact.

The data for this path is exposed in Shadow v2.3.5+ so it will require and upgrade of the Shadow CLJS dep.

Question: is any code in the client artifact that should not be there?

Answer: CLI can load an extra EDN resource (via a new CLI option) that is a set of ns' or paths which must not be in the client code.

If one is present in the artifact then an exception is thrown i.e. non-zero exit code.

This check should happen after the html generation so it's easy to investigate the problem using the HTML artifact

Question : how much did my artifact grow since the last commit? Which new fns/ns' made it grow?

Answer: tooltips on the bar chart display % increase since prev bar. also shows a list of cells which were not in the prev commit.

Nice to have : click on one of the list items, highlights it in the treemap