Contribute to text2num

Submit bug reports, questions or feature requests

Bug reports, questions and feature requests should be submitted on

When you submit a bug report:

  • Precisely describe what was the expected behavior and what you actually got;
  • indicate your python version;
  • set the Bug label on your issue.

When you submit a feature request:

  • Precisely describe what you’d like, with many illustrative examples;
  • expose the rationale behind your request;
  • set the Enhancement label on your issue.

When you submit a question:

  • set the Question label on your issue.

Install from sources

First, create and activate a virtual environment with the tool of you preference.

Then clone in your workspace. If you are going to submit some patches, you should fork the project on Github and clone your own fork in your workspace.

Finally, install the sources in-place:

python develop

You do that once. Then, any change you make to the code is immediatly visible when you import the modules.

Run the tests

To run the tests, simply do:

python test

The tests are automatically discovered and run from the text_to_num/tests directory.

We also use mypy:

pip install mypy
mypy text_to_num

Submit changes

If you wish to submit changes, fork the projec on github, and clone your own fork locally.

All PR should be made from a dedicated branch, not from master, please.