Skip to main content

Characters Tables and Tokenizer for Mathics and the Wolfram Language.

Project description

Workflows Pypi Installs Latest Version Supported Python Versions

Packaging status

Mathics Character Tables and Scanner

This repository really contains two things:

  • extensive tables describing WL symbols and operators their properties

  • a tokenizer or scanner portion for the Wolfram Language.

With respect to the first item, there is a commented YAML that contains a full set of translation between:

  • Wolfram Language named characters,

  • their Unicode/ASCII equivalents and Unicode and WL code-points,

  • Operator name (if symbol is an operator),

  • Operator precedence (if an operator)

  • Keyboard escape sequences for the symbol

Uses

The scanner and character tables are used inside Mathics. However information can also be used by other programs for tokenizing and formatting Wolfram Language code.

For example, tables are used in mathics-pygments, a Pygments-based lexer and highlighter for Mathematica/Wolfram Language source code.

This library may be useful if you need to work with Wolfram Language named character and convert them to various formats.

Usage

  • For tokenizing and scanning Wolfram Language code, use the mathics_scanner.tokenizer.Tokenizer class.

  • To convert between Wolfram Language named characters and Unicode/ASCII, use the mathics_scanner.characters.replace_wl_with_plain_text and mathics_scanner.characters.replace_unicode_with_wl functions.

  • To convert between qualified names of named characters (such FormalA for \[FormalA]) and Wolfram’s internal representation use the m̀athics_scanner.characters.named_characters dictionary.

To regenerate JSON-format tables run:

$ mathics-generate-json-table

Without options mathics-generate-json-table produces the maximum set of correspondences.

In most applications though you may need just a few of these. The --field option can be used to narrow the list of entries to output in JSON. Run mathics-generate-json-table --help for a full list of fields.

Implementation

For notes on the implementation of the packages or details on the conversion scheme please read Implementation.

Contributing

Please feel encouraged to contribute to this package or Mathics! Create your own fork, make the desired changes, commit, and make a pull request.

License

Mathics is released under the GNU General Public License Version 3 (GPL3).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Mathics_Scanner-1.2.1.tar.gz (84.1 kB view hashes)

Uploaded Source

Built Distributions

Mathics_Scanner-1.2.1-py3.9.egg (76.7 kB view hashes)

Uploaded Source

Mathics_Scanner-1.2.1-py3.8.egg (76.8 kB view hashes)

Uploaded Source

Mathics_Scanner-1.2.1-py3.7.egg (76.7 kB view hashes)

Uploaded Source

Mathics_Scanner-1.2.1-py3.6.egg (77.2 kB view hashes)

Uploaded Source

Mathics_Scanner-1.2.1-py3-none-any.whl (71.6 kB view hashes)

Uploaded Python 3

Mathics_Scanner-1.2.1-py2.py3-none-any.whl (71.6 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page