bnc-lookup 1.0.5__tar.gz → 1.0.6__tar.gz

{bnc_lookup-1.0.5 → bnc_lookup-1.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: bnc-lookup
-Version: 1.0.5
+Version: 1.0.6
 Summary: Static Hash-Based Lookup for BNC Terms
 Home-page: https://github.com/craigtrim/bnc-lookup
 License: MIT
@@ -86,8 +86,8 @@ Not "what does it mean?" Not "give me synonyms." Just: is this a word?
 <td align="center"><code>is_bnc_term('asdfgh')</code></td>
 </tr>
 <tr>
-<td align="center"><img src="docs/images/yes-hot-dog.png" width="180"></td>
-<td align="center"><img src="docs/images/not-hot-dog.png" width="180"></td>
+<td align="center"><img src="https://raw.githubusercontent.com/craigtrim/bnc-lookup/master/docs/images/yes-hot-dog.png" width="180"></td>
+<td align="center"><img src="https://raw.githubusercontent.com/craigtrim/bnc-lookup/master/docs/images/not-hot-dog.png" width="180"></td>
 </tr>
 <tr>
 <td align="center"><code>True</code></td>
@@ -123,12 +123,6 @@ If a token passes the BNC test, you can be confident it's a word that real peopl
 
 For detailed usage, performance benchmarks, and advanced features, see the [API Documentation](docs/API.md).
 
-## How It Works
-
-BNC terms are stored as MD5 hash suffixes in 256 `frozenset` buckets (by first two hex characters of the hash). Lookups hash the input, route to the correct bucket, and perform O(1) set membership. Modules are lazy-loaded on first access per bucket.
-
-For the gory details, see [Implementation Notes](docs/IMPLEMENTATION.md).
-
 ## Development
 
 ```bash
@@ -160,6 +154,10 @@ This package contains data derived from the British National Corpus frequency li
 
 **Note:** This is a static snapshot of BNC frequency data. The data is not automatically updated.
 
+## See Also
+
+- **[wordnet-lookup](https://github.com/craigtrim/wordnet-lookup)** - Similar O(1) lookup using the WordNet lexicon
+
 ## Links
 
 - **Repository**: [github.com/craigtrim/bnc-lookup](https://github.com/craigtrim/bnc-lookup)

{bnc_lookup-1.0.5 → bnc_lookup-1.0.6}/README.md

@@ -55,8 +55,8 @@ Not "what does it mean?" Not "give me synonyms." Just: is this a word?
 <td align="center"><code>is_bnc_term('asdfgh')</code></td>
 </tr>
 <tr>
-<td align="center"><img src="docs/images/yes-hot-dog.png" width="180"></td>
-<td align="center"><img src="docs/images/not-hot-dog.png" width="180"></td>
+<td align="center"><img src="https://raw.githubusercontent.com/craigtrim/bnc-lookup/master/docs/images/yes-hot-dog.png" width="180"></td>
+<td align="center"><img src="https://raw.githubusercontent.com/craigtrim/bnc-lookup/master/docs/images/not-hot-dog.png" width="180"></td>
 </tr>
 <tr>
 <td align="center"><code>True</code></td>
@@ -92,12 +92,6 @@ If a token passes the BNC test, you can be confident it's a word that real peopl
 
 For detailed usage, performance benchmarks, and advanced features, see the [API Documentation](docs/API.md).
 
-## How It Works
-
-BNC terms are stored as MD5 hash suffixes in 256 `frozenset` buckets (by first two hex characters of the hash). Lookups hash the input, route to the correct bucket, and perform O(1) set membership. Modules are lazy-loaded on first access per bucket.
-
-For the gory details, see [Implementation Notes](docs/IMPLEMENTATION.md).
-
 ## Development
 
 ```bash
@@ -129,6 +123,10 @@ This package contains data derived from the British National Corpus frequency li
 
 **Note:** This is a static snapshot of BNC frequency data. The data is not automatically updated.
 
+## See Also
+
+- **[wordnet-lookup](https://github.com/craigtrim/wordnet-lookup)** - Similar O(1) lookup using the WordNet lexicon
+
 ## Links
 
 - **Repository**: [github.com/craigtrim/bnc-lookup](https://github.com/craigtrim/bnc-lookup)

{bnc_lookup-1.0.5 → bnc_lookup-1.0.6}/pyproject.toml

@@ -11,7 +11,7 @@ maintainers = [
 description = "Static Hash-Based Lookup for BNC Terms"
 name = "bnc-lookup"
 readme = "README.md"
-version = "1.0.5"
+version = "1.0.6"
 license = "MIT"
 
 keywords = [

bnc_lookup-1.0.6/setup.py

@@ -0,0 +1,26 @@
+# -*- coding: utf-8 -*-
+from setuptools import setup
+
+packages = \
+['bnc_lookup', 'bnc_lookup.hs']
+
+package_data = \
+{'': ['*']}
+
+setup_kwargs = {
+    'name': 'bnc-lookup',
+    'version': '1.0.6',
+    'description': 'Static Hash-Based Lookup for BNC Terms',
+    'long_description': '# BNC Lookup\n\n[![PyPI version](https://img.shields.io/pypi/v/bnc-lookup.svg)](https://pypi.org/project/bnc-lookup/)\n[![PyPI downloads](https://img.shields.io/pypi/dm/bnc-lookup.svg)](https://pypi.org/project/bnc-lookup/)\n[![Python versions](https://img.shields.io/pypi/pyversions/bnc-lookup.svg)](https://pypi.org/project/bnc-lookup/)\n[![License](https://img.shields.io/badge/License-MIT%20%2B%20BNC-yellow.svg)](LICENSE)\n[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)\n[![Pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)\n[![Tests](https://img.shields.io/badge/tests-passing-brightgreen.svg)](https://github.com/craigtrim/bnc-lookup)\n\n**Is this token a word? O(1) answer. No setup. No dependencies.**\n\nA simple question deserves a simple answer. This library gives you instant yes/no validation against 669,000 word forms from the British National Corpus.\n\n## Quick Start\n\n```bash\npip install bnc-lookup\n```\n\n```python\nfrom bnc_lookup import is_bnc_term\n\n# That\'s it. Start validating.\nis_bnc_term(\'the\')          # True\nis_bnc_term(\'however\')      # True\nis_bnc_term(\'nonetheless\')  # True\nis_bnc_term(\'xyzabc123\')    # False\n\n# Handles plurals automatically\nis_bnc_term(\'computers\')    # True\n\n# Case insensitive\nis_bnc_term(\'THE\')          # True\n```\n\n## Features\n\n- **Zero Dependencies** - Pure Python, no external packages\n- **Zero I/O** - No filesystem access, no database queries\n- **Zero Setup** - No corpus downloads or configuration\n- **Microsecond Lookups** - O(1) dictionary access\n- **Smart Plurals** - Automatically checks singular forms\n- **Simple API** - One function does it all\n\n## The Problem This Solves\n\nIn NLP, you frequently need to answer the question: **"Is this token a real word?"**\n\nNot "what does it mean?" Not "give me synonyms." Just: is this a word?\n\n<table>\n<tr>\n<td align="center"><code>is_bnc_term(\'computer\')</code></td>\n<td align="center"><code>is_bnc_term(\'asdfgh\')</code></td>\n</tr>\n<tr>\n<td align="center"><img src="https://raw.githubusercontent.com/craigtrim/bnc-lookup/master/docs/images/yes-hot-dog.png" width="180"></td>\n<td align="center"><img src="https://raw.githubusercontent.com/craigtrim/bnc-lookup/master/docs/images/not-hot-dog.png" width="180"></td>\n</tr>\n<tr>\n<td align="center"><code>True</code></td>\n<td align="center"><code>False</code></td>\n</tr>\n</table>\n\nThat\'s it. O(1) response. No ambiguity.\n\n## Why BNC?\n\nThe British National Corpus isn\'t an academic wordlist (too narrow). It\'s not a web scrape (too noisy). It\'s not slang (too ephemeral).\n\nIt\'s a **100-million-word corpus of real British English** collected from written and spoken sources between 1991-1994. Books, newspapers, academic papers, conversations. The BNC frequency list captures ~669,000 unique word forms actually used by native speakers.\n\nIf a token passes the BNC test, you can be confident it\'s a word that real people actually use.\n\n## When to Use This\n\n- **Tokenization filtering**: Keep real words, discard garbage\n- **Input validation**: Reject nonsense in user input\n- **NLP preprocessing**: Filter candidates before expensive operations\n- **Spell-check pre-filtering**: Quick reject obvious non-words before fuzzy matching\n- **Data cleaning**: Identify malformed or corrupted text\n\n## What This Doesn\'t Do\n\n- No definitions, synonyms, or semantic relationships (use spaCy for that)\n- No frequency counts or rankings (just yes/no)\n- No spell-checking or suggestions (just existence check)\n\n## Documentation\n\nFor detailed usage, performance benchmarks, and advanced features, see the [API Documentation](docs/API.md).\n\n## Development\n\n```bash\ngit clone https://github.com/craigtrim/bnc-lookup.git\ncd bnc-lookup\nmake install  # Install dependencies\nmake test     # Run tests\nmake all      # Full build pipeline\n```\n\nSee [API Documentation](docs/API.md) for detailed development information.\n\n## License\n\nThis package is dual-licensed:\n- **Software**: MIT License\n- **BNC Data**: BNC User Licence\n\nSee [LICENSE](LICENSE) for complete terms.\n\n## Attribution\n\nThis package contains data derived from the British National Corpus frequency lists:\n\n> BNC frequency lists compiled by Adam Kilgarriff.\n> Source: https://www.kilgarriff.co.uk/BNClists/all.num.gz\n>\n> The British National Corpus, version 3 (BNC XML Edition). 2007. Distributed by Bodleian Libraries, University of Oxford, on behalf of the BNC Consortium.\n\n**Note:** This is a static snapshot of BNC frequency data. The data is not automatically updated.\n\n## See Also\n\n- **[wordnet-lookup](https://github.com/craigtrim/wordnet-lookup)** - Similar O(1) lookup using the WordNet lexicon\n\n## Links\n\n- **Repository**: [github.com/craigtrim/bnc-lookup](https://github.com/craigtrim/bnc-lookup)\n- **PyPI**: [pypi.org/project/bnc-lookup](https://pypi.org/project/bnc-lookup)\n- **BNC**: [natcorp.ox.ac.uk](http://www.natcorp.ox.ac.uk)\n- **Author**: Craig Trim ([craigtrim@gmail.com](mailto:craigtrim@gmail.com))\n',
+    'author': 'Craig Trim',
+    'author_email': 'craigtrim@gmail.com',
+    'maintainer': 'Craig Trim',
+    'maintainer_email': 'craigtrim@gmail.com',
+    'url': 'https://github.com/craigtrim/bnc-lookup',
+    'packages': packages,
+    'package_data': package_data,
+    'python_requires': '>=3.7,<4.0',
+}
+
+
+setup(**setup_kwargs)

bnc_lookup-1.0.5/setup.py

@@ -1,26 +0,0 @@
-# -*- coding: utf-8 -*-
-from setuptools import setup
-
-packages = \
-['bnc_lookup', 'bnc_lookup.hs']
-
-package_data = \
-{'': ['*']}
-
-setup_kwargs = {
-    'name': 'bnc-lookup',
-    'version': '1.0.5',
-    'description': 'Static Hash-Based Lookup for BNC Terms',
-    'long_description': '# BNC Lookup\n\n[![PyPI version](https://img.shields.io/pypi/v/bnc-lookup.svg)](https://pypi.org/project/bnc-lookup/)\n[![PyPI downloads](https://img.shields.io/pypi/dm/bnc-lookup.svg)](https://pypi.org/project/bnc-lookup/)\n[![Python versions](https://img.shields.io/pypi/pyversions/bnc-lookup.svg)](https://pypi.org/project/bnc-lookup/)\n[![License](https://img.shields.io/badge/License-MIT%20%2B%20BNC-yellow.svg)](LICENSE)\n[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)\n[![Pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)\n[![Tests](https://img.shields.io/badge/tests-passing-brightgreen.svg)](https://github.com/craigtrim/bnc-lookup)\n\n**Is this token a word? O(1) answer. No setup. No dependencies.**\n\nA simple question deserves a simple answer. This library gives you instant yes/no validation against 669,000 word forms from the British National Corpus.\n\n## Quick Start\n\n```bash\npip install bnc-lookup\n```\n\n```python\nfrom bnc_lookup import is_bnc_term\n\n# That\'s it. Start validating.\nis_bnc_term(\'the\')          # True\nis_bnc_term(\'however\')      # True\nis_bnc_term(\'nonetheless\')  # True\nis_bnc_term(\'xyzabc123\')    # False\n\n# Handles plurals automatically\nis_bnc_term(\'computers\')    # True\n\n# Case insensitive\nis_bnc_term(\'THE\')          # True\n```\n\n## Features\n\n- **Zero Dependencies** - Pure Python, no external packages\n- **Zero I/O** - No filesystem access, no database queries\n- **Zero Setup** - No corpus downloads or configuration\n- **Microsecond Lookups** - O(1) dictionary access\n- **Smart Plurals** - Automatically checks singular forms\n- **Simple API** - One function does it all\n\n## The Problem This Solves\n\nIn NLP, you frequently need to answer the question: **"Is this token a real word?"**\n\nNot "what does it mean?" Not "give me synonyms." Just: is this a word?\n\n<table>\n<tr>\n<td align="center"><code>is_bnc_term(\'computer\')</code></td>\n<td align="center"><code>is_bnc_term(\'asdfgh\')</code></td>\n</tr>\n<tr>\n<td align="center"><img src="docs/images/yes-hot-dog.png" width="180"></td>\n<td align="center"><img src="docs/images/not-hot-dog.png" width="180"></td>\n</tr>\n<tr>\n<td align="center"><code>True</code></td>\n<td align="center"><code>False</code></td>\n</tr>\n</table>\n\nThat\'s it. O(1) response. No ambiguity.\n\n## Why BNC?\n\nThe British National Corpus isn\'t an academic wordlist (too narrow). It\'s not a web scrape (too noisy). It\'s not slang (too ephemeral).\n\nIt\'s a **100-million-word corpus of real British English** collected from written and spoken sources between 1991-1994. Books, newspapers, academic papers, conversations. The BNC frequency list captures ~669,000 unique word forms actually used by native speakers.\n\nIf a token passes the BNC test, you can be confident it\'s a word that real people actually use.\n\n## When to Use This\n\n- **Tokenization filtering**: Keep real words, discard garbage\n- **Input validation**: Reject nonsense in user input\n- **NLP preprocessing**: Filter candidates before expensive operations\n- **Spell-check pre-filtering**: Quick reject obvious non-words before fuzzy matching\n- **Data cleaning**: Identify malformed or corrupted text\n\n## What This Doesn\'t Do\n\n- No definitions, synonyms, or semantic relationships (use spaCy for that)\n- No frequency counts or rankings (just yes/no)\n- No spell-checking or suggestions (just existence check)\n\n## Documentation\n\nFor detailed usage, performance benchmarks, and advanced features, see the [API Documentation](docs/API.md).\n\n## How It Works\n\nBNC terms are stored as MD5 hash suffixes in 256 `frozenset` buckets (by first two hex characters of the hash). Lookups hash the input, route to the correct bucket, and perform O(1) set membership. Modules are lazy-loaded on first access per bucket.\n\nFor the gory details, see [Implementation Notes](docs/IMPLEMENTATION.md).\n\n## Development\n\n```bash\ngit clone https://github.com/craigtrim/bnc-lookup.git\ncd bnc-lookup\nmake install  # Install dependencies\nmake test     # Run tests\nmake all      # Full build pipeline\n```\n\nSee [API Documentation](docs/API.md) for detailed development information.\n\n## License\n\nThis package is dual-licensed:\n- **Software**: MIT License\n- **BNC Data**: BNC User Licence\n\nSee [LICENSE](LICENSE) for complete terms.\n\n## Attribution\n\nThis package contains data derived from the British National Corpus frequency lists:\n\n> BNC frequency lists compiled by Adam Kilgarriff.\n> Source: https://www.kilgarriff.co.uk/BNClists/all.num.gz\n>\n> The British National Corpus, version 3 (BNC XML Edition). 2007. Distributed by Bodleian Libraries, University of Oxford, on behalf of the BNC Consortium.\n\n**Note:** This is a static snapshot of BNC frequency data. The data is not automatically updated.\n\n## Links\n\n- **Repository**: [github.com/craigtrim/bnc-lookup](https://github.com/craigtrim/bnc-lookup)\n- **PyPI**: [pypi.org/project/bnc-lookup](https://pypi.org/project/bnc-lookup)\n- **BNC**: [natcorp.ox.ac.uk](http://www.natcorp.ox.ac.uk)\n- **Author**: Craig Trim ([craigtrim@gmail.com](mailto:craigtrim@gmail.com))\n',
-    'author': 'Craig Trim',
-    'author_email': 'craigtrim@gmail.com',
-    'maintainer': 'Craig Trim',
-    'maintainer_email': 'craigtrim@gmail.com',
-    'url': 'https://github.com/craigtrim/bnc-lookup',
-    'packages': packages,
-    'package_data': package_data,
-    'python_requires': '>=3.7,<4.0',
-}
-
-
-setup(**setup_kwargs)