Erste Schritte

anYChe ist ein Akronym für AnniversaryChecker, was auf deutsch so viel wie JahrestagsPrüfer heißt. Von anYChe können mehrere Listen mit Jahresereignissen verwaltet werden. Zu einem Jahresereignis werden eine Person, das Datum und der Anlass des Ereignisses sowie beliebige Notizen gespeichert. anYChe kann so konfiguriert werden, dass direkt nach dem Anmelden des Nutzers eine Überprüfung auf anstehende Jahrestage erfolgt. Diese Überprüfung kann aber auch zeitgesteuert zu jedem beliebigen Zeitpunkt erfolgen. Im Übrigen können Sie dieses Benutzerhandbuch auch mit Ihrem bevorzugten Browser betrachten. Im Installationsverzeichnis von anYChe finden Sie einen Unterordner help, welcher wiederum das Verzeichnis de beinhaltet. Hier können Sie die Datei handbuch.html mit Ihrem Browser öffnen.

Voraussetzungen

anYChe steht unter Linux und Windows zur Verfügung. Apples Mac OSX sollte zwar grundsätzlich auch funktionieren, doch konnte ich das bislang mangels Hardware nicht testen. Im Grunde sind alle Plattformen denkbar, für die es neben der Programmiersprache Python auch das Cross-Entwicklungswerkzeug wxPython und somit auch wxWidgets gibt.

Installation / Deinstallation

Zunächst einmal müssen Sie sich eine aktuelle Version des Programms für Ihr Betriebssystem herunterladen.

Linux
Unter Linux wird anYChe in Form eines gepackten TAR-Archivs geliefert. Dieses Archiv können Sie an einer beliebigen Stelle in Ihrem Dateisystem entpacken. In der Regel bietet sich dafür das Verzeichnis /opt an. Folgende Kommandos müssen Sie dazu in einer Shell eintippern (x und y müssen Sie durch die passenden Versionsnummern ersetzen):

# cd /opt
# mkdir anyche
# cd anyche
# tar zxvf /pfad/zu/ihrem/downloadverzeichnis/anyche-x.y.tgz

Sofern auf Ihrem System die Pakete für Python 2.6 oder 2.8, wxWidgets 2.8 und wxPython 2.8 installiert sind, sollte sich anYChe durch Eingabe von /opt/anyche/anyche starten lassen. Sie sehen dann das Hauptfenster des Programms.

Windows XP / Windows 7
Die Installation erfolgt wie allgemein üblich durch Ausführen der Datei anyche-setup-x.y.exe (x und y stehen für die genaue Versionsbezeichnung). Während der Installation werden Sie gefragt, in welchem Installationsordner Sie anYChe ablegen möchten, ob ein Desktop-Symbol angelegt und ob das Programm direkt gestartet werden soll. Mit den Schaltflächen Weiter und Zurück können Sie dabei bequem durch die einzelnen Installationsschritte navigieren. Im letzten Schritt beenden Sie die Installation durch einen Klick auf die Schaltfläche Fertigstellen.

Sollten Sie anYChe nicht mehr benötigen, können Sie das Programm über die Windows-Systemsteuerung einfach wieder entfernen. Dabei wird lediglich das Programmverzeichnis gelöscht. Eventuelle Datendateien mit Jahresereignissen müssen Sie bei Bedarf manuell mit dem Windows Explorer von Ihrer Festplatte entfernen.

Wenn Sie selber Entwickler sind und bereits ein Python 2.6 oder 2.8 auf Ihrem Windows-System installiert haben, können Sie alternativ auch das TAR-Archiv herunterladen und mit einem Programm wie 7zip in einem Verzeichnis Ihrer Wahl installieren. Zusätzlich benötigen Sie auch die Windows-Installationen von wxWidgets und wxPython auf Ihrem System. Sodann können Sie anYChe durch Aufruf von python anyche.py starten.

Startargumente

Beim Aufruf von anyche können unterschiedliche Parameter angegeben werden:

• -c, --check: Mit diesem Argument prüft anYChe auf anstehende Jahresereignisse. Wenn keine passenden Ereignisse gefunden werden, wird anYChe sofort wieder beendet. Werden jedoch Treffer gefunden, zeigt anYChe diese in einem Fenster an.
• --checkconsole=text: Mit diesem Argument prüft anYChe auf anstehende Jahresereignisse. Wenn keine passenden Ereignisse gefunden werden, wird anYChe sofort wieder beendet. Werden jedoch Treffer gefunden, zeigt anYChe diese in Textform auf der Konsole an. Dieses Startargument steht nicht zur Verfügung, wenn Sie anYChe über das Windows-Installationsprogramm installiert haben!
• --checkconsole=csv: Mit diesem Argument prüft anYChe auf anstehende Jahresereignisse. Wenn keine passenden Ereignisse gefunden werden, wird anYChe sofort wieder beendet. Werden jedoch Treffer gefunden, zeigt anYChe diese in Form einer kommaseparierten Liste an. Diese Ausgabe ist für eine Weiterverarbeitung mit anderen Programmen gedacht. Dieses Startargument steht nicht zur Verfügung, wenn Sie anYChe über das Windows-Installationsprogramm installiert haben!
• -f DATEI, --file=DATEI: Mit dieser Angabe können Sie explizit eine Konfigurationsdatei angeben. Es ist empfehlenswert, diese Datei mit einer absoluten Pfadangabe anzugeben. Normalerweise ist dieser Parameter jedoch nicht notwendig, da anYChe selbst plattformabhängig den richtigen Speicherort für die Konfigurationsdatei wählt.
  • Linux: Im Heimatverzeichnis des Nutzers wird die Konfiguration in der Datei .anyche gespeichert.
  • Windows: Die Dateien werden unter c:\benutzer\\AppData\Local\scheernet.de\ in der Datei anyche.ini gespeichert. Es erfolgt keine Speicherung in der Registry von Windows!
• --force: In den Einstellungen von anYChe können Sie angeben, dass eine Überprüfung auf anstehende Jahrestage nur einmal am Tag stattfinden soll. Mit der Option --force können Sie diese Einstellung einmalig abschalten. Wenn diese Option angegeben wird, muss auch entweder --check oder --checkconsole=text|csv mit angegeben werden. Dieses Startargument steht nicht zur Verfügung, wenn Sie anYChe über das Windows-Installationsprogramm installiert haben!
• --help: Anzeige eines kurzen Hilfetextes. Dieses Startargument steht nicht zur Verfügung, wenn Sie anYChe über das Windows-Installationsprogramm installiert haben!
• --version: Anzeige der aktuellen Versionsnummer. Dieses Startargument steht nicht zur Verfügung, wenn Sie anYChe über das Windows-Installationsprogramm installiert haben!
• -w SEKUNDEN, --wait=SEKUNDEN: Mit diesem Parameter können Sie die Anzahl Sekunden einstellen, um die eine Prüfung auf anstehende Ereignisse verzögert werden soll. Wenn diese Option angegeben wird, muss auch entweder --check oder --checkconsole=text|csv angegeben werden. Wenn die Option --check angegeben wurde, dann setzt die Option --wait den Wert in den Einstellungen von anYChe außer Kraft. Auf diese Weise ist es möglich, über die Einstellungen von anYChe eine Standardverzögerung einzustellen, die bei Bedarf über --wait an andere Situationen angepasst werden kann. Wenn bei --wait der Wert 0 angegeben wird, erfolgt keine Verzögerung der Prüfung.