aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorArun Isaac2025-01-04 16:00:29 +0000
committerArun Isaac2025-01-04 16:00:29 +0000
commitbd69a8b6c33f56d1ea9eb83f0fc612b310d0a43d (patch)
treee88d3114d3251b646493254195e4db641377d5dd
parent88686ab7f52955bb50f603040e8dd29bac2b459b (diff)
downloadglobus-weblinks-bd69a8b6c33f56d1ea9eb83f0fc612b310d0a43d.tar.gz
globus-weblinks-bd69a8b6c33f56d1ea9eb83f0fc612b310d0a43d.tar.lz
globus-weblinks-bd69a8b6c33f56d1ea9eb83f0fc612b310d0a43d.zip
Add "How it works" section to README.
-rw-r--r--README.md6
1 files changed, 6 insertions, 0 deletions
diff --git a/README.md b/README.md
index 0b0cbfa..5e68609 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,11 @@
This python script is a quick hack to download data from Globus via HTTPS and without having to set up any Globus-specific tools. This is convenient if you simply want to download data from a Globus collection, and don't wish to set up their complex proprietary tooling.
+# How it works
+
+We use [globus-sdk](https://pypi.org/project/globus-sdk/) to traverse the file tree in our Globus collection and obtain HTTPS links for them. Then, we download the files authenticating using cookies extracted from the Globus web app.
+
+Really, this is hacky abuse of the single file HTTPS download links that the Globus web app provides. Doing everything through globus-sdk would be preferable, but I haven't figured out how. And, it works for now.
+
# Dependencies
[globus-sdk](https://pypi.org/project/globus-sdk/) and requests are the only dependencies. The easiest way to obtain them is to use GNU Guix. You will need the [guix-bioinformatics channel](https://git.genenetwork.org/guix-bioinformatics/about/).