Added Globster project

This commit is contained in:
Yorhel 2012-12-16 09:48:20 +01:00
parent c1e08277ef
commit 2e29709225
4 changed files with 110 additions and 8 deletions

94
dat/globster Normal file
View file

@ -0,0 +1,94 @@
=pod
[html]<!-- This code is ugly as hell. -->
<div style="width: 600px; height: 227px; background-image: url(/img/globster.png); margin-bottom: -30px">
<b style="font-size: 14px; position: relative; left: 150px; top: 10px">The Globster What?</b>
<p style="position: relative; left: 150px; top: 20px; width: 420px; text-align: right">
Globster is an efficient file sharing client for the Direct Connect<br />
network. It runs as a background daemon and provides<br />
a convenient and high-level D-Bus API, making<br />
it easy to write scripts, bots and user<br />
interfaces for Direct Connect.
</p></div>É
=head1 Adopt your own Globster
=head2 Download
There are no tarballs at the moment. You'll have to get it from the git repo:
git clone --recursive git://g.blicky.net/globster.git
cd globster
autoreconf -i
./configure
make
The git repo is available for
L<online browsing|http://g.blicky.net/globster.git/> and can also be
L<found on github|https://github.com/yorhel/globster>.
(Note: If you have a git version before 1.6.5, the C<--recursive> argument
isn't going to work. You'll have to type C<git submodule init> and C<git
submodule update> after checking out the repo. But chances are that your GnuTLS
is waaay too old as well and Globster won't currently build, anyway.)
=head2 Requirements
Globster can be compiled with a (moderately recent) GCC or clang. You'll need
the following libraries: L<libdbus|http://dbus.freedesktop.org/> and
L<GnuTLS|http://gnutls.org> 3.0+.
I've only tested things on Linux (glibc and L<musl|http://www.musl-libc.org>),
but I intent to support more kinda-sane POSIX systems in the future as well.
The requirement of GnuTLS 3.0+ will be relaxed later on. On the other hand,
Globster will no doubt require some more libraries as more basic features are
being implemented. And, yes, I<of course> we will get static binaries!
=head2 Status
Remember when I called Globster a "file sharing" client? I lied. It doesn't
share or download files yet, since it's currently in an early alpha stage. So
what I<does> it do?
=over
=item * Connect to ADC and NMDC hubs
=item * User list management
=item * Chatting and private messaging
=back
Those features already make it perfectly suitable for writing chat-only bots
and interfaces.
=head2 Usage
Globster isn't particularly hard to use, but usage documentation is currently a
bit lacking. I have every intention to fix that, but for now, you're encouraged
to join the development hub and bug me for help: C<adc://dc.blicky.net:2780/>.
I did already write some
L<API documentation|http://dev.yorhel.nl/globster/api>.
There are at this point no scripts or interfaces for Globster available. I'd
love to have at least a simple console client (a weechat or irssi plugin?) and
perhaps a web-based interface. But other solutions are nice, too. Who's going
to write all that, you ask? Erm... well... You, perhaps? :-)
=head2 Final notes
As you've come to expect from me I<(right?)>, Globster is entirely written in C
and available under a liberal MIT license.
Globster incorporates code from
L<libev|http://software.schmorp.de/pkg/libev.html>,
L<libeio|http://software.schmorp.de/pkg/libeio.html>,
L<freetiger|http://klondike.es/freetiger/>,
L<klib|https://github.com/attractivechaos/klib> and
L<ylib|https://github.com/yorhel/ylib>.
Additionally, L<makeheaders|http://www.hwaci.com/sw/mkhdr/> is used to prevent
obsessing over header file management, and
L<autoconf-lean|https://bitbucket.org/GregorR/autoconf-lean> keeps the
configure script fast.

1
dat/globster-api Symbolic link
View file

@ -0,0 +1 @@
/home/yhdev/globster/doc/api.pod