X-Git-Url: https://git.rkrishnan.org/?p=functorrent.git;a=blobdiff_plain;f=README.md;h=457a754818fb90e688900103a476fb2a219931f1;hp=927b9872c160ad6738c3076b04e64596b9c6b4b2;hb=27fccae52521d6b0d0502708d737c3b6eb908941;hpb=5abe96bac9a04eb35e71357086e51992f86bf9b8 diff --git a/README.md b/README.md index 927b987..457a754 100644 --- a/README.md +++ b/README.md @@ -1,49 +1,33 @@ # A command line BitTorrent client. -I started writing a BitTorrent client because it seemed like fun and I am learning Haskell and wanted to see if I can write something real with Haskell than just heat the room. It is turning out to be a lot of fun. +I started writing a BitTorrent client because it seemed like fun +and I am learning Haskell and wanted to see if I can write something +real with Haskell than just heat the room. It is turning out to be a +lot of fun. -[![Join the chat at https://gitter.im/vu3rdd/functorrent](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/vu3rdd/functorrent?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) - -## Building - -Functorrent can be build with [Stack](https://github.com/commercialhaskell/stack) or -[Nix](https://nixos.org/nix/). I personally test the build with Debian GNU/Linux and -OS X using FP Complete's stack. - -### Stack - -Sandboxes give you per project independent containers, just like Python's -virtualenv. +### Building +You need to install [Stack](https://github.com/commercialhaskell/stack), either via +the OS package manager or via `cabal` (`cabal install stack`). $ git clone https://github.com/vu3rdd/functorrent && cd functorrent $ cabal install stack # or install stack by other means $ stack build # binaries in $(pwd)/.stack-work/install/x86..../lts-2.16/7.8.4/bin/functorrent -### Building with Nix - -``$ nix-shell``` at the root of the source code repo should drop you into a -shell which has all the package dependencies installed. - - - $ nix-shell --pure - [...] - [nix-shell] $ cabal configure && cabal build - ### Usage If you invoke functorrent without any options, it expects the contents of a torrent file to be given in stdin. So -$ cat ubuntu-14.10-desktop-amd64.iso.torrent | functorrent -[....] + $ cat ubuntu-14.10-desktop-amd64.iso.torrent | functorrent + [....] Or one can explicitly specify the torrent file as input. -$ functorrent ubuntu-14.10-desktop-amd64.iso.torrent -[...] + $ functorrent ubuntu-14.10-desktop-amd64.iso.torrent + [...] -## Goals +### Goals - [Optimized for Fun](http://www.slideshare.net/autang/ofun-optimizing-for-fun). (should have called it "funtorrent") @@ -55,21 +39,29 @@ $ functorrent ubuntu-14.10-desktop-amd64.iso.torrent - doctest and quickcheck tests. - Follow Haskell Style Guide - https://github.com/tibbe/haskell-style-guide/blob/master/haskell-style.md -## Current Status +### WARNING + +This client is not usable as your daily BitTorrent client yet. You may get +corrupted files and end up wasting a lot of bandwidth. So, until we achieve +some robustness, consider this as a programmer-friendly project to learn +about a bunch of stuff. + +### Current Status - most of the peer wire protocol works. -- talks only to one peer at the moment. Single threaded. +- talks only to one peer at the moment. - can download files. But needs every piece to be served by the peer it connected to. +- can talk to http/udp trackers. -## WARNING +### TODO -- this client is not usable as your daily BitTorrent client yet. You may get corrupted files and end up wasting a lot of bandwidth. So, until we achieve some robustness, consider this as a programmer-friendly project to learn about a bunch of stuff. +- Test suite. +- Talk to multiple peers concurrently. +- Piece download algorithms. +- Multifile torrent support. +- Magnet link support. +- other advanced features of BitTorrent (like DHT). -## TODO +### Misc -* Test suite. -* Talk to multiple peers. -* Piece download algorithms. -* Concurrency (threads per peer) -* Multifile torrent support. -* other advanced features of BitTorrent (like DHT). +The Bangalore Haskell group forked an early version of this code and started to develop it as a group. My code has diverged a lot from it. Both are calling it functorrent. Perhaps that needs to be fixed.