Breame
( British English and American English)
Breame is a lightweight Python package with a number of utility tools to aid in the detection of words that have dual spellings in British and American English.
Breame can also be used to detect and provide definitions for words that have different meanings in both British English, American English, and Common English.
Additionally, Breame includes some tooling to detect and define words and phrases that are specific to British English or American English i.e. "strop" in British English or "mailman" in American English.
Install
pip install breame
Documentation
Quick Start
Spelling Detection and Conversion
Check if both an American and British English Spelling for a word exists:
from breame.spelling import american_spelling_exists, british_spelling_exists
american_spelling_exists("color")
>>> True
british_spelling_exists("colour")
>>> True
Get British English spelling of American English word and vice versa:
from breame.spelling import get_american_spelling, get_british_spelling
get_american_spelling("colour")
>>> 'color'
get_british_spelling("color")
>>> 'colour'
Detect different word meanings in British and American English
from breame.meanings import different_meanings_exist, get_meaning_definitions
different_meanings_exist("football")
>>> True
get_meaning_definitions("football")
>>> {'American English': 'American football',
'British English': '(usually) Association football (US: soccer). Less frequently applies to \nRugby football (espec. Rugby union in English private schools).'}
Detect whether a word is a term or short phrase specific to American English or British English
American:
from breame.terminology import is_american_english_term, get_american_term_definition
is_american_english_term("bleachers")
>>> True
get_american_term_definition("bleachers")
>>> 'are the raised open air tiered rows of seats (stands) found at sports fields or at other spectator events'
British:
from breame.terminology import is_british_english_term, get_british_term_definition
is_british_english_term("wellies")
>>> True
get_british_term_definition("wellies")
>>> 'Wellington boots, waterproof rubber boots named after the Duke of Wellington.'
Contributions
If you would like to contribute to the package or add to the data constants used for spelling, meanings, or terminology please don't hesitate to submit a PR or raise an issue. The data used is by no means an exhaustive list.
Data Stats
Stats for some of the data constants used throughout the package
- >= 690 words with multiple meanings covered in British, American, and Common English.
- >= 321 American English specific words or phrases.
- >= 605 British English specific words or phrases.
- >= 1730 British English spellings for American English words.
get_british_spelling() - >= 1706 American English spellings for British English words.
get_american_spelling()
Acknowledgements
This package was inspired by the javascript library American British English Translator by @hyperreality and @jessp01. All of the data constants defined in their package are gratefully used throughout breame.
The sources for American British English Translator constants are below:
Uses modified versions of the following lists:
- List of words having different meanings in American and British English: A-L
- List of words having different meanings in American and British English: M-Z
- Glossary of American terms not widely used in the United Kingdom
- Glossary of British terms not widely used in the United States
- Comprehensive list of American and British spelling differences
2 Nov 5, 2021
475 Jan 4, 2023
70 Dec 12, 2022
161 Dec 19, 2022
45 Oct 4, 2022
42 Dec 27, 2022
1 Jan 24, 2022
7 Nov 7, 2022
49 Sep 12, 2022
159 Apr 04, 2022
34 Dec 18, 2022
1 Jan 15, 2022
6 Apr 29, 2022
112 Dec 22, 2022
2 Mar 29, 2022
1.3k Jan 01, 2023
6 Nov 10, 2022
7 Sep 20, 2022
11 Feb 18, 2022
11 Nov 11, 2022
13 Sep 20, 2022
62 Dec 20, 2022
0 Feb 21, 2022
100 Dec 19, 2022
673 Dec 28, 2022
67 Dec 15, 2022
1.4k Dec 29, 2022
4 Feb 19, 2022
1 Feb 14, 2022