Skip to content

Commit

Permalink
DOC Add FAQ about loading external python files (#727)
Browse files Browse the repository at this point in the history
  • Loading branch information
rth committed Jul 14, 2020
1 parent f03cf8b commit f2c92ad
Show file tree
Hide file tree
Showing 2 changed files with 20 additions and 0 deletions.
19 changes: 19 additions & 0 deletions docs/faq.md
@@ -0,0 +1,19 @@
# Frequently Asked Questions (FAQ)

### How can I load external python files in Pyodide?

The two possible solutions are,

- include these files in a python package, build a pure python wheel with
`python setup.py bdist_wheel` and [load it with micropip](./pypi.html#installing-wheels-from-arbitrary-urls).
- fetch the python code as a string and evaluate it in Python,
```js
pyodide.eval_code(pyodide.open_url('https://some_url/...'))
```

In both cases, files need to be served with a web server and cannot be loaded from local file system.

### Why can't I load files from the local file system?

For security reasons JavaScript in the browser is not allowed to load local
data files. You need to serve them with a web-browser.
1 change: 1 addition & 0 deletions docs/index.rst
Expand Up @@ -42,6 +42,7 @@ to be used with Pyodide.

pypi.md
api_reference.md
faq.md

Developing Pyodide
==================
Expand Down

0 comments on commit f2c92ad

Please sign in to comment.