helloasso-to-discourse/README.md

Helloasso to Discourse

This works in two distinct steps: first fetch HelloAsso data, then sync with Discourse.

Installing

pip install .

Fetching HelloAsso data

Use the fetch subcommand, I use it as is:

$ helloasso-to-discourse fetch "$(pass helloasso-clientid)" "$(pass helloasso-clientsecret)" afpy

this fetches the data of the given organization, here named afpy, it creates an ./afpy file.

Choosing what to sync

The goal is to sync an HelloAsso event (they call it forms) to a Discourse Badge.

First let's discover which events we can use:

$ helloasso-to-discourse list-forms ./afpy

this will list names that can be used for the next step.

Syncing with Discourse

This step actually assigns badges to Discourse users:

As an example to assign badge number 114 to HelloAsso users having paid for the form named adhesion-2023-a-l-afpy:

$ helloasso-to-discourse sync https://discuss.afpy.org "$(pass discuss.afpy.org-api-key)" ./afpy adhesion-2023-a-l-afpy 114
$ helloasso-to-discourse sync https://discuss.afpy.org "$(pass discuss.afpy.org-api-key)" ./afpy pyconfr-2023 113