First class dagger shell

[sourishkrout]

In order to natively support Dagger's shell Runme needs to take the entire notebook as opposed to an atomic cell into account. This PR introduces the APIs necessary to transform a notebook into a Dagger Shell script using some basic AST transformation.

Integration with extension in stateful/vscode-runme#1947.

PS: The protos are not published yet and need local-gen to work.

The new service will turn a deserialized version of the following markdown into a runnable Dagger shell script.

Simple example notebook

Unamed cell:

git github.com/stateful/runme |
    head |
    tree |
    file examples/README.md

And the same as a named cell:

# Named in README in cell attributes
git github.com/stateful/runme |
    head |
    tree |
    file examples/README.md

Resulting Dagger Shell Script

Running the unamed cell:

DAGGER_01JKE40B6A0F5NBESE49X122RD()
{
  git github.com/stateful/runme \
    | head \
    | tree \
    | file examples/README.md
}
DAGGER_01JKE40B6A0F5NBESE49X122RD

Running the named cell:

DAGGER_01JKE4K781F87XRK9SQZ9T1GQD()
{
  git github.com/stateful/runme \
    | head \
    | tree \
    | file examples/README.md
}
README()
{
  git github.com/stateful/runme | head | tree | file examples/README.md
}
README

[adambabik]

A couple of suggestions, but overall LGTM.

One more asks I have is to add an example in the PR description of the input (exemplary Markdown) and the expected output (a script) and how it will be executed.

[adambabik]

Question: Is there any reason this method couldn't be in RunnerService?

[sourishkrout]

That's where I had it first. I decided to make it a separate service because the Runner only knows about atomic cells, and this service needs the entire notebook. Perhaps that's not "different enough". We could consider bringing it back into the Runner as part of runnerv2.

[sonarqubecloud]

Quality Gate passed

Issues
7 New issues
0 Accepted issues

Measures
0 Security Hotspots
58.0% Coverage on New Code
4.7% Duplication on New Code

See analysis details on SonarQube Cloud