ucdinfo 0.2__tar.gz

ucdinfo-0.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026, SIL Global (https://www.sil.org)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ucdinfo-0.2/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: ucdinfo
+Version: 0.2
+Summary: Unicode UCD wrapper module
+Author-email: SIL WSTech <fonts@sil.org>
+License-Expression: MIT
+Project-URL: Home-Page, https://github.com/silnrsi/python-ucd
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Text Processing :: Linguistic
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: platformdirs
+Dynamic: license-file
+
+# ucd Module
+
+## Summary
+
+A wrapper module around the Unicode Character Database which dynamically caches the latest data, compresses and gives access to nearly all the UCD data
+
+This module contains most of the ucd information for every character in Unicode.
+
+## Usage
+
+```python
+    from ucdinfo import get_ucd, get_info, find_ucd, get_enums
+    print(get_ucd(0x0041, 'scx'))
+    print(get_info(0x0041))
+    print(get_enums("indic position"))
+    print(find_ucd("indic position", "Bottom")
+```
+
+Note cjk properties are not supported for space reasons.
+
+If you want to use your own data file (perhaps the module data is stale) the use
+the object interface:
+
+```python
+    from ucdinfo import UCD
+    myucd = UCD(localfile="ucd.nounihan.flat.zip")   # localfile falls back to bundled data
+    print(myucd.get(0x0041, 'scx'))
+```
+
+The second parameter specifies the property to be queried and can either be a property from
+https://www.unicode.org/reports/tr42, especially section 4.4 Properties, or the start of a
+full property name from that list.
+
+For characters not yet in Unicode, data for additional characters can
+be temporarily appended to the bundled data:
+
+```python
+    from ucdinfo import get_ucd, loadxml
+    loadxml("extra-ucd.xml")
+```
+
+or, with the object interface:
+
+```python
+    from ucdinfo import UCD
+    myucd = UCD().loadxml("extra-ucd.xml")
+```
+
+The named file must be coded in the same form as the "flat" UCD XML data, though the only
+required character attributes are "cp" and anything needed by the calling process. For example:
+
+```xml
+    <?xml version="1.0" encoding="utf-8" standalone="yes"?>
+    <ucd xmlns="http://www.unicode.org/ns/2003/ucd/1.0">
+        <description>Some additional characters</description>
+        <repertoire>
+            <char cp="10EC2" age="16.0" gc="Lo" bc="AL" na="ARABIC LETTER DAL WITH TWO DOTS VERTICALLY BELOW"></char>
+            <char cp="10EC3" age="16.0" gc="Lo" bc="AL" na="ARABIC LETTER TAH WITH TWO DOTS VERTICALLY BELOW"></char>
+            <char cp="10EC4" age="16.0" gc="Lo" bc="AL" na="ARABIC LETTER KAF WITH TWO DOTS VERTICALLY BELOW"></char>
+        </repertoire>
+    </ucd>
+```
+

ucdinfo-0.2/README.md

@@ -0,0 +1,63 @@
+# ucd Module
+
+## Summary
+
+A wrapper module around the Unicode Character Database which dynamically caches the latest data, compresses and gives access to nearly all the UCD data
+
+This module contains most of the ucd information for every character in Unicode.
+
+## Usage
+
+```python
+    from ucdinfo import get_ucd, get_info, find_ucd, get_enums
+    print(get_ucd(0x0041, 'scx'))
+    print(get_info(0x0041))
+    print(get_enums("indic position"))
+    print(find_ucd("indic position", "Bottom")
+```
+
+Note cjk properties are not supported for space reasons.
+
+If you want to use your own data file (perhaps the module data is stale) the use
+the object interface:
+
+```python
+    from ucdinfo import UCD
+    myucd = UCD(localfile="ucd.nounihan.flat.zip")   # localfile falls back to bundled data
+    print(myucd.get(0x0041, 'scx'))
+```
+
+The second parameter specifies the property to be queried and can either be a property from
+https://www.unicode.org/reports/tr42, especially section 4.4 Properties, or the start of a
+full property name from that list.
+
+For characters not yet in Unicode, data for additional characters can
+be temporarily appended to the bundled data:
+
+```python
+    from ucdinfo import get_ucd, loadxml
+    loadxml("extra-ucd.xml")
+```
+
+or, with the object interface:
+
+```python
+    from ucdinfo import UCD
+    myucd = UCD().loadxml("extra-ucd.xml")
+```
+
+The named file must be coded in the same form as the "flat" UCD XML data, though the only
+required character attributes are "cp" and anything needed by the calling process. For example:
+
+```xml
+    <?xml version="1.0" encoding="utf-8" standalone="yes"?>
+    <ucd xmlns="http://www.unicode.org/ns/2003/ucd/1.0">
+        <description>Some additional characters</description>
+        <repertoire>
+            <char cp="10EC2" age="16.0" gc="Lo" bc="AL" na="ARABIC LETTER DAL WITH TWO DOTS VERTICALLY BELOW"></char>
+            <char cp="10EC3" age="16.0" gc="Lo" bc="AL" na="ARABIC LETTER TAH WITH TWO DOTS VERTICALLY BELOW"></char>
+            <char cp="10EC4" age="16.0" gc="Lo" bc="AL" na="ARABIC LETTER KAF WITH TWO DOTS VERTICALLY BELOW"></char>
+        </repertoire>
+    </ucd>
+```
+

ucdinfo-0.2/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["setuptools>=77.0.3", "wheel", "platformdirs"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ucdinfo"
+version = "0.2"
+authors = [{name = "SIL WSTech", email = "fonts@sil.org"}]
+readme = "README.md"
+license = "MIT"
+description = "Unicode UCD wrapper module"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Topic :: Text Processing :: Linguistic",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+requires-python = ">=3.9"
+#dynamic = ["version"]
+dependencies = ["platformdirs"]
+
+# [project.optional-dependencies]
+# dev = [ ]
+
+[project.urls]
+Home-Page = "https://github.com/silnrsi/python-ucd"
+
+# [tool.setuptools_scm]
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+ucd = ["data/ucdata_v*.pickle.bz2"]
+
+#[tool.setuptools.data-files]
+#"" = ["tests/*.usfm"]
+
+#[tool.setuptools.dynamic]
+#version = {attr = "usfmtc.version"}
+
+#[tool.setuptools]
+#packages = ["usfmtc"]
+
+[tool.bdist_wheel]
+universal = true
+
+[project.scripts]
+ucdinfo = "ucdinfo.ucd:main"

ucdinfo-0.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ucdinfo-0.2/setup.py

@@ -0,0 +1,24 @@
+import os, sys
+from setuptools import setup
+from setuptools.command.build_py import build_py
+
+class build_py_with_data(build_py):
+    def run(self):
+        super().run()
+        pkg_dir = os.path.join(self.build_lib, "ucd", "data")
+        os.makedirs(pkg_dir, exist_ok=True)
+
+        if os.environ.get("UCD_SKIP_FETCH") == "1":
+            self.announce("UCD_SKIP_FETCH=1: shipping wheel without bundled data",
+                          level=2)
+            return
+
+        sys.path.insert(0, self.build_lib)
+        from ucdinfo import UCD
+        out = os.path.join(pkg_dir, UCD._cache_filename())
+        self.announce("Fetching UCD data for wheel...", level=2)
+        UCD.build_from_remote().save(out)
+        self.announce(f"Wrote {out}", level=2)
+
+
+setup(cmdclass={"build_py": build_py_with_data})

ucdinfo-0.2/src/ucdinfo/__init__.py

@@ -0,0 +1,4 @@
+from .ucd import *
+from .ucd import __all__ as ucd_all
+
+__all__ = [*ucd_all]