add uvloop optional dependency (piccolo-orm#145)

Author: aminalaee

.github/workflows/release.yaml

@@ -16,7 +16,7 @@ jobs:
         with:
           python-version: 3.7
       - name: "Install dependencies"
-        run: "pip install -r dev-requirements.txt"
+        run: "pip install -r requirements/dev-requirements.txt"
       - name: "Publish to PyPI"
         run: "./scripts/release.sh"
         env:

.github/workflows/tests.yaml

@@ -22,9 +22,9 @@ jobs:
             - name: Install dependencies
               run: |
                   python -m pip install --upgrade pip
-                  pip install -r requirements.txt
-                  pip install -r dev-requirements.txt
-                  pip install -r tests/test-requirements.txt
+                  pip install -r requirements/requirements.txt
+                  pip install -r requirements/dev-requirements.txt
+                  pip install -r requirements/test-requirements.txt
             - name: Lint
               run: ./scripts/lint.sh
 
@@ -62,8 +62,8 @@ jobs:
             - name: Install dependencies
               run: |
                   python -m pip install --upgrade pip
-                  pip install -r requirements.txt
-                  pip install -r tests/test-requirements.txt
+                  pip install -r requirements/requirements.txt
+                  pip install -r requirements/test-requirements.txt
             - name: Setup postgres
               run: |
                   export PGPASSWORD=postgres
@@ -97,8 +97,8 @@ jobs:
             - name: Install dependencies
               run: |
                   python -m pip install --upgrade pip
-                  pip install -r requirements.txt
-                  pip install -r tests/test-requirements.txt
+                  pip install -r requirements/requirements.txt
+                  pip install -r requirements/test-requirements.txt
             - name: Test with pytest, SQLite
               run: ./scripts/test-sqlite.sh
             - name: Upload coverage

.gitignore

@@ -15,3 +15,5 @@ _build/
 *.sqlite
 htmlcov/
 prof/
+.env/
+.venv/

docs/src/piccolo/getting_started/installing_piccolo.rst

@@ -21,6 +21,10 @@ Now install piccolo, ideally inside a `virtualenv <https://docs.python-guide.org
     # The important bit:
     pip install piccolo
 
-    # For optional orjson support, which improves JSON serialisation
-    # performance:
+    # Optional: orjson for improved JSON serialisation performance
     pip install piccolo[orjson]
+
+    # Optional: uvloop as default event loop instead of asyncio
+    # If using Piccolo with Uvicorn, Uvicorn will set uvloop as
+    # default event loop if installed
+    pip install piccolo[uvloop]

piccolo/main.py

@@ -3,6 +3,13 @@
 
 from targ import CLI  # type: ignore
 
+try:
+    import uvloop  # type: ignore
+
+    uvloop.install()
+except ImportError:
+    pass
+
 from piccolo.apps.app.piccolo_app import APP_CONFIG as app_config
 from piccolo.apps.asgi.piccolo_app import APP_CONFIG as asgi_config
 from piccolo.apps.meta.piccolo_app import APP_CONFIG as meta_config

requirements/README.md

@@ -0,0 +1,6 @@
+# Requirement files
+
+* `extras` - Optional dependencies of `Piccolo`.
+* `dev-requirements.txt` - Requirements needed to develop `Piccolo`.
+* `requirements.txt` - Default requirements of `Piccolo`.
+* `test-requirements.txt` - Requirements needed to run `Piccolo` tests.

dev-requirements.txt requirements/dev-requirements.txtdev-requirements.txt renamed to requirements/dev-requirements.txt

@@ -0,0 +1 @@
+orjson==3.4.1

requirements/extras/orjson.txt

@@ -0,0 +1 @@
+ipython

requirements/extras/playground.txt

@@ -0,0 +1 @@
+uvloop>=0.12.0