CATweasel Toolkit v4.0.5

Einheitliche Befehle, aussagekräftige Exit-Codes und eigenes Branding im PDFParser

Mit der Version 4.0.5 erhält das CATweasel Toolkit zahlreiche Verbesserungen bei der Einbindung in bestehende Arbeitsabläufe, bei der Konfiguration und bei der Zuverlässigkeit der Auswertungsergebnisse. Damit lässt sich das Toolkit noch besser aus Skripten und anderen Programmen heraus steuern.

Im Mittelpunkt stehen die einheitliche Benennung der Befehle, Exit-Codes nach einer etablierten Konvention, ein eigenes Branding für die Ergebnis-PDFs sowie eine stabile, reproduzierbare Sortierung von Klemmen und Betriebsmitteln.

Einheitliche Befehle und bessere Integration

Befehle mit dem Präfix ctw-

Die Befehle des Toolkits beginnen jetzt mit ctw-. Dadurch werden Konflikte mit gleichnamigen Befehlen anderer Programme vermieden. Der PDFParser wird zum Beispiel so aufgerufen:

ctw-pdfparser Schaltplan.pdf

Der bisherige Befehl pdfparser funktioniert vorerst weiter, gibt jedoch einen Hinweis aus und entfällt in einer späteren Version. Skripte, die ihn verwenden, sollten daher angepasst werden. Verknüpfungen, das Menü „Senden an“ und der Eintrag „Öffnen mit“ werden vom Installer automatisch aktualisiert.

Exit-Codes für aufrufende Programme

Die Anwendungen melden jetzt mit ihrem Exit-Code, was schiefgegangen ist. Aufrufende Programme und Skripte können so gezielt auf die Art des Fehlers reagieren, statt nur zwischen „erfolgreich“ und „fehlgeschlagen“ zu unterscheiden. Die Codes folgen der verbreiteten sysexits.h-Konvention, zum Beispiel:

  • 64 fehlerhafter Aufruf
  • 66 Eingabedatei nicht gefunden
  • 73 Ausgabedatei kann nicht geschrieben werden
  • 78 Konfigurationsfehler
  • 130 Abbruch durch den Benutzer

Die vollständige Liste enthält das Handbuch jeder Anwendung (–man). Auch die Startskripte wie ctw-pdfparser.cmd und catweasel.cmd geben den Exit-Code jetzt an den Aufrufer weiter. Bisher lieferten sie immer 0. Fehlermeldungen werden außerdem nur noch einmal angezeigt.

Parser für einzelne Aufrufe festlegen

Der Parser des PDFParsers kann für einen einzelnen Aufruf vorgegeben werden, etwa wenn der PDFParser von einem anderen Programm gestartet wird. Die Parserauswahl wird dann nicht angezeigt:

ctw-pdfparser --DefaultParser=SignedPageDeviceCounter Schaltplan.pdf

Alternativ ist die Umgebungsvariable CATWEASEL_DefaultParser möglich. Ein unbekannter Name wird mit einer Liste der konfigurierten Parser abgewiesen.

Strengere Prüfung der Kommandozeile

Optionen müssen jetzt vollständig ausgeschrieben werden. Abkürzungen wie –log für –log-level werden nicht mehr akzeptiert. Der PDFParser erwartet genau eine PDF-Datei. Dateinamen mit Leerzeichen sind beim direkten Aufruf in Anführungszeichen zu setzen. Der Aufruf per Drag-and-Drop oder über „Senden an“ ist davon nicht betroffen.

Eigenes Branding im Ergebnis-PDF

Der PDFParser kann auf jeder Seite des Ergebnis-PDFs ein Wasserzeichen und einen Stempel anbringen, beispielsweise das eigene Firmenlogo. Beide werden als PDF-Datei hinterlegt:

  • var/custom/branding/watermark.pdf wird auf die Seitengröße skaliert und halbtransparent dargestellt.
  • var/custom/branding/stamp.pdf behält seine Größe und wird in einer Ecke platziert.

Sind die Dateien vorhanden, werden sie automatisch verwendet. Andere Dateien, die Deckkraft und die Ecke des Stempels lassen sich im neuen Block <Branding> der pdfparser.cfg einstellen. Die Testversion enthält ein Wasserzeichen und einen Stempel mit QR-Code zur Anforderung der Vollversion. Der Installer der Vollversion entfernt diese wieder, eigene Dateien bleiben erhalten.

Zuverlässigere Konfiguration

Relative Pfade und Umgebungsvariablen

