irc-ctcp

A CTCP encoding and decoding library for IRC clients.

https://github.com/barrucadu/irc-ctcp

Version on this page:0.1.3.0
LTS Haskell 22.13:0.1.3.1
Stackage Nightly 2024-03-14:0.1.3.1
Latest on Hackage:0.1.3.1

See all snapshots irc-ctcp appears in

MIT licensed by Michael Walker
Maintained by [email protected]
This version can be pinned in stack with:irc-ctcp-0.1.3.0@sha256:4dfbc6084a0d346b50d8d2f1ba6dfaa0c5807bb3db69a7e41877f651db726c3f,3849

Module documentation for 0.1.3.0

Depends on 3 packages(full list with versions):
Used by 3 packages in lts-8.5(full list with versions):

CTCP (Client To Client Protocol) is a way of sending arbitrary data over an IRC network, which may include bytes not allowed in standard IRC messages. CTCPs are sent as a PRIVMSG or NOTICE, where the first and last characters as \001 (SOH), and special bytes are escaped by encoding them into a two-byte sequence beginning with \020 (DLE). CTCPs consist of command name (typically in upper-case) followed by list of space-separated arguments, which may be empty.

One use of CTCPs supported by the vast majority of IRC clients today is the ACTION command, typically invoked with /me. For example, if the user foo in the channel #bar were to issue

/me dances

everyone in the channel would receive the message

:foo PRIVMSG #bar :\001ACTION dances\001

Other common uses of CTCP include requesting the name and version of a user's IRC client, their local time, determining ping times, and initiating file transfers (DCC).

Characters are escaped as follows:

\000 (NUL)
\020 \060 ("0")
\012 (NL)
\020 \156 ("n")
\015 (CR)
\020 \162 ("r")
\020 (DLE)
\020 \020

All other appearences of the escape character are errors, and are dropped.

See http://www.irchelp.org/irchelp/rfc/ctcpspec.html for more details.

Changes

0.1.2.0

  • Add a Show instance for CTCPByteString

0.1.1.0

  • Add an Eq instance for CTCPByteString