Add CLI API

[pankgeorg]

CLI API:
(Web API coming soon!)

usage: <PROGRAM> [--host HOST] [--port PORT] [--dry-run]
                 [--notebook_paths [NOTEBOOK_PATHS...]]
                 [--skip-run-notebooks [SKIP-RUN-NOTEBOOKS...]]
                 [--export] [--export-only]
                 [--export-exclude [EXPORT-EXCLUDE...]] [--enable-ui]
                 [--separate-pluto-state] [--binder-url BINDER-URL]
                 [--slider-server-url SLIDER-SERVER-URL]
                 [--cache-dir CACHE-DIR] [--output-dir OUTPUT-DIR]
                 [-c CONFIG] [--sample-toml SAMPLE-TOML]
                 [--enable-api] [--secret SECRET] [--version] [-h]
                 [start_dir]

Pluto Slide Server. A boutique pluto-notebook runner that gives life
to your static exports.
Can respond to @bind macros updates but also just create static
exports that look cool.

positional arguments:
  start_dir             The starting directory (default: ".")

optional arguments:
  --host HOST           host:port (default: "127.0.0.1")
  --port PORT           port (type: Int64, default: 2345)
  --dry-run             Stop the the slider server after running once.
                        Useful in conjuction with --export.
  --notebook_paths [NOTEBOOK_PATHS...]
                        The paths in which to look for notebooks
                        (type: Vector{String})
  --skip-run-notebooks [SKIP-RUN-NOTEBOOKS...]
                        list of notebook files to skip from running.
                        (type: Vector{String})
  --export              also export static files
  --export-only         Same as --export --dry-run
  --export-exclude [EXPORT-EXCLUDE...]
                        Export option. list of notebook files to skip
                        from exporting (type: Vector{String})
  --enable-ui           Export option. Don't hide all buttons and
                        toolbars. Without this flag, they will be
                        hidden by default to make the page look like
                        an article
  --separate-pluto-state
                        Export option. If set this flag splits the
                        export to two files: a .plutostate and an
                        .html. Default is to have state 'baked in' the
                        file'
  --binder-url BINDER-URL
                        Export option. This will set the binder URL
                        that will be used as a backend. MIT Math uses:
                                                https://mybinder.org/v2/gh/mitmath/18S191/e2dec90
                        (default: "")
  --slider-server-url SLIDER-SERVER-URL
                        Export option. The URL of the slider server
                        which can respond to requests of @bind
                        elements
  --cache-dir CACHE-DIR
                        if provided, use this directory to read and
                        write cached notebook states. Caches will be
                        indexed by notebook hash, but you need to take
                        care to invalidate the cache when Pluto or
                        this export script updates. Useful in
                        combination with
                        https://github.com/actions/cache.
  --output-dir OUTPUT-DIR
                        folder to write generated HTML files to (will
                        create directories to preserve the input
                        folder structure). Leave at the default to
                        generate each HTML file in the same folder as
                        the notebook file. (default: ".")
  -c, --config, --configuration_file CONFIG
                        Use this option to provide a configuration
                        TOML
  --sample-toml SAMPLE-TOML
                        Print a sample TOML configuration file
  --enable-api          Allow API requests
  --secret SECRET       Web API secret
  --version             show version information and exit
  -h, --help            show this help message and exit

[pankgeorg]

To test the cli, run this at the project where you dev Pluto & PlutoBindServer:
julia --project=. -e "using PlutoSliderServer; cli()" -- --help (note the -- before --help)

[fonsp]

Wow!!

[fonsp]

We could use https://github.com/Roger-luo/Comonicon.jl if it's useful

[fonsp]

myhash(read(path))

[pankgeorg]

!!!!

[pankgeorg]

bug!

[pankgeorg]

if that is different, restart
write a file (.env~!!!~~~) that the process will find after boot
and run shutdown()