Relative Pfade in der Konfiguration, etwa bei FilterConfig oder einem <Target>-Ordner, beziehen sich jetzt immer auf das Installationsverzeichnis, unabhängig davon, von wo aus der PDFParser gestartet wird. Außerdem können Umgebungsvariablen in Pfaden verwendet werden:

<Target "$PUBLIC\Documents\CATweasel">

Eine fehlende Filterdatei wird als Konfigurationsfehler mit vollständigem Pfad gemeldet.

Neu benannte und zusätzliche Parser

Die vorinstallierten Parser sind jetzt nach dem benannt, was sie erkennen. Aus „Standardfilter IEC81346“ wird SignedPageDeviceCounter, aus „Sonderfilter EXAMPLE“ wird PageDeviceCounter. Die Filterregeln selbst bleiben unverändert. Bei einem Update passt der Installer die Include-Zeilen in der pdfparser.cfg an und bewahrt die bisherigen Dateien als .old auf, damit eigene Anpassungen übernommen werden können. Hinzu kommt der neue Parser SignedDeviceCounter für Betriebsmittelkennzeichen wie -K1 ohne Seitenangabe. Die Kommentare der Parser-Konfigurationen wurden überarbeitet, alle Parameter sind zentral in _example.cfg.tmpl dokumentiert.

Stabile und nachvollziehbare Sortierung

Klemmen, die Ziffern und Buchstaben kombinieren, etwa 1A, 11C oder 24VDC, werden jetzt natürlich sortiert, zum Beispiel 1A, 1B, 4A, 11A. Bisher konnte ihre Reihenfolge von Lauf zu Lauf abweichen. Damit liefert derselbe Schaltplan jetzt stets dasselbe Ergebnis.

Außerdem werden PA- und SH-Klemmen wie im Handbuch beschrieben am Ende der Klemmleiste hinter PE eingeordnet. Betriebsmittel ohne Nummer wie -K erscheinen direkt vor den nummerierten Betriebsmitteln gleicher Kennbuchstaben (-K, -K1, -K2) statt in einem eigenen Block am Anfang der Liste.

Fehlerbehebungen

  • Der PDFParser prüft vor der Auswertung, ob Ergebnis-PDF und Exportdateien geschrieben werden können. Ist eine Datei noch geöffnet, etwa im PDF-Viewer oder in Excel, bricht er sofort mit einem Hinweis auf die Datei ab, statt erst nach der vollständigen Auswertung zu scheitern.
  • In der Parserauswahl fehlten Parser mit gleichem SortCriteria. Jetzt werden alle Parser angeboten.
  • Ist nur ein Parser konfiguriert, wird er direkt verwendet, statt zu einem internen Fehler zu führen.
  • Das Verlassen der Parserauswahl ohne Auswahl wird als Abbruch durch den Benutzer behandelt (Exit-Code 130).
  • PDF-Dateien mit einem Ausrufezeichen im Namen werden per Drag-and-Drop und „Senden an“ wieder gefunden.
  • Ein Start ohne Datei, etwa über das Startmenü, schließt das Fenster nicht mehr sofort, sondern zeigt die Fehlermeldung an.

Ausblick

Die Anwendungen unterstützen jetzt Unterbefehle mit eigenen Optionen und eigener Hilfe. Diese Struktur bildet die Grundlage für das neu entwickelte Modul Lagerist zur Verwaltung von Materialdaten und Stücklisten, das in einer kommenden Version vorgestellt wird.

Zusammenfassung

Die Version 4.0.5 macht das CATweasel Toolkit robuster und erleichtert die Einbindung in bestehende Arbeitsabläufe:

  • Einheitliche Befehle mit dem Präfix ctw- vermeiden Konflikte mit anderen Programmen.
  • Aussagekräftige Exit-Codes ermöglichen aufrufenden Programmen eine gezielte Fehlerbehandlung.
  • Eigenes Branding mit Wasserzeichen und Stempel im Ergebnis-PDF.
  • Zuverlässigere Konfiguration durch einheitliche relative Pfade und Umgebungsvariablen.
  • Reproduzierbare Ergebnisse dank stabiler Sortierung von Klemmen und Betriebsmitteln.
  • Frühzeitige Fehlererkennung, wenn Ergebnisdateien noch geöffnet sind.

Wer pdfparser in eigenen Skripten aufruft, sollte diese auf ctw-pdfparser umstellen und dabei die neuen Exit-Codes berücksichtigen.

CATweasel Toolkit v4.0.4

