Setup Webssi
For users
WEBSSI IS NOT READY FOR REAL USAGE YET, IT IS PRE-ALPHA. But if it were ready, instuctions would be something like this:
- Download webssi.tar.gz and unpack it. (when I actually put that online somewhere)
- Put webssi.pl in your irssi scripts directory (e.g. ~/.irssi/scripts)
- Put the webssi directory at ~/.irssi/webssi
- Install the JSON and HTTP::Daemon::SSL perl modules (libjson-perl and libhttp-daemon-ssl-perl packages on Debian/Ubuntu)
- Run the script (/run webssi)
- Follow instructions printed by the script to configure https daemon
- Point your browser to the started https server
For developers
The code is in the irssi subversion repository. To check it out: svn co http://coekie@svn.irssi.org/repos/webssi/trunk webssi
.
There are two ways to run Webssi.
- The normal way to run it, production mode (how end-users will use it), is to let webssi.pl play webserver for all the files, and the client runs in a normal browser.
- The other way is for development, using gwt's hosted mode. A tomcat serves the files, and forwards requests for events.json (the only dynamic one) to irssi.
This mode is useful for debugging.
Production mode
- If you haven't already, install Maven 2
- Run
mvn
in the webssi directory
- Make a symlink from ~/.irssi/scripts/webssi.pl to .../webssi/src/main/perl/webssi.pl
- Make a symlink from ~/.irssi/webssi to .../webssi/target/webssi-0.0.1-SNAPSHOT/org.irssi.webssi.Webssi
- Run the script (/run webssi)
- Point your browser to http://[hostname]:38444/
Development mode
Assuming you'll be using Eclipse, and already did the steps for production mode:
- Run
mvn eclipse:eclipse gwt:eclipse
in the webssi directory
- Import the project into eclipse (File, Import, General, Existing Projects into Workspace,...)
- There should be Webssi launch configuration to run or debug the GWT development shell and a hosted browser
- The embedded browser can't remember the password, so you probably want to /set webssi_authentication_disabled off if nobody from the outside can connect to it
To run the integration tests:
-
You must have an irssi running (on localhost) with
- webssi.pl loaded
- webssi_authentication_disabled must be set on
- Run your own irc server with nobody else on it, and connect to it
- Make sure there's no channel/query/... open, and just the statuswindow
- Run
mvn eclipse:eclipseTest
to create the test launching configuration
- Run the created WebssiTest. (you can delete the AbstractExpectTest.launch).