| Name | sanakirja-org JSON |
| Version |
1.1.2
JSON |
| download |
| home_page | None |
| Summary | An unofficial Python API and CLI tool for sanakirja.org. |
| upload_time | 2025-08-03 08:03:38 |
| maintainer | None |
| docs_url | None |
| author | AceHanded |
| requires_python | >=3.8 |
| license | None |
| keywords |
sanakirja
translation
cli
api
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# sanakirja-org
[](https://github.com/AceHanded/sanakirja-org/blob/main/LICENSE)[](https://github.com/AceHanded/sanakirja-org/blob/main/LICENSE.CC-BY-SA)
[](https://github.com/AceHanded/sanakirja-org)
[](https://pypi.org/project/sanakirja-org/)
[](https://buymeacoffee.com/acehand)
An unofficial Python API and CLI tool for sanakirja.org.
## Installation
```bash
pip install sanakirja-org
```
## Examples
### Language codes
```python
import sanakirja as sk
sanakirja = sk.Sanakirja()
# The below formats are all equivalent
sanakirja.search(q="life", l=sk.LangCodes.en)
sanakirja.search(q="life", l="en")
sanakirja.search(q="life", l=3)
```
### Basic search
```python
import sanakirja as sk
sanakirja = sk.Sanakirja()
# No language codes specified -> source language is guessed and simple translations are provided for each language
sanakirja.search(q="everything")
# No target language code specified -> simple translations are provided from the source language to each language
sanakirja.search(q="everything", l=sk.LangCodes.en)
# No source language code specified -> source language is guessed and accurate translations are provided for the target language
sanakirja.search(q="everything", l2=sk.LangCodes.fi)
# Both language codes specified -> accurate translations are provided from the source language to the target language
sanakirja.search(q="everything", l=sk.LangCodes.en, l2=sk.LangCodes.fi)
```
### Error handling
```python
import sanakirja as sk
sanakirja = sk.Sanakirja()
try:
sk_res = sanakirja.search(q="universe", l=42)
except sk.LanguageCodeError as e:
print(e) # Invalid language code: '42'
```
> [!TIP]
> Valid language codes can be viewed, for example, via the `__members__` attribute of the `LangCodes` IntEnum.
### CLI
```bash
sanakirja --from fi --to 3 --lang sv --show="all,-translations" --pretty 2 --output "./result.json" kivi
```
The above example performs a search for the query "kivi" from Finnish to English. The language of user interface elements is set to Swedish, the "translations" field is omitted and the indent level is set to 2. Finally, the result is saved into a file named "result.json" at the current directory.
> [!NOTE]
> The argument `-h, --help` provides more information about each argument.
## Attribution and licensing
This package is licensed under the [MIT License](LICENSE).
It makes use of content retrieved from [sanakirja.org](https://sanakirja.org), a web service provided by Sanakirja.org Solutions Oy. The content is licensed under the Creative Commons Attribution-ShareAlike 3.0 Unported License ([CC BY-SA 3.0](LICENSE.CC-BY-SA)). \
This package is **not** affiliated with or endorsed by sanakirja.org.
If you redistribute content fetched using this package, you are responsible for complying with the terms of the CC BY-SA license, including proper attribution.
Raw data
{
"_id": null,
"home_page": null,
"name": "sanakirja-org",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "sanakirja, translation, CLI, API",
"author": "AceHanded",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/b5/e1/7b79f74e448c8abfbe46df1c9859b985ec8fa9729799c0bc7618c680f626/sanakirja_org-1.1.2.tar.gz",
"platform": null,
"description": "# sanakirja-org\r\n\r\n[](https://github.com/AceHanded/sanakirja-org/blob/main/LICENSE)[](https://github.com/AceHanded/sanakirja-org/blob/main/LICENSE.CC-BY-SA)\r\n[](https://github.com/AceHanded/sanakirja-org)\r\n[](https://pypi.org/project/sanakirja-org/)\r\n[](https://buymeacoffee.com/acehand)\r\n\r\nAn unofficial Python API and CLI tool for sanakirja.org.\r\n\r\n## Installation\r\n\r\n```bash\r\npip install sanakirja-org\r\n```\r\n\r\n## Examples\r\n\r\n### Language codes\r\n\r\n```python\r\nimport sanakirja as sk\r\n\r\nsanakirja = sk.Sanakirja()\r\n\r\n# The below formats are all equivalent\r\nsanakirja.search(q=\"life\", l=sk.LangCodes.en)\r\nsanakirja.search(q=\"life\", l=\"en\")\r\nsanakirja.search(q=\"life\", l=3)\r\n```\r\n\r\n### Basic search\r\n\r\n```python\r\nimport sanakirja as sk\r\n\r\nsanakirja = sk.Sanakirja()\r\n\r\n# No language codes specified -> source language is guessed and simple translations are provided for each language\r\nsanakirja.search(q=\"everything\")\r\n\r\n# No target language code specified -> simple translations are provided from the source language to each language\r\nsanakirja.search(q=\"everything\", l=sk.LangCodes.en)\r\n\r\n# No source language code specified -> source language is guessed and accurate translations are provided for the target language\r\nsanakirja.search(q=\"everything\", l2=sk.LangCodes.fi)\r\n\r\n# Both language codes specified -> accurate translations are provided from the source language to the target language\r\nsanakirja.search(q=\"everything\", l=sk.LangCodes.en, l2=sk.LangCodes.fi)\r\n```\r\n\r\n### Error handling\r\n\r\n```python\r\nimport sanakirja as sk\r\n\r\nsanakirja = sk.Sanakirja()\r\n\r\ntry:\r\n sk_res = sanakirja.search(q=\"universe\", l=42)\r\nexcept sk.LanguageCodeError as e:\r\n print(e) # Invalid language code: '42'\r\n```\r\n\r\n> [!TIP]\r\n> Valid language codes can be viewed, for example, via the `__members__` attribute of the `LangCodes` IntEnum.\r\n\r\n### CLI\r\n\r\n```bash\r\nsanakirja --from fi --to 3 --lang sv --show=\"all,-translations\" --pretty 2 --output \"./result.json\" kivi\r\n```\r\n\r\nThe above example performs a search for the query \"kivi\" from Finnish to English. The language of user interface elements is set to Swedish, the \"translations\" field is omitted and the indent level is set to 2. Finally, the result is saved into a file named \"result.json\" at the current directory.\r\n\r\n> [!NOTE]\r\n> The argument `-h, --help` provides more information about each argument.\r\n\r\n## Attribution and licensing\r\n\r\nThis package is licensed under the [MIT License](LICENSE).\r\n\r\nIt makes use of content retrieved from [sanakirja.org](https://sanakirja.org), a web service provided by Sanakirja.org Solutions Oy. The content is licensed under the Creative Commons Attribution-ShareAlike 3.0 Unported License ([CC BY-SA 3.0](LICENSE.CC-BY-SA)). \\\r\nThis package is **not** affiliated with or endorsed by sanakirja.org.\r\n\r\nIf you redistribute content fetched using this package, you are responsible for complying with the terms of the CC BY-SA license, including proper attribution.\r\n",
"bugtrack_url": null,
"license": null,
"summary": "An unofficial Python API and CLI tool for sanakirja.org.",
"version": "1.1.2",
"project_urls": {
"Bug Reports": "https://github.com/AceHanded/sanakirja-org/issues",
"Source Code": "https://github.com/AceHanded/sanakirja-org"
},
"split_keywords": [
"sanakirja",
" translation",
" cli",
" api"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ee721cf61249cbdffa574360840a1a4066dacab5f31b5164970b5a1b68173e9d",
"md5": "0c60ee28bba1bb4798bb064c14414de4",
"sha256": "292dff6261c45c5ed2f999475e724fb3ce834d512ed229de611b43c021ab4d09"
},
"downloads": -1,
"filename": "sanakirja_org-1.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0c60ee28bba1bb4798bb064c14414de4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 13260,
"upload_time": "2025-08-03T08:03:36",
"upload_time_iso_8601": "2025-08-03T08:03:36.938148Z",
"url": "https://files.pythonhosted.org/packages/ee/72/1cf61249cbdffa574360840a1a4066dacab5f31b5164970b5a1b68173e9d/sanakirja_org-1.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b5e17b79f74e448c8abfbe46df1c9859b985ec8fa9729799c0bc7618c680f626",
"md5": "2465d5c049821c199176912a8ef96689",
"sha256": "d0393ce2196efc7b442800d641c5da8f380e0119c95d6c17b2b33800b5f09b38"
},
"downloads": -1,
"filename": "sanakirja_org-1.1.2.tar.gz",
"has_sig": false,
"md5_digest": "2465d5c049821c199176912a8ef96689",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 13633,
"upload_time": "2025-08-03T08:03:38",
"upload_time_iso_8601": "2025-08-03T08:03:38.906899Z",
"url": "https://files.pythonhosted.org/packages/b5/e1/7b79f74e448c8abfbe46df1c9859b985ec8fa9729799c0bc7618c680f626/sanakirja_org-1.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-03 08:03:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "AceHanded",
"github_project": "sanakirja-org",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "sanakirja-org"
}