Verbesserungen bei Konfiguration, Kommandozeile und CSV-Export

Mit der Version 4.0.4 erhält das CATweasel Toolkit zahlreiche Verbesserungen, die insbesondere die Bedienung der Anwendungen, die Integration in bestehende Arbeitsabläufe und die Ausgabe von Analyseergebnissen betreffen. Neben der Behebung eines Fehlers bei der Verarbeitung von Konfigurationsblöcken wurden neue Kommandozeilenfunktionen eingeführt, die Versionsinformationen zentral verfügbar machen und eine flexiblere Steuerung der Anwendungen ermöglichen.

Ein weiterer Schwerpunkt liegt auf einer übersichtlicheren Konsolenausgabe und einer vereinfachten Konfiguration des CSV-Exports. Damit wird die Arbeit mit dem Toolkit sowohl bei der manuellen Verwendung als auch beim automatisierten Einsatz in Skripten und anderen Anwendungen komfortabler.

Neue Kommandozeilenfunktionen

Zentrale Versionsabfrage mit catweasel

Mit der neuen Kommandozeilenanwendung catweasel steht eine zentrale Möglichkeit zur Verfügung, die installierte Version des CATweasel Toolkits und die Versionsstände seiner installierten Module abzufragen.

Der Aufruf

catweasel --version

gibt die Toolkit-Version zusammen mit den Versionen der installierten Module aus, beispielsweise des PDFParser. Die Versionsinformationen werden bei der Installation des Toolkits mit eingerichtet und stehen damit direkt auf dem jeweiligen System zur Verfügung.

Zusätzlich gibt es im Startmenü die neue Verknüpfung CATweasel VERSION. Sie öffnet ein Fenster mit den Versionsinformationen, das so lange geöffnet bleibt, bis eine Taste gedrückt wird. Dadurch lassen sich die installierten Versionsstände auch ohne die manuelle Eingabe eines Befehls schnell überprüfen.

Anwendungen gezielt über Kommandozeilenparameter steuern

Alle Anwendungen des CATweasel Toolkits unterstützen jetzt die zusätzlichen Kommandozeilenoptionen --SystemWait und --TempCleanup.

Mit diesen Optionen lassen sich die entsprechenden Einstellungen der Konfigurationsdatei für einen einzelnen Programmaufruf überschreiben, ohne die Konfiguration dauerhaft verändern zu müssen. Das ist besonders hilfreich, wenn Anwendungen in andere Programme, Arbeitsabläufe oder Skripte integriert werden.

Ein Beispiel für den PDFParser:

pdfparser.pl --SystemWait=false test.pdf

In diesem Fall wartet der PDFParser nach der Verarbeitung nicht auf eine weitere Tasteneingabe. Das erleichtert insbesondere die automatisierte Verarbeitung mehrerer Dateien, bei der eine manuelle Bestätigung nach jedem Durchlauf unerwünscht ist.

Für beide Optionen werden die Werte true und false akzeptiert. Alternativ können yes und no verwendet werden. Bei --SystemWait ist außerdem die Angabe einer Wartezeit in Sekunden möglich.

Die neuen Optionen bieten damit mehr Flexibilität bei der Steuerung des Programmverhaltens, ohne dass für unterschiedliche Einsatzszenarien separate Konfigurationsdateien benötigt werden.

Verbesserte Rückmeldungen und Konsolenausgabe

Countdown bei zeitgesteuertem Programmende

Wird über die Einstellung SystemWait eine Wartezeit in Sekunden festgelegt, zeigt die Anwendung jetzt einen Countdown mit der verbleibenden Zeit an.

Anstelle einer statischen Meldung ist damit jederzeit erkennbar, wie lange das Programm noch wartet, bevor der Vorgang abgeschlossen ist. Das verbessert die Übersicht bei der interaktiven Verwendung und macht das Verhalten der Anwendungen nachvollziehbarer.

Korrekte Behandlung der Log-Level-Option

Auch die Verarbeitung der Option --log-level wurde verbessert.

Bisher konnte die Meldung über eine Änderung des Log-Levels doppelt erscheinen. Außerdem wurde ein ungültiger Wert zunächst so behandelt, als wäre das Log-Level geändert worden, bevor sich herausstellte, dass die Angabe nicht zulässig ist.

Beide Probleme wurden behoben. Ungültige Log-Level werden nun direkt zurückgewiesen, wobei die verfügbaren gültigen Werte ausgegeben werden. Dadurch lassen sich fehlerhafte Kommandozeilenparameter schneller erkennen und korrigieren.

