A SymPy version of WolframAlpha.
.. image:: https://travis-ci.org/sympy/sympygamma.svg?branch=master :target: https://travis-ci.org/sympy/sympygamma
SymPy Gamma_ is a simple web application based on Google App Engine that executes and displays the results of SymPy expressions as well as additional related computations, in a fashion similar to that of Wolfram|Alpha. For instance, entering an integer will display prime factors, digits in the base-10 expansion, and a factorization diagram. Entering a function will give its docstring; in general, entering an arbitrary expression will provide the derivative, integral, series expansion, plot, and roots.
Google App Engine has intrinsic 30 second request handling limit, so each evaluation request is a subject to this limit. There are also other limits related to memory consumption, output size, etc. (see Google App Engine documentation for details). Each result is evaluated in a separate request, so (for instance) an integral that takes too long will not prevent the other information from loading.
Clone sympy_gamma repository::
$ git clone git://github.com/sympy/sympy_gamma.git $ cd sympy_gamma
To setup the development environment and run the app locally, you need
Now you are ready to run development web server::
$ docker-compose up
This will build and run the image for app and datastore emulator.
This will spin up a local server that runs on port
8080. Open a web browser and go to http://localhost:8080. You should see GUI of SymPy Gamma
Note: Make sure to set
DEBUG = Truein
settings.pyfor serving staticfiles locally.
Travis-CI is used to deploy automatically to the official server via Github Releases. Go to https://github.com/sympy/sympy_gamma/releases and click on create a release and name the release as version-NN where NN is the release version. After this travis will automatically release the version NN.
To upload the application manually, you need to do a few things. First, tag the current commit with the App Engine application version (this is not necessary unless you are deploying to the official server)::
$ git tag -a version-42
Then install the Google Cloud SDK for your OS from here: https://cloud.google.com/sdk/install
This will let you use the "gcloud" CLI. After this configure the CLI to access the google cloud console for the project::
$ gcloud init
Assuming that sympygamma works properly (also across different mainstream web browsers), you can upload your changes to Google App Engine, replacing the <TAGGEDVERSION> with actual version we tagged with::
$ gcloud app deploy --project sympy-gamma-hrd --no-promote --version
This requires admin privileges to https://sympy-gamma-hrd.appspot.com. If you don't have access to this App Engine application, but want to test it, see the instructions in the
Testing on the App Engine_ section below.
Finally, go to https://NN-dot-sympy-gamma-hrd.appspot.com, where
NNis the version you just uploaded, and make sure that it works. If it does, go to the
Versionssection of the sympy_gamma dashboard, and set this as the new default version. If there are any issues, you can roll back to the previous version from this same screen.
Travis-CI deploys the application using service account credentials. To create a service account for deployment with suitable permissions, follow these steps:
These are stored encrypted in the
client-secret.json.encfile in the repository, and are generated using the Travis command-line tools (client-secret.json is the credentials file for the service account created int the step above) ::
travis encrypt-file client-secret.json --add
This also adds the encrypted keys in travis environment variables, which you can check from here: https://travis-ci.org/github/aktech/sympy_gamma/settings in the "Environment Variables" section.
It's usually a good idea to test big changes on the App Engine itself before deploying, as local environment can only simulate the App Engine. Currently, there is no testing server set up as there is for SymPy Live. However, you can set up your own testing server (it's free, though it requires a cell phone to set up).
Either way, to test, you will need to edit the Project ID in the deploy command mentioned above with your Project ID and the version you want to deploy to::
gcloud app deploy --project --no-promote --version
If you have a test app online, remember to update it every time you update a pull request, so that others can easily review your work, without even having to use
Branch builds are automatically deployed by Travis to
https://-dot-sympy-gamma-hrd.appspot.com/. Note that the pull request has to be from a branch on this repository, as forks do not have access to the key to deploy to the app engine.
To run tests you need to spinup the container as mentioned above via
docker-composeand run the following command::
$ docker-compose exec app nosetests app/test -vv $ docker-compose exec app casperjs test app/test
Update the version in requirements.txt file.
Originally realized by Ondřej Čertík (a core SymPy developer) as an online Python notebook and Wolfram|Alpha clone for the Google App Engine that would showcase SymPy. The notebook was eventually removed in favor of using SymPy Live.