From f79b4bd3247385c4b72467bf530af55f23aa6b7a Mon Sep 17 00:00:00 2001
From: Matthijs Kooijman <matthijs@stdin.nl>
Date: Tue, 3 Sep 2019 13:31:55 +0200
Subject: [PATCH 1/3] main: Support running from virtualenv

This fixes #105
---
 README.md | 38 ++++++++++++++++++++++++++++++++++++++
 main.py   | 11 +++++++++++
 2 files changed, 49 insertions(+)

diff --git a/README.md b/README.md
index 595c244..5744d38 100644
--- a/README.md
+++ b/README.md
@@ -47,6 +47,44 @@ support is still experimental.
 
         /python version
 
+## Using virtualenv
+If you want to install dependencies inside a virtualenv, rather than
+globally for your system or user, you can use a virtualenv.
+Weechat-Matrix will automatically use any virtualenv it finds in a
+directory called `venv` next to its main Python file (after resolving
+symlinks). Typically, this means `~/.weechat/python/venv`.
+
+To create such a virtualenv, you can use something like below. This only
+needs to happen once:
+
+```
+virtualenv ~/.weechat/python/venv
+```
+
+Then, activate the virtualenv:
+
+```
+. ~/.weechat/python/venv/bin/activate
+```
+
+This needs to be done whenever you want to install packages inside the
+virtualenv (so before running the `pip install` command documented
+above.
+
+
+Once the virtualenv is prepared in the right location, Weechat-Matrix
+will automatically activate it when the plugin is loaded. This should
+not affect other plugins, which seem to have a separate Python
+environment.
+
+Note that this only supports virtualenv tools that support the
+[`activate_this.py` way of
+activation](https://virtualenv.pypa.io/en/latest/userguide/#using-virtualenv-without-bin-python).
+This includes the `virtualenv` command, but excludes pyvenv and the
+Python3 `venv` module. In particular, this works if (for a typical
+installation of `matrix.py`) the file
+`~/.weechat/python/venv/bin/activate_this.py` exists.
+
 ## Uploads
 
 Uploads are done using a helper script, the script found under
diff --git a/main.py b/main.py
index db71a70..162cfa3 100644
--- a/main.py
+++ b/main.py
@@ -18,6 +18,17 @@
 from __future__ import unicode_literals
 
 import os
+
+# See if there is a `venv` directory next to our script, and use that if
+# present. This first resolves symlinks, so this also works when we are
+# loaded through a symlink (e.g. from autoload).
+# See https://virtualenv.pypa.io/en/latest/userguide/#using-virtualenv-without-bin-python
+# This does not support pyvenv or the python3 venv module, which do not
+# create an activate_this.py: https://stackoverflow.com/questions/27462582
+activate_this = os.path.join(os.path.dirname(os.path.realpath(__file__)), 'venv', 'bin', 'activate_this.py')
+if os.path.exists(activate_this):
+    exec(open(activate_this).read(), {'__file__': activate_this})
+
 import socket
 import ssl
 import textwrap

From 904d65675222bc3ba5b2af219a3c7e4457924689 Mon Sep 17 00:00:00 2001
From: Matthijs Kooijman <matthijs@stdin.nl>
Date: Tue, 3 Sep 2019 13:32:19 +0200
Subject: [PATCH 2/3] README: Document when make install does

---
 README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/README.md b/README.md
index 5744d38..a0d4da5 100644
--- a/README.md
+++ b/README.md
@@ -36,6 +36,10 @@ support is still experimental.
 
 3. As your regular user, just run: `make install` in this repository directory.
 
+    This installs the main python file (`main.py`) into
+    `~/.weechat/python/` (renamed to `matrix.py`) along with the other
+    python files it needs (from the `matrix` subdir).
+
     Note that weechat only supports Python2 OR Python3, and that setting is
     determined at the time that Weechat is compiled.  Weechat-Matrix can work with
     either Python2 or Python3, but when you install dependencies you will have to

From 6534ae2b7c040acd2947b17fa5667e49ff87df21 Mon Sep 17 00:00:00 2001
From: Matthijs Kooijman <matthijs@stdin.nl>
Date: Tue, 3 Sep 2019 13:45:36 +0200
Subject: [PATCH 3/3] README: Document runing from git directly

---
 README.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/README.md b/README.md
index a0d4da5..06f843d 100644
--- a/README.md
+++ b/README.md
@@ -89,6 +89,28 @@ Python3 `venv` module. In particular, this works if (for a typical
 installation of `matrix.py`) the file
 `~/.weechat/python/venv/bin/activate_this.py` exists.
 
+## Run from git directly
+
+Rather than copying files into `~/.weechat` (step 3 above), it is also
+possible to run from a git checkout directly using symlinks.
+
+For this, you need two symlinks:
+
+```
+ln -s /path/to/weechat-matrix/main.py ~/.weechat/python/matrix.py
+ln -s /path/to/weechat-matrix/matrix ~/.weechat/python/matrix
+```
+
+This first link is the main python file, that can be loaded using
+`/script load matrix.py`. The second link is to the directory with extra
+python files used by the main script. This directory must be linked as
+`~/.weechat/python/matrix` so it ends up in the python library path and
+its files can be imported using e.g. `import matrix` from the main python
+file.
+
+Note that these symlinks are essentially the same as the files that
+would have been copied using `make install`.
+
 ## Uploads
 
 Uploads are done using a helper script, the script found under