OCDL: Unterschied zwischen den Versionen

14 Bytes hinzugefügt ,  27. Oktober 2012
ohne die qualität dieses tollen scripts schmälern zu wollen: unter "komfortabel" werden die allermeisten leser eine gui erwarten; "Plattform" missverständlich wegen Geocaching-Plattformen
(Überflüssiges Windows-Zeug entfernt)
(ohne die qualität dieses tollen scripts schmälern zu wollen: unter "komfortabel" werden die allermeisten leser eine gui erwarten; "Plattform" missverständlich wegen Geocaching-Plattformen)
Zeile 1: Zeile 1:
'''OCDL''' ('''O'''pen'''c'''aching '''D'''own'''l'''oader) ist ein [[wikipedia:Python_(Programmiersprache)|Python]]-Skript zum komfortablen 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.
'''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.


== Systemvoraussetzungen ==
== Systemvoraussetzungen ==
OCDL ist ein plattformübergreifendes Python-Skript und sollte auf allen Systemen lauffähig sein, auf denen eine aktuelle Python-Version installiert ist.
OCDL ist ein betriebssystemunabhängiges Python-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]).
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 ==
== Allgemein ==
OCDL ist ein Kommandozeilenprogramm und wird daher innerhalb der Kommandozeile (Linux/Unix: Terminalfenster, Windows: Eingabeaufforderung) verwendet.
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 Kommandozeilenparameter <tt>--help</tt> aufgerufen werden kann:
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 51: Zeile 51:
| config directory for future logins.                                      |
| config directory for future logins.                                      |
</pre>  
</pre>  


== Konfiguration ==
== Konfiguration ==
Zeile 65: Zeile 64:


== Verfügbare gespeicherte Suchen auslesen ==
== Verfügbare gespeicherte Suchen auslesen ==
Mit dem Kommandozeilenparameter <tt>--list</tt> wird die Liste der online verfügbaren gespeicherten Suchen abgefragt und ausgegeben:
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 71: Zeile 70:
42325999/'OC-only Deutschland'
42325999/'OC-only Deutschland'
</pre>  
</pre>  
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-Werte sind wichtig für den Download der Suchen.
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 Download der Suchen benötigt.


== Download der Suchen ==
== Download der Suchen ==
Hat man festgestellt, welche Suchen überhaupt verfügbar sind, kann man diese auch herunterladen. Dazu gibt man die entsprechende ID als Parameter an OCDL.  
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 "OC-only Deutschland" als ZIP-komprimierte GPX-Datei herunter:
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
2.505

Bearbeitungen