Science Score: 36.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
○Academic publication links
-
✓Committers with academic emails
1 of 7 committers (14.3%) from academic institutions -
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (13.3%) to scientific vocabulary
Repository
Basic Info
- Host: GitHub
- Owner: aboSamoor
- License: apache-2.0
- Language: C++
- Default Branch: master
- Size: 41.7 MB
Statistics
- Stars: 173
- Watchers: 7
- Forks: 64
- Open Issues: 38
- Releases: 2
Metadata Files
README.md
PYCLD2 - Python Bindings to CLD2
Python bindings for the Compact Langauge Detect 2 (CLD2).
This package contains forks of:
- The
cld2C++ library, developed by Dick Sites - The
chromium-compact-language-detectorC++ extension module, originally created by Mike McCandless, which has been modified post-fork. These bindings, among other changes, make the support of over 165 languages the default.
The goal of this project is to consolidate the upstream library with its bindings, so the user can pip install one package instead of two.
The LICENSE is the same as Chromium's LICENSE and is included in the LICENSE file for reference.
Installing
bash
$ python -m pip install -U pycld2
Example
```python import pycld2 as cld2
isReliable, textBytesFound, details = cld2.detect( "а неправильный формат идентификатора дн назад" )
print(isReliable)
True
details[0]
('RUSSIAN', 'ru', 98, 404.0)
frenLatn = """\ France is the largest country in Western Europe and the third-largest in Europe as a whole. A accès aux chiens et aux frontaux qui lui ont été il peut consulter et modifier ses collections et exporter Cet article concerne le pays européen aujourd’hui appelé République française. Pour d’autres usages du nom France, Pour une aide rapide et effective, veuiller trouver votre aide dans le menu ci-dessus. Motoring events began soon after the construction of the first successful gasoline-fueled automobiles. The quick brown fox jumped over the lazy dog."""
isReliable, textBytesFound, details, vectors = cld2.detect( frenLatn, returnVectors=True ) print(vectors)
((0, 94, 'ENGLISH', 'en'), (94, 329, 'FRENCH', 'fr'), (423, 139, 'ENGLISH', 'en'))
```
API
This package exports one function, detect(). See help(detect) for the full docstring.
The first parameter (utf8Bytes) is the text for which you want to detect language.
utf8Bytes may be either:
str(example:"¼ cup of flour")bytesthat have been encoded using UTF-8 (example:"¼ cup of flour".encode("utf-8"))
Bytes that are not UTF-8 encoded will raise a pycld2.error. For example, passing
b"\xbc cup of flour" (which is "¼ cup of flour".encode("latin-1")) will raise.
All other parameters are optional:
| Parameter | Type/Default | Use |
| --------- | ------------ | --- |
| utf8Bytes | str or bytes* | The text to detect language for. |
| isPlainText | bool, default False | If False, then the input is HTML and CLD will skip HTML tags, expand HTML entities, detect HTML <lang ...> tags, etc. |
| hintTopLevelDomain | str | E.g., 'id' boosts Indonesian. |
| hintLanguage | str | E.g., 'ITALIAN' or 'it' boosts Italian; see cld.LANGUAGES for all known languages. |
| hintLanguageHTTPHeaders | str | E.g., 'mi,en' boosts Maori and English. |
| hintEncoding | str | E.g, 'SJS' boosts Japanese; see cld.ENCODINGS for all known encodings. |
| returnVectors | bool, default False | If True, then the vectors indicating which language was detected in which byte range are returned in addition to details. The vectors are a sequence of (bytesOffset, bytesLength, languageName, languageCode), in order. bytesOffset is the start of the vector, bytesLengthis the length of the vector. Note that there is some added CPU cost if this is True. (Approx. 2x performance hit.) |
| debugScoreAsQuads | bool, default False | Normally, several languages are detected solely by their Unicode script. Combined with appropritate lookup tables, this flag forces them instead to be detected via quadgrams. This can be a useful refinement when looking for meaningful text in these languages, instead of just character sets. The default tables do not support this use. |
| debugHTML | bool, default False | For each detection call, write an HTML file to stderr, showing the text chunks and their detected languages. See cld2/docs/InterpretingCLD2UnitTestOutput.pdf to interpret this output. |
| debugCR | bool, default False | In that HTML file, force a new line for each chunk. |
| debugVerbose | bool, default False | In that HTML file, show every lookup entry. |
| debugQuiet | bool, default False | In that HTML file, suppress most of the output detail. |
| debugEcho | bool, default False | Echo every input buffer to stderr. |
| bestEffort | bool, default False | If True, then allow low-quality results for short text, rather than forcing the result to "UNKNOWN_LANGUAGE". This may be of use for those desiring approximate results on short input text, but there is no claim that these result are very good. |
*If bytes, must be UTF-8 encoded bytes.
Constants
This package exports these global constants:
| Constant | Description |
| -------- | ----------- |
| pycld2.ENCODINGS | list of the encoding names CLD recognizes (if you provide hintEncoding, it must be one of these names). |
| pycld2.LANGUAGES | list of languages and their codes (if you provide hintLanguageCode, it must be one of the codes from these codes). |
| pycld2.EXTERNAL_LANGUAGES | list of external languages and their codes. |
| pycld2.DETECTED_LANGUAGES | list of all detectable languages. |
What About CLD3?
Owner
- Name: RAMI ALRFOU
- Login: aboSamoor
- Kind: user
- Location: Mountain View, CA
- Company: Google
- Website: alrfou.com
- Twitter: aboSamoor
- Repositories: 35
- Profile: https://github.com/aboSamoor
Research Scientist @ Google / Weekdays. --------------------------------------------------------------------------------------- A Bedouin Ranger / Weekends
GitHub Events
Total
- Watch event: 11
- Issue comment event: 2
- Push event: 13
- Pull request review event: 2
- Pull request event: 5
- Fork event: 4
- Create event: 1
- Commit comment event: 1
Last Year
- Watch event: 11
- Issue comment event: 2
- Push event: 13
- Pull request review event: 2
- Pull request event: 5
- Fork event: 4
- Create event: 1
- Commit comment event: 1
Committers
Last synced: over 1 year ago
Top Committers
| Name | Commits | |
|---|---|---|
| Brad Solomon | b****4@g****m | 28 |
| Rami Al-Rfou | r****d@g****m | 25 |
| Rami Al-Rfou | r****d@e****u | 5 |
| Rami Al-Rfou | R****u | 5 |
| nettnikl | n****t@d****g | 1 |
| Dobatymo | D****o | 1 |
| Daniel Herman | d****n@p****m | 1 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 10 months ago
All Time
- Total issues: 44
- Total pull requests: 21
- Average time to close issues: 10 months
- Average time to close pull requests: 4 months
- Total issue authors: 41
- Total pull request authors: 18
- Average comments per issue: 2.3
- Average comments per pull request: 1.19
- Merged pull requests: 6
- Bot issues: 0
- Bot pull requests: 1
Past Year
- Issues: 0
- Pull requests: 4
- Average time to close issues: N/A
- Average time to close pull requests: 4 days
- Issue authors: 0
- Pull request authors: 3
- Average comments per issue: 0
- Average comments per pull request: 0.25
- Merged pull requests: 2
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- bsolomon1124 (3)
- Benbbe (2)
- msdos (1)
- karipov (1)
- tirkarthi (1)
- ShadowRaven256 (1)
- dendisuhubdy (1)
- colesbury (1)
- Dobatymo (1)
- mrpurpledev (1)
- ma7555 (1)
- yasaswini1995 (1)
- Badiboy (1)
- gregtatum (1)
- donmonc (1)
Pull Request Authors
- detrin (4)
- GregBowyer (2)
- bsolomon1124 (2)
- JakeForsey-Ripjar (2)
- fstutz (2)
- kochelmonster (1)
- martinsvoboda (1)
- zagorulkinde (1)
- Dobatymo (1)
- tirkarthi (1)
- pquentin (1)
- tmikus (1)
- nettnikl (1)
- movermeyer (1)
- dudio92 (1)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 3
-
Total downloads:
- pypi 633,973 last-month
- Total docker downloads: 934,457,600
-
Total dependent packages: 28
(may contain duplicates) -
Total dependent repositories: 222
(may contain duplicates) - Total versions: 9
- Total maintainers: 2
pypi.org: pycld2
Python bindings around Google Chromium's embedded compact language detection library (CLD2)
- Homepage: https://github.com/aboSamoor/pycld2
- Documentation: https://pycld2.readthedocs.io/
- License: Apache2
-
Latest release: 0.42
published about 1 year ago
Rankings
Maintainers (1)
conda-forge.org: pycld2
- Homepage: https://github.com/aboSamoor/pycld2
- License: Apache-2.0
-
Latest release: 0.41
published almost 5 years ago
Rankings
pypi.org: pycld2-chatbees-fork
Python bindings around Google Chromium's embedded compact language detection library (CLD2)
- Homepage: https://github.com/aboSamoor/pycld2
- Documentation: https://pycld2-chatbees-fork.readthedocs.io/
- License: Apache2
-
Latest release: 0.42
published over 2 years ago
Rankings
Maintainers (1)
Dependencies
- actions/checkout v2 composite
- actions/download-artifact v2 composite
- actions/setup-python v2 composite
- actions/upload-artifact v2 composite
- docker/setup-qemu-action v1 composite
- pypa/gh-action-pypi-publish master composite
- wheel ==0.23.0
