glazing 0.0.1__tar.gz

glazing-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Aaron Steven White
+
+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.

glazing-0.0.1/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: glazing
+Version: 0.0.1
+Summary: A unified interface for FrameNet, PropBank, VerbNet, and WordNet
+Author-email: Aaron Steven White <aaron.white@rochester.edu>
+License: MIT
+Project-URL: Homepage, https://github.com/aaronstevenwhite/glazing
+Project-URL: Bug Reports, https://github.com/aaronstevenwhite/glazing/issues
+Project-URL: Source, https://github.com/aaronstevenwhite/glazing
+Project-URL: Documentation, https://glazing.readthedocs.io
+Keywords: nlp,linguistics,framenet,propbank,verbnet,wordnet,semantics,lexicon
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Text Processing :: Linguistic
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: typing-extensions>=4.9.0
+Requires-Dist: python-dateutil>=2.8.2
+Provides-Extra: dev
+Requires-Dist: ruff>=0.1.9; extra == "dev"
+Requires-Dist: mypy>=1.8.0; extra == "dev"
+Requires-Dist: pytest>=7.4.3; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.1; extra == "dev"
+Requires-Dist: pre-commit>=3.6.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.5.3; extra == "docs"
+Requires-Dist: mkdocs-material>=9.5.3; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.24.0; extra == "docs"
+Provides-Extra: xml
+Requires-Dist: lxml>=5.0.0; extra == "xml"
+Dynamic: license-file
+
+# glazing
+
+A Python package providing unified data models and interfaces for four linguistic resources: FrameNet, PropBank, VerbNet, and WordNet.
+
+## Features
+
+- Type-safe data models using Pydantic v2 for validation
+- Support for FrameNet 1.7 semantic frames and annotations
+- PropBank roleset and argument structure models
+- VerbNet verb classes with thematic role inheritance
+- WordNet 3.1 synsets and lexical relations
+- Cross-dataset reference resolution and mapping
+- Python 3.13+ with comprehensive type hints
+
+## Installation
+
+```bash
+pip install glazing
+```
+
+For development installation:
+
+```bash
+git clone https://github.com/aaronstevenwhite/glazing.git
+cd glazing
+pip install -e ".[dev]"
+```
+
+## Basic Usage
+
+```python
+from glazing import FrameNet, PropBank, VerbNet, WordNet
+
+# Load datasets from JSON Lines
+fn = FrameNet.load("data/framenet.jsonl")
+pb = PropBank.load("data/propbank.jsonl")
+vn = VerbNet.load("data/verbnet.jsonl")
+wn = WordNet.load("data/wordnet.jsonl")
+
+# Query by lemma
+abandon_frames = fn.get_frames_by_lemma("abandon")
+abandon_rolesets = pb.get_rolesets_by_lemma("abandon")
+abandon_classes = vn.get_classes_by_lemma("abandon")
+abandon_synsets = wn.get_synsets_by_lemma("abandon", pos="v")
+```
+
+## Data Formats
+
+The package uses JSON Lines as the primary data format. Original XML and database formats are converted to JSON Lines during data preparation, enabling efficient lazy loading of large datasets.
+
+### Data Conversion
+
+Convert source data to JSON Lines format:
+
+```python
+from glazing.converters import convert_framenet, convert_propbank, convert_verbnet, convert_wordnet
+
+# Convert from original formats
+convert_framenet("framenet_v17/", "data/framenet.jsonl")
+convert_propbank("propbank-frames/", "data/propbank.jsonl")
+convert_verbnet("verbnet/", "data/verbnet.jsonl")
+convert_wordnet("wn3.1/", "data/wordnet.jsonl")
+```
+
+## Cross-References
+
+The package maintains cross-references between datasets:
+
+```python
+from glazing.references import CrossRef
+
+xref = CrossRef(fn, pb, vn, wn)
+
+# Get related entries across datasets
+related = xref.get_related("give.01", source="propbank")
+print(related.verbnet_classes)  # ['give-13.1']
+print(related.framenet_frames)  # ['Giving']
+print(related.wordnet_senses)   # ['give%2:40:00', 'give%2:40:01']
+```
+
+## Requirements
+
+- Python 3.13+
+- pydantic >= 2.5.0
+- typing-extensions >= 4.9.0
+- python-dateutil >= 2.8.2
+
+## Documentation
+
+Full documentation is available at [https://glazing.readthedocs.io](https://glazing.readthedocs.io)
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Citation
+
+If you use this package in your research, please cite:
+
+```bibtex
+@software{glazing2025,
+  author = {White, Aaron Steven},
+  title = {glazing: A Unified Interface for FrameNet, PropBank, VerbNet, and WordNet},
+  year = {2025},
+  url = {https://github.com/aaronstevenwhite/glazing}
+}
+```
+
+## Contributing
+
+Contributions are welcome. Please ensure all tests pass and code follows the project's style guidelines:
+
+```bash
+# Run tests
+pytest
+
+# Check code style
+ruff check src/ tests/
+
+# Type checking
+mypy src/
+```
+
+## Data Sources
+
+This package provides models for data from:
+
+- [FrameNet](https://framenet.icsi.berkeley.edu/)
+- [PropBank](https://propbank.github.io/)
+- [VerbNet](https://verbs.colorado.edu/verbnet/)
+- [WordNet](https://wordnet.princeton.edu/)

glazing-0.0.1/README.md

@@ -0,0 +1,131 @@
+# glazing
+
+A Python package providing unified data models and interfaces for four linguistic resources: FrameNet, PropBank, VerbNet, and WordNet.
+
+## Features
+
+- Type-safe data models using Pydantic v2 for validation
+- Support for FrameNet 1.7 semantic frames and annotations
+- PropBank roleset and argument structure models
+- VerbNet verb classes with thematic role inheritance
+- WordNet 3.1 synsets and lexical relations
+- Cross-dataset reference resolution and mapping
+- Python 3.13+ with comprehensive type hints
+
+## Installation
+
+```bash
+pip install glazing
+```
+
+For development installation:
+
+```bash
+git clone https://github.com/aaronstevenwhite/glazing.git
+cd glazing
+pip install -e ".[dev]"
+```
+
+## Basic Usage
+
+```python
+from glazing import FrameNet, PropBank, VerbNet, WordNet
+
+# Load datasets from JSON Lines
+fn = FrameNet.load("data/framenet.jsonl")
+pb = PropBank.load("data/propbank.jsonl")
+vn = VerbNet.load("data/verbnet.jsonl")
+wn = WordNet.load("data/wordnet.jsonl")
+
+# Query by lemma
+abandon_frames = fn.get_frames_by_lemma("abandon")
+abandon_rolesets = pb.get_rolesets_by_lemma("abandon")
+abandon_classes = vn.get_classes_by_lemma("abandon")
+abandon_synsets = wn.get_synsets_by_lemma("abandon", pos="v")
+```
+
+## Data Formats
+
+The package uses JSON Lines as the primary data format. Original XML and database formats are converted to JSON Lines during data preparation, enabling efficient lazy loading of large datasets.
+
+### Data Conversion
+
+Convert source data to JSON Lines format:
+
+```python
+from glazing.converters import convert_framenet, convert_propbank, convert_verbnet, convert_wordnet
+
+# Convert from original formats
+convert_framenet("framenet_v17/", "data/framenet.jsonl")
+convert_propbank("propbank-frames/", "data/propbank.jsonl")
+convert_verbnet("verbnet/", "data/verbnet.jsonl")
+convert_wordnet("wn3.1/", "data/wordnet.jsonl")
+```
+
+## Cross-References
+
+The package maintains cross-references between datasets:
+
+```python
+from glazing.references import CrossRef
+
+xref = CrossRef(fn, pb, vn, wn)
+
+# Get related entries across datasets
+related = xref.get_related("give.01", source="propbank")
+print(related.verbnet_classes)  # ['give-13.1']
+print(related.framenet_frames)  # ['Giving']
+print(related.wordnet_senses)   # ['give%2:40:00', 'give%2:40:01']
+```
+
+## Requirements
+
+- Python 3.13+
+- pydantic >= 2.5.0
+- typing-extensions >= 4.9.0
+- python-dateutil >= 2.8.2
+
+## Documentation
+
+Full documentation is available at [https://glazing.readthedocs.io](https://glazing.readthedocs.io)
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Citation
+
+If you use this package in your research, please cite:
+
+```bibtex
+@software{glazing2025,
+  author = {White, Aaron Steven},
+  title = {glazing: A Unified Interface for FrameNet, PropBank, VerbNet, and WordNet},
+  year = {2025},
+  url = {https://github.com/aaronstevenwhite/glazing}
+}
+```
+
+## Contributing
+
+Contributions are welcome. Please ensure all tests pass and code follows the project's style guidelines:
+
+```bash
+# Run tests
+pytest
+
+# Check code style
+ruff check src/ tests/
+
+# Type checking
+mypy src/
+```
+
+## Data Sources
+
+This package provides models for data from:
+
+- [FrameNet](https://framenet.icsi.berkeley.edu/)
+- [PropBank](https://propbank.github.io/)
+- [VerbNet](https://verbs.colorado.edu/verbnet/)
+- [WordNet](https://wordnet.princeton.edu/)

glazing-0.0.1/pyproject.toml

@@ -0,0 +1,161 @@
+[build-system]
+requires = ["setuptools>=68.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "glazing"
+version = "0.0.1"
+description = "A unified interface for FrameNet, PropBank, VerbNet, and WordNet"
+readme = "README.md"
+requires-python = ">=3.13"
+license = {text = "MIT"}
+authors = [
+    {name = "Aaron Steven White", email = "aaron.white@rochester.edu"}
+]
+keywords = ["nlp", "linguistics", "framenet", "propbank", "verbnet", "wordnet", "semantics", "lexicon"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Text Processing :: Linguistic",
+    "Typing :: Typed",
+]
+
+dependencies = [
+    "pydantic>=2.5.0",
+    "typing-extensions>=4.9.0",
+    "python-dateutil>=2.8.2",
+]
+
+[project.optional-dependencies]
+dev = [
+    "ruff>=0.1.9",
+    "mypy>=1.8.0",
+    "pytest>=7.4.3",
+    "pytest-cov>=4.1.0",
+    "pytest-asyncio>=0.21.1",
+    "pre-commit>=3.6.0",
+]
+docs = [
+    "mkdocs>=1.5.3",
+    "mkdocs-material>=9.5.3",
+    "mkdocstrings[python]>=0.24.0",
+]
+xml = [
+    "lxml>=5.0.0",  # For XML parsing if needed
+]
+
+[project.urls]
+"Homepage" = "https://github.com/aaronstevenwhite/glazing"
+"Bug Reports" = "https://github.com/aaronstevenwhite/glazing/issues"
+"Source" = "https://github.com/aaronstevenwhite/glazing"
+"Documentation" = "https://glazing.readthedocs.io"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+    "E",    # pycodestyle errors
+    "W",    # pycodestyle warnings
+    "F",    # pyflakes
+    "I",    # isort
+    "B",    # flake8-bugbear
+    "C90",  # mccabe
+    "N",    # pep8-naming
+    "UP",   # pyupgrade
+    "YTT",  # flake8-2020
+    "ANN",  # flake8-annotations
+    "S",    # flake8-bandit
+    "BLE",  # flake8-blind-except
+    "FBT",  # flake8-boolean-trap
+    "A",    # flake8-builtins
+    "C4",   # flake8-comprehensions
+    "DTZ",  # flake8-datetimez
+    "EM",   # flake8-errmsg
+    "ISC",  # flake8-implicit-str-concat
+    "ICN",  # flake8-import-conventions
+    "G",    # flake8-logging-format
+    "PIE",  # flake8-pie
+    "PT",   # flake8-pytest-style
+    "Q",    # flake8-quotes
+    "RET",  # flake8-return
+    "SIM",  # flake8-simplify
+    "TID",  # flake8-tidy-imports
+    "ARG",  # flake8-unused-arguments
+    "PTH",  # flake8-use-pathlib
+    "ERA",  # eradicate
+    "PD",   # pandas-vet
+    "PGH",  # pygrep-hooks
+    "PL",   # pylint
+    "TRY",  # tryceratops
+    "RUF",  # ruff-specific rules
+]
+ignore = [
+    "ANN101",  # Missing type annotation for self
+    "ANN102",  # Missing type annotation for cls
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["S101", "ANN", "ARG"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "numpy"
+
+[tool.mypy]
+python_version = "3.13"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_any_unimported = true
+no_implicit_optional = true
+check_untyped_defs = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+follow_imports = "normal"
+namespace_packages = true
+show_error_codes = true
+pretty = true
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+ignore_errors = true
+
+[tool.pytest.ini_options]
+minversion = "7.0"
+testpaths = ["tests"]
+python_files = ["test_*.py", "*_test.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = [
+    "--strict-markers",
+    "--tb=short",
+    "--cov=glazing",
+    "--cov-report=term-missing",
+    "--cov-report=html",
+    "--cov-report=xml",
+]
+
+[tool.coverage.run]
+source = ["src/glazing"]
+omit = ["*/tests/*", "*/test_*.py"]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "if __name__ == .__main__.:",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if TYPE_CHECKING:",
+]

glazing-0.0.1/setup.cfg

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

glazing-0.0.1/src/glazing/__init__.py

@@ -0,0 +1,34 @@
+"""Unified interface for FrameNet, PropBank, VerbNet, and WordNet linguistic resources.
+
+This package provides type-safe data models and utilities for working with
+four major linguistic resources. All models use Pydantic v2 for validation
+and support JSON Lines serialization.
+
+Modules
+-------
+framenet
+    Models and utilities for FrameNet semantic frames.
+propbank
+    Models and utilities for PropBank rolesets.
+verbnet
+    Models and utilities for VerbNet verb classes.
+wordnet
+    Models and utilities for WordNet synsets and relations.
+references
+    Cross-reference resolution between datasets.
+utils
+    Shared utilities and helper functions.
+
+Examples
+--------
+>>> from frames import FrameNet, PropBank, VerbNet, WordNet
+>>> fn = FrameNet.load("data/framenet.jsonl")
+>>> frames = fn.get_frames_by_lemma("give")
+"""
+
+from frames.__version__ import __version__, __version_info__
+
+__all__ = [
+    "__version__",
+    "__version_info__",
+]

glazing-0.0.1/src/glazing/__version__.py

@@ -0,0 +1,4 @@
+"""Version information for the glazing package."""
+
+__version__ = "0.0.1"
+__version_info__ = tuple(int(i) for i in __version__.split("."))

glazing-0.0.1/src/glazing/framenet/__init__.py

@@ -0,0 +1,31 @@
+"""FrameNet data models and utilities.
+
+This module provides models for FrameNet semantic frames, frame elements,
+lexical units, and their relationships. It supports the complete FrameNet
+annotation model including multi-layer annotations and valence patterns.
+
+Classes
+-------
+Frame
+    A semantic frame representing a schematic situation.
+FrameElement
+    A participant or prop in a frame.
+LexicalUnit
+    A word or phrase that evokes a frame.
+FrameRelation
+    Relationships between frames.
+
+Functions
+---------
+load
+    Load FrameNet data from JSON Lines.
+
+Examples
+--------
+>>> from frames.framenet import load
+>>> fn = load("data/framenet.jsonl")
+>>> frame = fn.get_frame("Giving")
+>>> print(frame.definition)
+"""
+
+__all__: list[str] = []

glazing-0.0.1/src/glazing/propbank/__init__.py

@@ -0,0 +1,31 @@
+"""PropBank data models and utilities.
+
+This module provides models for PropBank framesets, rolesets, semantic roles,
+and their mappings to other resources. It includes support for argument
+structure and lexical links with confidence scores.
+
+Classes
+-------
+Frameset
+    Container for all senses of a predicate.
+Roleset
+    A single sense of a predicate with its semantic roles.
+Role
+    Semantic role definition with argument number and description.
+RoleLink
+    Link from a role to VerbNet or FrameNet.
+
+Functions
+---------
+load
+    Load PropBank data from JSON Lines.
+
+Examples
+--------
+>>> from frames.propbank import load
+>>> pb = load("data/propbank.jsonl")
+>>> roleset = pb.get_roleset("give.01")
+>>> print(roleset.roles)
+"""
+
+__all__: list[str] = []

glazing-0.0.1/src/glazing/references/__init__.py

@@ -0,0 +1,30 @@
+"""Cross-reference models and resolution utilities.
+
+This module provides models and utilities for managing cross-references
+between FrameNet, PropBank, VerbNet, and WordNet. It includes confidence
+scoring, transitive mapping resolution, and conflict detection.
+
+Classes
+-------
+CrossReference
+    A mapping between entities in different datasets.
+MappingConfidence
+    Confidence scoring for mappings.
+UnifiedLemma
+    A lemma with representations across all datasets.
+MappingIndex
+    Bidirectional index for fast mapping lookups.
+
+Functions
+---------
+resolve_references
+    Resolve cross-references between datasets.
+
+Examples
+--------
+>>> from frames.references import CrossRef
+>>> xref = CrossRef(fn, pb, vn, wn)
+>>> mappings = xref.get_mappings("give", source="verbnet")
+"""
+
+__all__: list[str] = []

glazing-0.0.1/src/glazing/utils/__init__.py

@@ -0,0 +1,29 @@
+"""Shared utilities and helper functions.
+
+This module provides common utilities used across the package including
+XML parsing, validation, caching, and data conversion helpers.
+
+Functions
+---------
+parse_xml
+    Parse XML with namespace handling.
+validate_schema
+    Validate data against XSD or DTD schemas.
+create_cache
+    Create an LRU cache for query results.
+
+Classes
+-------
+LazyLoader
+    Lazy loading for large datasets.
+DataCache
+    Caching layer for frequently accessed data.
+
+Examples
+--------
+>>> from frames.utils import LazyLoader
+>>> loader = LazyLoader("data/large_dataset.json")
+>>> item = loader.get_item(123)  # Loads on demand
+"""
+
+__all__: list[str] = []

glazing-0.0.1/src/glazing/verbnet/__init__.py

@@ -0,0 +1,31 @@
+"""VerbNet data models and utilities.
+
+This module provides models for VerbNet verb classes, thematic roles,
+syntactic frames, and semantic predicates. It includes support for the
+complete role inheritance hierarchy and optional Generative Lexicon features.
+
+Classes
+-------
+VerbClass
+    A verb class with members, roles, and frames.
+Member
+    Individual verb with cross-references.
+ThematicRole
+    Semantic role with selectional restrictions.
+VNFrame
+    Syntactic-semantic frame pattern.
+
+Functions
+---------
+load
+    Load VerbNet data from JSON Lines.
+
+Examples
+--------
+>>> from frames.verbnet import load
+>>> vn = load("data/verbnet.json")
+>>> verb_class = vn.get_class("give-13.1")
+>>> print(verb_class.themroles)
+"""
+
+__all__: list[str] = []

glazing-0.0.1/src/glazing/wordnet/__init__.py

@@ -0,0 +1,31 @@
+"""WordNet data models and utilities.
+
+This module provides models for WordNet synsets, word senses, lexical and
+semantic relations. It supports the complete WordNet 3.1 database structure
+including morphological processing and relation traversal.
+
+Classes
+-------
+Synset
+    A set of cognitive synonyms representing a concept.
+Word
+    A lemma within a synset.
+Sense
+    A word-meaning pair with sense key.
+Pointer
+    A relation to another synset or word.
+
+Functions
+---------
+load
+    Load WordNet data from JSON Lines.
+
+Examples
+--------
+>>> from frames.wordnet import load
+>>> wn = load("data/wordnet.json")
+>>> synset = wn.get_synset("02084442")  # dog.n.01
+>>> print(synset.gloss)
+"""
+
+__all__: list[str] = []

glazing-0.0.1/src/glazing.egg-info/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: glazing
+Version: 0.0.1
+Summary: A unified interface for FrameNet, PropBank, VerbNet, and WordNet
+Author-email: Aaron Steven White <aaron.white@rochester.edu>
+License: MIT
+Project-URL: Homepage, https://github.com/aaronstevenwhite/glazing
+Project-URL: Bug Reports, https://github.com/aaronstevenwhite/glazing/issues
+Project-URL: Source, https://github.com/aaronstevenwhite/glazing
+Project-URL: Documentation, https://glazing.readthedocs.io
+Keywords: nlp,linguistics,framenet,propbank,verbnet,wordnet,semantics,lexicon
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Text Processing :: Linguistic
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: typing-extensions>=4.9.0
+Requires-Dist: python-dateutil>=2.8.2
+Provides-Extra: dev
+Requires-Dist: ruff>=0.1.9; extra == "dev"
+Requires-Dist: mypy>=1.8.0; extra == "dev"
+Requires-Dist: pytest>=7.4.3; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.1; extra == "dev"
+Requires-Dist: pre-commit>=3.6.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.5.3; extra == "docs"
+Requires-Dist: mkdocs-material>=9.5.3; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.24.0; extra == "docs"
+Provides-Extra: xml
+Requires-Dist: lxml>=5.0.0; extra == "xml"
+Dynamic: license-file
+
+# glazing
+
+A Python package providing unified data models and interfaces for four linguistic resources: FrameNet, PropBank, VerbNet, and WordNet.
+
+## Features
+
+- Type-safe data models using Pydantic v2 for validation
+- Support for FrameNet 1.7 semantic frames and annotations
+- PropBank roleset and argument structure models
+- VerbNet verb classes with thematic role inheritance
+- WordNet 3.1 synsets and lexical relations
+- Cross-dataset reference resolution and mapping
+- Python 3.13+ with comprehensive type hints
+
+## Installation
+
+```bash
+pip install glazing
+```
+
+For development installation:
+
+```bash
+git clone https://github.com/aaronstevenwhite/glazing.git
+cd glazing
+pip install -e ".[dev]"
+```
+
+## Basic Usage
+
+```python
+from glazing import FrameNet, PropBank, VerbNet, WordNet
+
+# Load datasets from JSON Lines
+fn = FrameNet.load("data/framenet.jsonl")
+pb = PropBank.load("data/propbank.jsonl")
+vn = VerbNet.load("data/verbnet.jsonl")
+wn = WordNet.load("data/wordnet.jsonl")
+
+# Query by lemma
+abandon_frames = fn.get_frames_by_lemma("abandon")
+abandon_rolesets = pb.get_rolesets_by_lemma("abandon")
+abandon_classes = vn.get_classes_by_lemma("abandon")
+abandon_synsets = wn.get_synsets_by_lemma("abandon", pos="v")
+```
+
+## Data Formats
+
+The package uses JSON Lines as the primary data format. Original XML and database formats are converted to JSON Lines during data preparation, enabling efficient lazy loading of large datasets.
+
+### Data Conversion
+
+Convert source data to JSON Lines format:
+
+```python
+from glazing.converters import convert_framenet, convert_propbank, convert_verbnet, convert_wordnet
+
+# Convert from original formats
+convert_framenet("framenet_v17/", "data/framenet.jsonl")
+convert_propbank("propbank-frames/", "data/propbank.jsonl")
+convert_verbnet("verbnet/", "data/verbnet.jsonl")
+convert_wordnet("wn3.1/", "data/wordnet.jsonl")
+```
+
+## Cross-References
+
+The package maintains cross-references between datasets:
+
+```python
+from glazing.references import CrossRef
+
+xref = CrossRef(fn, pb, vn, wn)
+
+# Get related entries across datasets
+related = xref.get_related("give.01", source="propbank")
+print(related.verbnet_classes)  # ['give-13.1']
+print(related.framenet_frames)  # ['Giving']
+print(related.wordnet_senses)   # ['give%2:40:00', 'give%2:40:01']
+```
+
+## Requirements
+
+- Python 3.13+
+- pydantic >= 2.5.0
+- typing-extensions >= 4.9.0
+- python-dateutil >= 2.8.2
+
+## Documentation
+
+Full documentation is available at [https://glazing.readthedocs.io](https://glazing.readthedocs.io)
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Citation
+
+If you use this package in your research, please cite:
+
+```bibtex
+@software{glazing2025,
+  author = {White, Aaron Steven},
+  title = {glazing: A Unified Interface for FrameNet, PropBank, VerbNet, and WordNet},
+  year = {2025},
+  url = {https://github.com/aaronstevenwhite/glazing}
+}
+```
+
+## Contributing
+
+Contributions are welcome. Please ensure all tests pass and code follows the project's style guidelines:
+
+```bash
+# Run tests
+pytest
+
+# Check code style
+ruff check src/ tests/
+
+# Type checking
+mypy src/
+```
+
+## Data Sources
+
+This package provides models for data from:
+
+- [FrameNet](https://framenet.icsi.berkeley.edu/)
+- [PropBank](https://propbank.github.io/)
+- [VerbNet](https://verbs.colorado.edu/verbnet/)
+- [WordNet](https://wordnet.princeton.edu/)

glazing-0.0.1/src/glazing.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+pyproject.toml
+src/glazing/__init__.py
+src/glazing/__version__.py
+src/glazing.egg-info/PKG-INFO
+src/glazing.egg-info/SOURCES.txt
+src/glazing.egg-info/dependency_links.txt
+src/glazing.egg-info/requires.txt
+src/glazing.egg-info/top_level.txt
+src/glazing/framenet/__init__.py
+src/glazing/propbank/__init__.py
+src/glazing/references/__init__.py
+src/glazing/utils/__init__.py
+src/glazing/verbnet/__init__.py
+src/glazing/wordnet/__init__.py

glazing-0.0.1/src/glazing.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

glazing-0.0.1/src/glazing.egg-info/requires.txt

@@ -0,0 +1,19 @@
+pydantic>=2.5.0
+typing-extensions>=4.9.0
+python-dateutil>=2.8.2
+
+[dev]
+ruff>=0.1.9
+mypy>=1.8.0
+pytest>=7.4.3
+pytest-cov>=4.1.0
+pytest-asyncio>=0.21.1
+pre-commit>=3.6.0
+
+[docs]
+mkdocs>=1.5.3
+mkdocs-material>=9.5.3
+mkdocstrings[python]>=0.24.0
+
+[xml]
+lxml>=5.0.0

glazing-0.0.1/src/glazing.egg-info/top_level.txt

@@ -0,0 +1 @@
+glazing