Aufgeräumte Konsolenausgabe

Die Start- und Beendigungsmeldungen der Anwendungen werden nun nur noch auf der Protokollierungsebene debug ausgegeben.

Dadurch bleibt die reguläre Konsolenausgabe übersichtlicher und konzentriert sich stärker auf die für den jeweiligen Verarbeitungsvorgang relevanten Informationen. Bei Bedarf können die detaillierteren Meldungen weiterhin über die Debug-Protokollierung eingesehen werden.

Fehlerbehebung bei Konfigurationsblöcken

Ein Fehler bei der Verarbeitung der Kurzschreibweise von Konfigurationsblöcken wurde behoben.

Betroffen waren unter anderem Konstrukte wie:

<Target "C:\Path" />

Je nach Schreibweise konnten verbleibende Leerzeichen oder Anführungszeichen dazu führen, dass der Name des Konfigurationsblocks nicht korrekt bereinigt wurde. In der Folge konnte beispielsweise ein angegebener Zielordner für den CSV-Export unbrauchbar sein.

Die Bereinigung der Blocknamen erfolgt jetzt unabhängig davon, in welcher Schreibweise ein Konfigurationsblock angegeben wurde. Dadurch werden die Namen konsistent verarbeitet und die daraus resultierenden Pfade zuverlässig nutzbar.

Vereinfachte Standardkonfiguration für den CSV-Export

Die Standardkonfigurationen für den CSV-Export wurden ebenfalls verbessert. Beide CSV-Exportkonfigurationen enthalten jetzt den folgenden Zielpfad als Standard:

C:\Users\Public\Documents\CATweasel

Damit steht ein festgelegtes Verzeichnis für CSV-Berichte zur Verfügung, in dem Analyseergebnisse direkt gespeichert werden können.

Insbesondere bei der PDF-Analyse entfällt dadurch die Notwendigkeit, das Exportziel zunächst manuell konfigurieren zu müssen. Das vereinfacht die Inbetriebnahme und erleichtert die Verwendung des CSV-Exports in bestehenden Arbeitsabläufen.

Zusammenfassung

Die Version 4.0.4 verbessert mehrere Bereiche des CATweasel Toolkits, von der Konfigurationsverarbeitung über die Kommandozeilensteuerung bis hin zur Ausgabe von Analyseergebnissen.

Die wichtigsten Neuerungen im Überblick:

  • Neue Versionsabfrage: Das Kommando catweasel --version zeigt die Version des Toolkits und die Versionsstände der installierten Module an.
  • Mehr Kontrolle über Programmaufrufe: Mit --SystemWait und --TempCleanup lassen sich Konfigurationseinstellungen für einzelne Aufrufe überschreiben.
  • Verbesserte Bedienbarkeit: Ein Countdown macht die verbleibende Wartezeit sichtbar.
  • Zuverlässigere Konfiguration: Konfigurationsblocknamen werden unabhängig von ihrer Schreibweise korrekt bereinigt.
  • Übersichtlichere Konsolenausgabe: Start- und Beendigungsmeldungen werden nur noch im Debug-Modus ausgegeben.
  • Einfacherer CSV-Export: Ein Standardzielpfad steht nun in beiden CSV-Exportkonfigurationen zur Verfügung.

Mit diesen Änderungen wird das CATweasel Toolkit robuster und flexibler. Besonders die neuen Kommandozeilenoptionen und die zentrale Versionsabfrage erleichtern die Integration und Verwaltung der Anwendungen, während die Korrekturen und Standardkonfigurationen für einen zuverlässigeren und komfortableren Arbeitsablauf sorgen.

CATweasel Toolkit v4.0.3

Mit Version 4.0.3 wird das CATweasel Toolkit an mehreren Stellen weiter verbessert. Der Schwerpunkt liegt diesmal auf einer übersichtlicheren Darstellung der PDF-Ergebnisse, einem komfortableren Windows-Installer sowie der Unterstützung von Entwicklungs- und Testversionen.

Verbesserte Darstellung der PDF-Ergebnisse

Der PDFParser zeichnet die erkannten Elemente im Ergebnis-PDF nun in einer festen Reihenfolge. Dadurch ist unabhängig von der Reihenfolge der Erkennung sichergestellt, dass die einzelnen Elemente korrekt sichtbar bleiben.

Die zusammengeführte Anschlussfläche eines Betriebsmittels wird dabei im Hintergrund dargestellt, einzelne Anschlüsse darüber und die Betriebsmittelkennzeichen schließlich im Vordergrund. Zuvor konnte es vorkommen, dass die zusammengeführte Anschlussfläche andere Erkennungsergebnisse teilweise überdeckte.

