-
Notifications
You must be signed in to change notification settings - Fork 75
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'main' into x_into_main
* main: Remove leading newline Stop testing on Python 3.12 Update changelog Check that file is autogenerated before overwriting Run tests on Python 3.12 Add support for Quarto integration (#746) Revert inadvertent whitespace change Update shinylive version for docs (#759) Self outputting renderers (#747)
- Loading branch information
Showing
25 changed files
with
949 additions
and
102 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,126 @@ | ||
# Shinylive package methods | ||
|
||
## Methods | ||
|
||
### R | ||
|
||
Interaction: | ||
|
||
``` | ||
Rscript -e 'shinylive:::quarto_ext()' [methods] [args] | ||
``` | ||
|
||
### Python | ||
|
||
Interaction: | ||
|
||
``` | ||
shinylive [methods] [args] | ||
``` | ||
|
||
## CLI Methods | ||
|
||
* `extension info` | ||
* Package, version, asset version, and script paths information | ||
* `extension base-htmldeps` | ||
* Quarto html dependencies for the base shinylive integration | ||
* `extension language-resources` | ||
* Language specific resource files for the quarto html dependency named `shinylive` | ||
* `extension app-resources` | ||
* App specific resource files for the quarto html dependency named `shinylive` | ||
|
||
### CLI Interface | ||
* `extension info` | ||
* Prints information about the extension including: | ||
* `version`: The version of the R package | ||
* `assets_version`: The version of the web assets | ||
* `scripts`: A list of paths scripts that are used by the extension, | ||
mainly `codeblock-to-json` | ||
* Example | ||
``` | ||
{ | ||
"version": "0.1.0", | ||
"assets_version": "0.2.0", | ||
"scripts": { | ||
"codeblock-to-json": "/<ASSETS_CACHE_DIR>/shinylive-0.2.0/scripts/codeblock-to-json.js" | ||
} | ||
} | ||
``` | ||
* `extension base-htmldeps` | ||
* Prints the language agnostic quarto html dependencies as a JSON array. | ||
* The first html dependency is the `shinylive` service workers. | ||
* The second html dependency is the `shinylive` base dependencies. This | ||
dependency will contain the core `shinylive` asset scripts (JS files | ||
automatically sourced), stylesheets (CSS files that are automatically | ||
included), and resources (additional files that the JS and CSS files can | ||
source). | ||
* Example | ||
``` | ||
[ | ||
{ | ||
"name": "shinylive-serviceworker", | ||
"version": "0.2.0", | ||
"meta": { "shinylive:serviceworker_dir": "." }, | ||
"serviceworkers": [ | ||
{ | ||
"source": "/<ASSETS_CACHE_DIR>/shinylive-0.2.0/shinylive-sw.js", | ||
"destination": "/shinylive-sw.js" | ||
} | ||
] | ||
}, | ||
{ | ||
"name": "shinylive", | ||
"version": "0.2.0", | ||
"scripts": [{ | ||
"name": "shinylive/load-shinylive-sw.js", | ||
"path": "/<ASSETS_CACHE_DIR>/shinylive-0.2.0/shinylive/load-shinylive-sw.js", | ||
"attribs": { "type": "module" } | ||
}], | ||
"stylesheets": [{ | ||
"name": "shinylive/shinylive.css", | ||
"path": "/<ASSETS_CACHE_DIR>/shinylive-0.2.0/shinylive/shinylive.css" | ||
}], | ||
"resources": [ | ||
{ | ||
"name": "shinylive/shinylive.js", | ||
"path": "/<ASSETS_CACHE_DIR>/shinylive-0.2.0/shinylive/shinylive.js" | ||
}, | ||
... # [ truncated ] | ||
] | ||
} | ||
] | ||
``` | ||
* `extension language-resources` | ||
* Prints the language-specific resource files as JSON that should be added to the quarto html dependency. | ||
* For r-shinylive, this includes the webr resource files | ||
* For py-shinylive, this includes the pyodide and pyright resource files. | ||
* Example | ||
``` | ||
[ | ||
{ | ||
"name": "shinylive/webr/esbuild.d.ts", | ||
"path": "/<ASSETS_CACHE_DIR>/shinylive-0.2.0/shinylive/webr/esbuild.d.ts" | ||
}, | ||
{ | ||
"name": "shinylive/webr/libRblas.so", | ||
"path": "/<ASSETS_CACHE_DIR>/shinylive-0.2.0/shinylive/webr/libRblas.so" | ||
}, | ||
... # [ truncated ] | ||
] | ||
* `extension app-resources` | ||
* Prints app-specific resource files as JSON that should be added to the `"shinylive"` quarto html dependency. | ||
* Currently, r-shinylive does not return any resource files. | ||
* Example | ||
``` | ||
[ | ||
{ | ||
"name": "shinylive/pyodide/anyio-3.7.0-py3-none-any.whl", | ||
"path": "/<ASSETS_CACHE_DIR>/shinylive-0.2.0/shinylive/pyodide/anyio-3.7.0-py3-none-any.whl" | ||
}, | ||
{ | ||
"name": "shinylive/pyodide/appdirs-1.4.4-py2.py3-none-any.whl", | ||
"path": "/<ASSETS_CACHE_DIR>/shinylive-0.2.0/shinylive/pyodide/appdirs-1.4.4-py2.py3-none-any.whl" | ||
}, | ||
... # [ truncated ] | ||
] | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.