From de53cd6e8f3300d241cd30271f1752b53b37f463 Mon Sep 17 00:00:00 2001 From: Levi Olson Date: Thu, 14 Oct 2021 18:17:54 -0500 Subject: [PATCH] Add README.org --- README.org | 55 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 README.org diff --git a/README.org b/README.org new file mode 100644 index 0000000..ba81ead --- /dev/null +++ b/README.org @@ -0,0 +1,55 @@ +#+title: README + +* Installation + +#+begin_src shell + +git clone https://gitea.l3vi.co/leviolson/msgraph2orgmode + +cd msgraph2orgmode/ + +cp config-example.cfg config.cfg + +#+end_src + +Then install the python dependencies: + +Note: Consider optionally using a =Virtual Environment=. This ensures the installed packages are kept separate. +#+begin_src shell + +python -m venv venv + +source venv/bin/activate + +#+end_src + +Finally, install actual packages: + +#+begin_src shell + +pip install -r requirements.txt + +#+end_src + +* Usage +After installation, you're ready to get your =client_id= and =client_secret= from Azure. + +Follow the steps here -> https://github.com/microsoftgraph/python-sample-console-app#application-registration + +Then: + +1. Update =config.cfg= to contain your =client_id=. +1. Update =.authinfo.gpg= to include something like: +#+begin_src authinfo + +machine azure.api login email@example.com^client_secret password YOUR_CLIENT_ID_GOES_HERE_WITHOUT_SURROUNDING_QUOTES + +#+end_src + +And finally, you can run the tool with: + +#+begin_src shell + +python msgraph-orgmode.py + +#+end_src