History

Valentin Lorentz 63eb6672ea Revert generic 'The Limnoria Contributors' in copyright notices This commit reverts `db7ef3f025` (though it keeps the year updates) After discussion with several people, it seems better to mention copyright owners explicitly. eg. https://reuse.software/faq/#vcs-copyright explains the issue of using VCSs to track copyright. As `db7ef3f025` only replaced mentions of my name with 'The Limnoria Contributors', this commit only needs to undo that + add one person who contributed to setup.py.		2021-10-17 09:57:55 +02:00
..
locales	Fix msgfmt warnings.	2020-03-26 22:10:28 +01:00
README.rst	Move stripformatting from Format to Filter, for consistency	2021-08-28 23:37:21 +02:00
__init__.py	Revert generic 'The Limnoria Contributors' in copyright notices	2021-10-17 09:57:55 +02:00
config.py	Revert generic 'The Limnoria Contributors' in copyright notices	2021-10-17 09:57:55 +02:00
messages.pot	Squashed commit of the following:	2014-12-20 14:37:27 +01:00
plugin.py	Revert generic 'The Limnoria Contributors' in copyright notices	2021-10-17 09:57:55 +02:00
test.py	Revert generic 'The Limnoria Contributors' in copyright notices	2021-10-17 09:57:55 +02:00

README.rst

Documentation for the Format plugin for Supybot

Purpose

Provides simple commands for formatting text on IRC (like bold), and to change the output of the bot for a particular command. See also the Filter plugin <plugin-Filter> to configure the output format for all commands.

Usage

Provides some commands for formatting text, such as making text bold or capitalized.

Commands

bold <text>: Returns <text> bolded.

capitalize <text>: Returns <text> capitalized.

color <foreground> [<background>] <text>: Returns <text> with foreground color <foreground> and background color <background> (if given)

concat <string 1> <string 2>: Concatenates two strings. Do keep in mind that this is not the same thing as join "", since if <string 2> contains spaces, they won't be removed by concat.

cut <size> <text>: Cuts <text> down to <size> by chopping off the rightmost characters in excess of <size>. If <size> is a negative number, it chops that many characters off the end of <text>.

field <number> <text>: Returns the <number>th space-separated field of <text>. I.e., if text is "foo bar baz" and <number> is 2, "bar" is returned.

format <format string> [<arg> ...]: Expands a Python-style format string using the remaining args. Just be sure always to use %s, not %d or %f or whatever, because all the args are strings.

join <separator> <string 1> [<string> ...]: Joins all the arguments together with <separator>.

lower <text>: Returns <text> lowercased.

replace <substring to translate> <substring to replace it with> <text>: Replaces all non-overlapping occurrences of <substring to translate> with <substring to replace it with> in <text>.

repr <text>: Returns <text> surrounded by double quotes.

reverse <text>: Returns <text> in reverse-video.

title <text>: Returns <text> titlecased.

translate <chars to translate> <chars to replace those with> <text>: Replaces <chars to translate> with <chars to replace those with> in <text>. The first and second arguments must necessarily be the same length.

underline <text>: Returns <text> underlined.

upper <text>: Returns <text> uppercased.

Configuration

supybot.plugins.Format.public

This config variable defaults to "True", is not network-specific, and is not channel-specific.

Determines whether this plugin is publicly visible.