{"id":34095122,"url":"https://github.com/willwillis/bennie","last_synced_at":"2026-04-10T10:32:34.508Z","repository":{"id":307406949,"uuid":"1029423332","full_name":"willwillis/Bennie","owner":"willwillis","description":"The dangling preposition detector","archived":false,"fork":false,"pushed_at":"2025-11-18T22:52:13.000Z","size":226,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-03T06:12:04.671Z","etag":null,"topics":["english-language","pypi-package","python"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/bennie/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/willwillis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-31T03:15:18.000Z","updated_at":"2025-11-18T22:52:17.000Z","dependencies_parsed_at":"2025-07-31T05:11:23.580Z","dependency_job_id":"8c94b951-d8bf-46e5-a59a-f9dec24e3679","html_url":"https://github.com/willwillis/Bennie","commit_stats":null,"previous_names":["willwillis/bennie"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/willwillis/Bennie","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willwillis%2FBennie","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willwillis%2FBennie/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willwillis%2FBennie/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willwillis%2FBennie/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/willwillis","download_url":"https://codeload.github.com/willwillis/Bennie/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willwillis%2FBennie/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31638464,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T07:40:12.752Z","status":"ssl_error","status_checked_at":"2026-04-10T07:40:11.664Z","response_time":98,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["english-language","pypi-package","python"],"created_at":"2025-12-14T15:08:20.539Z","updated_at":"2026-04-10T10:32:34.487Z","avatar_url":"https://github.com/willwillis.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bennie\n\n*A Python module for detecting dangling prepositions and other grammatical constructs that your English teacher warned you about.*\n\n## Motivation\n\nThis module is dedicated to my mom, an English teacher of 30 years, who would always catch me when I'd end a sentence with a preposition. Bennie helps you identify these constructions - not to judge, but to give you the tools to make informed decisions about what you want to end your sentences with.\n\n## What is it?\n\nBennie is a modular Python package designed to detect various \"dangling\" grammatical elements in English text. Currently, it focuses on dangling prepositions, but it's built to expand to other constructs like dangling participles and modifiers.\n\n**Note:** We don't judge here! Sometimes ending with a preposition is perfectly fine and more natural. This tool simply helps you identify these patterns so you can decide what to do about them.\n\n## Installation\n\n```bash\n# Install from PyPI\npip install bennie\n\n# Install the required spaCy language model\npython -m spacy download en_core_web_sm\n```\n\n**Development Installation:**\n```bash\n# Clone the repository\ngit clone https://github.com/willwillis/bennie.git\ncd bennie\n\n# Install with uv (recommended)\nuv sync\n\n# Or install with pip\npip install -e .\n\n# Install the spaCy model\npython -m spacy download en_core_web_sm\n```\n\n## Quick Start\n\n```python\nfrom bennie import find_dangling_prepositions\n\n# Test some sentences (with intentional dangling prepositions for irony)\ntext = \"What are you looking at?\"\nfound, sentences = find_dangling_prepositions(text)\n\nif found:\n    print(\"Found dangling prepositions in:\")\n    for sentence in sentences:\n        print(f\"  - {sentence}\")\n```\n\n## Examples\n\nHere are some examples of what Bennie can help you identify:\n\n```python\nfrom bennie import find_dangling_prepositions\n\ntest_cases = [\n    \"What are you looking at?\",           # ✓ Dangling preposition detected\n    \"This is what I was talking about.\",  # ✓ Dangling preposition detected  \n    \"Where did you come from?\",           # ✓ Dangling preposition detected\n    \"She gave the book to him.\",          # ✗ No dangling preposition\n    \"The house that Jack built.\",         # ✗ No dangling preposition\n]\n\nfor text in test_cases:\n    found, _ = find_dangling_prepositions(text)\n    status = \"🔍 Found\" if found else \"✅ Clean\"\n    print(f\"{status}: {text}\")\n```\n\n## Testing\n\nRun the test suite to see Bennie in action. This assumes you ran the 'Development Installation' above.\n\n```bash\nuv run python run_tests.py\n```\n\n## Architecture\n\nBennie is designed with modularity in mind, making it easy to add new detectors for different grammatical constructs:\n\n```\nbennie/\n├── __init__.py              # Public interface\n├── core.py                  # Shared utilities (spaCy model loading)\n└── detectors/\n    ├── __init__.py\n    ├── prepositions.py      # Dangling preposition detection\n    └── (future detectors)   # participles.py, modifiers.py, etc.\n```\n\n## Future Plans\n\n- **Dangling Participles**: \"Walking down the street, the trees looked beautiful.\"\n- **Dangling Modifiers**: \"After eating the sandwich, the park was lovely.\"\n- **Split Infinitives**: \"To boldly go where no one has gone before.\"\n- **Custom Rules**: Add your own grammatical pet peeves to catch.\n\n## Technical Details\n\nBennie uses spaCy's `en_core_web_sm` model for natural language processing. The detection algorithm identifies prepositions (POS tag \"ADP\") that appear at the end of sentences or clauses without a clear object. \n\n## Contributing\n\nGot a grammatical construct you'd like Bennie to help identify? Contributions are welcome! The modular architecture makes it easy to add new detectors without breaking existing functionality.\n\n## A Note on Prescriptivism vs. Descriptivism\n\nWhile some grammar rules are more guidelines than absolute laws, this tool exists to help you write with intention. Sometimes ending with a preposition is exactly what you want to do - and that's something this tool won't argue with. ( \u003c-- you see what I did there, right? )\n\n---\n\n*\"This is the sort of English up with which I will not put.\"* - Often attributed to Winston Churchill (though he probably never said it)\n\nRemember: Good writing is about clarity and communication, not following every rule you were taught in school. Use Bennie as a guide, not a judge! 🎓","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwillwillis%2Fbennie","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwillwillis%2Fbennie","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwillwillis%2Fbennie/lists"}