Benutzung

Scrape-A-RIS wird über die Kommandozeile ausgeführt. Hier wird ausführlich erklärt, wie das Programm aufgerufen werden kann und was die verschiedenen Optionen bewirken.

Vorbedingung 1: Arbeitsverzeichnis = Hauptverzeichnis

Für alle Aufrufe müssen wir uns als aufrufender Benutzer im Hauptverzeichnis von Scrape-A-RIS befinden. Das ist das Verzeichnis, in dem die Datei README.md, main.py und config.py zu finden sind.

Vorbedingung 2: Richtige Python-Umgebung gestartet?

Wer - wie in der Installationsanleitung empfohlen - eine virtualenv Umgebung für Scrape-A-RIS eingerichtet hat, muss diese zunächst starten, bevor er/sie die nachstehenden Kommandos ausführen kann.

Angenommen, Deine virtuelle Python-Umgebung ist im Ordner venv angelegt, dann lautet der Befehl zum Aktivieren dieser Umgebung:

$ source venv/bin/activate

Konvention: Das Dollar-Zeichen vor einer Befehlszeile gilt innerhalb dieser Anleitung nicht als Teil des Befehlsaufrufs.

Erster Test

Wenn alle Voraussetzungen erfüllt sind, solltest Du den folgenden Aufruf ausprobieren können:

$ python main.py

Hier sollte, wenn alles in Ordnung ist, gar nichts passieren. Das heißt, im Hintergrund passiert schon etwas. Zum Beispiel wird geguckt, ob Deine Konfigurationsdatei vorhanden ist, ob die Datenbank erreichbar ist und ob das RIS, das Du später scrapen willst, gefunden werden kann. Aber es wird - sofern alles funktioniert wie erwartet - nichts ausgegeben.

Um wenigstens ein kleines bisschen Rückmeldung zu bekommen, kannst Du den -v Parameter (für "verbose" = ausführlich) hinzufügen. Wichtig: Alle Parameter, die hier erläutert werden, müssen hinter dem Dateinamen main.py stehen.

$ python main.py -v
Found ASP template system