tmc-cli - The Modding Community
Die API, Aus Deinem Terminal
tmc-cli ist ein Kommandozeilen-Client für unsere öffentliche Content-API. Er erstellt, bearbeitet und löscht deine Assets, Mods, Server, Artikel, Communities, Sammlungen und Gruppen, und weil die API genau dafür benutzt wird, lädt er Dateien hoch und veröffentlicht Releases in einem Befehl.
Installation aus einem Klon. tmc-cli ist noch nicht auf PyPI, daher installiert pip es aus dem öffentlichen Repository. Die drei Schritte stehen weiter unten.
$ tmc auth whoamiprofile defaultsite https://moddingcommunity.comauthMode tokentoken tmc_ab…9fcanRead truecanWrite truecanDelete falseEin einzelnes Paket der Standardbibliothek: Es gibt nichts zu bauen und nichts aufzulösen. Es ist nicht auf PyPI und wird aus einem Klon installiert. Jeder Befehl, jedes Flag und jeder Exit-Code steht in der Dokumentation.
Drei Schritte, kein Paketindex
tmc-cli ist nicht auf PyPI. Es wird aus einem Klon des öffentlichen Repositorys installiert, braucht Python 3.11 oder neuer und zieht keine weiteren Pakete nach.
Ein Werkzeug, sechs Bereiche der API
Befehlsnamen sind genau das, was eingetippt wird. tmc --help zeigt die vollständige Liste.
Releases Mit Einem Befehl
Ein Release über die rohe API zu schneiden sind vier Requests in einer bestimmten Reihenfolge: Dateien hochladen, ihre IDs einsammeln, den bereits vorhandenen Release-Satz lesen und dann den neuen zurückschreiben, ohne die anderen zu stören. release publish ist genau diese Abfolge.
Was Die CLI Kann
Ein Befehl für alles, was du im Browser tun würdest, plus einiges, was du nicht von Hand tun willst: Massenänderungen, Pipelines und Releases per Skript.
Schlüssel, Profile Und Die Öffentliche Hälfte
Melde dich einmal an, und die Zugangsdaten landen in ~/.config/tmc/config.json mit Modus 0600, oder übergib sie über die Umgebung, dann wird die Platte gar nicht angefasst. Ein Profil pro Site oder pro Schlüssel, und --anon für die Hälfte der API, die überhaupt keinen Schlüssel braucht.
Vier Verben, Die Sagen, Was Sie Tun
Das gefährliche ist set: In dieser API bedeutet ein PUT auf eine Beziehung „das ist jetzt die vollständige Menge“, also löscht ein PUT mit einem einzigen Mitglied alles andere am Objekt. Die CLI hält die vier auseinander und warnt, bevor sie das zerstörerische sendet.
Nutze Sie In CI
Baue dein Projekt, schneide ein Release und lade seine Dateien bei jedem Tag hoch. Die Zugangsdaten kommen aus der Umgebung, also wird auf einem Runner nichts auf die Platte geschrieben.
