HansaChat

Documentation

Kanavat ja jäsenet

Luo kanavia, liity niihin ja arkistoi kanavia sekä hallitse jäsenyyksiä idempotenttien komentojen avulla.

Kanavakomennot tarkistavat ensin nykyisen tilan ja kohdentuvat siihen, mitä pyydät: jo toteutuneen komennon toistaminen onnistuu arvolla changed: false sellaisenaan sen sijaan, että se epäonnistuisi tai lois kaksoiskappaleita.

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

Kanavien luominen ja muuttaminen

# 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

Viittaukset käyttävät taustajärjestelmän slugia tai tunnistetta, eivät näyttönimen vertailua. Huomaa, että kanavan nimeäminen uudelleen muuttaa sen slugin — viittaa kanavaan skripteissä tunnisteen perusteella tai ratkaise se uudelleen nimen muutoksen jälkeen.

Jäsenyys

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

Yksityisviestit

hansa chat channels dm --member 42

Palauttaa olemassa olevan yksityisen kanavan kyseisen käyttäjän kanssa tai luo sen; taustajärjestelmä käsittelee operaation idempotenttina.

Lukutila

Kanavien ja viestien lukeminen ei koskaan muuta lukemisen tilaa. Ainoa komento, joka tekee sen, on:

hansa chat channels mark-read --channel general

Työtilan jäsenet

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