Go to file
Jim Martens 91364e8a13 Added support for modern python build system 2020-01-13 08:27:28 +01:00
src/twomartens Fixed wrong links after fourth link was added in ALLRIS 2020-01-13 08:07:44 +01:00
.gitignore Create config file automatically if missing 2020-01-07 08:07:27 +01:00
LICENSE Initial commit 2020-01-06 22:10:14 +01:00
MANIFEST.in Include README and LICENSE in finished manifest 2020-01-08 21:45:59 +01:00
README.md Fixed wrong links after fourth link was added in ALLRIS 2020-01-13 08:07:44 +01:00
pyproject.toml Added support for modern python build system 2020-01-13 08:27:28 +01:00
setup.py Fixed wrong links after fourth link was added in ALLRIS 2020-01-13 08:07:44 +01:00

README.md

ALLRIS Scraper

Apache Licence 2.0 Supports Python 3.7 and 3.8 version 0.3.2

This scraper requires your username and password and performs the following tasks for you:

  • login
  • download of all agendas and motions related to upcoming meetings of committees and plenary sessions
    • Only considers meetings where you already have been invited formally through ALLRIS.

IMPORTANT: All districts are supported but official committe abbreviations will only work for Eimsbüttel as of now.

Requirements

Initial setup

  1. Install ALLRIS scraper pip install twomartens.allrisscraper (you need Python 3.7+)
  2. Run ALLRIS scraper a first time tm-allrisscraper (creates config ini in your current working directory)
  3. Fill out the config file with your login credentials and an absolute path on your system to store PDFs of files

Configuration

[Default]
; possible values for district: Altona, Bergedorf, Eimsbüttel, Hamburg-Nord, 
; Hamburg-Mitte, Harburg, Wandsbek
district = Eimsbüttel
; if you are not from Eimsbüttel your domain ending will differ
username = max.mustermann@eimsbuettel.de
; password is stored in clear text, therefore ini file should have most 
; restrictive read permissions
password = VerySecurePassword
; location for storage of PDFs (trailing slash is IMPORTANT)
pdflocation = /path/to/storage/of/PDFs/

Usage after initial setup

Run ALLRIS scraper: tm-allrisscraper (takes a few seconds to finish)

In the specified location for download you will find the following structure:

  • YYYY-MM-DD_Abbreviation of committee or plenary session/ (one directory for each meeting)
  • files inside the directory Einladung.pdf (contains invitation), Mappe.pdf (contains all motions in one document), and Tagesordnung.pdf (agenda)