HansaChat

Documentation

Kanalid ja liikmed

Looge, liituge ja arhiveerige kanaleid ning haldage liikmelisusi idempotentsete käskudega.

Kanalikäsklused loevad kõigepealt praegust olekut ja lähenevad sellele, mida te küsite: juba mõjunud käsu kordamine õnnestub tulemusega changed: false, selle asemel et nurjuda või midagi dubleerida.

hansa chat channels list                       # your channels
hansa chat channels browse                     # public channels you have not joined
hansa chat channels get --channel general      # one channel by slug or ID

Kanalite loomine ja muutmine

# Return "Marketing" and create it only if it does not exist yet
hansa chat channels ensure --name Marketing --type public

# Rename or change the type; a no-op when nothing changes
hansa chat channels set --channel marketing --name Marketing EU --type private

# Archive a channel (idempotent)
hansa chat channels archive --channel marketing

Viited kasutavad taustsüsteemi slugi või ID-d, mitte kunagi kuvatava nime põhjal sobitamist. Pange tähele, et kanali ümbernimetamine muudab selle slugi — viidake skriptides kanalile ID järgi või lahendage see pärast ümbernimetamist uuesti.

Liikmelisus

hansa chat channels join --channel general     # no-op when already a member
hansa chat channels leave --channel general    # no-op when not a member
hansa chat channels members --channel general  # list channel members
hansa chat channels invite --channel general --member 42

Otsesõnumid

hansa chat channels dm --member 42

Tagastab selle kasutajaga olemasoleva otsesõnumikanali või loob selle; taustsüsteem käsitleb seda toimingut idempotentsena.

Lugemise olek

Kanalite ja sõnumite lugemine ei muuda kunagi seda, mis loetakse loetuks. Ainuke käsk, mis seda teeb, on:

hansa chat channels mark-read --channel general

Tööruumi liikmed

hansa chat members list --query igor   # search members by text
hansa chat members get --member 42     # one member by user ID