Utilities and code for exploring Unicode string preparation.
This package contains code for exploring various different strategies for preparing Unicode strings for use as identifiers. There have been various different approaches to this problem over the years, and this code lets you explore them, compare them, and create new ones.
At present, this code focuses only on what characters are allowed, rejected, stripped, etc... by these preparation methods. Some of these preparation methods have further processing on the whole string, including contextual checks which are not yet embodied in this code base.
You can start by running the included command line utility:
> python preputil.py --help Usage: preputil.py (-m | --map) [method] -- map out a method preputil.py (-d | --diff) [method1] [method2] -- compare two methods preputil.py (-l | --list) -- list available methods preputil.py (-h | --help) -- this help text > python preputil.py --list Available methods, and aliases to use on command line: IDNA2008: idna idna2008 idnabis StringPrep: string stringprep UAX31: id uax31 VName: vname > python preputil.py --map idna2008 | less > python preputil.py --diff stringprep uax31 | less
Note that the '--map' and '--diff' modes are computing functions over the entire Unicode code point range, and so take some time to run. On my 2.2Ghz MacBook they take ~17 seconds each!
The processing code is all in the package newprep. See the docstrings in the modules for more extensive notes, caveats, and information on how to use and extend this code.
Main Modules: codepoint - Utilities for handling code points and sets of code points. methods - A list of available preparation methods. UCD - Information and utilities from the Unicode Character Database. prep - Base class for representing a preparation method.
idna2008 - IDNA2008's code point classification stringprep - An RFC 3454 ("StringPrep") style profile uax31 - Unicode's Identifier Syntax vname - A proposed method for use in VWRAP
This code was written by Mark Lentczner at Linden Lab. It was inspired by the newprep BoF session at IETF 77 (Anaheim, 2010) and work needed for both the VWRAP working gorup, and internal Linden Lab development. Discussion of this code and the surrounding issues can be on the newprep mailing list: https://www.ietf.org/mailman/listinfo/newprep or directly with the author.
The code is released open source under an "MIT style" license. See LICENSE.
- Mark Lentczner email@example.com May, 2010