Compare commits

...

23 Commits

Author SHA1 Message Date
6267bf84c6 chore: release version v0.5.2 2016-05-09 10:55:15 +01:00
4b82e33b39 chore: update contributors 2016-05-09 10:55:15 +01:00
8adced0f4b Merge pull request #13 from dignifiedquire/next
refactor: use aegir
2016-05-09 10:51:21 +01:00
3f4f163f40 refactor: use aegir 2016-05-09 11:14:40 +02:00
11c46ac995 Release v0.5.1. 2016-05-08 21:50:30 +01:00
749db165ce do not callback with error on no listeners to close 2016-05-08 21:50:03 +01:00
3781115f42 Release v0.5.0. 2016-04-25 02:21:55 +01:00
2070a5b0a0 Merge pull request #12 from diasdavid/fix/error-handling
switch from throw to send err to callback
2016-04-25 02:16:46 +01:00
c253a44f59 switch from throw to send err to callback 2016-04-25 02:13:49 +01:00
1e350a4dc7 Merge pull request #11 from noffle/words
Fixes README example & grammar.
2016-04-24 00:48:34 +01:00
69068f5da4 Fixes README example & grammar. 2016-04-22 14:14:07 -07:00
ce6edb05a2 Merge pull request #10 from noffle/master
Adds README, coverage, clean up, CircleCI.
2016-04-22 01:45:11 +01:00
73a79c9277 Enables ipv6 on CircleCI. 2016-04-21 16:42:40 -07:00
2e05826b30 s/::1/:: 2016-04-21 16:38:26 -07:00
e8a3c35cfb Adds example and API docs. 2016-04-21 16:33:57 -07:00
3c6bce9d28 Adds README stub. 2016-04-21 16:18:39 -07:00
d582fb5f61 Adds ipv6 tests. 2016-04-21 16:14:03 -07:00
b43f6ffb6f Makes callback optional on close. 2016-04-21 15:56:38 -07:00
c456326515 Improves test coverage. 2016-04-21 15:44:26 -07:00
6d1b729fcd Removes unused options param. 2016-04-21 15:36:39 -07:00
fdfdb7a5ad Adds circle.yml config. 2016-04-21 15:21:03 -07:00
3f87b5470c Merge pull request #8 from JGAntunes/patch-1
Fixing link in README.md
2016-04-03 13:36:38 -04:00
f4dafe55d1 Fixing link in README.md 2016-04-03 03:16:27 +01:00
11 changed files with 247 additions and 57 deletions

3
.gitignore vendored
View File

@ -25,3 +25,6 @@ build/Release
# Dependency directory
# https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git
node_modules
lib
dist

29
.npmignore Normal file
View File

@ -0,0 +1,29 @@
# Logs
logs
*.log
# Runtime data
pids
*.pid
*.seed
# Directory for instrumented libs generated by jscoverage/JSCover
lib-cov
# Coverage directory used by tools like istanbul
coverage
# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
.grunt
# node-waf configuration
.lock-wscript
# Compiled binary addons (http://nodejs.org/api/addons.html)
build/Release
# Dependency directory
# https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git
node_modules
test

View File

@ -1,11 +1,25 @@
sudo: false
language: node_js
node_js:
- "4.0"
- 4
- 5
- stable
# Make sure we have new NPM.
before_install:
- npm install -g npm
script:
- npm run lint
- npm test
- npm run coverage
addons:
firefox: 'latest'
before_script:
- export DISPLAY=:99.0
- sh -e /etc/init.d/xvfb start
after_success:
- npm run coverage-publish

View File

