sitzungsdienst 1.6.1

A simple Python utility for converting the weekly assignment PDF by the "Staatsanwaltschaft Freiburg"

sitzungsdienst

A simple Python utility for converting the weekly assignment PDF by the "Staatsanwaltschaft Freiburg" into csv, json as well as ics files.

Getting started

Running setup.bash will install all dependencies inside a virtual environment, ready for action:

# Set up & activate virtualenv
virtualenv -p python3 venv

# shellcheck disable=SC1091
source venv/bin/activate

# Install dependencies
python -m pip install --editable .

Usage

Using this library is straightforward:

$ sta --help
Usage: sta [OPTIONS] SOURCE

  Extract weekly assignments from SOURCE file.

Options:
  -o, --output PATH         Output filename, without extension.
  -d, --directory TEXT      Output directory.
  -f, --file-format TEXT    File format, "csv", "json" or "ics".
  -q, --query TEXT          Query assignees, eg for name, department.
  -i, --inquiries FILENAME  JSON file with parameters for automation.
  -c, --clear-cache         Remove existing files in directory first.
  -v, --verbose             Enable verbose mode.
  --version                 Show the version and exit.
  --help                    Show this message and exit.

The following code snippet provides a very basic batch processing example:

#!/bin/bash

# Create multiple calendar files at once
for arg; do
   sta -f ics -q "$arg" -o "$arg" source.pdf
done

Calling this script with something like bash script.bash alice bob charlie would give you alice.ics, bob.ics and charlie.ics, each containing their respective assignments.

However, you might want to store these information inside a json file and pass it via --inquiries:

[
    {
        "output": "study-group",
        "query": [
            "123",
            "456",
            "789"
        ]
    },
    {
        "output": "alice",
        "query": [
            "123"
        ]
    },
    {
        "output": "bob",
        "query": [
            "456"
        ]
    },
    {
        "output": "all-events",
        "query": []
    }
]

The output property resembles the filename whereas query contains all search terms. Therefore, the first entry is equivalent to this command: sta -o study-group -q 123 -q 456 -q 789 source.pdf.

Example

After installing this package, eg with pip install sitzungsdienst, the underlying module may also be used directly:

from sitzungsdienst import Sitzungsdienst

# Pass file path (or its stream)
sta = Sitzungsdienst(file_path)

# Retrieve data
data = sta.data

# Use a subset by filtering it
filtered = sta.filter(['alice', 'bob'])

If you want to see it in action, head over to the sitzungsapp!

Happy coding!