diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 6030b7f1..3646715f 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -28,7 +28,7 @@ repos:
rev: 24.8.0
hooks:
- id: black
- exclude: core/src/stdlib/pyscript/__init__\.py
+ args: ["-l", "88", "--skip-string-normalization"]
- repo: https://github.com/codespell-project/codespell
rev: v2.3.0
@@ -44,10 +44,3 @@ repos:
- id: prettier
exclude: core/test|core/dist|core/types|core/src/stdlib/pyscript.js|pyscript\.sw/|core/src/3rd-party
args: [--tab-width, "4"]
-
- - repo: https://github.com/pycqa/isort
- rev: 5.13.2
- hooks:
- - id: isort
- name: isort (python)
- args: [--profile, black]
diff --git a/Makefile b/Makefile
index f724ba31..1b8b6264 100644
--- a/Makefile
+++ b/Makefile
@@ -9,6 +9,7 @@ PY_OK := $(shell python3 -c "print(int($(PY3_VER) >= $(MIN_PY3_VER)))")
all:
@echo "\nThere is no default Makefile target right now. Try:\n"
@echo "make setup - check your environment and install the dependencies."
+ @echo "make update - update dependencies."
@echo "make clean - clean up auto-generated assets."
@echo "make build - build PyScript."
@echo "make precommit-check - run the precommit checks (run eslint)."
@@ -57,6 +58,11 @@ clean:
build:
cd core && npx playwright install chromium && npm run build
+# Update the dependencies.
+update:
+ cd core && npm update && cd ..
+ python -m pip install -r requirements.txt --upgrade
+
# Run the precommit checks (run eslint).
precommit-check:
pre-commit run --all-files
@@ -76,7 +82,6 @@ fmt-check: fmt-py-check
# Format Python code.
fmt-py:
black -l 88 --skip-string-normalization .
- isort --profile black .
# Check the format of Python code.
fmt-py-check:
diff --git a/README.md b/README.md
index 01b6d7d3..00806ae2 100644
--- a/README.md
+++ b/README.md
@@ -1,97 +1,85 @@
# PyScript
-## What is PyScript
+## PyScrcipt is an open source platform for Python in the browser.
-### Summary
+Using PyScript is as simple as:
-PyScript is a framework that allows users to create rich Python applications in the browser using HTML's interface and the power of [Pyodide](https://pyodide.org/en/stable/), [MicroPython](https://micropython.org/) and [WASM](https://webassembly.org/), and modern web technologies.
+```html
+
+
+
+
+
+ PyScript!
+
+
+
+
+
+
+
+
+```
-To get started see the [Beginning PyScript tutorial](https://docs.pyscript.net/latest/beginning-pyscript/).
+PyScript enables the creation of rich Python applications in the browser using
+[Pyodide](https://pyodide.org/en/stable/) (a version of
+[CPython](https://python.org/)), [MicroPython](https://micropython.org/),
+[WASM](https://webassembly.org/), and modern web technologies. It means Python
+now runs anywhere a browser runs: desktop, laptop, mobile, tablet, or any other
+browser enabled device.
-For examples see [here](https://pyscript.com/@examples).
+To start building, read the
+[Beginning PyScript tutorial](https://docs.pyscript.net/latest/beginning-pyscript/).
+
+For example applications, see [here](https://pyscript.com/@examples).
Other useful resources:
+- Our [Home Page](https://pyscript.net/) as an open source project.
- The [official technical docs](https://docs.pyscript.net/).
-- Our current [Home Page](https://pyscript.net/) on the web.
-- A free-to-use [online editor](https://pyscript.com/) for trying PyScript.
-- Our community [Discord Channel](https://discord.gg/BYB2kvyFwm), to keep in touch .
+- A [YouTube channel](https://www.youtube.com/@PyScriptTV) with helpful videos
+ and community content.
+- A free-to-use [online IDE](https://pyscript.com/) for trying PyScript.
+- Our community [Discord Channel](https://discord.gg/BYB2kvyFwm), to keep in
+ touch .
-Every Tuesday at 15:30 UTC there is the _PyScript Community Call_ on zoom, where we can talk about PyScript development in the open. Most of the maintainers regularly participate in the call, and everybody is welcome to join.
+Every Tuesday at 15:30 UTC there is the _PyScript Community Call_ on zoom,
+where we can talk about PyScript development in the open. Most of the
+maintainers regularly participate in the call, and everybody is welcome to
+join. This meeting is recorded and uploaded to our YouTube channel.
-Every other Thursday at 16:00 UTC there is the _PyScript FUN_ call: this is a call in which everybody is encouraged to show what they did with PyScript.
+Every other Thursday at 16:00 UTC there is the _PyScript FUN_ call: the focus
+of this call is to share fun projects, goofy hacks or clever uses of PyScript.
+It's a supportive, energetic and entertaining meeting. This meeting is also
+recorded and uploaded to our YouTube channel.
-For more details on how to join the calls and up to date schedule, consult the official calendar:
+For more details on how to join the calls and up to date schedule, consult the
+official calendar:
- [Google calendar](https://calendar.google.com/calendar/u/0/embed?src=d3afdd81f9c132a8c8f3290f5cc5966adebdf61017fca784eef0f6be9fd519e0@group.calendar.google.com&ctz=UTC) in UTC time;
- [iCal format](https://calendar.google.com/calendar/ical/d3afdd81f9c132a8c8f3290f5cc5966adebdf61017fca784eef0f6be9fd519e0%40group.calendar.google.com/public/basic.ics).
-### Longer Version
+## Contribute
-PyScript is a meta project that aims to combine multiple open technologies into a framework that allows users to create sophisticated browser applications with Python. It integrates seamlessly with the way the DOM works in the browser and allows users to add Python logic in a way that feels natural both to web and Python developers.
+For technical details of the code, please see the [README](core/README) in the
+`core` directory.
-## Try PyScript
+Read the [contributing guide](https://docs.pyscript.net/latest/contributing/)
+to learn about our development process, reporting bugs and improvements,
+creating issues and asking questions.
-To try PyScript, import the appropriate pyscript files into the `` tag of your html page:
-
-```html
-
-
-
-
-
-
-
-```
-
-You can then use PyScript components in your html page. PyScript currently offers various ways of running Python code:
-
-- `
+
+
+
+
+