Tests
To execute all tests, run:
$./setup.py test
in the current directory.
For the more fine-grained running of tests or doctests, use bin/test
or respectively bin/doctest. The master branch is automatically tested
by GitHub Actions.
To test pull requests, use sympy-bot.
Regenerate Experimental LaTeX Parser/Lexer
The parser and lexer were generated with the ANTLR4
toolchain in sympy/parsing/latex/_antlr and checked into the repo.
Presently, most users should not need to regenerate these files, but
if you plan to work on this feature, you will need the antlr4
command-line tool (and you must ensure that it is in your PATH).
One way to get it is:
$ conda install -c conda-forge antlr=4.11.1
Alternatively, follow the instructions on the ANTLR website and download
the antlr-4.11.1-complete.jar. Then export the CLASSPATH as instructed
and instead of creating antlr4 as an alias, make it an executable file
with the following contents:
#!/bin/bash
java -jar /usr/local/lib/antlr-4.11.1-complete.jar "$@"
After making changes to sympy/parsing/latex/LaTeX.g4, run:
$ ./setup.py antlr
Clean
To clean everything (thus getting the same tree as in the repository):
$ git clean -Xdf
which will clear everything ignored by .gitignore, and:
$ git clean -df
to clear all untracked files. You can revert the most recent changes in git with:
$ git reset --hard
WARNING: The above commands will all clear changes you may have made,
and you will lose them forever. Be sure to check things with git
status, git diff, git clean -Xn, and git clean -n before doing any
of those.
Bugs
Our issue tracker is at https://github.com/sympy/sympy/issues. Please report any bugs that you find. Or, even better, fork the repository on GitHub and create a pull request. We welcome all changes, big or small, and we will help you make the pull request if you are new to git (just ask on our mailing list or Gitter Channel). If you further have any queries, you can find answers on Stack Overflow using the sympy tag.
Brief History
SymPy was started by Ondřej Čertík in 2005, he wrote some code during the summer, then he wrote some more code during summer 2006. In February 2007, Fabian Pedregosa joined the project and helped fix many things, contributed documentation, and made it alive again. 5 students (Mateusz Paprocki, Brian Jorgensen, Jason Gedge, Robert Schwarz, and Chris Wu) improved SymPy incredibly during summer 2007 as part of the Google Summer of Code. Pearu Peterson joined the development during the summer 2007 and he has made SymPy much more competitive by rewriting the core from scratch, which has made it from 10x to 100x faster. Jurjen N.E. Bos has contributed pretty-printing and other patches. Fredrik Johansson has written mpmath and contributed a lot of patches.
SymPy has participated in every Google Summer of Code since 2007. You can see https://github.com/sympy/sympy/wiki#google-summer-of-code for full details. Each year has improved SymPy by bounds. Most of SymPy’s development has come from Google Summer of Code students.
In 2011, Ondřej Čertík stepped down as lead developer, with Aaron Meurer, who also started as a Google Summer of Code student, taking his place. Ondřej Čertík is still active in the community but is too busy with work and family to play a lead development role.
Since then, a lot more people have joined the development and some people have also left. You can see the full list in doc/src/aboutus.rst, or online at:
https://docs.sympy.org/dev/aboutus.html#sympy-development-team
The git history goes back to 2007 when development moved from svn to hg. To see the history before that point, look at https://github.com/sympy/sympy-old.
You can use git to see the biggest developers. The command:
$ git shortlog -ns
will show each developer, sorted by commits to the project. The command:
$ git shortlog -ns --since="1 year"
will show the top developers from the last year.