An der eigentlichen Erkennung oder an den Konfigurationseinstellungen ändert sich dadurch nichts. Es wurde ausschließlich die Darstellung des erzeugten Ergebnis-PDFs verbessert.

Verbesserungen am Windows-Installer

Der CATweasel-Uninstaller wird nun korrekt in der Windows-Liste der installierten Anwendungen registriert. Zusätzlich ist er direkt über den CATweasel-Ordner im Startmenü erreichbar.

Für Test- und Präsentationsversionen steht außerdem eine Verknüpfung zu den mitgelieferten Beispieldateien zur Verfügung. Diese wird bei entsprechenden Entwicklungsbuilds bereits standardmäßig zur Installation ausgewählt. Auch reguläre Release-Versionen können die Verknüpfung anlegen, wobei sie dort optional während der Installation ausgewählt werden kann.

Neue Vereinbarung für Test- und Präsentationsversionen

Mit den Entwicklungsbuilds wird eine neue Test- und Präsentationsvereinbarung eingeführt. Damit können aktuelle Entwicklungsstände des dev-Branches beispielsweise für Tests oder Präsentationen bereitgestellt werden.

Diese sogenannten Nightly Builds sind zeitlich auf einen Zeitraum von bis zu vier Wochen ausgelegt und werden ausdrücklich als Entwicklungsstände ohne Garantie, Support oder Sicherheitsupdates bereitgestellt. Rückmeldungen und Fehlerberichte sind selbstverständlich willkommen, begründen jedoch keinen Anspruch auf eine Bearbeitung oder Fehlerbehebung.

Angepasste Lizenzierung von Entwicklungsbuilds

Entwicklungsbuilds werden nicht mehr unter der ASL ausgeliefert. Der Installer weist bei diesen Versionen stattdessen auf die geltenden Bedingungen für Test- und Entwicklungsbuilds hin und installiert den entsprechenden Hinweis.

Die regulären Releases bleiben davon unberührt.

Vereinheitlichte Lizenzhinweise

Die Lizenzhinweise im Quellcode wurden vereinheitlicht. Sie verweisen nun einheitlich auf die LICENSE-Datei, die Bestandteil jeder Distribution ist. Dadurch wird vermieden, dass unterschiedliche oder veraltete Lizenztexte innerhalb des Quellcodes gepflegt werden müssen.

Fazit

Mit v4.0.3 werden vor allem bestehende Funktionen und Abläufe weiter abgerundet. Die Verbesserungen reichen von einer zuverlässigeren Darstellung der PDF-Ergebnisse über einen komfortableren Windows-Installer bis hin zu klar definierten Rahmenbedingungen für Entwicklungs- und Testversionen.

CATweasel Toolkit v4.0.2

Mit Version 4.0.2 wird die Filterverarbeitung des CATweasel Toolkits grundlegend flexibler. Die bisher fest implementierte Filterkonfiguration wurde durch die neuen CATweasel-Filterdefinitionen ersetzt.

Damit entsteht eine wesentlich bessere Grundlage für komplexere Filterregeln und zukünftige Erweiterungen der Erkennung.

Neue Filterarchitektur

Die bisher verwendeten Filtermodule wurden durch eine neue Filterarchitektur ersetzt. Anstelle der bisherigen ECAD::PDF::Filter::*-Module kommen nun die entsprechenden CTW::PDF::Filter::*-Module zum Einsatz.

Dabei handelt es sich nicht lediglich um eine Umbenennung. Die neue Struktur bildet eine technische Weiterentwicklung der Filterverarbeitung und schafft die Grundlage für künftig leistungsfähigere Filterdefinitionen.

Die bisherigen Modulnamen werden aus Gründen der Kompatibilität vorerst weiterhin akzeptiert. Ihre Verwendung wird jedoch im Log als Warnung protokolliert und ist nur als Übergangslösung vorgesehen. Bestehende Konfigurationen sollten daher auf die neuen CTW-Modulnamen umgestellt werden.

Einfachere Filterkonfiguration

Die Angabe eines Filters ist ab dieser Version optional.

Wird kein Filter explizit angegeben, wählt der PDFParser automatisch die passende Standardkonfiguration: Ist eine eigene FilterConfig vorhanden, wird der Custom-Filter verwendet. Andernfalls kommt der Standardfilter zum Einsatz.

