wlc


Namewlc JSON
Version 1.14 PyPI version JSON
download
home_page
SummaryA command-line utility for Weblate, translation tool with tight version control integration
upload_time2024-02-23 11:57:07
maintainer
docs_urlNone
author
requires_python>=3.8
licenseGPL-3.0-or-later
keywords i18n l10n gettext git mercurial translate
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            <a href="https://weblate.org/"><img alt="Weblate" src="https://s.weblate.org/cdn/Logo-Darktext-borders.png" height="80px" /></a>

**Weblate is libre software web-based continuous localization system,
used by over 2500 libre projects and companies in more than 165 countries.**

# wlc

wlc is a [Weblate](https://weblate.org/) command-line client using [Weblate's REST API](https://docs.weblate.org/en/latest/api.html).

[![Website](https://img.shields.io/badge/website-weblate.org-blue.svg)](https://weblate.org/)
[![Translation status](https://hosted.weblate.org/widgets/weblate/-/svg-badge.svg)](https://hosted.weblate.org/engage/weblate/?utm_source=widget)
[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/552/badge)](https://bestpractices.coreinfrastructure.org/projects/552)
[![PyPI package](https://img.shields.io/pypi/v/wlc.svg)](https://pypi.org/project/wlc/)
[![Documenation](https://readthedocs.org/projects/weblate/badge/)](https://docs.weblate.org/en/latest/wlc.html)

## PIP Installation

Install using pip:

```console
pip3 install wlc
```

Sources are available at <https://github.com/WeblateOrg/wlc>.

## Usage

Please see [Weblate documentation](https://docs.weblate.org/en/latest/wlc.html) for more complete documentation.

Command-line usage:

```console
wlc list-projects
wlc list-components
wlc list-translations
wlc list-languages
wlc show
wlc ls
wlc commit
wlc push
wlc pull
wlc repo
wlc stats
wlc lock
wlc unlock
wlc lock-status
wlc download
wlc upload
```

Configuration is stored in `~/.config/weblate`. The key/values (`retries`,
`timeout`, `method_whitelist`, `backoff_factor`, `status_forcelist`) are closely
coupled with the [urllib3 parameters](https://urllib3.readthedocs.io/en/latest/reference/urllib3.util.html) and allows the user to configure request
parameters.

```ini
[weblate]
url = https://hosted.weblate.org/api/
retries = 3
method_whitelist = PUT,POST,GET
backoff_factor = 0.2
status_forcelist = 429,500,502,503,504
timeout = 30

[keys]
https://hosted.weblate.org/api/ = APIKEY
```

## Docker image

The image is published on [Docker Hub](https://hub.docker.com/r/weblate/wlc).

Building locally:

```console
docker build -t weblate/wlc .
```

Detailed documentation is available in [Weblate documentation](https://docs.weblate.org/en/latest/wlc.html#docker-wlc).

## Docker hub tags

You can use following tags on Docker hub:

| Tag name | Description                                                                       | Use case                                        |
| -------- | --------------------------------------------------------------------------------- | ----------------------------------------------- |
| `latest` | wlc stable release, matches latest tagged release                                 | Rolling updates in a production environment     |
| `edge`   | wlc development                                                                   | Staging environment                             |
| version  | wlc stable release, see [weblate/wlc](https://hub.docker.com/r/weblate/wlc/tags/) | Well defined deploy in a production environment |

Every image is tested by our CI before it gets published, so even the `bleeding` version should be quite safe to use.

## Contributing

Contributions are welcome! See [documentation](https://docs.weblate.org/en/latest/contributing/modules.html) for more information.

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "wlc",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "",
    "keywords": "i18n,l10n,gettext,git,mercurial,translate",
    "author": "",
    "author_email": "Michal \u010ciha\u0159 <michal@cihar.com>",
    "download_url": "https://files.pythonhosted.org/packages/e2/5c/636f0495e3ff829d6df1b762454963244e28afd18581f61b341ab4762f8d/wlc-1.14.tar.gz",
    "platform": "any",
    "description": "<a href=\"https://weblate.org/\"><img alt=\"Weblate\" src=\"https://s.weblate.org/cdn/Logo-Darktext-borders.png\" height=\"80px\" /></a>\n\n**Weblate is libre software web-based continuous localization system,\nused by over 2500 libre projects and companies in more than 165 countries.**\n\n# wlc\n\nwlc is a [Weblate](https://weblate.org/) command-line client using [Weblate's REST API](https://docs.weblate.org/en/latest/api.html).\n\n[![Website](https://img.shields.io/badge/website-weblate.org-blue.svg)](https://weblate.org/)\n[![Translation status](https://hosted.weblate.org/widgets/weblate/-/svg-badge.svg)](https://hosted.weblate.org/engage/weblate/?utm_source=widget)\n[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/552/badge)](https://bestpractices.coreinfrastructure.org/projects/552)\n[![PyPI package](https://img.shields.io/pypi/v/wlc.svg)](https://pypi.org/project/wlc/)\n[![Documenation](https://readthedocs.org/projects/weblate/badge/)](https://docs.weblate.org/en/latest/wlc.html)\n\n## PIP Installation\n\nInstall using pip:\n\n```console\npip3 install wlc\n```\n\nSources are available at <https://github.com/WeblateOrg/wlc>.\n\n## Usage\n\nPlease see [Weblate documentation](https://docs.weblate.org/en/latest/wlc.html) for more complete documentation.\n\nCommand-line usage:\n\n```console\nwlc list-projects\nwlc list-components\nwlc list-translations\nwlc list-languages\nwlc show\nwlc ls\nwlc commit\nwlc push\nwlc pull\nwlc repo\nwlc stats\nwlc lock\nwlc unlock\nwlc lock-status\nwlc download\nwlc upload\n```\n\nConfiguration is stored in `~/.config/weblate`. The key/values (`retries`,\n`timeout`, `method_whitelist`, `backoff_factor`, `status_forcelist`) are closely\ncoupled with the [urllib3 parameters](https://urllib3.readthedocs.io/en/latest/reference/urllib3.util.html) and allows the user to configure request\nparameters.\n\n```ini\n[weblate]\nurl = https://hosted.weblate.org/api/\nretries = 3\nmethod_whitelist = PUT,POST,GET\nbackoff_factor = 0.2\nstatus_forcelist = 429,500,502,503,504\ntimeout = 30\n\n[keys]\nhttps://hosted.weblate.org/api/ = APIKEY\n```\n\n## Docker image\n\nThe image is published on [Docker Hub](https://hub.docker.com/r/weblate/wlc).\n\nBuilding locally:\n\n```console\ndocker build -t weblate/wlc .\n```\n\nDetailed documentation is available in [Weblate documentation](https://docs.weblate.org/en/latest/wlc.html#docker-wlc).\n\n## Docker hub tags\n\nYou can use following tags on Docker hub:\n\n| Tag name | Description                                                                       | Use case                                        |\n| -------- | --------------------------------------------------------------------------------- | ----------------------------------------------- |\n| `latest` | wlc stable release, matches latest tagged release                                 | Rolling updates in a production environment     |\n| `edge`   | wlc development                                                                   | Staging environment                             |\n| version  | wlc stable release, see [weblate/wlc](https://hub.docker.com/r/weblate/wlc/tags/) | Well defined deploy in a production environment |\n\nEvery image is tested by our CI before it gets published, so even the `bleeding` version should be quite safe to use.\n\n## Contributing\n\nContributions are welcome! See [documentation](https://docs.weblate.org/en/latest/contributing/modules.html) for more information.\n",
    "bugtrack_url": null,
    "license": "GPL-3.0-or-later",
    "summary": "A command-line utility for Weblate, translation tool with tight version control integration",
    "version": "1.14",
    "project_urls": {
        "Documentation": "https://docs.weblate.org/",
        "Download": "https://github.com/WeblateOrg/wlc",
        "Funding": "https://weblate.org/donate/",
        "Homepage": "https://weblate.org/",
        "Issue Tracker": "https://github.com/WeblateOrg/wlc/issues",
        "Source Code": "https://github.com/WeblateOrg/wlc",
        "Twitter": "https://twitter.com/WeblateOrg"
    },
    "split_keywords": [
        "i18n",
        "l10n",
        "gettext",
        "git",
        "mercurial",
        "translate"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "0f230f95ec3eb47cfef3f362c2285d5a010b512fd596656961624663b70229b2",
                "md5": "4e70b7e243debacd1673ff8dfb4be530",
                "sha256": "5a1bb3c104a028dea97d8aaa25698ac42e92d0f9c4d4f636bfbbbe0d399a6459"
            },
            "downloads": -1,
            "filename": "wlc-1.14-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "4e70b7e243debacd1673ff8dfb4be530",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 90028,
            "upload_time": "2024-02-23T11:57:06",
            "upload_time_iso_8601": "2024-02-23T11:57:06.251286Z",
            "url": "https://files.pythonhosted.org/packages/0f/23/0f95ec3eb47cfef3f362c2285d5a010b512fd596656961624663b70229b2/wlc-1.14-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e25c636f0495e3ff829d6df1b762454963244e28afd18581f61b341ab4762f8d",
                "md5": "e9ad92f330770ca53c358e766db8a2a8",
                "sha256": "40c178d41e9ada33127618de168450abe2b5609004cfdea6b072f35fac15a927"
            },
            "downloads": -1,
            "filename": "wlc-1.14.tar.gz",
            "has_sig": false,
            "md5_digest": "e9ad92f330770ca53c358e766db8a2a8",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 78350,
            "upload_time": "2024-02-23T11:57:07",
            "upload_time_iso_8601": "2024-02-23T11:57:07.697784Z",
            "url": "https://files.pythonhosted.org/packages/e2/5c/636f0495e3ff829d6df1b762454963244e28afd18581f61b341ab4762f8d/wlc-1.14.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-02-23 11:57:07",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "WeblateOrg",
    "github_project": "wlc",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "lcname": "wlc"
}
        
Elapsed time: 0.18338s