Python bindings for ICU4C
Project description
icupy
Python bindings for ICU4C.
Installation
Prerequisites
Building from source
-
Configuring environment variables:
Windows:
- Set the
ICU_ROOT
environment variable to the root of the ICU installation. (default isC:\icu
)
Linux/POSIX:
- If the ICU is located in a non-regular place, set the
PKG_CONFIG_PATH
andLD_LIBRARY_PATH
environment variables.
- Set the
-
Installing from PyPI:
pip install icupy
Alternatively, installing from the git repository:
pip install git+https://github.com/miute/icupy.git
Optionally, the CMake environment variables are available. For example, using the Ninja build system:
CMAKE_GENERATOR=Ninja pip install icupy
Changes
- Naming Rules
- Renamed C functions and C++ class methods from mixed case to snake case. (e.g.,
findAndReplace()
→find_and_replace()
) - Renamed C++ enumerators to upper snake case without "k" prefix. (e.g.,
kDateOffset
→DATE_OFFSET
)
- Renamed C functions and C++ class methods from mixed case to snake case. (e.g.,
Examples
-
icu::UnicodeString with error callback
>>> import icupy as icu >>> cnv = icu.ucnv_open("utf-8") >>> action = icu.UCNV_TO_U_CALLBACK_ESCAPE >>> context = icu.ConstVoidPtr(icu.UCNV_ESCAPE_C) >>> icu.ucnv_set_to_u_call_back(cnv, action, context) >>> utf8 = b"\x61\xfe\x62" # Impossible bytes >>> s = icu.UnicodeString(utf8, -1, cnv) >>> str(s) 'a\\xFEb'
-
icu::IDNA (UTS #46)
>>> import icupy as icu >>> uts46 = icu.IDNA.create_uts46_instance(icu.UIDNA_NONTRANSITIONAL_TO_ASCII) >>> dest = icu.UnicodeString() >>> info = icu.IDNAInfo() >>> uts46.name_to_ascii(icu.UnicodeString("faß.ExAmPlE"), dest, info) UnicodeString("xn--fa-hia.example") >>> str(dest) 'xn--fa-hia.example'
-
See also tests directory.
License
This project is licensed under the MIT License.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
icupy-0.10.0.tar.gz
(443.0 kB
view hashes)