You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Tanner Collin cfc475a361 Add timeout 1 year ago
docs Merge https://github.com/jaraco/skeleton 3 years ago
wolframalpha Add timeout 1 year ago
.flake8 Run flake8 with tests. Add flake8 config to ignore common exclusions. Add comments to testing and docs extras to aid with merges. 3 years ago
.readthedocs.yml Move requirements for docs and testing into extras 4 years ago
.travis.yml Merge https://github.com/jaraco/skeleton 3 years ago
CHANGES.rst Backfill changelog 3 years ago
LICENSE Add a license file. Fixes jaraco/skeleton#1. 3 years ago
README.rst Merge https://github.com/jaraco/skeleton 3 years ago
appveyor.yml Save the pip cache across builds. Ref pypa/setuptools#1279. 3 years ago
conftest.py Feed the hobgoblins (delint). 3 years ago
pytest.ini Run flake8 with tests. Add flake8 config to ignore common exclusions. Add comments to testing and docs extras to aid with merges. 3 years ago
setup.cfg reference the license file in metadata 3 years ago
setup.py Merge https://github.com/jaraco/skeleton 3 years ago
tox.ini Merge https://github.com/jaraco/skeleton 3 years ago

README.rst

.. image:: https://img.shields.io/pypi/v/wolframalpha.svg
:target: https://pypi.org/project/wolframalpha

.. image:: https://img.shields.io/pypi/pyversions/wolframalpha.svg

.. image:: https://img.shields.io/travis/jaraco/wolframalpha/master.svg
:target: https://travis-ci.org/jaraco/wolframalpha

.. image:: https://readthedocs.org/projects/wolframalpha/badge/?version=latest
:target: https://wolframalpha.readthedocs.io/en/latest/?badge=latest

Python Client built against the `Wolfram|Alpha <http://wolframalpha.com>`_
v2.0 API.

Usage
=====

Basic usage is pretty simple. Create the client with your App ID (request from
Wolfram Alpha)::

import wolframalpha
client = wolframalpha.Client(app_id)

Then, you can send queries, which return Result objects::

res = client.query('temperature in Washington, DC on October 3, 2012')

Result objects have `pods` (a Pod is an answer group from Wolfram Alpha)::

for pod in res.pods:
do_something_with(pod)

Pod objects have ``subpods`` (a Subpod is a specific response with the plaintext
reply and some additional info)::

for pod in res.pods:
for sub in pod.subpods:
print(sub.text)

You may also query for simply the pods which have 'Result' titles or are
marked as 'primary' using ``Result.results``::

print(next(res.results).text)

All objects returned are dictionary subclasses, so to find out which attributes
Wolfram|Alpha has supplied, simply invoke ``.keys()`` on the object.
Attributes formed from XML attributes can be accessed with or without their
"@" prefix (added by xmltodict).

For more information, read the source.