<a id="index-0"></a>

<a id="wlc"></a>

# Client Weblate

## Instalare

The [Weblate Client](https://pypi.org/project/wlc/) is shipped separately and includes the Python
module.
The source code is maintained in the [WeblateOrg/wlc repository](https://github.com/WeblateOrg/wlc).
To use the commands below, you need to install **wlc** using pip:

```sh
pip install wlc
```

You can also execute it directly using **uvx**:

```sh
uvx wlc --help
```

#### HINT
You can also use this **wlc** as a Python module, see [`wlc`](https://docs.weblate.org/ro/latest/python.md#module-wlc).

<a id="docker-wlc"></a>

## Utilizarea Docker

Clientul Weblate este, de asemenea, disponibil ca o imagine Docker.

Images are published on [Docker Hub](https://hub.docker.com/r/weblate/wlc)
and the [GitHub Container Registry](https://github.com/WeblateOrg/wlc/pkgs/container/wlc). The examples below
use the Docker Hub image name.

Instalare:

```sh
docker pull weblate/wlc
```

The following tags are available:

`latest`
: Latest stable release.

Full version, for example `2.2.0`
: A specific stable release.

Major version, for example `2`
: Latest stable release in that major series.

`edge`
: Current development version from the main branch.

`edge-YYYY-MM-DD-COMMIT`
: A specific development snapshot.

To build an image from the source checkout:

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

The Docker container uses Weblate Client defaults and connects to the API
deployed on localhost. Configure the API URL and API key using the normal
**wlc** arguments or environment variables, for example [`--url`](#cmdoption-wlc-url),
[`--key`](#cmdoption-wlc-key), [`WLC_URL`](#envvar-WLC_URL), and [`WLC_KEY`](#envvar-WLC_KEY).
API keys are rejected over non-local `http://` URLs by default; use HTTPS,
loopback HTTP for local development, or explicitly opt in to insecure HTTP.

Comanda de lansare a containerului utilizează următoarea sintaxă:

```sh
docker run --rm weblate/wlc [WLC_ARGS]
```

Exemplu:

```sh
docker run --rm weblate/wlc --url https://hosted.weblate.org/api/ list-projects
```

You might want to pass your [Fișiere de configurare](#wlc-config) to the Docker container. When
your repository contains a project configuration such as `.weblate`, the
easiest approach is to add your current directory as the
`/home/weblate` volume:

```sh
docker run --volume $PWD:/home/weblate --rm weblate/wlc show
```

When the mounted repository provides the API URL in project configuration and
you pass an unscoped API key to the container, also pin the URL explicitly:
[`WLC_KEY`](#envvar-WLC_KEY) requires [`WLC_URL`](#envvar-WLC_URL), and [`--key`](#cmdoption-wlc-key) requires
[`--url`](#cmdoption-wlc-url). The same pairing is required for the
[`--allow-insecure-http`](#cmdoption-wlc-allow-insecure-http) and [`--allow-insecure-ssl`](#cmdoption-wlc-allow-insecure-ssl) overrides.

If the configured API URL uses non-local `http://` and an API key is
provided, the container refuses to send the key unless insecure HTTP is
explicitly enabled. Prefer HTTPS; for legacy deployments, pass
[`--allow-insecure-http`](#cmdoption-wlc-allow-insecure-http) or set [`WLC_ALLOW_INSECURE_HTTP`](#envvar-WLC_ALLOW_INSECURE_HTTP).
TLS certificates are always verified by default, including for loopback URLs.
Use [`--allow-insecure-ssl`](#cmdoption-wlc-allow-insecure-ssl) or [`WLC_ALLOW_INSECURE_SSL`](#envvar-WLC_ALLOW_INSECURE_SSL) only
when certificate verification can not be enabled.

## Noțiuni introductive

The easiest way to get started is to create a personal
**wlc** configuration in `~/.config/weblate` (see
[Fișiere de configurare](#wlc-config) for the full discovery rules and other locations):

```ini
[weblate]
url = https://hosted.weblate.org/api/

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

Apoi puteți invoca comenzi pe serverul implicit:

```console
wlc ls
wlc commit sandbox/hello-world
```

#### SEE ALSO
[Fișiere de configurare](#wlc-config)

<a id="wlc-legacy"></a>

## Legacy configuration

#### Versionchanged
Schimbat în versiunea 1.17: The legacy configuration using unscoped `key` is no longer supported.

#### Versionchanged
Schimbat în versiunea 2.2.0: Global `allow_insecure_http` configuration is no longer supported.
Configure an origin in the `[insecure_http]` section instead.

Migrate legacy configuration:

```ini
[weblate]
url = https://hosted.weblate.org/api/
key = YOUR_KEY_HERE
```

To a configuration with key scoped to an API URL:

```ini
[weblate]
url = https://hosted.weblate.org/api/

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

## Sinopsis

```text
wlc [arguments] <command> [options]
```

Comenzile indică de fapt ce operațiune trebuie efectuată.

## Descriere

Weblate Client is a Python library and command-line utility to manage Weblate
remotely using [Weblate’s REST API](https://docs.weblate.org/ro/latest/api.md#api). Invoke the command-line utility as
**wlc**; see [`wlc`](https://docs.weblate.org/ro/latest/python.md#module-wlc) for the Python API.

### Argumente

Programul acceptă următoarele argumente care definesc formatul de ieșire sau instanța Weblate care trebuie utilizată. Acestea trebuie introduse înainte de orice comandă.

### --format {csv,json,text,html}

Specify the output format. The default is `text`.

### --version

Print the program version and exit. The [`version`](#cmdoption-wlc-arg-version) command supports
output formatting and can print only the version number.

### --debug

Print verbose HTTP communication. Authorization header values are redacted
and request bodies are not logged, but query parameters are; do not put
secrets in query parameters.

### --url URL

Specificați URL-ul API. Suprascrie orice valoare găsită în fișierul de configurare, a se vedea [Fișiere de configurare](#wlc-config). URL-ul trebuie să se termine cu `/api/`, de exemplu `https://hosted.weblate.org/api/`.

### --key KEY

Specify the API user key to use. Overrides any value found in the configuration file, see [Fișiere de configurare](#wlc-config).
You can find your key in your profile on Weblate.
When the API URL is loaded from automatically discovered project
configuration, [`--key`](#cmdoption-wlc-key) must be used together with [`--url`](#cmdoption-wlc-url).
API keys are rejected over non-local `http://` URLs by default.

### --allow-insecure-http

Allow sending API keys over non-local `http://` URLs. Prefer HTTPS or
loopback HTTP instead; this option is intended only for legacy deployments
where HTTPS is not available. This option only enables insecure HTTP for
the current run. When the API URL comes from automatically discovered
project configuration, this option requires [`--url`](#cmdoption-wlc-url).

### --allow-insecure-ssl

Disable TLS certificate verification for the current run. Certificates are
verified by default for every HTTPS URL, including loopback URLs. When the
API URL comes from automatically discovered project configuration, this
option requires [`--url`](#cmdoption-wlc-url).

### --config PATH

Load configuration only from `PATH` instead of the discovered global and
project configuration files, see [Fișiere de configurare](#wlc-config).

### --config-section SECTION

Selects the configuration file section to use instead of `[weblate]`, see
[Fișiere de configurare](#wlc-config).

### Object paths

Commands that operate on an object accept one of these paths:

`PROJECT`
: Project slug.

`PROJECT/COMPONENT`
: Component slug, including its project.

`PROJECT/COMPONENT/LANGUAGE`
: Translation language, including its project and component.

`UNIT_ID`
: Numeric translation unit ID. Only commands that explicitly support units
  accept this form.

Commands that require an object use the `translation` setting from
[Fișiere de configurare](#wlc-config) when the path is omitted. The [`ls`](#cmdoption-wlc-arg-ls) and
[`download`](#cmdoption-wlc-arg-download) commands also use this setting before falling back to their
no-object behavior. For [`list-components`](#cmdoption-wlc-arg-list-components) and
[`list-translations`](#cmdoption-wlc-arg-list-translations), an omitted object always requests an instance-wide
list.

### Comenzi

Sunt disponibile următoarele comenzi:

### version

Tipărește versiunea curentă.

### --bare

Prints only the version number.

### list-languages

Lists all languages in Weblate.

### list-projects

Lists all projects in Weblate.

### list-components

Lists all components in Weblate, or components in the specified project.

### list-translations

Lists all translations in Weblate, or translations in the specified
component.

### list-units

Lists units in the specified translation.

### --query QUERY

Filters units using the [search query syntax](https://docs.weblate.org/ro/latest/user/search.md).

### show

Shows a project, component, translation, or unit.

### delete

Deletes a project, component, translation, or unit without a confirmation
prompt.

### ls

Lists all projects when no object is specified, components in a project, or
translations in a component.

### commit

Comută modificările efectuate într-un obiect Weblate (traducere, componentă sau proiect).

### pull

Atrage modificările din depozitul de la distanță în obiectul Weblate (traducere, componentă sau proiect).

### push

Împinge modificările obiectelor Weblate în depozitul la distanță (traducere, componentă sau proiect).

### reset

Resetează modificările din obiectul Weblate pentru a se potrivi cu depozitul la distanță (traducere, componentă sau proiect).

### cleanup

Îndepărtează orice modificări netrasate într-un obiect Weblate pentru a se potrivi cu depozitul la distanță (traducere, componentă sau proiect).

### repo

Afișează starea depozitului pentru un anumit obiect Weblate (traducere, componentă sau proiect).

### stats

Afișează statistici detaliate pentru un anumit obiect Weblate (traducere, componentă sau proiect).

### lock-status

Displays the lock status of a component.

### lock

Blochează componenta de la traducerea ulterioară în Weblate.

### unlock

Deblochează traducerea componentei Weblate.

### changes

Displays changes for a project, component, or translation.

### download

Downloads translation files. For a translation, **wlc** writes the
file to [`--output`](#cmdoption-wlc-output) or to redirected standard output. It refuses to
write raw file content to an interactive terminal.

For a component or project, [`--output`](#cmdoption-wlc-output) is required and is treated
as a directory. **wlc** writes one ZIP archive per component. With
no object, it downloads every component in the Weblate instance in the same
way.

### --convert FORMAT

Requests conversion to `FORMAT` on the server. If unspecified, no
conversion happens.

### --output PATH

Specifies the output file for a translation or output directory for a
component, project, or instance-wide download. Use `-` to write a
translation to standard output.

### --no-glossary

Excludes glossary components from component, project, and instance-wide
downloads.

### upload

Încarcă un fișier de traducere.

### --overwrite

Overwrites existing translated strings. This is equivalent to
`--conflicts replace-translated`.

### --conflicts {ignore,replace-translated,replace-approved}

Selects how conflicts with existing translations are handled.

### --input PATH

Reads content from `PATH`. If unspecified or `-`, content is read
from standard input.

### --method {translate,approve,suggest,fuzzy,replace,source,add}

Upload method to use, see [Metode de import](https://docs.weblate.org/ro/latest/user/files.md#upload-method). The default is
`translate`.

### --fuzzy {process,approve}

Selects processing of fuzzy strings (marked for edit).

### --author-name NAME

Numele autorului, pentru a suprascrie utilizatorul autentificat în prezent

### --author-email EMAIL

E-mailul autorului, pentru a suprascrie utilizatorul autentificat în prezent

### edit-unit

Updates a translation unit. At least one update option is required.

### --target TARGET [TARGET ...]

Sets one or more translated strings.

### --state STATE

Sets the unit state: `0` for empty, `10` for fuzzy, `20` for
translated, or `30` for approved.

### --explanation EXPLANATION

Sets the string explanation.

### --extra-flags FLAGS

Sets additional string flags.

#### HINT
Puteți obține informații mai detaliate despre invocarea comenzilor individuale trecând `--help`, de exemplu: `wlc ls --help`.

<a id="wlc-config"></a>

## Fișiere de configurare

When [`--config`](#cmdoption-wlc-config) is provided, **wlc** loads only that file.

Without [`--config`](#cmdoption-wlc-config), **wlc** first loads the discovered global
configuration file from the standard platform-specific locations:

`C:\Users\NAME\AppData\Roaming\weblate.ini`
: Global configuration file on Windows in the roamed profile.

`C:\Users\NAME\AppData\Local\weblate.ini`
: Global configuration file on Windows in the local profile.

`~/.config/weblate`
: Global configuration file on Unix-like systems.

`~/.config/weblate.ini`
: Alternative global configuration filename on Unix-like systems.

`/etc/xdg/weblate`
: System-wide fallback configuration file.

`/etc/xdg/weblate.ini`
: Alternative system-wide fallback filename.

The program follows the XDG specification, so you can adjust the placement of
config files by environment variables `XDG_CONFIG_HOME` or
`XDG_CONFIG_DIRS`.

On Windows `APPDATA` and `LOCALAPPDATA` directories are the preferred
locations for the configuration file.

After loading the global configuration, **wlc** loads the nearest
project configuration file from the current directory or its parents:

`.weblate`, `.weblate.ini`, `weblate.ini`
: Project configuration file placed in the repository.

Project configuration is loaded after global configuration and overrides
matching settings. It can select the API URL, default object, request settings,
and a matching URL-scoped API key, allowing a cloned repository to
automatically select its Weblate server and translation.

Only the closest project configuration file is loaded. Configuration files in
farther parent directories are ignored.

Următoarele setări pot fi configurate în secțiunea `[weblate]` (puteți personaliza acest lucru prin [`--config-section`](#cmdoption-wlc-config-section)):

### key

#### Versionremoved
Removed in version 1.17: Use the `[keys]` section to specify keys scoped for individual API URLs, see [Legacy configuration](#wlc-legacy).

### url

URL-ul serverului API, valoarea implicită este `http://127.0.0.1:8000/api/`.

### translation

Default object path for commands that accept one: a project, component,
translation, or numeric unit ID.

### retries, timeout, allowed_methods, backoff_factor, status_forcelist

HTTP request retry and timeout settings. `retries` defaults to `0` and
`backoff_factor` to `0`. `status_forcelist` is a comma-separated list
of HTTP status codes that trigger retries and is empty by default.

`allowed_methods` lists methods that may be retried, separated by commas
or whitespace. It defaults to `HEAD`, `DELETE`, `OPTIONS`, `PUT`,
and `GET`. These retry settings are passed to `urllib3.util.Retry`.

`timeout` is the request timeout in seconds and defaults to `300`.
Current **wlc** releases use `allowed_methods` in place of the
older `method_whitelist` option.

Fișierul de configurare este un fișier INI, de exemplu:

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

The API keys are stored in the `[keys]` section:

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

This allows you to store keys in your personal settings, while using the
`.weblate` configuration in the VCS repository so that **wlc**
knows which server it should talk to. The `[keys]` lookup is scoped to the
complete configured API URL, not merely its network origin.

Project configuration can also supply or replace a matching entry in
`[keys]`. Do not commit valuable API keys to version control; normally keep
keys in personal configuration and only the API URL and default object in
project configuration.

Insecure transport exceptions are stored in origin-scoped sections in trusted
user configuration:

```ini
[insecure_http]
http://legacy.example.com:80 = true

[insecure_ssl]
https://legacy.example.com:443 = true
```

An origin consists of the scheme, normalized hostname, and effective port. The
API path is ignored, while different schemes and ports remain isolated. The
`[insecure_http]` section allows API keys over non-local HTTP for matching
origins. The `[insecure_ssl]` section disables TLS certificate verification
for matching origins.

#### Versionchanged
Schimbat în versiunea 2.2.0: TLS certificates are verified for all hosts by default. Insecure HTTP and
TLS configuration is scoped to origins. Automatically discovered project
configuration can neither add entries to these sections nor enable the
removed global settings. User configuration and explicitly selected
[`--config`](#cmdoption-wlc-config) files are trusted.

In CI, unscoped keys must pin the API URL explicitly: set both
[`WLC_URL`](#envvar-WLC_URL) and [`WLC_KEY`](#envvar-WLC_KEY), or use [`--url`](#cmdoption-wlc-url) together with
[`--key`](#cmdoption-wlc-key).

## Environment variables

#### Versionadded
Added in version 1.18.0.

#### Versionchanged
Schimbat în versiunea 2.0.1: Unscoped API keys require an explicit API URL when project configuration is
discovered automatically. API keys are rejected over non-local `http://`
URLs unless insecure HTTP is explicitly enabled.

#### Versionchanged
Schimbat în versiunea 2.2.0: Insecure HTTP and TLS environment overrides require [`WLC_URL`](#envvar-WLC_URL) when
the API URL would otherwise come from automatically discovered project
configuration.

The API URL and key can also be configured using environment variables. This is
especially useful for CI workflows where [`WLC_URL`](#envvar-WLC_URL) pins the destination
and [`WLC_KEY`](#envvar-WLC_KEY) is injected as a secret:

### WLC_URL

URL-UL API

### WLC_KEY

API key. When the API URL would otherwise come from automatically discovered
project configuration, [`WLC_KEY`](#envvar-WLC_KEY) is accepted only together with
[`WLC_URL`](#envvar-WLC_URL). API keys are rejected over non-local `http://` URLs by
default.

### WLC_ALLOW_INSECURE_HTTP

Set to `1`, `true`, `yes`, or `on` to allow API keys over non-local
`http://` URLs. Prefer HTTPS or loopback HTTP instead. Other values, such
as `0` or `false`, are treated as unset. When the API URL would otherwise
come from automatically discovered project configuration, this variable is
accepted only together with [`WLC_URL`](#envvar-WLC_URL).

### WLC_ALLOW_INSECURE_SSL

Set to `1`, `true`, `yes`, or `on` to disable TLS certificate
verification. Other values, such as `0` or `false`, are treated as
unset. When the API URL would otherwise come from automatically discovered
project configuration, this variable is accepted only together with
[`WLC_URL`](#envvar-WLC_URL).

The same protection applies to command-line arguments: [`--key`](#cmdoption-wlc-key),
[`--allow-insecure-http`](#cmdoption-wlc-allow-insecure-http), and [`--allow-insecure-ssl`](#cmdoption-wlc-allow-insecure-ssl) are accepted
with automatically discovered project configuration only when [`--url`](#cmdoption-wlc-url)
is provided.

The API URL and key configuration precedence (highest to lowest) is:

1. Command-line arguments ([`--url`](#cmdoption-wlc-url), [`--key`](#cmdoption-wlc-key)).
2. Environment variables ([`WLC_URL`](#envvar-WLC_URL), [`WLC_KEY`](#envvar-WLC_KEY)).
3. Configuration loaded from [`--config`](#cmdoption-wlc-config), or from the discovered global
   configuration plus the nearest project configuration when
   [`--config`](#cmdoption-wlc-config) is not used.

The insecure transport opt-ins are enable-only rather than normal precedence
settings. They are enabled by a command-line or environment override, or by a
matching origin in the trusted `[insecure_http]` or `[insecure_ssl]`
section. Automatically discovered project configuration cannot add trusted
origins.

<a id="wlc-security"></a>

## Security model

Project configuration is part of the repository workflow and is intentionally
trusted to select the API endpoint, default object, request settings, and a
matching URL-scoped API key. Running **wlc** inside a repository
authorizes its nearest project configuration to select the server that receives
commands and uploads and supplies displayed or downloaded content. Use an
explicit trusted [`--config`](#cmdoption-wlc-config) file when this is not desired.

The command-line client accepts API keys from [`--key`](#cmdoption-wlc-key),
[`WLC_KEY`](#envvar-WLC_KEY), or the `[keys]` section. It does not load HTTP
authentication from `.netrc` or the file named by `NETRC`. Credentials
embedded in API URLs are rejected; use an API key instead. Other Requests
environment integration, including proxy and CA-bundle variables, remains
enabled.

The [wlc threat model](https://github.com/WeblateOrg/wlc/blob/main/THREAT_MODEL.md) documents the
complete trust boundaries, security properties, non-goals, and downstream
responsibilities. A version-matched copy is included in source and wheel
distributions. Report security issues using the [Weblate vulnerability
reporting process](https://docs.weblate.org/ro/latest/security/issues.md#security).

## Exemple

Imprimă versiunea curentă a programului:

```sh
$ wlc version
```

Enumerați toate proiectele:

```sh
$ wlc list-projects
name: Hello
slug: hello
url: http://example.com/api/projects/hello/
web: https://weblate.org/
web_url: http://example.com/projects/hello/
```

Încărcați fișierul de traducere:

```sh
$ wlc upload project/component/language --input /tmp/hello.po
```

You can also designate what project **wlc** should work on:

```sh
$ cat .weblate
[weblate]
url = https://hosted.weblate.org/api/
translation = weblate/application

$ wlc show
branch: main
file_format: po
source_language: en
filemask: weblate/locale/*/LC_MESSAGES/django.po
git_export: https://hosted.weblate.org/git/weblate/application/
license: GPL-3.0+
license_url: https://spdx.org/licenses/GPL-3.0+
name: Application
new_base: weblate/locale/django.pot
project: weblate
repo: git://github.com/WeblateOrg/weblate.git
slug: application
template:
url: https://hosted.weblate.org/api/components/weblate/application/
vcs: git
web_url: https://hosted.weblate.org/projects/weblate/application/
```

Cu această configurație, este ușor să confirmați modificările în așteptare în proiectul curent:

```sh
$ wlc commit
```