tmc-cli - The Modding Community
De API, Vanuit Je Terminal
tmc-cli is een opdrachtregelclient voor onze publieke content-API. Hij maakt, bewerkt en verwijdert je assets, mods, servers, artikelen, communities, collecties en groepen, en omdat de API daar in de praktijk voor gebruikt wordt, uploadt hij bestanden en publiceert hij releases in één commando.
Installeer vanuit een kloon. tmc-cli staat nog niet op PyPI, dus pip installeert het vanuit de openbare repository. De drie stappen staan verderop.
$ tmc auth whoamiprofile defaultsite https://moddingcommunity.comauthMode tokentoken tmc_ab…9fcanRead truecanWrite truecanDelete falseEén pakket uit de standaardbibliotheek: er valt niets te bouwen of op te lossen. Het staat niet op PyPI en wordt dus vanuit een kloon geïnstalleerd. Elk commando, elke vlag en elke exitcode staat in de documentatie.
Drie stappen, geen pakketindex
tmc-cli staat niet op PyPI. Het wordt vanuit een kloon van de openbare repository geïnstalleerd, vraagt Python 3.11 of nieuwer en haalt geen andere pakketten binnen.
Eén tool, zes hoeken van de API
Commandonamen zijn precies wat er getypt wordt. Draai tmc --help voor de volledige lijst.
Releases Met Één Opdracht
Een release uitbrengen via de kale API is vier verzoeken in een bepaalde volgorde: de bestanden uploaden, hun ids verzamelen, de bestaande releaseverzameling lezen en dan de nieuwe terugschrijven zonder de andere te verstoren. release publish is precies die reeks.
Wat De CLI Kan
Eén opdracht voor alles wat je in de browser zou doen, plus een paar dingen die je niet met de hand wilt doen: bulkbewerkingen, pipelines en releases via scripts.
Sleutels, Profielen En De Publieke Helft
Log één keer in en de gegevens worden opgeslagen in ~/.config/tmc/config.json met modus 0600, of geef ze mee via de omgeving en er wordt helemaal niets naar schijf geschreven. Eén profiel per site of per sleutel, en --anon voor de helft van de API die überhaupt geen sleutel nodig heeft.
Vier Werkwoorden Die Zeggen Wat Ze Doen
De gevaarlijke is set: op deze API betekent een PUT op een relatie „dit is nu de volledige verzameling”, dus een PUT met één lid verwijdert al het andere op het item. De CLI houdt de vier uit elkaar en waarschuwt voordat hij de destructieve verstuurt.
Gebruik Hem In CI
Bouw je project, breng een release uit en upload de bestanden bij elke tag. Inloggegevens komen uit de omgeving, dus er wordt niets naar de schijf van een runner geschreven.
