Client.State

This module provides the core logic of the IRC client. The client state tracks everything about the client.

Client state type

data ClientState

All state information for the IRC client

Constructors

ClientState

Fields

• _clientWindows :: !(Map Focus Window)

  client message buffers

• _clientPrevFocus :: !Focus

  previously focused buffer

• _clientFocus :: !Focus

  currently focused buffer

• _clientSubfocus :: !Subfocus

  sec

• _clientExtraFocus :: ![Focus]

  extra messages windows to view

• _clientConnections :: !(IntMap NetworkState)

  state of active connections

• _clientNextConnectionId :: !Int
• _clientConnectionContext :: !ConnectionContext

  network connection context

• _clientEvents :: !(TQueue NetworkEvent)

  incoming network event queue

• _clientNetworkMap :: !(HashMap Text NetworkId)

  network name to connection ID

• _clientConfig :: !Configuration

  client configuration

• _clientVty :: !Vty

  VTY handle

• _clientTextBox :: !EditBox

  primary text box

• _clientWidth :: !Int

  current terminal width

• _clientHeight :: !Int

  current terminal height

• _clientScroll :: !Int

  buffer scroll lines

• _clientDetailView :: !Bool

  use detailed rendering mode

• _clientActivityBar :: !Bool

  visible activity bar

• _clientShowMetadata :: !Bool

  visible activity bar

• _clientRegex :: Maybe Regex

  optional persistent filter

• _clientBell :: !Bool

  sound a bell next draw

• _clientIgnores :: !(HashSet Identifier)

  ignored nicknames

• _clientExtensions :: !ExtensionState

Lenses

clientWindows :: Lens' ClientState (Map Focus Window)

clientTextBox :: Lens' ClientState EditBox

clientConnections :: Lens' ClientState (IntMap NetworkState)

clientWidth :: Lens' ClientState Int

clientHeight :: Lens' ClientState Int

clientEvents :: Lens' ClientState (TQueue NetworkEvent)

clientVty :: Lens' ClientState Vty

clientFocus :: Lens' ClientState Focus

clientExtraFocus :: Lens' ClientState [Focus]

clientConnectionContext :: Lens' ClientState ConnectionContext

clientConfig :: Lens' ClientState Configuration

clientScroll :: Lens' ClientState Int

clientDetailView :: Lens' ClientState Bool

clientActivityBar :: Lens' ClientState Bool

clientShowMetadata :: Lens' ClientState Bool

clientSubfocus :: Lens' ClientState Subfocus

clientNextConnectionId :: Lens' ClientState Int

clientNetworkMap :: Lens' ClientState (HashMap Text NetworkId)

clientIgnores :: Lens' ClientState (HashSet Identifier)

clientConnection

Arguments

:: Applicative f

=> Text

network

-> LensLike' f ClientState NetworkState

Traversal for finding the NetworkState associated with a given network if that connection is currently active.

clientBell :: Lens' ClientState Bool

clientExtensions :: Lens' ClientState ExtensionState

clientRegex :: Lens' ClientState (Maybe Regex)

Client operations

withClientState :: Configuration -> (ClientState -> IO a) -> IO a

Construct an initial ClientState using default values.

clientStartExtensions :: ClientState -> IO ClientState

Start extensions after ensuring existing ones are stopped

clientShutdown :: ClientState -> IO ()

clientPark :: ClientState -> (Ptr () -> IO a) -> IO (ClientState, a)

clientMatcher :: ClientState -> Text -> Bool

clientActiveRegex :: ClientState -> Maybe Regex

Construct a text matching predicate used to filter the message window.

consumeInput :: ClientState -> ClientState

Add the textbox input to the edit history and clear the textbox.

currentCompletionList :: ClientState -> [Identifier]

Returns the current network's channels and current channel's users.

ircIgnorable :: IrcMsg -> ClientState -> Maybe Identifier

Predicate for messages that should be ignored based on the configurable ignore list

clientFirstLine :: ClientState -> String

The full top-most line that would be executed

clientLine

Arguments

:: ClientState

-> (Int, String)

line number, line content

The line under the cursor in the edit box.

abortNetwork

Arguments

:: Text

network

-> ClientState

-> IO ClientState

Forcefully terminate the connection currently associated with a given network name.

addConnection

Arguments

:: Int

attempts

-> Maybe UTCTime

optional disconnect time

-> Text

network name

-> ClientState

-> IO ClientState

Start a new connection. The delay is used for reconnections.

removeNetwork :: NetworkId -> ClientState -> (NetworkState, ClientState)

Remove a network connection and unlink it from the network map. This operation assumes that the networkconnection exists and should only be applied once per connection.

clientTick :: ClientState -> ClientState

Function applied to the client state every redraw.

applyMessageToClientState

Arguments

:: ZonedTime

timestamp

-> IrcMsg

message recieved

-> NetworkId

message network

-> NetworkState

network connection state

-> ClientState

client state

-> ([RawIrcMsg], ClientState)

response , updated state

clientHighlights

Arguments

:: NetworkState

network state

-> ClientState

client state

-> HashSet Identifier

extra highlight identifiers

Compute the set of extra identifiers that should be highlighted given a particular network state.

clientWindowNames :: ClientState -> [Char]

Produce the list of window names configured for the client.

clientPalette :: ClientState -> Palette

Produce the list of window names configured for the client.

clientAutoconnects :: ClientState -> [Text]

Returns the list of network names that requested autoconnection.

clientActiveCommand

Arguments

:: ClientState

client state

-> Maybe (String, String)

command name and argument string

Compute the command and arguments currently in the textbox.

clientExtraFocuses :: ClientState -> [Focus]

List of extra focuses to display as split windows

currentNickCompletionMode :: ClientState -> WordCompletionMode

Returns the WordCompletionMode associated with the current network.

Add messages to buffers

recordChannelMessage

Arguments

:: Text

network

-> Identifier

channel

-> ClientMessage

-> ClientState

-> ClientState

Add a message to the window associated with a given channel

recordNetworkMessage :: ClientMessage -> ClientState -> ClientState

Record a message on a network window

recordIrcMessage

Arguments

:: Text

network

-> MessageTarget

-> ClientMessage

-> ClientState

-> ClientState

Record a message in the windows corresponding to the given target

Focus manipulation

changeFocus

Arguments

:: Focus

new focus

-> ClientState

client state

-> ClientState

Change the window focus to the given value, reset the subfocus to message view, reset the scroll, remember the previous focus if it changed.

changeSubfocus

Arguments

:: Subfocus

new subfocus

-> ClientState

client state

-> ClientState

Change the subfocus to the given value, preserve the focus, reset the scroll.

returnFocus :: ClientState -> ClientState

Return to previously focused window.

advanceFocus :: ClientState -> ClientState

Step focus to the next window when on message view. Otherwise switch to message view.

retreatFocus :: ClientState -> ClientState

Step focus to the previous window when on message view. Otherwise switch to message view.

jumpToActivity :: ClientState -> ClientState

Jump the focus of the client to a buffer that has unread activity. Some events like errors or chat messages mentioning keywords are considered important and will be jumped to first.

jumpFocus

Arguments

:: Int

zero-based window index

-> ClientState

-> ClientState

Jump the focus directly to a window based on its zero-based index.

Scrolling

scrollClient :: Int -> ClientState -> ClientState

Scroll the current buffer to show newer messages

Extensions

data ExtensionState

esActive :: Lens' ExtensionState [ActiveExtension]

URL view

urlPattern :: Regex