Das bxpublish-Programm erzeugt eine Kopie einer Dateisystemstruktur unter Auslassung bestimmter Dateien. Es kann benutzt werden, um einen Veröffentlichungsordner als einen Bereich zur Vorbereitung eines Blox-Projektes für den Upload bereitzustellen. Unter Benutzung von bxpublish ist es möglich, die Bereitstellung von Dateien zu verhindern, welche ohne Inhaltsänderung neu erzeugt wurde. Es genügt dann, die Änderungszeitpunkte von Dateien im Veröffentlichgunsordner und denen auf dem Server zu vergleichen.
bxpublish liest seine Spezifikation über ein- und auszuschließende Dateien von Konfigurationsdateien mit Namen publish.txt ein. Es gibt zwei verschiedene Arten von Instruktionszeilen in einer publish.txt-Datei:
Das Verzeichnismuster wie auch das Namensmuster werden als reguläre Ausdrücke interpretiert. Leerzeichen in ihrem Inneren sind Teil des Musters. Eine beispielhafte publish.txt-Datei lautet:
- notneeded\.txt + included\.tar\.gz dir(ectory)?: - .*\.ext
Jede Pfadgruppenzeile betrifft die darauffolgenden Definitionszeilen, bis eine weitere Pfadgruppenzeile gelesen wird. Aufgrund dieses Verhaltens unterteilen Pfadgruppenzeilen die Definitionzeilen in Gruppen.
Kommentare werden durch eine Raute # eingeleitet und erstrecken sich bis zum Ende der Zeile. Kommentare werden vor jeder weiteren Verarbeitung der Zeile herausgefiltert. Weil Freiraum am Ende der Definitionszeilen sowie der Pfadgruppenzeilen zugelassen ist, werden Leerzeichen direkt vor der Raute ignoriert. Kommentare können wieder Rautenzeichnen in jeder beliebigen Menge enthalten. Rauten können nicht maskiert werden, sie können also nicht als Teil einer Pfadgruppe oder eines Definitionsmusters verwendet werden.
Das bxpublish-Programm liest zunächst alle publish.txt-Dateien, um für jede einzelne Datei im Quellordner zu entscheiden, ob sie einzuschließen ist oder nicht. Dies resultiert in einem Inventar von zu veröffentlichenden Dateien. Die darauffolgende Tätigkeit von bxpublish besteht aus drei Schritten:
Dateien werden kopiert wenn der Inhalt der betreffenden Quelldatei von dem der Zieldatei abweicht. Es gibt mehrere Umstände, welche bei der Entscheidung über das Kopieren einer Datei angetroffen werden können:
Wenn das Ziel als ein Verzeichnis existiert, wird die Datei übersprungen. In diesem Fall existiert die Quelle als eine Datei, sodass keinerlei Dateien unterhalb des Zieles Teil des Inventars sind; das Zielverzeichnis kommt daher bereits nach dem Streichen von Dateien zum Ausdünnen in Frage und wird beim Kürzen der Verzeichnisse gelöscht werden. bxpublish sollte in diesem Fall also erneut ausgeführt werden; eine entsprechende Mitteilung wird ausgegeben werden. Ausschließlich im Trockenlauf kann das Ziel den Vorgang überstehen.
Wenn das Ziel nicht existiert oder die Größe des Zieles von der Größe der Quelle abweicht, wird die Datei unter Nutzung von rsync -t kopiert.
Falls Quelle und Ziel existieren und von gleicher Größe sind, wird ihr Inhalt verglichen, um über die Notwendigkeit der Kopieroperation zu entscheiden.
Am Beginn seiner Tätigkeit hält bxpublish Ausschau nach einem Hashgenerator. Im Moment werden sha1sum und md5sum erwogen. Die Wahl kann manuell über die Umgebungsvariable HASHGEN übersteuert werden. Der Wert none steht dabei für die Abwesenheit eines jeglichen Hashgenerators. Es wird erwartet, dass der Hashgenerator als erstes den Hash der jeweiligen Datei ausgibt, wenn er als $ <HASHGENERATOR> <DATEI> aufgerufen wird.
Wenn ein Hashgenerator bereitsteht, wird er genutzt werden um die Inhalte der Quell- und der Zieldatei zu vergeleichen, und wenn es notwendig ist die Datei zu kopieren, wird rsync -t darauf angewendet werden.
Wenn kein Hashgenerator gefunden wurde, wird die Option -c für rsync verwendet, um die Entscheidung an rsync weiterzureichen, sodass effektiv rsync -tc verwendet wird.
Quelldateien sind zu überspringen, wenn sie den gleichen Inhalt wie ihr Pendant im Ziel aufweisen. Bei Abwesenheit eines Hashgenerator ist dieser Umstand allerdings ununterscheidbar von der Situation abweichenden Inhalts bei gleicher Größe, ein Fall in welchem das Kopieren notwendig ist; damit kann das Kopieren nicht überprungen werden. Unter derartigen Umständen werden daher alle Quelldateien stets kopiert, möglicherweise unter Weiterreichung der Inhaltsfrage an rsync. Die verschiedenen Gründe für das Durchführen einer Kopieroperation werden weiterhin iteriert um dem Nutzer in erhöhtem Verbosity-Level detaillierte Informationen zu liefern. Man beachte dass rsync von sich aus das Kopieren einer Datei überspringen kann, wenn rync -tc unter Nutzung seines integrierten Hash-Algorithmus' feststellt, dass keine Unterscheide vorliegen. Es ist dem Nutzer allerdings erst im höchsten Verbosity-Level möglich, dies festzustellen.
Um die publish.txt-Dateien zu finden, sucht bxpublish nach Verzeichnissen im Quellordner, und prüft für jedes gefunden Verzeichnis, ob es eine solche Datei enthält. Die Liste von Verzeichnispfaden wird vor dieser Untersuchung sortiert.
Im Zuge des Einlesens der publish.txt-Dateien wird ein Katalog von Regeln erstellt, jeweils eine Regel pro Definitionszeile. Jede solche Regel hat vier Komponenten:
Es ist eine Standard-Ausschlussregel definiert, um die publish.txt-Dateien nicht zu veröffentlichen. Diese Regel ist im Quellverzeichnis verwurzelt, ihr Pfadmuster passt auf jeden Pfad und ihr Dateimuster trifft genau auf publish.txt zu.
Für jede Datei im Quellverzeichnis wird für jede Regel festgestellt, ob die Datei von der Regel abgedeckt wird:
Definitionszeilen im Kopf einer publish.txt-Datei vor einer jeglichen Pfadgruppenzeile ergeben Regeln mit dem leeren String als ihr Pfadmuster. Derartige Regeln decken dementsprechend Dateien ab, welche direkt im Wurzelpfad der betreffenden publish.txt-Datei liegen.
Wenn mehrere Regeln eine Datei abdecken, ist diejenige entscheidend welche zuletzt definiert wurde. Wenn keinerlei Regel eine fragliche Datei abdeckt, wird die Datei standardmäßig eingeschlossen. Weil allein die Verzeichnispfade im Zuge der Suche nach publish.txt-Dateien sortiert werden, ist garantiert dass jede publish.txt-Datei in einem bestimmten Verzeichnis eher als alle publish.txt-Dateien in Unterverzeichnissen des betreffenden Ordners gelesen wird.