OCDL: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
K
→Verfügbare gespeicherte Suchen auslesen
Flopp (Diskussion | Beiträge) Keine Bearbeitungszusammenfassung |
Dl6hbo (Diskussion | Beiträge) |
||
(9 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
'''OCDL''' ('''O'''pen'''c'''aching '''D'''own'''l'''oader) ist ein [[wikipedia:Python_(Programmiersprache)|Python]]-Skript zum | '''OCDL''' ('''O'''pen'''c'''aching '''D'''own'''l'''oader) ist ein [[wikipedia:Python_(Programmiersprache)|Python]]-Skript zum Download von [[Suchformular#Gespeicherte Suche|gespeicherten Suchen]] als [[GPX-Datei|GPX-Dateien]]. OCDL ist besonders dann nützlich, wenn man regelmäßig gespeicherte Suchen herunterladen möchte, beispielsweise um die Cache-Datenbank von [[OpenCacheManager]] auf einem aktuellen Stand zu halten. Das Skript ist dabei weniger für die manuelle und interaktive Verwendung gedacht, als für den automatisierten, zeitgesteuerten Aufruf, beispielsweise via [[wikipedia:Cron|Cron]]. | ||
== | == Systemvoraussetzungen == | ||
OCDL ist ein betriebssystemunabhängiges Skript und sollte auf allen Systemen lauffähig sein, auf denen eine aktuelle Python-Version installiert ist. Typische Unixe bringen Python bereits mit; unter Windows ist meist eine manuelle Installation von Python notwendig (z.B. [http://www.activestate.com/activepython ActivePython]). | |||
== Allgemein == | |||
Wie für Kommandozeilenprogramme üblich, verfügt OCDL über eine integrierte Hilfsfunktion, die über den | OCDL ist ein Kommandozeilenprogramm und wird daher innerhalb der Kommandozeile (Linux/Unix: Terminalfenster, Windows: Eingabeaufforderung) verwendet. | ||
Wie für Kommandozeilenprogramme üblich, verfügt OCDL über eine integrierte Hilfsfunktion, die über den Parameter <tt>--help</tt> aufgerufen werden kann: | |||
<pre> | <pre> | ||
user@host:~/GPX> ./ocdl.py --help | user@host:~/GPX> ./ocdl.py --help | ||
Zeile 50: | Zeile 51: | ||
</pre> | </pre> | ||
== Konfiguration == | |||
OCDL hat eine Setup-Funktion, die die notwendigen Verzeichnisse anlegt und den Nutzer nach seinen Zugangsdaten für Opencaching.de fragt. Dazu ruft man OCDL mit dem Parameter <tt>--setup</tt> auf und gibt seine Zugangsdaten ein: | OCDL hat eine Setup-Funktion, die die notwendigen Verzeichnisse anlegt und den Nutzer nach seinen Zugangsdaten für Opencaching.de fragt. Dazu ruft man OCDL mit dem Parameter <tt>--setup</tt> auf und gibt seine Zugangsdaten ein: | ||
<pre> | <pre> | ||
Zeile 62: | Zeile 62: | ||
Danach ist OCDL fertig konfiguriert und kann normal verwendet werden. Falls sich die Zugangsdaten ändern sollten, kann die Setup-Funktion jederzeit wieder aufgerufen werden. | Danach ist OCDL fertig konfiguriert und kann normal verwendet werden. Falls sich die Zugangsdaten ändern sollten, kann die Setup-Funktion jederzeit wieder aufgerufen werden. | ||
== Verfügbare gespeicherte Suchen auslesen == | |||
Mit dem Kommandozeilenparameter <tt>--list</tt> wird die Liste der | Mit dem Kommandozeilenparameter <tt>--list</tt> wird die Liste der im [[Benutzerprofil|Opencaching-Benutzerprofil]] gespeicherten Suchen abgefragt und ausgegeben: | ||
<pre> | <pre> | ||
user@host:~/GPX> ./ocdl.py --list | user@host:~/GPX> ./ocdl.py --list | ||
Zeile 69: | Zeile 69: | ||
42325999/'OC-only Deutschland' | 42325999/'OC-only Deutschland' | ||
</pre> | </pre> | ||
In obigem Beispiel sind zwei Suchen verfügbar, nämlich | In obigem Beispiel sind zwei Suchen verfügbar, nämlich „Tradis Berlin“ mit der ID 11339629 und „OC-only Deutschland“ mit der ID 42325999. Die ID-Nummern werden für den Download der Suchen benötigt. | ||
== Download der Suchen == | |||
Hat man festgestellt, welche Suchen überhaupt verfügbar sind, kann man diese auch herunterladen. Dazu | Hat man festgestellt, welche Suchen überhaupt verfügbar sind, kann man diese auch herunterladen. Dazu übergibt man die entsprechende ID als Parameter an OCDL. | ||
Mit folgendem Aufruf läd man die Suche | Mit folgendem Aufruf läd man die Suche „OC-only Deutschland“ als ZIP-komprimierte GPX-Datei herunter: | ||
<pre> | <pre> | ||
user@host:~/GPX> ./ocdl.py 42325999 | user@host:~/GPX> ./ocdl.py 42325999 | ||
Zeile 86: | Zeile 86: | ||
* <tt>--name NAME</tt> erzeugt Dateien nach dem Schema '''Name.zip''', wobei '''Name''' der Name der gespeicherten Suche ist; Leerzeichen im Name werden dabei durch Unterstriche ersetzt; im Beispiel: '''OC-only_Deutschland.zip''' | * <tt>--name NAME</tt> erzeugt Dateien nach dem Schema '''Name.zip''', wobei '''Name''' der Name der gespeicherten Suche ist; Leerzeichen im Name werden dabei durch Unterstriche ersetzt; im Beispiel: '''OC-only_Deutschland.zip''' | ||
* <tt>--name NAME+DATE</tt> erzeugt Dateien nach dem Schema '''Name_Datum.zip'''; im Beispiel: '''OC-only_Deutschland_2012-10-26.zip''' | * <tt>--name NAME+DATE</tt> erzeugt Dateien nach dem Schema '''Name_Datum.zip'''; im Beispiel: '''OC-only_Deutschland_2012-10-26.zip''' | ||
== Weblinks == | == Weblinks == | ||
* [https://github.com/flopp/ocdl.py Download bei github.com] | * [https://raw.github.com/flopp/ocdl.py/master/ocdl.py Direkt-Download von OCDL] | ||
* [https://github.com/flopp/ocdl.py OCDL bei github.com] | |||
* [http://www.python.org/ Python] | * [http://www.python.org/ Python] | ||
[[Kategorie: Geocaching-Software]] | [[Kategorie:Geocaching-Software]] | ||
[[Kategorie:Opencaching]] |