Add new script and some docs

README.md

@@ -1,3 +1,25 @@
 # toolshed
 
 Bits and bobs.
+
+## add-users-keycloak.py
+
+> **DEPRECATED**: user
+
+Attempt to create users using the local command-line client.
+
+## add-users-keycloak-api.py
+
+Create users using the REST API.
+
+```
+$ export KEYCLOAK_DOMAIN=login.lumbung.space
+$ export KEYCLOAK_REALM=lumbung-space
+$ export KEYCLOAK_CLIENT_SECRET=foobar
+$ python3 -m venv .venv && source .venv/bin/activate
+$ pip install -r requirements.txt
+$ cat mycoolemail@foobar.com > accounts.txt  # the data source
+$ ./add-users-keycloak-api.py
+```
+
+`accounts.txt` just needs an email on each new line.