1 | mruby-socket
|
---|
2 | ============
|
---|
3 |
|
---|
4 | "mruby-socket" mrbgem provides BSD socket interface for mruby.
|
---|
5 | API is compatible with CRuby's "socket" library.
|
---|
6 |
|
---|
7 |
|
---|
8 | ## Example
|
---|
9 | ```sh
|
---|
10 | % vi kame.rb
|
---|
11 | s = TCPSocket.open("www.kame.net", 80)
|
---|
12 | s.write("GET / HTTP/1.0\r\n\r\n")
|
---|
13 | puts s.read
|
---|
14 | s.close
|
---|
15 |
|
---|
16 | % mruby kame.rb
|
---|
17 | HTTP/1.1 200 OK
|
---|
18 | Date: Tue, 21 May 2013 04:31:30 GMT
|
---|
19 | ...
|
---|
20 | ```
|
---|
21 |
|
---|
22 | ## Requirement
|
---|
23 | - [iij/mruby-io](https://github.com/iij/mruby-io) mrbgem
|
---|
24 | - [iij/mruby-mtest](https://github.com/iij/mruby-mtest) mrgbem to run tests
|
---|
25 | - system must have RFC3493 basic socket interface
|
---|
26 | - and some POSIX API...
|
---|
27 |
|
---|
28 | ## TODO
|
---|
29 | - add missing methods
|
---|
30 | - write more tests
|
---|
31 | - fix possible descriptor leakage (see XXX comments)
|
---|
32 | - `UNIXSocket#recv_io` `UNIXSocket#send_io`
|
---|
33 |
|
---|
34 |
|
---|
35 | ## License
|
---|
36 |
|
---|
37 | Copyright (c) 2013 Internet Initiative Japan Inc.
|
---|
38 |
|
---|
39 | Permission is hereby granted, free of charge, to any person obtaining a
|
---|
40 | copy of this software and associated documentation files (the "Software"),
|
---|
41 | to deal in the Software without restriction, including without limitation
|
---|
42 | the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
---|
43 | and/or sell copies of the Software, and to permit persons to whom the
|
---|
44 | Software is furnished to do so, subject to the following conditions:
|
---|
45 |
|
---|
46 | The above copyright notice and this permission notice shall be included in
|
---|
47 | all copies or substantial portions of the Software.
|
---|
48 |
|
---|
49 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
---|
50 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
---|
51 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
---|
52 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
---|
53 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
---|
54 | FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
---|
55 | DEALINGS IN THE SOFTWARE.
|
---|