Bazel Ordner Namenskonvention

Question

Ich weiß, dass Bazel keine bestimmte Dateistruktur auferlegt, aber es gibt einige Ordnerbenennungskonventionen, die Produkte mit Bazel folgen, und einige von ihnen (zB "third_party") haben eine spezielle Behandlung (es erfordert die licenses angegeben werden).

Also verstehe ich nicht ganz den Unterschied zwischen tools und third_party. Zum Beispiel, wenn ich eine "Ruby Toolchain" setzen möchte, ist es ein Werkzeug, da es der Sprachinterpreter ist, aber es ist auch eine dritte Partei, weil es von einer Gemeinschaft entwickelt wurde. Wohin soll es gehen?

Und was ist mit Bazel-Regeln? Wo sollte das idiomatisch platziert werden?

Answer 1

Ich bin ein Bazel-Entwickler, und ich stimme zu, die Verwendung hier kann ein wenig verwirrend sein.

Im Allgemeinen empfehlen wir, dass third_party für jeden externen Code verwendet wird, den Sie importieren, um ihn in Ihrem Projekt zu verwenden. Bazel selbst hat zum Beispiel viele Bibliotheken für Python-Flag-Parsing, Java-Kompilierung und viele andere Dinge.

Werkzeuge hingegen sind Code, den Sie geschrieben haben, um Ihr Projekt als eigenständiges Programm zu unterstützen. Wenn Sie zum Beispiel ein Skript geschrieben haben, das eine statische Textdatei in Code umwandelt (vielleicht können Sie auf die Daten als In-Sprache-Konstanten zugreifen), würde ich sagen, dass es in Tools gehen könnte, da es ein Standalone ist, aber nützlich für Ihre Projekt.

(Beachten Sie, Bazel Tools-Verzeichnis ist ein bisschen anders als das: wir packen diese tatsächlich und enthalten sie in der Bazel-Binärdatei, so dass sie zur Laufzeit, nicht zur Build-Zeit verwendet werden können).

Wenn Sie benutzerdefinierte Skylark-Regeln schreiben, können Sie das überall hin mitnehmen, aber ich möchte Sie bitten, dass Sie, wenn Sie denken, dass sie über Ihr Projekt hinaus nützlich sind, ein separates Repository für sie erstellen kann sie benutzen. Es ist viel einfacher, benutzerdefinierte Regeln aus einem dedizierten Repository zu verwenden, da Sie nur die http_archive() - Regel in einem WORKSPACE verwenden müssen, um sie zu erhalten. Wenn sie mit dem Rest Ihres Projekts gemischt sind, ist es für andere Menschen schwieriger, sie wiederzuverwenden.