Wikipedia Anagrams

Finds anagrams in Wikipedia pages.

Installation

$ npm install wikipedia-anagrams

For use in the browser, use browserify.

Usage

var getAnagrams = require( 'wikipedia-anagrams' );

getAnagrams( resources, [opts,] clbk )

Finds anagrams in Wikipedia pages. The function requires two arguments:

• resources: may be either a string specifying a page title/URL or a string array specifying multiple page title/URLs.
• clbk: callback function to invoke after analyzing Wikipedia pages. The function should accept two arguments:
  • error: error object. If no errors occur during analysis, this value is null.
  • hashes: array of anagram hashes.

// Single resource:
getAnagrams( 'President of the United States', onAnagrams );

// Multiple resources:
getAnagrams( [
	'http://en.wikipedia.org/wiki/ballet',
	'http://es.wikipedia.org/wiki/ballet'
], onAnagrams );

function onAnagrams( error, hashes ) {
	if ( error ) {
		console.error( error );
		return;
	}
	console.log( hashes );
}

The function accepts the following options:

• lang: the default page language. Default: 'en'.

To specify an alternative default language, set the lang option.

getAnagrams( 'ballet', {'lang':'es'}, onAnagrams );
// => fetches the Spanish Wikipedia resource for ballet

Note: if provided a URL, the language indicated by the URL supersedes the default lang option.

getAnagrams( 'http://en.wikipedia.org/wiki/ballet', {'lang':'es'}, onAnagrams );
// => fetches the 'en' ballet resource, not the 'es' resource

Examples

var getAnagrams = require( 'wikipedia-anagrams' );

// Specify Wikipedia resources either by page title or by URL...
var resources = [
	'Linear regression',
	'http://en.wikipedia.org/wiki/ballet',
	'http://es.wikipedia.org/wiki/ballet',
	'Spain',
	'President of the United States',
	'Mathematics'
];

// Run the analysis...
getAnagrams( resources, onAnagrams );

// Callback invoked after running the anagram analysis...
function onAnagrams( error, hashes ) {
	var hash,
		len,
		i;
	if ( error ) {
		throw new Error( error );
	}
	// Print the individual results...
	len = hashes.length;
	for ( i = 0; i < len; i++ ) {
		console.log( resources[ i ] + '...' );
		console.log( hashes[ i ].get() );
		console.log( '\n' );
	}
	// Merge the hashes...
	hash = hashes[ 0 ].copy();
	hash.merge.apply( hash, hashes.slice( 1 ) );

	// Print the merged hash...
	console.log( 'Merged...' );
	console.log( hash.get() );
}

To run the example code from the top-level application directory,

$ node ./examples/index.js

CLI

Installation

To use the module as a general utility, install the module globally

$ npm install -g wikipedia-anagrams

Usage

Usage: wikipedia-anagrams [options] [url 1] [url 2] [url 3] ...

Options:

  -h,    --help                Print this message.
  -V,    --version             Print the package version.
  -enc,  --encoding <encoding> Set the string encoding of chunks. Default: null.
  -hwm,  --highwatermark       Specify how much data can be buffered into memory
                               before applying back pressure. Default: 16kb.
  -nho,  --no-halfopen         Close the stream when the writable stream ends.
                               Default: false.
  -nds,  --no-decodestrings    Prevent strings from being converted into buffers
                               before streaming to destination. Default: false.
  -om,   --objectmode          Stream individual objects rather than buffers.
                               Default: false.
  -lang, --language <lang>     Set the default query language. Default: 'en'.

The wikipedia-anagrams command is available as a standard stream.

$ <stdout> | wikipedia-anagrams | <stdin>

Examples

# Specify a single page title:
$ wikipedia-anagrams mathematics

# Specify the default language:
$ wikipedia-anagrams --lang=es ballet

# Specify multiple page titles:
$ wikipedia-anagrams mathematics ballet

# Specify a single page URL:
$ wikipedia-anagrams 'http://en.wikipedia.org/wiki/mathematics'

# Specify multiple page URLs:
$ wikipedia-anagrams 'http://en.wikipedia.org/wiki/mathematics' 'http://en.wikipedia/org/wiki/ballet'

# Specify both page titles and page URLs:
$ wikipedia-anagrams 'http://en.wikipedia.org/wiki/mathematics' ballet

# Pipe Wikipedia page markup:
$ curl -s 'http://en.wikipedia.org/w/index.php?action=raw&title=mathematics' | wikipedia-anagrams | awk '{print "\nAnagrams:\n\n"$1}'

# Pipe multiple Wikipedia pages:
$ curl -s 'http://en.wikipedia.org/w/index.php?action=raw&title=mathematics' 'http://en.wikipedia.org/w/index.php?action=raw&title=ballet' | wikipedia-anagrams | awk '{print "\nAnagrams:\n\n"$1}'

For local installations, modify the command to point to the local installation directory; e.g.,

$ ./node_modules/.bin/wikipedia-anagrams  mathematics

Or, if you have cloned this repository and run npm install, modify the command to point to the executable; e.g.,

$ node ./bin/cli mathematics

Tests

Unit

Unit tests use the Mocha test framework with Chai assertions. To run the tests, execute the following command in the top-level application directory:

$ make test

All new feature development should have corresponding unit tests to validate correct functionality.

Test Coverage

This repository uses Istanbul as its code coverage tool. To generate a test coverage report, execute the following command in the top-level application directory:

$ make test-cov

Istanbul creates a ./reports/coverage directory. To access an HTML version of the report,

$ make view-cov

License

MIT license.

Copyright

Copyright © 2015. Athan Reines.