Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

bencodec

isolomak207MIT3.1.0TypeScript support: included

Library for decoding and encoding bencode data

bencode, codec, bittorrent, torrent, read, create, decode, encode, parse, generate

readme

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