akka-irc's Introduction

======= akka-irc

A simple IRC-like client and server implementation in Scala and Akka. Thanks to the guys from LSUG for contributions to making it more Scala-esque.

How to run

This program requires an installation of the Simple Build Tool SBT, which requires that you have at least java 1.6. The build.sbt file has all the requirement definitions and resolvers

Steps

Clone the akka-irc repository if you have not done so yet
Open your terminal and change to the actor-chat directory
Run

sbt run
SBT will download all the required dependencies and provide you with 2 options

Multiple main classes detected, select one to run: [1] kaning.actors.ChatClientApplication [2] kaning.actors.ChatServerApplication Enter number:
Please note that this will not be in the same order
First run the server so in the example above type in 2 and hit return, if in your case the server is the first option type 1
Open another terminal, change your working directory to actor-chat again and run

sbt run
This time choose the client application and identify yourself
In order to join the server type in /join and hit return

Everything else you type into the client console will be displayed in the server console and to any other clients connected to that server

Heroku

The server part of this application can be deployed to Heroku. You will need a Heroku account and the and the toolbelt installed. Follow these instructions on how to deploy the application. Other useful commands include:

heroku logs -t - Tails the log
git push heroku akka-actors:master - Pushes the latest version to heroku

Added persistence at Scala Hack 12th April

akka-irc's People