IRC client framework (wrapper around libircclient library).
Go to file
achmizs 554522c5ce Banish NSString to the depths of oblivion (encoding fix)
IRCClient is now entirely text-encoding-agnostic[1]. It takes values
for messages, nicks, channels, etc. as NSData objects which should
contain null-terminated C strings, and returns values likewise.
The 'encoding' property of IRCClientSession and IRCClientChannel is
no longer used for any[1] internal functions. It is the responsibility
of the framework's user to select an appropriate encoding for display
of received C-strings (storing this encoding with session and channel
objects is the function of the 'encoding' property).

[1] The one exception is the reply string to CTCP TIME requests, which
uses the specified encoding for the session.
2015-12-24 15:34:26 -05:00
IRCClient Banish NSString to the depths of oblivion (encoding fix) 2015-12-24 15:34:26 -05:00
IRCClient.xcodeproj Add support for 'anonymous' PRIVMSG and NOTICE 2015-12-24 02:00:41 -05:00
NSData+SA_NSDataExtensions Fix more null termination bugs 2015-12-22 18:33:01 -05:00
.gitignore Add NSData_SA_NSDataExtensions 2015-12-22 17:19:54 -05:00
IRCClient.h Updated documentation 2015-12-19 08:29:12 -05:00
README Updated documentation 2015-12-19 16:26:11 -05:00
README_libircclient Updated documentation 2015-12-19 16:26:11 -05:00

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This is a modified version of the IRCClient framework by Nathan Ollerenshaw. Ive rewritten it to allow robust support for arbitrary text encodings, and fixed various other problems. The original version is available here: http://sourceforge.net/projects/libircclient/ (distributed alongside the libircclient library).

- Said Achmiz

—

ADDING IRCCLIENT TO YOUR APPLICATION
(using Xcode)
(these instructions apply to Xcode 7.1.1, build 7B1005)

0. Build libircclient and add it to the IRCClient project (see file “README_libircclient” for details)

1. Place the entire IRCClient folder in your project folder

2. Using “File -> Add Files…”, add IRCClient.xcodeproj to your project

3. Build the IRCClient framework target

4. Make sure the “Header Search Paths” build setting of your project contains the following entry:

	$(PROJECT_DIR)/

		(non-recursive)

5. Configure the build phases for your application target thusly:

	  i. Add IRCClient.framework to “Link Binary With Libraries”
	 ii. Add IRCClient.framework to “Target Dependencies”
	iii. Add a “Copy Files” build phase
	 iv. Set destination for the just-added “Copy Files” build phase to “Frameworks”
	  v. Add IRCClient.framework to the just-added “Copy Files” build phase

6. Import IRCClients API into your code using “#import <IRCClient/IRCClient.h>”

—

See the following header files for documentation:

IRCClientSession.h
IRCClientSessionDelegate.h
IRCClientChannel.h
IRCClientChannelDelegate.h