From feeab0cf032a32e93cd154c360835236a5dbe261 Mon Sep 17 00:00:00 2001 From: Hood Chatham Date: Mon, 13 Dec 2021 09:36:35 -0800 Subject: [PATCH] Rewrite intro text (#2031) --- README.md | 25 ++++++++++++++----------- docs/index.rst | 28 +++++++++++++++++----------- docs/project/about.md | 28 +++++++++++++++------------- 3 files changed, 46 insertions(+), 35 deletions(-) diff --git a/README.md b/README.md index cdb100598..9d78d81fb 100644 --- a/README.md +++ b/README.md @@ -9,22 +9,25 @@ [![Build Status](https://circleci.com/gh/pyodide/pyodide.png)](https://circleci.com/gh/pyodide/pyodide) [![Documentation Status](https://readthedocs.org/projects/pyodide/badge/?version=stable)](https://pyodide.readthedocs.io/?badge=stable) -Python with the scientific stack, compiled to WebAssembly. +Pyodide is a Python distribution for the browser and Node.js based on WebAssembly. ## What is Pyodide? -Pyodide may be used in any context where you want to run Python inside a web -browser. +Pyodide is a port of CPython to WebAssembly/[Emscripten](https://emscripten.org/). -Pyodide brings the Python 3.9 runtime to the browser via WebAssembly thanks to -[Emscripten](https://emscripten.org/). -It builds the Python scientific stack including NumPy, Pandas, Matplotlib, SciPy, and -scikit-learn. The [packages directory](packages) lists over 75 packages which -are currently available. In addition, it's possible to install pure Python wheels -from PyPI. +Pyodide makes it possible to install and run Python packages in the browser with +[micropip](https://pyodide.org/en/stable/usage/api/micropip-api.html). Any pure +Python package with a wheel available on PyPi is supported. Many packages with C +extensions have also been ported for use with Pyodide. These include many +general-purpose packages such as regex, pyyaml, lxml and scientific Python +packages including numpy, pandas, scipy, matplotlib, and scikit-learn. -Pyodide provides transparent conversion of objects between JavaScript and -Python. When used inside a browser, Python has full access to the Web APIs. +Pyodide comes with a robust Javascript ⟺ Python foreign function interface so +that you can freely mix these two languages in your code with minimal +friction. This includes full support for error handling (throw an error in one +language, catch it in the other), async/await, and much more. + +When used inside a browser, Python has full access to the Web APIs. ## Try Pyodide (no installation needed) diff --git a/docs/index.rst b/docs/index.rst index b541348e7..13beea62d 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -1,21 +1,27 @@ Pyodide ======= -Python with the scientific stack, compiled to WebAssembly. -Pyodide may be used in any context where you want to run Python inside a web -browser. +Pyodide is a Python distribution for the browser and Node.js based on WebAssembly. -Pyodide brings the Python 3.9 runtime to the browser via WebAssembly, thanks to -`Emscripten `_. -It builds the Python scientific stack including NumPy, Pandas, Matplotlib, SciPy, and -scikit-learn. Over 75 packages are currently available. In addition, it's -possible to install pure Python wheels from PyPI. +What is Pyodide? +---------------- -Pyodide provides transparent conversion of objects between JavaScript and -Python. When used inside a browser, Python has full access to the Web APIs. +Pyodide is a port of CPython to WebAssembly/[Emscripten](https://emscripten.org/). -Pyodide development happens on GitHub: `github.com/pyodide/pyodide `_ +Pyodide makes it possible to install and run Python packages in the browser with +[micropip](https://pyodide.org/en/stable/usage/api/micropip-api.html). Any pure +Python package with a wheel available on PyPi is supported. Many packages with C +extensions have also been ported for use with Pyodide. These include many +general-purpose packages such as regex, pyyaml, lxml and scientific Python +packages including numpy, pandas, scipy, matplotlib, and scikit-learn. + +Pyodide comes with a robust Javascript ⟺ Python foreign function interface so +that you can freely mix these two languages in your code with minimal +friction. This includes full support for error handling (throw an error in one +language, catch it in the other), async/await, and much more. + +When used inside a browser, Python has full access to the Web APIs. Try Pyodide (no installation needed) ------------------------------------ diff --git a/docs/project/about.md b/docs/project/about.md index 0522e2bc3..434a641b7 100644 --- a/docs/project/about.md +++ b/docs/project/about.md @@ -1,20 +1,22 @@ -# About Pyodide +Pyodide is a Python distribution for the browser and Node.js based on WebAssembly. -Python with the scientific stack, compiled to WebAssembly. +## What is Pyodide? -Pyodide may be used in any context where you want to run Python inside a web -browser. +Pyodide is a port of CPython to WebAssembly/[Emscripten](https://emscripten.org/). -Pyodide brings the Python 3.9 runtime to the browser via WebAssembly thanks to -[Emscripten](https://emscripten.org/). -It builds the Python scientific stack including NumPy, Pandas, Matplotlib, SciPy, and -scikit-learn. The [packages -directory](https://github.com/pyodide/pyodide/tree/main/packages) lists over -75 packages which are currently available. In addition, it's possible to install -pure Python wheels from PyPI. +Pyodide makes it possible to install and run Python packages in the browser with +[micropip](https://pyodide.org/en/stable/usage/api/micropip-api.html). Any pure +Python package with a wheel available on PyPi is supported. Many packages with C +extensions have also been ported for use with Pyodide. These include many +general-purpose packages such as regex, pyyaml, lxml and scientific Python +packages including numpy, pandas, scipy, matplotlib, and scikit-learn. -Pyodide provides transparent conversion of objects between JavaScript and -Python. When used inside a browser, Python has full access to the Web APIs. +Pyodide comes with a robust Javascript 🡘 Python foreign function interface so +that you can freely mix these two languages in your code with minimal +friction. This includes full support for error handling (throw an error in one +language, catch it in the other), async/await, and much more. + +When used inside a browser, Python has full access to the Web APIs. ## History