README.md · zhangshenhua/lisp-chat

[![Quicklisp dist](http://quickdocs.org/badge/lisp-chat.svg)](http://quickdocs.org/lisp-chat/)

# Lisp Chat

An experimental chat irc-like written in Lisp.

![lisp-chat-screenshot](lisp-chat.png)

# Installation

You'll need in your system:

* [SBCL]
* [Quicklisp Client]

[SBCL]: http://www.sbcl.org/
[Quicklisp Client]: https://github.com/quicklisp/quicklisp-client

Make sure that `~/.sbclrc` has a entry calling to the Quicklisp setup.

```common-lisp
(load "~/.quicklisp/setup.lisp")
```

Since that `~/.quicklisp` is the Quicklisp instalation distribution, clone this
repository with:

`git clone https://www.github.com/ryukinix/lisp-chat.git ~/.quicklisp/local-projects/lisp-chat`

## Tip for Quicklisp

As I said, we'll need a proper instalation of Quicklisp to getting this running. To accomplish that,
if you are not familiar with the CL ecossystem, I'll guide you in a simple way: clone the [Quicklisp Client] and execute the `setup.lisp` with `sbcl --script setup.lisp`.

In general Quicklisp distribution provide the folder `~/quicklisp` instead
of `~/.quicklisp`, but I personally don't like it much. Make sure to synchronize with the quicklisp correct folder. Maybe
will need change the `.sblcrc` file to accomplish that, since for default as I said quicklisp set `~/quicklisp` folder.

# Usage

Load the server
```bash
$ ./lisp-chat-server
```

Get a client
```bash
$ ./lisp-chat
```

You can easilly setup your own configuration of `*port*` and
`*host*` for running a new instance of the server and client. For
now we have a instance of lisp-chat as example running. If you really
want to runs locally, you can just change the `*host*` variable to `"localhost"` as:

```lisp
(require 'lisp-chat)
(setq lisp-chat-config:*host* "localhost")
```

# For Non-lispers

If you want test this and don't have the Lisp environment with SBCL
and Quicklisp, I have two alternative choices for you:

* Python client
* Netcat client (wtf?)

On Python client, I wrote in a way only using ths stdlib avoiding pain to handle the dependency hell, so you can just call that:

```bash
$ python client.py
```

So finally... netcat. Yes! You can even just use `netcat`! An user called `Chris` in past days
just logged in the server with the following message:

```
|16:30:37| [Chris]: Used netcad
|16:30:41| [Chris]: netcat*
|16:30:50| [Chris]: bye
```

So you can type `netcat chat.lerax.me 5558` and go on! I tested on my machine and
works fine! The main reason is because the communication between
server and client just use raw data. For better synchronization with
text data from server while you typing, I suggest you to
use a readline wrapper like [`rlwrap`](https://github.com/hanslub42/rlwrap) calling as `rlwrap netcat
ryukinix.tk 5558`.
<p align="center">
  <a href= http://chat.lerax.me>
    <img src="http://www.lisperati.com/lisplogo_warning2_256.png" width="128" />
  </a>
</p>

zhangshenhua/lisp-chat

简介

发行版

贡献者

近期动态

zhangshenhua/lisp-chat .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

zhangshenhua/lisp-chat