Skip to content

Library for decoding and encoding bencoded data.

License

Notifications You must be signed in to change notification settings

isolomak/bencodec

Repository files navigation

Bencodec

ci Coverage Status NPM Downloads NPM License Commitizen friendly

Library for decoding and encoding bencode data
Compliant with the BitTorrent bencoding specification

Fast and easy to use
Written in TypeScript
Fully tested with 100% code coverage
Without dependencies

Installation

npm install --save bencodec

Getting Started

Decode data

By default, all strings will be parsed as buffers

import bencodec from 'bencodec';

const result = bencodec.decode( 'd3:bar4:spam3:fooi42ee' );
// result = { bar: <Buffer 73 70 61 6d>, foo: 42 }

To convert buffers to strings add stringify option

const result = bencodec.decode( 'd3:bar4:spam3:fooi42ee', { stringify: true } );
// result = { bar: 'spam', foo: 42 }

Encode data

By default method encode will return buffer

import bencodec from 'bencodec';

const result = bencodec.encode({ bar: 'spam', foo: 42 });  
// result = <Buffer 64 33 ... 65 65>

To convert buffer to string add stringify option

const result = bencodec.encode({ bar: 'spam', foo: 42 }, { stringify: true });
// result = 'd3:bar4:spam3:fooi42ee'

Tests

npm test

License

This project is licensed under the MIT License - see the LICENSE file for details