[279] | 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 |
|
---|
[331] | 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
|
---|
[279] | 44 | Software is furnished to do so, subject to the following conditions:
|
---|
| 45 |
|
---|
[331] | 46 | The above copyright notice and this permission notice shall be included in
|
---|
[279] | 47 | all copies or substantial portions of the Software.
|
---|
| 48 |
|
---|
[331] | 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
|
---|
[279] | 55 | DEALINGS IN THE SOFTWARE.
|
---|