WolframAlpha NodeJS Wrapper
npm install wolfram-alpha-wrapperwolfram-alpha-wrapper
=====================
A nodejs wrapper for http://api.wolframalpha.com/v1/query.jsp
This software is a NodeJS application.
Install node and its package manager (npm) from here: http://nodejs.org
* install dependencies
``
npm install
Visit the Wolfram|Alpha Webservice API website http://products.wolframalpha.com/api to register for a Wolfram|Alpha API account. An AppID is provided on completion of API account registration. An AppID is a string that identifies your application, and it must be supplied in all calls to the Wolfram|Alpha API. If you have multiple applications using the Wolfram|Alpha API, each must have its own AppID.
After you have an AppID, you need to edit the value of APP_ID in demo.js. Only do this during development. You don't want other to use your key and can deplete your call quotas.
For security reason the safe place to store value for APP_ID is an enviroment variable named WOLFRAM_USERAPPID. You might use a .bashrc or equivalent to store this id.
To test immediately how wolfram-alpha-wrapper process a Wolfram|Alpha XML files, I have provided the XML file I have recieved while querying for the input word 'random' using my AppID and save it into .logs/test-query.xml
* setup include/WAConfig.js to use local file
`
// javascript
var config = require('./include/WAConfig');
config.set('USELOCALFILE', true);
`
* setup ./index.js to use local file
`
// javascript
var engine = require('./index.js');
var input = 'INPUTPARAMETER';
engine.getRequest(input, 'file://./.logs/test-query.xml', function (err, xml){
... PROCESS err and xml here
});
`
The provided demo.js is use to test wolfram-alpha-wrapper by just reading file .logs/test-query.xml instead of reading it from http://api.wolframalpha.com/v1/query.jsp.
* To capture the result of running demo.js
``
node demo > demo.json
* doc/demo.json is the sample output of reading 'random' information on the api.wolframalpha.com web site.
``
npm test
* Mocha test will display the following
``
> wolfram-alpha-wrapper@0.1.0 test /projects/wolfram-alpha-wrapper
> mocha -b test -u tdd -R spec
WolframAlphaWrapperTest
✓ Contructor test
✓ config.set("appID")
✓ engine.constructURL(input, other)
✓ engine.parseXML(xml, cb)
✓ engine.readXML(url, cb)
5 passing (27ms)
`
``
grunt
Running "jshint:gruntfile" (jshint) task
✔ No problems
Running "jshint:lib" (jshint) task
✔ No problems
Running "jshint:test" (jshint) task
✔ No problems
Running "mochaTest:test" (mochaTest) task
․․․․․
5 passing (35ms)
Done, without errors.
`
Currently, when you signup a free account in [](), your free application will have a limit of 2000 call per month.
For development purposes, we can cache the resulting XML into a file per input value. This way, the developer account can avoid exceeding it monthly API call quotas.
The getResults(input, otherParams, callback) method is design to programmatically switch from reading information on Wolframa|Alpha endpoint http://api.wolframalpha.com/v1/query.jsp or on the local file.
* The included node js files (as listed below) were distributed with MIT license.
``
./demo.js
./include/WAAssumption.js
./include/WAConfig.js
./include/WAImage.js
./include/WAInfo.js
./include/WAPod.js
./include/WAResponse.js
./include/WASubpod.js
./include/WASubstitution.js
./index.js
./LICENSE
Node js code were based from the PHP wrapper publish here http://products.wolframalpha.com/docs/PHP_Binding_0_1.zip
API Information were taken from http://products.wolframalpha.com/docs/WolframAlpha-API-Reference.pdf
Other Wolframa Alpha API information taken from http://products.wolframalpha.com/api/documentation.html