File: README.md

package info (click to toggle)
ruby-http-parser 1.2.3-1
  • links: PTS, VCS
  • area: main
  • in suites: sid, trixie
  • size: 280 kB
  • sloc: ansic: 2,137; ruby: 672; makefile: 12
file content (70 lines) | stat: -rw-r--r-- 1,324 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
# http-parser

Ruby FFI bindings to [http-parser](https://github.com/joyent/http-parser) [![Build Status](https://travis-ci.org/cotag/http-parser.png)](https://travis-ci.org/cotag/http-parser)

## Install

```shell
gem install http-parser
```
This gem will compile a local copy of http-parser


## Usage

```ruby
require 'rubygems'
require 'http-parser'

#
# Create a shared parser
#
parser = HttpParser::Parser.new do |parser|
  parser.on_message_begin do |inst|
    puts "message begin"
  end

  parser.on_message_complete do |inst|
    puts "message end"
  end

  parser.on_url do |inst, data|
    puts "url: #{data}"
  end

  parser.on_header_field do |inst, data|
    puts "field: #{data}"
  end

  parser.on_header_value do |inst, data|
    puts "value: #{data}"
  end
end

#
# Create state objects to track requests through the parser
#
request = HttpParser::Parser.new_instance do |inst|
  inst.type = :request
end

#
# Parse requests
#
parser.parse request, "GET /foo HTTP/1.1\r\n"
sleep 3
parser.parse request, "Host: example.com\r\n"
sleep 3
parser.parse request, "\r\n"

#
# Re-use the memory for another request
#
request.reset!
```

## Acknowledgements

* https://github.com/joyent/http-parser#readme
* https://github.com/postmodern/ffi-http-parser#readme
* https://github.com/deepfryed/http-parser-lite#readme