Wird ein Filter ausdrücklich angegeben, hat diese Einstellung weiterhin Vorrang.

Dadurch können einfache Konfigurationen kompakter gehalten werden, während für komplexere Anwendungen weiterhin die vollständige Kontrolle über die Filterverarbeitung erhalten bleibt.

Aktualisierte Beispiele und Dokumentation

Die neue Filterarchitektur wurde auch in der Dokumentation und den mitgelieferten Beispielkonfigurationen berücksichtigt. Damit stehen die Beispiele unmittelbar mit der aktuellen technischen Struktur im Einklang.

Gerade bei bestehenden Installationen empfiehlt sich ein Blick auf die aktualisierte Dokumentation, um ältere Filterdefinitionen auf die neue Struktur umzustellen.

Angepasster XLSX-Export

Im XLSX-Export wurde das bisherige Tabellenblatt BMK in Devices umbenannt.

Die neue Bezeichnung entspricht damit der Benennung der zugehörigen Konfigurationsoptionen und sorgt für eine konsistentere Terminologie innerhalb des Exports.

Technische Bereinigung

Neben den funktionalen Änderungen wurden verschiedene binäre Dateien und Bestandteile der Distribution bereinigt. Dadurch konnten Größe und Komplexität der Distribution reduziert werden.

Auch diese Arbeiten tragen dazu bei, die technische Basis des CATweasel Toolkits übersichtlicher und besser wartbar zu halten.

Aktualisierte Lizenz

Mit Version 4.0.2 wurde außerdem die Lizenz auf ASL 1.1 aktualisiert.

Die neue Fassung stellt insbesondere die Rahmenbedingungen für die Nutzung in Container- und Hosting-Umgebungen klarer dar und berücksichtigt den Zugriff auf den Quellcode im Rahmen von Wartungsvereinbarungen.

Weitere Neuerung: Changelog

Mit dieser Version wird erstmals ein zentraler CHANGELOG.md Bestandteil der Distribution. Damit werden Änderungen und Neuerungen künftig versionsbezogen dokumentiert und können auch unabhängig von der ausführlichen technischen Dokumentation nachvollzogen werden.

Version 4.0.2 legt damit vor allem bei der Filterverarbeitung die Grundlage für weitere funktionale Erweiterungen und eine flexiblere Konfiguration des PDFParsers.

CATweasel Toolkit v4.0.1

Mit Version 4.0.1 wird die mit Version 4.0 eingeführte technische Basis weiter ausgebaut. Der Schwerpunkt liegt insbesondere auf den Exportfunktionen des PDFParsers, der Windows-Integration sowie einer weiteren Überarbeitung der Dokumentation und Konfiguration.

Neuer CSV-Export

Eine der wichtigsten Neuerungen ist die überarbeitete Implementierung des CSV-Exports.

Der CSV-Export bietet nun Konfigurationsmöglichkeiten, die sich an den bereits vorhandenen Optionen des XLSX-Exports orientieren. Zusätzlich stehen CSV-spezifische Einstellungen zur Verfügung.

Damit lassen sich die erzeugten CSV-Dateien wesentlich flexibler an die jeweiligen Anforderungen der Weiterverarbeitung anpassen.

Verbesserte Verarbeitung von PDF-Anhängen

Die Verarbeitung eingebetteter PDF-Dateien wurde verbessert. Ein Fehler bei der Erzeugung mehrerer Exporte, durch den PDF-Anhänge nicht in allen Fällen korrekt behandelt wurden, wurde behoben.

Damit ist die Kombination mehrerer Exporte und eingebetteter Dateien zuverlässiger geworden.

Verbesserte Verwaltung temporärer Dateien

Auch die Handhabung temporärer Dateien wurde überarbeitet. Die Erstellung, Verwendung und anschließende Bereinigung temporärer Dateien erfolgt nun kontrollierter.

Dies verbessert insbesondere die Zuverlässigkeit bei der Verarbeitung komplexerer Exportvorgänge und reduziert unnötig zurückbleibende temporäre Dateien.

Bessere Windows-Integration

Der PDFParser wird unter Windows nun für „Öffnen mit…“ registriert. PDF-Dateien können dadurch direkt über die Windows-Dateizuordnung mit dem PDFParser geöffnet werden.

Damit fügt sich der PDFParser besser in die gewohnte Arbeitsweise unter Windows ein.

Überarbeitete Konfiguration und Dokumentation

Die Konfigurationsmöglichkeiten des PDFParsers wurden weiter ausgebaut und entsprechend dokumentiert. Dies betrifft unter anderem Einstellungen für Parser, Exporte und Logging.

