added pip install piccolo[all] option (piccolo-orm#230)

* added `pip install piccolo[all]` option

* tweak install docs

* update README to mention piccolo[all] option

Author: dantownsend

README.md

@@ -72,21 +72,27 @@ await b.remove().run()
 
 Installing with PostgreSQL driver:
 
-```
+```bash
 pip install 'piccolo[postgres]'
 ```
 
 Installing with SQLite driver:
 
-```
+```bash
 pip install 'piccolo[sqlite]'
 ```
 
+Installing with all optional dependencies (easiest):
+
+```bash
+pip install 'piccolo[all]'
+```
+
 ## Building a web app?
 
 Let Piccolo scaffold you an ASGI web app, using Piccolo as the ORM:
 
-```
+```bash
 piccolo asgi new
 ```
 
@@ -98,4 +104,6 @@ We have a handy page which shows the equivalent of [common Django queries in Pic
 
 ## Documentation
 
-See [Read the docs](https://piccolo-orm.readthedocs.io/en/latest/piccolo/getting_started/index.html).
+Our documentation is on [Read the docs](https://piccolo-orm.readthedocs.io/en/latest/piccolo/getting_started/index.html).
+
+We also have some great [tutorial videos on YouTube](https://www.youtube.com/channel/UCE7x5nm1Iy9KDfXPNrNQ5lA).

docs/src/piccolo/getting_started/installing_piccolo.rst

@@ -30,7 +30,11 @@ Now install piccolo, ideally inside a `virtualenv <https://docs.python-guide.org
     # 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
+    # Optional: uvloop as the default event loop instead of asyncio
+    # If using Piccolo with Uvicorn, Uvicorn will set uvloop as the default
+    # event loop if installed
     pip install 'piccolo[uvloop]'
+
+    # If you just want Piccolo with all of it's functionality, you might prefer
+    # to use this:
+    pip install 'piccolo[all]'

setup.py

@@ -1,13 +1,14 @@
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
+import itertools
 import os
-from typing import List
+import typing as t
+
 from setuptools import find_packages, setup
 
 from piccolo import __VERSION__ as VERSION
 
-
 directory = os.path.abspath(os.path.dirname(__file__))
 
 extras = ["orjson", "playground", "postgres", "sqlite", "uvloop"]
@@ -17,7 +18,7 @@
     LONG_DESCRIPTION = f.read()
 
 
-def parse_requirement(req_path: str) -> List[str]:
+def parse_requirement(req_path: str) -> t.List[str]:
     """
     Parse requirement file.
     Example:
@@ -31,7 +32,7 @@ def parse_requirement(req_path: str) -> List[str]:
         return [i.strip() for i in contents.strip().split("\n")]
 
 
-def extras_require():
+def extras_require() -> t.Dict[str, t.List[str]]:
     """
     Parse requirements in requirements/extras directory
     """
@@ -41,6 +42,10 @@ def extras_require():
             os.path.join("extras", extra + ".txt")
         )
 
+    extra_requirements["all"] = [
+        i for i in itertools.chain.from_iterable(extra_requirements.values())
+    ]
+
     return extra_requirements