onflow / flow-cli

The Flow CLI is a command-line interface that provides useful utilities for building Flow applications
https://onflow.org
Apache License 2.0
206 stars 62 forks source link

Dev super command: Extract core logic to flowkit package #1634

Open bartolomej opened 3 weeks ago

bartolomej commented 3 weeks ago

Issue To Be Solved

flow dev command logic (used by flow super command group) can't be (re)used by external packages at the moment, as it lives in the flow-cli/internal package.

Suggest A Solution

More core logic (from project.go and files.go) to a non-internal package (preferably to flowkit repo, as that's where other such logic already lives), so that other packages or projects can reuse it if needed (useful mostly for other devtools).

This is similar to how DeployProject function lives in flowkit, instead of internal/project package.

Context

This would be useful for Flowser, as we want to build a browser-based Flow playground, which would include an emulator and (a subset of) Flow CLI all running within the browser.

We also want to make setting up and running a project at least as easy as when doing local development in the shell. For that, it may be good to reuse the logic from flow dev, to be consistent with how the project development flow works locally.

To be fair, I'm not sure it's worth refactoring and extracting this, as flow dev logic depends on some functions/dependencies that won't work as desired js/wasm environment (e.g. os.Stat which doesn't do anything on the web) + it's not necessarily that complicated to re-implement at the moment (although I think we could all benefit from using and improving a single such library function). But that could be solved by depending on an interface (e.g. ReaderWriter and FileWatcher) instead on the concrete implementation.

For more context, see our grant proposal: https://github.com/onflow/developer-grants/issues/260

bartolomej commented 3 weeks ago

Related to https://github.com/onflow/flow-cli/issues/1633