#+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= as well as the ~machine~ name and ~login~ you choose.
1. Update =.authinfo.gpg= to include something like:
#+begin_src authinfo

machine azure.api login email@example.com^client_secret password CLIENT_SECRET_GOES_HERE

#+end_src

Given the above authinfo entry, you would set the following in =config.cfg=:
#+begin_src conf
#...
client_id=CLIENT_ID_GOES_HERE
machine=azure.api
login=email@example.com
#...
#+end_src

And finally, you can run the tool with:

#+begin_src shell

python msgraph-orgmode.py

#+end_src