]> code.communitydata.science - nu-vpn-proxy.git/commitdiff
Add installation notes
authorJason Owen <jason@jasonaowen.net>
Sat, 19 Oct 2019 00:06:53 +0000 (17:06 -0700)
committerJason Owen <jason@jasonaowen.net>
Sat, 19 Oct 2019 00:06:53 +0000 (17:06 -0700)
Add some instructions on how to install the dependencies needed to use
this tool.

README.md

index 6df9f5d9e07756f9de5c6594923a0c2259ab8f8f..aa947786234eb3579835f004f1cc42d5da1f8709 100644 (file)
--- a/README.md
+++ b/README.md
@@ -8,6 +8,27 @@ Interactive login is, unfortunately, sometimes a necessary alternative to automa
 login via scripts such as
 [zdave/openconnect-gp-okta](https://github.com/zdave/openconnect-gp-okta).
 
+Installation
+============
+
+gp-saml-gui uses GTK, which requires Python 3 bindings.
+
+On Debian / Ubuntu, these are packaged as `python3-gi`, `gir1.2-gtk-3.0`, and
+`gir1.2-webkit2-4.0`:
+
+```
+$ sudo apt install python3-gi gir1.2-gtk-3.0 gir1.2-webkit2-4.0
+```
+
+Then, set up a virtual environment that can access these system packages,
+activate it, and install the Python dependencies:
+
+```
+$ virtualenv --python=python3 --system-site-packages venv
+$ . venv/bin/activate
+$ pip install requests
+```
+
 How to use
 ==========
 
@@ -45,7 +66,6 @@ TODO
 ====
 
 * Packaging
-* Explain dependencies
 
 License
 =======

Community Data Science Collective || Want to submit a patch?