http_spew 0.7.1
[http_spew.git] / README
blob8eaf0eae335708ac92ac2cc6845defb984e695b5
1 = HTTP Spew - LAN-only HTTP spam^H^H^H^Hclient for Ruby
3 Do not use HTTP Spew for connecting to servers outside of your LAN.
4 Do not use HTTP Spew without the permission of your server admins.
5 Use HTTP Spew if you wish you could kinda multicast with HTTP...
7 == Problems
9 * No support for bidirectional HTTP streaming
10 * No support for "Expect: 100-continue" headers/responses
11 * No support for DNS resolution (WONTFIX, ever)
12 * No support for HTTPS
13 * No support for keepalive (yet?)
14 * Not remotely RFC-compliant
15 * Messes up analytics/reporting on servers
16 * Resets server connections
17 * May get you banned from the Internet!
19 == Still Interested?
21 HTTP Spew lets you fire off identical (or similar) requests to multiple
22 HTTP servers and wait for any number (or all) of them to complete or for
23 a timeout to expire.
25 HTTP Spew may be useful for implementing reverse proxy servers if you
26 1) can't decide on a load balancing strategy for them
27 2) have much more hardware than you actually use
29 It's also completely untested and unused anywhere!
31 == Hacking
33 You can get the latest source via git from the following locations:
35   git://yhbt.net/http_spew.git
36   git://repo.or.cz/http_spew.git (mirror)
38 You may browse the code from the web and download the latest snapshot
39 tarballs here:
41 * https://yhbt.net/http_spew.git
42 * http://repo.or.cz/w/http_spew.git (gitweb)
44 Inline patches (from "git format-patch") to the mailing list are
45 preferred because they allow code review and comments in the reply to
46 the patch.
48 We will adhere to mostly the same conventions for patch submissions as
49 git itself.  See the Documentation/SubmittingPatches document
50 distributed with git on on patch submission guidelines to follow.  Just
51 don't email the git mailing list or maintainer with http_spew patches.
53 == Contact
55 All feedback (bug reports, user/development discussion, patches, pull
56 requests) go to the mailing list: mailto:http_spew-public@yhbt.net
58 Mailing list archives may be viewed and downloaded here:
60 https://yhbt.net/http_spew-public/