node-wolfram
v0.0.1
Published
Extremely minimal WolframAlpha API wrapper for Node.js.
Downloads
51
Readme
node-wolfram
node-wolfram is a very thin wrapper for the WolframAlpha API. It merely makes queries and returns the answer in JSON (converted from their usual XML). The conversion is done with node-xml2js and nothing else is done.
(Kind of a rewrite of node-wolfram by strax. He used libxml for parsing and I didn't like that.)
Install
npm install node-wolfram
Usage
Here is an example in JavaScript:
var Client = require('node-wolfram');
var Wolfram = new Client('YOUR_APPID_HERE');
Wolfram.query("2+2", function(err, result) {
if(err)
console.log(err);
else
{
for(var a=0; a<result.queryresult.pod.length; a++)
{
var pod = result.queryresult.pod[a];
console.log(pod.$.title,": ");
for(var b=0; b<pod.subpod.length; b++)
{
var subpod = pod.subpod[b];
for(var c=0; c<subpod.plaintext.length; c++)
{
var text = subpod.plaintext[c];
console.log('\t', text);
}
}
}
}
});Here is the equivalent in CoffeeScript:
Client = require 'node-wolfram'
Wolfram = new Client('YOUR_APPID_HERE')
Wolfram.query "2+2", (err, result) ->
if err?
console.log err
else
for pod in result.queryresult.pod
console.log pod.$.title + ": "
for subpod in pod.subpod
for text in subpod.plaintext
console.log '\t', textBoth will output:
Input:
2+2
Result:
4
Number name:
four
Number line:
Manipulatives illustration:
| + | | = |
2 | | 2 | | 4
Typical human computation times:
age 6: 3.2 seconds | age 8: 1.8 seconds | age 10: 1.2 seconds |
age 18: 0.83 seconds
(ignoring concentration, repetition, variations in education, etc.)If the request or xml2js conversion has an error, the callback will receive that error. If the query is received, but the queryresult has an error property, then the error given to the callback will be that queryresult's error.
Testing
Install grunt with: npm install -g grunt grunt-cli
APPID=YOUR_APPID_HERE grunt test
Example Response
This is what you get for the response if you query 2+2. It should help show how the XML response gets converted to JSON. Attributes of tags are stored in the $ properties.
{
"queryresult": {
"$": {
"success": "true",
"error": "false",
"numpods": "6",
"datatypes": "Math",
"timedout": "",
"timedoutpods": "",
"timing": "0.671",
"parsetiming": "0.076",
"parsetimedout": "false",
"recalculate": "",
"id": "MSPa264521a0e4dg83gd7eg200005037925gie85ce02",
"host": "http://www5a.wolframalpha.com",
"server": "29",
"related": "http://www5a.wolframalpha.com/api/v2/relatedQueries.jsp?id=MSPa264621a0e4dg83gd7eg200003a3da730hhbdgifi&s=29",
"version": "2.6"
},
"pod": [{
"$": {
"title": "Input",
"scanner": "Identity",
"id": "Input",
"position": "100",
"error": "false",
"numsubpods": "1"
},
"subpod": [{
"$": {
"title": ""
},
"plaintext": ["2+2"],
"img": [{
"$": {
"src": "http://www5a.wolframalpha.com/Calculate/MSP/MSP264721a0e4dg83gd7eg20000519g66800ac2e7bg?MSPStoreType=image/gif&s=29",
"alt": "2+2",
"title": "2+2",
"width": "32",
"height": "18"
}
}]
}]
}, {
"$": {
"title": "Result",
"scanner": "StepByStep",
"id": "Result",
"position": "200",
"error": "false",
"numsubpods": "1",
"primary": "true"
},
"subpod": [{
"$": {
"title": ""
},
"plaintext": ["4"],
"img": [{
"$": {
"src": "http://www5a.wolframalpha.com/Calculate/MSP/MSP264821a0e4dg83gd7eg2000033434gf1i1cfc47h?MSPStoreType=image/gif&s=29",
"alt": "4",
"title": "4",
"width": "8",
"height": "18"
}
}]
}],
"states": [{
"$": {
"count": "1"
},
"state": [{
"$": {
"name": "Step-by-step solution",
"input": "Result__Step-by-step solution"
}
}]
}]
}, {
"$": {
"title": "Number name",
"scanner": "Integer",
"id": "NumberName",
"position": "300",
"error": "false",
"numsubpods": "1"
},
"subpod": [{
"$": {
"title": ""
},
"plaintext": ["four"],
"img": [{
"$": {
"src": "http://www5a.wolframalpha.com/Calculate/MSP/MSP264921a0e4dg83gd7eg2000026f0i2b652da2991?MSPStoreType=image/gif&s=29",
"alt": "four",
"title": "four",
"width": "28",
"height": "18"
}
}]
}]
}, {
"$": {
"title": "Number line",
"scanner": "NumberLine",
"id": "NumberLine",
"position": "400",
"error": "false",
"numsubpods": "1"
},
"subpod": [{
"$": {
"title": ""
},
"plaintext": [""],
"img": [{
"$": {
"src": "http://www5a.wolframalpha.com/Calculate/MSP/MSP265021a0e4dg83gd7eg20000393ii8ihd6575ib6?MSPStoreType=image/gif&s=29",
"alt": "",
"title": "",
"width": "300",
"height": "51"
}
}]
}]
}, {
"$": {
"title": "Manipulatives illustration",
"scanner": "Arithmetic",
"id": "Illustration",
"position": "500",
"error": "false",
"numsubpods": "1"
},
"subpod": [{
"$": {
"title": ""
},
"plaintext": [" | + | | = | \n2 | | 2 | | 4"],
"img": [{
"$": {
"src": "http://www5a.wolframalpha.com/Calculate/MSP/MSP265121a0e4dg83gd7eg20000596ci7a3i5064882?MSPStoreType=image/gif&s=29",
"alt": " | + | | = | \n2 | | 2 | | 4",
"title": " | + | | = | \n2 | | 2 | | 4",
"width": "134",
"height": "48"
}
}]
}]
}, {
"$": {
"title": "Typical human computation times",
"scanner": "Arithmetic",
"id": "TypicalHumanComputationTimes",
"position": "600",
"error": "false",
"numsubpods": "1"
},
"subpod": [{
"$": {
"title": ""
},
"plaintext": ["age 6: 3.2 seconds | age 8: 1.8 seconds | age 10: 1.2 seconds | \nage 18: 0.83 seconds\n(ignoring concentration, repetition, variations in education, etc.)"],
"img": [{
"$": {
"src": "http://www5a.wolframalpha.com/Calculate/MSP/MSP265221a0e4dg83gd7eg20000647fdi2ce1ce2f8e?MSPStoreType=image/gif&s=29",
"alt": "age 6: 3.2 seconds | age 8: 1.8 seconds | age 10: 1.2 seconds | \nage 18: 0.83 seconds\n(ignoring concentration, repetition, variations in education, etc.)",
"title": "age 6: 3.2 seconds | age 8: 1.8 seconds | age 10: 1.2 seconds | \nage 18: 0.83 seconds\n(ignoring concentration, repetition, variations in education, etc.)",
"width": "485",
"height": "63"
}
}]
}],
"states": [{
"$": {
"count": "1"
},
"state": [{
"$": {
"name": "More details",
"input": "TypicalHumanComputationTimes__More details"
}
}]
}]
}],
"sources": [{
"$": {
"count": "1"
},
"source": [{
"$": {
"url": "http://www.wolframalpha.com/sources/HumanComputationQuerySourceInformationNotes.html",
"text": "Human computation query"
}
}]
}]
}
}