<div align="center">
<img src=".github/assets/logo.png" height="128">
[](https://badge.fury.io/py/fastlingo)
[](https://opensource.org/licenses/MIT)
</div>
FastLingo is a command-line tool designed to translate iOS app metadata using a variety of translation sources. It is built on top of [Fastlane](https://fastlane.tools) and [Deliver](https://docs.fastlane.tools/actions/deliver/). FastLingo is currently supports the following translation sources:
- [Google Cloud Translation API](https://cloud.google.com/translate)
Full documentation can be found [here](https://fastlingo.readthedocs.io/en/latest/).
### Features
- Multilingual app metadata translation.
- Configurable translation sources.
- Translation caching for enhanced performance and fewer API calls.
- Seamless integration with Fastlane metadata folder structure.
### Installation
To install FastLingo, execute the following command:
```bash
pip install fastlingo
```
### Configuration
Before using FastLingo, configure your preferred translation source by establishing API keys and endpoints. Generate a template configuration file by executing:
```bash
fastlingo init
```
This action creates a `FastLingo.toml` file in the current directory, which can then be edited to include your API keys and endpoints. For example, to configure the Google Cloud Translation API, add the following to your configuration file:
```toml
translation_service = "google"
source_language = "ENGLISH"
target_languages = [ "AUTO",]
metadata_folder = "your/metadata/folder"
fields_to_translate = [ "name", "description" ]
[api_keys]
google = "service/account/key.json"
[cache]
cache_folder = ".fastlingo-cache"
cache_enabled = true
```
### How to Use
To translate your app metadata, run:
```bash
fastlingo translate
```
This will translate all the metadata fields specified in your configuration file for each target language.
### Contributing
Pull requests are welcome. Additions to the translation source list are encouraged.
### License
FastLingo is available under the MIT license.
Raw data
{
"_id": null,
"home_page": "",
"name": "fastlingo",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "fastlane,localization,translation,localize,translate,localization-management",
"author": "",
"author_email": "F\u0131rat Tamur <ftamur16@ku.edu.tr>",
"download_url": "https://files.pythonhosted.org/packages/43/d7/6d690410419fef32df4e09ea1ce934b6f2266ce9fa06442777fcab0c4ec6/fastlingo-1.2.0.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n <img src=\".github/assets/logo.png\" height=\"128\">\n\n[](https://badge.fury.io/py/fastlingo)\n[](https://opensource.org/licenses/MIT)\n\n\n</div>\n\nFastLingo is a command-line tool designed to translate iOS app metadata using a variety of translation sources. It is built on top of [Fastlane](https://fastlane.tools) and [Deliver](https://docs.fastlane.tools/actions/deliver/). FastLingo is currently supports the following translation sources:\n\n- [Google Cloud Translation API](https://cloud.google.com/translate)\n\nFull documentation can be found [here](https://fastlingo.readthedocs.io/en/latest/).\n\n### Features\n\n- Multilingual app metadata translation.\n- Configurable translation sources.\n- Translation caching for enhanced performance and fewer API calls.\n- Seamless integration with Fastlane metadata folder structure.\n\n### Installation\n\nTo install FastLingo, execute the following command:\n\n```bash\npip install fastlingo\n```\n\n### Configuration\n\nBefore using FastLingo, configure your preferred translation source by establishing API keys and endpoints. Generate a template configuration file by executing:\n\n```bash\nfastlingo init\n```\n\nThis action creates a `FastLingo.toml` file in the current directory, which can then be edited to include your API keys and endpoints. For example, to configure the Google Cloud Translation API, add the following to your configuration file:\n\n```toml\ntranslation_service = \"google\"\nsource_language = \"ENGLISH\"\ntarget_languages = [ \"AUTO\",]\nmetadata_folder = \"your/metadata/folder\"\nfields_to_translate = [ \"name\", \"description\" ]\n\n[api_keys]\ngoogle = \"service/account/key.json\"\n\n[cache]\ncache_folder = \".fastlingo-cache\"\ncache_enabled = true\n```\n\n### How to Use\n\nTo translate your app metadata, run:\n\n```bash\nfastlingo translate\n```\n\nThis will translate all the metadata fields specified in your configuration file for each target language.\n\n### Contributing\n\nPull requests are welcome. Additions to the translation source list are encouraged.\n\n### License\n\nFastLingo is available under the MIT license.\n",
"bugtrack_url": null,
"license": "",
"summary": "FastLingo is a command-line tool designed to translate and manage app metadata within Fastlane projects.",
"version": "1.2.0",
"project_urls": {
"documentation": "https://github.com/firattamur/fastlingo",
"homepage": "https://github.com/firattamur/fastlingo",
"repository": "https://github.com/firattamur/fastlingo"
},
"split_keywords": [
"fastlane",
"localization",
"translation",
"localize",
"translate",
"localization-management"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5ee5c11a2d486c0772109fc31a7abab4291379b7ded10612e42d8d31d35c5825",
"md5": "f2a671725f458f1f64040fc31ee84409",
"sha256": "cdffe6d6281eab1cdffc96c973168629970ebaaf73773eb749fe3c236f0e2aef"
},
"downloads": -1,
"filename": "fastlingo-1.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f2a671725f458f1f64040fc31ee84409",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 16530,
"upload_time": "2023-05-10T22:29:37",
"upload_time_iso_8601": "2023-05-10T22:29:37.892620Z",
"url": "https://files.pythonhosted.org/packages/5e/e5/c11a2d486c0772109fc31a7abab4291379b7ded10612e42d8d31d35c5825/fastlingo-1.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "43d76d690410419fef32df4e09ea1ce934b6f2266ce9fa06442777fcab0c4ec6",
"md5": "4d3cdd91ce6342c63953bb919c7e9251",
"sha256": "a7deed1733b1f2754b20eea7d0bef66630afcf201597aea6d78556df75d05ec7"
},
"downloads": -1,
"filename": "fastlingo-1.2.0.tar.gz",
"has_sig": false,
"md5_digest": "4d3cdd91ce6342c63953bb919c7e9251",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 12269,
"upload_time": "2023-05-10T22:29:39",
"upload_time_iso_8601": "2023-05-10T22:29:39.918783Z",
"url": "https://files.pythonhosted.org/packages/43/d7/6d690410419fef32df4e09ea1ce934b6f2266ce9fa06442777fcab0c4ec6/fastlingo-1.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-10 22:29:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "firattamur",
"github_project": "fastlingo",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "fastlingo"
}
JSON