@ -11,6 +11,86 @@ js-libp2p-tcp
![](https://raw.githubusercontent.com/diasdavid/abstract-connection/master/img/badge.png)
![](https://raw.githubusercontent.com/diasdavid/abstract-transport/master/img/badge.png)
> Node.js implementation of the TCP module that libp2p uses, which implements the [interface-connection]() interface for dial/listen.
> Node.js implementation of the TCP module that libp2p uses, which implements
> the [interface-connection](https://github.com/diasdavid/interface-connection)
> interface for dial/listen.
note: libp2p-tcp in Node.js is a very thin shim that adds the support to dial to a `multiaddr`. This small shim will enable libp2p to use other different transports.
## Description
`libp2p-tcp` in Node.js is a very thin shim that adds support for dialing to a
`multiaddr`. This small shim will enable libp2p to use other different
transports.
## Example
```js
const Tcp = require('libp2p-tcp')
const multiaddr = require('multiaddr')
const mh1 = multiaddr('/ip4/127.0.0.1/tcp/9090')
const mh2 = multiaddr('/ip6/::/tcp/9092')
const tcp = new Tcp()
tcp.createListener([mh1, mh2], function handler (socket) {
console.log('connection')
socket.end('bye')
}, function ready () {
console.log('ready')
const client = tcp.dial(mh1)
client.pipe(process.stdout)
client.on('end', () => {
tcp.close()
})
})
```
outputs
```
ready
connection
bye
```
## Installation
### npm
```sh
> npm i libp2p-tcp
```
## API
```js
const Tcp = require('libp2p-tcp')
```
### var tcp = new Tcp()
Creates a new TCP object. This does nothing on its own, but provides access to
`dial` and `createListener`.
### tcp.createListener(multiaddrs, handler, ready)
Creates TCP servers that listen on the addresses described in the array
`multiaddrs`. Each connection will call `handler` with a connection stream.
`ready` is called once all servers are listening.
### tcp.dial(multiaddr, options={})
Connects to the multiaddress `multiaddr` using TCP, returning the socket stream.
If `options.ready` is set to a function, it is called when a connection is
established.
### tcp.close(callback)
Closes all the listening TCP servers, calling `callback` once all of them have
been shut down.
## License
MIT

12
circle.yml Normal file
View File

@ -0,0 +1,12 @@
machine:
node:
version: stable
dependencies:
pre:
- google-chrome --version
- wget -q -O - https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo apt-key add -
- sudo sh -c 'echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/google.list'
- sudo apt-get update
- sudo apt-get --only-upgrade install google-chrome-stable
- google-chrome --version

View File

@ -1,15 +1,18 @@
{
"name": "libp2p-tcp",
"version": "0.4.0",
"version": "0.5.2",
"description": "Node.js implementation of the TCP module that libp2p uses, which implements the interface-connection and interface-transport interfaces",
"main": "src/index.js",
"main": "lib/index.js",
"jsnext:main": "src/index.js",
"scripts": {
"test:compliance:connection": "node tests/connection.js",
"test:compliance:transport": "node tests/transport.js",
"test:specific": "mocha tests/*-test.js",
"test": "npm run test:specific",
"test-2": "npm run test:specific && npm run test:compliance:transport && npm run test:compliance:connection",
"lint": "standard"
"lint": "aegir-lint",
"build": "aegir-build --env node",
"test": "aegir-test --env node",
"release": "aegir-release --env node",
"release-minor": "aegir-release --type minor",
"release-major": "aegir-release --type major",
"coverage": "aegir-coverage",
"coverage-publish": "aegir-coverage publish"
},
"pre-commit": [
"lint",
@ -29,18 +32,24 @@
},
"homepage": "https://github.com/diasdavid/js-libp2p-tcp",
"devDependencies": {
"aegir": "^3.0.1",
"chai": "^3.5.0",
"interface-connection": "0.0.3",
"interface-transport": "^0.1.1",
"istanbul": "^0.4.2",
"mocha": "^2.4.5",
"pre-commit": "^1.1.2",
"standard": "^6.0.7",
"tape": "^4.2.0"
"tape": "^4.5.1"
},
"dependencies": {
"ip-address": "^5.8.0",
"mafmt": "^1.0.1",
"multiaddr": "^1.1.1"
}
"multiaddr": "^1.1.1",
"run-parallel": "^1.1.6"
},
"contributors": [
"David Dias <daviddias.p@gmail.com>",
"Friedel Ziegelmayer <dignifiedquire@gmail.com>",
"João Antunes <j.goncalo.antunes@gmail.com>",
"Richard Littauer <richard.littauer@gmail.com>",
"Stephen Whitmore <stephen.whitmore@gmail.com>"
]
}

View File

@ -1,9 +1,12 @@
// const debug = require('debug')
// const log = debug('libp2p:tcp')
'use strict'
const debug = require('debug')
const log = debug('libp2p:tcp')
const tcp = require('net')
const multiaddr = require('multiaddr')
const Address6 = require('ip-address').Address6
const mafmt = require('mafmt')
const parallel = require('run-parallel')
exports = module.exports = TCP
@ -26,21 +29,14 @@ function TCP () {
return conn
}
this.createListener = (multiaddrs, options, handler, callback) => {
if (typeof options === 'function') {
callback = handler
handler = options
options = {}
}
this.createListener = (multiaddrs, handler, callback) => {
if (!Array.isArray(multiaddrs)) {
multiaddrs = [multiaddrs]
}
var count = 0
const freshMultiaddrs = []
multiaddrs.forEach((m) => {
parallel(multiaddrs.map((m) => (cb) => {
const listener = tcp.createServer((conn) => {
conn.getObservedAddrs = () => {
return [getMultiaddr(conn)]
@ -55,30 +51,28 @@ function TCP () {
m = m.encapsulate('/tcp/' + address.port)
freshMultiaddrs.push(m)
}
if (address.family === 'IPv6') {
freshMultiaddrs.push(multiaddr('/ip6/' + address.address + '/tcp/' + address.port))
}
if (++count === multiaddrs.length) {
callback(null, freshMultiaddrs)
}
cb()
})
listeners.push(listener)
}), (err) => {
callback(err, freshMultiaddrs)
})
}
this.close = (callback) => {
if (listeners.length === 0) {
throw new Error('there are no listeners')
log('Called close with no active listeners')
return callback()
}
var count = 0
listeners.forEach((listener) => {
listener.close(() => {
if (++count === listeners.length) {
callback()
}
})
})
parallel(listeners.map((listener) => {
return (cb) => listener.close(cb)
}), callback)
}
this.filter = (multiaddrs) => {

View File

@ -1,4 +1,5 @@
/* eslint-env mocha */
'use strict'
const expect = require('chai').expect
const TCPlibp2p = require('../src')
@ -15,6 +16,19 @@ describe('libp2p-tcp', function () {
done()
})
it('create without new', (done) => {
tcp = TCPlibp2p()
expect(tcp).to.exist
done()
})
it('close /wo listeners', (done) => {
tcp = new TCPlibp2p()
expect(tcp).to.exist
expect(function () { tcp.close() }).to.throw(Error)
done()
})
it('listen', (done) => {
const mh = multiaddr('/ip4/127.0.0.1/tcp/9090')
tcp.createListener(mh, (socket) => {
@ -46,13 +60,32 @@ describe('libp2p-tcp', function () {
it('listen on several', (done) => {
const mh1 = multiaddr('/ip4/127.0.0.1/tcp/9090')
const mh2 = multiaddr('/ip4/127.0.0.1/tcp/9091')
const mh3 = multiaddr('/ip6/::/tcp/9092')
const tcp = new TCPlibp2p()
tcp.createListener([mh1, mh2], (socket) => {}, () => {
tcp.createListener([mh1, mh2, mh3], (socket) => {}, () => {
tcp.close(done)
})
})
it('dial ipv6', (done) => {
const mh = multiaddr('/ip6/::/tcp/9091')
var dialerObsAddrs
tcp.createListener(mh, (conn) => {
expect(conn).to.exist
dialerObsAddrs = conn.getObservedAddrs()
conn.end()
}, () => {
const conn = tcp.dial(mh)
conn.on('end', () => {
expect(dialerObsAddrs.length).to.equal(1)
tcp.close()
done()
})
})
})
it('get observed addrs', (done) => {
const mh = multiaddr('/ip4/127.0.0.1/tcp/9090')
var dialerObsAddrs
@ -88,5 +121,12 @@ describe('libp2p-tcp', function () {
done()
})
it.skip('listen on IPv6', (done) => {})
it('filter a valid addr for this transport', (done) => {
const mh1 = multiaddr('/ip4/127.0.0.1/tcp/9090')
const valid = tcp.filter(mh1)
expect(valid.length).to.equal(1)
expect(valid[0]).to.deep.equal(mh1)
done()
})
})

View File

@ -0,0 +1,23 @@
/* eslint-env mocha */
'use strict'
const tape = require('tape')
const tests = require('interface-transport/tests')
const TCP = require('../src')
// Not adhering to this interface anymore!
describe.skip('interface-transport', () => {
it('works', (done) => {
const common = {
setup (t, cb) {
cb(null, new TCP())
},
teardown (t, cb) {
cb()
}
}
tape.onFinish(done)
tests(tape, common)
})
})

View File

View File

@ -1,14 +0,0 @@
var tape = require('tape')
var tests = require('interface-transport/tests')
var conn = require('../src')
var common = {
setup: function (t, cb) {
cb(null, conn)
},
teardown: function (t, cb) {
cb()
}
}
tests(tape, common)