Gleichzeitig wurde die technische Dokumentation deutlich erweitert und überarbeitet. Neben der Konfiguration werden nun auch Aspekte der Sicherheit und Cyber-Resilienz ausführlicher beschrieben.

Weitere Verbesserungen

Zusätzlich wurden verschiedene Probleme im Installer und im Setup behoben. Auch der Build-Prozess wurde an mehreren Stellen verbessert und bereinigt.

Version 4.0.1 entwickelt damit insbesondere die Exportfunktionen und die Integration in die Windows-Umgebung weiter und ergänzt die umfangreiche technische Grundlage von Version 4.0 um zahlreiche praktische Verbesserungen.

CATweasel Toolkit v4.0.0

Mit Version 4.0.0 erhält das CATweasel Toolkit eine umfassende technische Überarbeitung. Neben einer neuen Grundlage für die PDF-Verarbeitung wurde insbesondere die Installation und Bereitstellung des Systems deutlich vereinfacht.

Die neue Version schafft damit eine kompaktere und besser wartbare Basis für die weitere Entwicklung des CATweasel Toolkits.

Vereinfachte Installation und weniger Abhängigkeiten

Ein wesentlicher Schwerpunkt der neuen Version ist die Reduzierung externer Abhängigkeiten. Komponenten mit restriktiven Lizenzbedingungen wurden aus der Distribution entfernt. Insbesondere ist für die PDF-Verarbeitung keine separate Installation von pdftk Server oder Ghostscript mehr erforderlich.

Die bisher von diesen Komponenten übernommenen Aufgaben werden nun durch qpdf sowie durch native Funktionen des PDFParsers erledigt. Die benötigten Komponenten werden bei der Windows-Distribution entsprechend bereitgestellt.

Dadurch wird die Installation deutlich übersichtlicher und das CATweasel Toolkit kann einfacher auf Zielsystemen eingerichtet und betrieben werden.

Neuer Installer und überarbeitetes Deployment

Auch der Windows-Installer wurde grundlegend überarbeitet und an den neuen Build- und Release-Prozess angepasst.

Die bisher erforderlichen zusätzlichen Installationsschritte für die PDF-Verarbeitung entfallen. Gleichzeitig wurde die Installationsdokumentation an die neue Struktur angepasst, sodass Installation und Konfiguration klarer voneinander getrennt sind.

Neue Konfigurationsstruktur

Die Konfiguration des CATweasel Toolkits wurde neu strukturiert. Insbesondere werden die Einstellungen des PDFParsers und der Exporte nun klar voneinander getrennt.

Darüber hinaus wurden neue Konfigurationsmöglichkeiten für Logging, die Verarbeitung temporärer Dateien und die Exportverarbeitung geschaffen. Damit lassen sich die Abläufe des PDFParsers besser an unterschiedliche Einsatzszenarien anpassen.

Deutlich erweiterte Dokumentation

Mit Version 4.0.0 wurde auch die technische Dokumentation erheblich erweitert.

Neben einer ausführlichen Dokumentation zur Konfiguration des PDFParsers enthält die neue Dokumentation unter anderem Informationen zu:

  • technischen Grundlagen der PDF-Verarbeitung,
  • Filterdefinitionen und deren Konfiguration,
  • relevanten Normen für Texte und Benennungen in Schaltplänen,
  • Sicherheit und Cyber-Resilienz,
  • Installation und Bereitstellung des CATweasel Toolkits.

Damit steht neben der Software selbst auch eine deutlich umfassendere Grundlage für deren Konfiguration und Betrieb zur Verfügung.

Weitere technische Verbesserungen

Neben den größeren Änderungen enthält Version 4.0.0 zahlreiche kleinere Verbesserungen am Build-System, Installer, der Konfigurationsverarbeitung und der PDF-Verarbeitung.

Die Version bildet damit die technische Grundlage für die weitere Entwicklung des CATweasel Toolkits und schafft insbesondere bei Installation, Konfiguration und Wartung eine deutlich klarere Struktur.

CATweasel Toolkit v3.0.2

Ich freue mich euch mitteilen zu können, dass ab sofort das Release v3.0.2 unseres CATweazle Toolkit zur Verfügung steht.

In diesem Release haben wir uns vor allem darauf konzentriert unsere neue Struktur weiter zu festigen und daher einige Änderungen an der Dateistruktur vorgenommen und Links, die durch die Umstellungen nicht mehr funktionsfähig waren wieder korrigiert.

