kcar.git  about / heads / tags
bytestream to Rack response converter
$ git log --pretty=format:'%h %s (%cs)%d'
bee39bd GNUmakefile: fix rsync destination for website (2020-02-21)
	(HEAD -> master)
cf28341 kcar 0.7.0 (2020-02-21)
	(tag: v0.7.0)
22b2fe5 doc: update URLs to point to YHBT.net (2020-02-19)
112498f website: use dark216 to save electricity (2020-02-19)
979187f use rb_gc_register_mark_object (2018-12-26)
94bc440 extconf: fix rb_hash_aset deduplication test (2018-12-15)
5ac452d request: set env["FRAGMENT"] for WebDAV litmus test (2018-12-01)
14e39b6 avoid String#-@ call on request parsing under Ruby 2.6 (2018-12-01)
e2973f3 always set non-negative Content-Length for requests (2018-12-01)
15c9b06 do not set "HTTP/0.9" for pre-1.0 requests (2018-12-01)
...

$ git cat-file blob HEAD:README
= kcar - bytestream to Rack response converter

kcar features an HTTP parser that will convert a bytestream into a
3-element array suitable for use as a Rack response.  It is IO interface
agnostic, so it may be used with HTTP streams over Unix domain sockets,
regular files, FIFOs, StringIOs as well as traditional TCP sockets.

== Features

* RFC2616-compliant Ragel+C parser adapted from Mongrel

* decodes chunked response bodies with an optional pass-through mode
  (to avoid rechunking with Rack::Chunked)

* handles odd things like trailers and multiline headers

* streaming interface for response bodies allows for incremental
  processing of arbitrarily large responses.

* supported under Ruby 1.9 and later.

== Problems

* kcar is only lightly tested and is not yet aware of all quirks found in
  all real (possibly broken) web servers.

== Install

If you're using a packaged Ruby distribution, make sure you have a C
compiler and the matching Ruby development libraries and headers.

If you use RubyGems:

    gem install kcar

Otherwise grab the latest tarball from:

https://yhbt.net/kcar/files/

Unpack it, and run "ruby setup.rb"

== Usage:

While you can use the Kcar::Parser directly, you'll usually want the
higher-level interface of Kcar::Response:

    require 'rack' # for Rack::Utils::HeaderHash, which is optional
    require 'socket' # for TCPSocket
    require 'kcar'
    sock = TCPSocket.new('example.com', 80)
    sock.write("GET / HTTP/1.0\r\n\r\n")

    # instead of a Rack::Utils::HeaderHash object below, you can also
    # pass a regular Hash or Array object.
    response = Kcar::Response.new(sock, Rack::Utils::HeaderHash.new)
    status, headers, body = response.rack

You can now do further processing on the status, headers, or iterate
through the body with body.each.

== Development

You can get the latest source via git from the following locations:

  https://yhbt.net/kcar.git
  https://repo.or.cz/kcar.git (mirror)

You may browse the code from the web and download the latest snapshot
tarballs here:

* https://yhbt.net/kcar.git
* https://repo.or.cz/w/kcar.git (gitweb)

Inline patches (from "git format-patch") to the mailing list are
preferred because they allow code review and comments in the reply to
the patch.

We will adhere to mostly the same conventions for patch submissions as
git itself.  See the Documentation/SubmittingPatches document
distributed with git on on patch submission guidelines to follow.  Just
don't email the git mailing list or maintainer with kcar patches.

== Contact

All feedback (bug reports, user/development discussion, patches, pull
requests) go to the public mailing list: mailto:kcar-public@yhbt.net
All mail is archived publically at: https://yhbt.net/kcar-public/
and nntp://news.public-inbox.org/inbox.comp.lang.ruby.kcar

Anonymous posts will always be welcome.

No subscription is necessary to post to the mailing list;
but you may subscribe by sending a plain-text mail to:

	mailto:kcar-public+subscribe@yhbt.net

Keep in mind we suck at delivering email, so using NNTP or
Atom feeds might be a better bet.
Please remember to Cc: all recipients as subscription is optional.

# heads (aka `branches'):
$ git for-each-ref --sort=-creatordate refs/heads \
	--format='%(HEAD) %(refname:short) %(subject) (%(creatordate:short))'
* master       GNUmakefile: fix rsync destination for website (2020-02-21)

# tags:
$ git for-each-ref --sort=-creatordate refs/tags \
	--format='%(refname:short) %(subject) (%(creatordate:short))'
v0.7.0       kcar 0.7.0 (2020-02-21) tar.gz
v0.6.0       kcar 0.6.0 - minor cleanups (2015-08-04) tar.gz
v0.5.0       kcar 0.5.0 - GPL-2.0+, new mailing list, doc updates (2015-01-14) tar.gz
v0.4.0       kcar 0.4.0 - Kcar::Response improvement (2012-10-26) tar.gz
v0.3.1       kcar 0.3.1 - Kcar::Response minor bugfix (2012-09-26) tar.gz
v0.3.0       kcar 0.3.0 (2011-06-07) tar.gz
v0.2.0       kcar 0.2.0 - small improvements (2011-02-24) tar.gz
v0.1.2       kcar 0.1.2 - one bugfix for one liners (2010-11-30) tar.gz
v0.1.1       kcar 0.1.1 (2010-07-25) tar.gz
v0.1.0       kcar 0.1.0 - initial release (2010-04-28) tar.gz

# associated public inboxes:
# (number on the left is used for dev purposes)
            https://yhbt.net/kcar-public

git clone https://yhbt.net/kcar.git