node-nntp/README.md

A client for connecting with a NNTP server.

# NNTP

Client for communicating with servers through the Network News Transfer Protocol (NNTP) protocol.

[![NPM version](http://img.shields.io/npm/v/node-nntp.svg?style=flat)](https://www.npmjs.org/package/node-nntp)
[![Build Status](http://img.shields.io/travis/RobinvdVleuten/node-nntp.svg?style=flat)](https://travis-ci.org/RobinvdVleuten/node-nntp)
[![Coverage Status](http://img.shields.io/coveralls/RobinvdVleuten/node-nntp.svg?style=flat)](https://coveralls.io/r/RobinvdVleuten/node-nntp)
[![Code Climate](http://img.shields.io/codeclimate/github/RobinvdVleuten/node-nntp.svg?style=flat)](https://codeclimate.com/github/RobinvdVleuten/node-nntp)
[![Gittip](http://img.shields.io/gittip/RobinvdVleuten.svg?style=flat)](https://www.gittip.com/RobinvdVleuten/)

## Installation

```bash
$ npm install node-nntp
```

## Usage

Here is an example that fetches 100 articles from the _php.doc_ of the _news.php.net_ server:

```javascript
var NNTP = require('node-nntp');

var nntp = new NNTP({host: 'news.php.net', port: 119, secure: false});

nntp.connect(function (error, response) {

  nntp.group('php.doc.nl', function (error, group) {

    nntp.overviewFormat(function (error, format) {

      // If your server supports XZVER use nntp.xzver for a performance boost.
      nntp.xover(group.first + '-' + (parseInt(group.first, 10) + 100), format, function (error, messages) {
        // An array containing all messages.
        console.log(messages);
      });
    });
  });
});
```

## License

MIT, see LICENSE