Auf neue Funktionen haben wir in diesem Release bewusst verzichtet. Neue Funktionen sind bereits in Entwicklung und werden mit dem kommenden Update dann zur Verfügung stehen.

Der aktualisierte Toolkit steht für euch wie gewohnt im Download-Bereich bereit.

CATweasel Toolkit v3.0.1

Nachdem die getrennte Installation von Interpreter und Anwendung auf aktuellen Windows 11 Versionen fehlgeschlagen ist, haben wir uns entschieden mit dem Patch zu Version 3.0.1 den Interpreter jetzt voll integriert mitzuliefern. Es gibt daher ab sofort nur noch eine Installer-Datei, die alles enthält.

Der aktualisierte Toolkit steht für euch wie gewohnt im Download-Bereich bereit.

CATweasel Toolkit v3.0.0

CATweasel Toolkit Version 3.0.0 veröffentlicht

Nach intensiver Entwicklungszeit freuen wir uns, die erste Version unseres neuen CATweasel Toolkits vorstellen zu können. Mit der Version 3.0.0 beginnt eine neue Ära unserer Softwarefamilie rund um die Datenverarbeitung im Schaltanlagenbau.

Die Versionsnummer 3.0.0 ist bewusst gewählt: Alle bisherigen CATweasel-Tools lagen maximal in Version 2 vor. Mit dem Toolkit führen wir die bisher getrennten Anwendungen in einer gemeinsamen Plattform zusammen und möchten so von Beginn an eine klare Abgrenzung zu den älteren Einzellösungen schaffen.

Alles in einem Toolkit vereint

Das CATweasel Toolkit vereint erstmals alle bisherigen Werkzeuge unter einer einheitlichen Oberfläche. In der aktuellen Version sind folgende Module enthalten:

  • PDFParser – zum Extrahieren, Analysieren und Filtern von PDF-Dokumenten
  • Lagerist – für die Verwaltung von Stücklisten, Artikeln und Logistikprozessen
  • Terminal – die leistungsstarke Kommandozeilenumgebung mit zahlreichen nützlichen Funktionen

Damit steht erstmals eine zentrale Plattform zur Verfügung, die die Arbeitsabläufe im Schaltanlagenbau effizienter und konsistenter macht. Einzelne Komponenten müssen nicht mehr separat installiert und aktualisiert werden – alles läuft integriert über das Toolkit.

Ältere Einzelversionen laufen aus

Die bisherigen Einzelversionen der Tools bleiben vorerst im Downloadbereich verfügbar, werden jedoch nicht mehr weiterentwickelt. Alle zukünftigen Erweiterungen und Verbesserungen erfolgen ausschließlich im Rahmen des CATweasel Toolkits.

Bitte beachtet: Ein einfaches Update von den Einzelversionen auf das Toolkit ist nicht möglich. Die alten Programme müssen zunächst vollständig deinstalliert werden, bevor das Toolkit installiert werden kann.

Bereits vorhandene Konfigurationen und Filterdefinitionen (z. B. aus dem PDFParser) bleiben weiterhin lauffähig und können in der neuen Umgebung weiterverwendet werden.

Abkündigung älterer Versionen

Die bisherigen Einzelversionen werden mittelfristig vollständig abgekündigt, sobald dort sicherheitsrelevante Änderungen notwendig würden. Diese alten Versionen werden dann aus dem Downloadbereich entfernt, da alle Wartung und Weiterentwicklung künftig nur noch für das Toolkit erfolgt.

Wir empfehlen daher allen Anwenderinnen und Anwendern, frühzeitig auf das neue CATweasel Toolkit 3.0.0 umzusteigen, um auch in Zukunft von allen Verbesserungen und Sicherheitsupdates profitieren zu können.

Ausblick

Mit dem Toolkit legen wir den Grundstein für die zukünftige Weiterentwicklung der CATweasel-Plattform. Geplant sind unter anderem neue Schnittstellen, verbesserte Automatisierungsfunktionen und eine engere Integration zwischen den Modulen.

Wir bedanken uns bei allen, die in den letzten Monaten Feedback gegeben und die Entwicklung begleitet haben. Das CATweasel Toolkit ist ein großer Schritt in Richtung einer modernen, einheitlichen und datenschutzfreundlichen Softwarebasis – und das Fundament für viele weitere spannende Funktionen in der Zukunft.

Download: Das neue CATweasel Toolkit 3.0.0 steht ab sofort im Downloadbereich zur Verfügung.