RuBBS

A rubbs a Ruby gemünk telnetes üzenőfalak (BBS-ek) építéséhez: egy belépő párbeszéd tíz sorból, egy ablakos, menüs, egérrel kezelhető teljes képernyős board néhány százból, és ugyanaz a board Commodore 64-en, ugyanazon a porton. A BBS-hálózatunk mind a tizenegy boardja ezen fut. Ez a kézikönyv a rubbs 1.0.0-t írja le. Minden osztálya és metódusa dokumentálva van a forrásban: az API-referencia (RDoc) minden kiadási taggel újraépül belőle.

Amit kapsz

• Három réteg egy hívásban — Flow a soronkénti párbeszédekhez (belépés, varázslók), Application egy asztalhoz ablakokkal, menükkel és widgetekkel, és a PETSCII Screen a Selector kurzoros menüivel egy soralapú boardhoz, Commodore 64-en vagy modern terminálon; a hívás szabadon jár köztük.
• Turbo Vision telnetvonalon — mozgatható, méretezhető, nagyítható és váltható ablakok, menüsor gyorsbillentyűkkel, státuszsor, űrlapok, master-detail böngészők, chat-folyamok, öt színtéma és Markdown-renderelő, mind kattintható egérrel.
• Commodore 64-es arc — a session.petscii! 40×25-ös PETSCII-re állítja a vonalat, a kód közben ugyanúgy UTF-8-at és ANSI-t ír; a BBS::Terminal minden hívótól megkérdezi, milyen terminálról hív, és a modern vagy a C64-es arcot indítja.
• Doorok és gatewayek — szimulált gépek (FakeOS), flow-k és bármilyen program doorként, telnet-gatewayek, amik egy másik boardnak adják tovább a vonalat (egy C64 akár ASCII-boardot is felhívhat), ZMODEM- és XMODEM-letöltés.
• AI-karakterek — egy YAML-fájlban leírt persona, ami bármilyen OpenAI-kompatibilis modellen beszél, szavanként streamelve, és beégetett válaszokkal, ha a modell nem elérhető.
• Egy tartalmas board építőelemei — SQLite-fájl migrációkkal, korlátok közé szorított HTTP, cache, rate limit, ütemezett Wikipédia-kliens, egységes naplóformátum és újrapróbáló háttérmunka.
• Az igazi vonalra készült — telnet-negotiation, ablakméret, SGR-egér, tétlenségi, hívásszám- és címenkénti korlátok, vezérlőkaraktermentes bemenet, csak nyilvános címet hívó gateway, és egy door összeomlása sosem bontja a hívást.

A kézikönyv

Az első board

A gem neve bbs. Figyel egy TCP-porton, minden hívóval lefolytatja a telnet-negotiationt, mindegyiknek ad egy Session-t, és futtatja a beállított flow-t:

require 'bbs'

BBS.configure do |c|
  c.log_tag = 'my-bbs'
  c.flow = BBS::Flow.define do
    big_banner 'My BBS'
    ask :name, prompt: 'Your name'
    say 'Welcome!', style: :success
  end
end

BBS.start

ruby bbs.rb, aztán telnet localhost 2323. Innen az Első lépések épít belőle ablakos, C64-es arcú boardot.

A három réteg

A hívás többnyire egy flow-val indul (a terminálkérdés, a belépés), és egy applicationben vagy egy PETSCII-képernyőn folytatódik; a doorok és gatewayek kilépnek belőle, majd visszatérnek. Az 1.0 előtt volt egy negyedik réteg is, a BBS::TUI, egyetlen teljes képernyős oldalakhoz; egyik board sem használta, és az 1.0 kivette (lásd a Változásnaplót).

flowchart LR
  S[TCP-szerver] --> SE[Session: telnet, ablakméret]
  SE --> F[Flow]
  F --> A[Application]
  F --> P[PETSCII Screen + Selector]
  A <--> D[Door: FakeOS, Flow, program]
  A <--> G[Gateway: egy másik board]
  P <--> G
  F --> F2[Al-flow]

Kik használják

Egy soralapú board építőkövei

A 0.29.0 óta a rubbs-ban van, amit eddig minden soralapú boardunk maga írt meg. Mind benne van az API-referenciában; a Commodore 64 oldal munka közben mutatja őket.

module UI
  module Petscii
    BBS::Petscii::Colors.install(self)

    class Screen < BBS::Petscii::Screen
    end

    LOGO = BBS::BlockFont.petscii('WARP', colors: [LB, LB, CY, CY, WH], indent: 10)
  end
end

screen = UI::Petscii::Screen.new(runner.session)
book   = screen.pick('the shelves', books, &:title)
screen.say('Downloading…', color: YE)
BBS::Goodbye.petscii(screen, title: 'warpengine bbs', color: LB)

Frissítés 0.x-ről

Az 1.0 a nagytakarítás kiadása: mindenre egyetlen út. Amit egy boardnak általában át kell írnia:

• screen.say(text, GN) → screen.say(text, color: GN), screen.rule(DG) → screen.rule(color: DG);
• screen.editor(max, title) → screen.edit(title: title, max: max).to_s;
• Petscii::Screen::MENU → BBS::Selector::COLORS (vagy semmi: ez az alapértelmezés);
• privát címen futó szomszéd boardra mutató gateway → public_only: false;
• kikerült a BBS::TUI, a BBS::Color, a ProgressBar, Spinner, HBox, VBox, Panel, AnsiArt, a Flow-lépések többsége a call mellől, és a színekről elnevezett Flow-stílusok.

A Változásnapló röviden felsorolja mindezt; a repó UPGRADING.md-je minden eltávolított vagy átnevezett API-t megad a helyettesítőjével és egy greppel, amely megtalálja.

Telepítés

gem 'bbs', git: 'https://git.teletypegames.org/engines/rubbs.git', tag: 'v1.0.0'

Ruby 3.2 vagy újabb (a socket időkorlátjaihoz IO#timeout= kell), a sqlite3 gemmel. A boardok taggel vagy git-revízióval rögzítik a rubbs-t a Gemfile.lock-jukban.

Forrásszerkezet

Repó

engines/rubbs — MIT-licenc. A README.md-je az egyfájlos fejlesztői referencia, az UPGRADING.md az út 0.x-ről 1.0-ra; ez a kézikönyv a vezetett változat.