IRC Client Library 0.3.0 released!

Version 0.3.0 of the Kitteh IRC Client Library has been released.

This release contains many substantial changes to the API.

Changes

• [BREAKING] Migrated from null to Optional:
  • Any API method that previously could return null now returns an Optional.
  • With the exception of some utility classes, null is no longer a valid parameter.
    • Instead, methods without that parameter are provided.
    • Pay attention to the JSR305 annotations @Nonnull and @Nullable.
• [BREAKING] New authentication API:
  • AuthManager (new package) now accepts AuthProtocol instances.
  • As these cannot be added in the ClientBuilder, utilize ClientBuilder#after(Consumer<Client>).
  • SASL SUPPORT added.
• Added ClientBuilder#after(Consumer<Client>) for defining tasks to perform on the new client prior to connection.
• [BREAKING] New modes API:
  • Channel modes are now available shortly after joining, and are tracked on the Channel object.
  • ChannelMode describes a channel mode possible.
    • ChannelUserMode now a subclass.
  • ChannelModeStatus describes a change in mode.
  • ChannelModeStatusList describes a set of changes and can be exported to a String:
    • Example: +msb *!*@*
  • ServerInfo now provides this updated mode information.
• Added KittehServerMessageException:
  • Thrown when the client falls over attempting to process a message from the server.
  • Please provide me with these as you encounter them.
• Added the original, unprocessed message contents to the command and numeric reception events.
• Added toString() output for nearly all classes (except events).
• Added a concept of staleness and snapshot re-use.
  • Snapshots are now reused if no change has occurred.
  • User and Channel can be stale, and have a isStale() method to see if the snapshot is up to date.
• Renamed many methods to more logical names.

Fixes

• Client#getChannel(String) now returns only tracked channels.
• Properly track users across nick changes.
  • Client was misplacing users who renamed only changing case.