From 9c450a97dd8510ab1009dfd7fcfcac2ab88b8ca6 Mon Sep 17 00:00:00 2001 From: Sergei Kliuikov Date: Tue, 1 Oct 2024 14:06:28 -0700 Subject: [PATCH] Chore(docs): Update configuration docs and gitlab/github templates. --- .github/workflows/review.yml | 4 +- .gitlab/merge_request_templates/Chore.md | 2 - .gitlab/merge_request_templates/Docs.md | 2 - .gitlab/merge_request_templates/Feature.md | 2 - .gitlab/merge_request_templates/Fix.md | 2 - doc/config.rst | 185 ++++- doc/locale/ru/LC_MESSAGES/config.po | 890 ++++++++++++++------- yarn.lock | 6 +- 8 files changed, 764 insertions(+), 329 deletions(-) diff --git a/.github/workflows/review.yml b/.github/workflows/review.yml index 62ca4789..4408f84d 100644 --- a/.github/workflows/review.yml +++ b/.github/workflows/review.yml @@ -14,7 +14,7 @@ jobs: runs-on: "ubuntu-22.04" strategy: matrix: - node: [ 18 ] + node: [ 20 ] steps: - name: Checkout the source code @@ -49,7 +49,7 @@ jobs: - name: Set the node version uses: actions/setup-node@v3 with: - node-version: 18 + node-version: 20 cache: 'yarn' - name: Set the python version diff --git a/.gitlab/merge_request_templates/Chore.md b/.gitlab/merge_request_templates/Chore.md index 57f41d02..97a1b071 100644 --- a/.gitlab/merge_request_templates/Chore.md +++ b/.gitlab/merge_request_templates/Chore.md @@ -6,8 +6,6 @@ ### Changelog: * What was done? -Parsed bundle size: 0.00 MB. (not changed) - Closes: group/project#issue WIP: group/project#issue diff --git a/.gitlab/merge_request_templates/Docs.md b/.gitlab/merge_request_templates/Docs.md index 4a039891..a3e9d648 100644 --- a/.gitlab/merge_request_templates/Docs.md +++ b/.gitlab/merge_request_templates/Docs.md @@ -6,8 +6,6 @@ ### Changelog: * What was done? -Parsed bundle size: 0.00 MB. (not changed) - Closes: group/project#issue WIP: group/project#issue diff --git a/.gitlab/merge_request_templates/Feature.md b/.gitlab/merge_request_templates/Feature.md index 28124bd8..d810a81d 100644 --- a/.gitlab/merge_request_templates/Feature.md +++ b/.gitlab/merge_request_templates/Feature.md @@ -6,8 +6,6 @@ ### Changelog: * What was done? -Parsed bundle size: 0.00 MB. (not changed) - Closes: group/project#issue WIP: group/project#issue diff --git a/.gitlab/merge_request_templates/Fix.md b/.gitlab/merge_request_templates/Fix.md index 88bba553..ca3652d9 100644 --- a/.gitlab/merge_request_templates/Fix.md +++ b/.gitlab/merge_request_templates/Fix.md @@ -6,8 +6,6 @@ ### Changelog: * What was done? -Parsed bundle size: 0.00 MB. (not changed) - Closes: group/project#issue WIP: group/project#issue diff --git a/doc/config.rst b/doc/config.rst index aee5a3f7..b52aca4e 100644 --- a/doc/config.rst +++ b/doc/config.rst @@ -65,8 +65,10 @@ In the example above authorization logic will be the following: * **log_level** - Logging level. The verbosity level, configurable in Django and Celery, dictates the extent of log information, with higher levels providing detailed debugging insights for development and lower levels streamlining logs for production environments. Default: WARNING. -* **enable_django_logs** - Enable or disable Django logger to output. - Useful for debugging. Default: false. +* **enable_django_logs** - Enable or disable Django logger output. + Useful for debugging. When set to ``true``, logs generated by Django's internal operations will be included in the application logs. + This can be helpful during development or troubleshooting to get more detailed information about Django's internal processes. + Default: ``false``. * **enable_admin_panel** - Enable or disable Django Admin panel. Default: false. * **enable_registration** - Enable or disable user self-registration. Default: false. * **enable_user_self_remove** - Enable or disable user self-removing. Default: false. @@ -77,6 +79,23 @@ In the example above authorization logic will be the following: The instance is serialized to a string using the :mod:`standard python module pickle ` and then encrypted with :wiki:`Vigenère cipher `. Read more in the :class:`vstutils.utils.SecurePickling` documentation. Default: false. +* **enable_user_self_remove** - Enable or disable the ability for users to delete their own accounts. + When set to ``true``, users will have the option to remove their own accounts from the system. + This feature should be enabled with caution, as it allows users to permanently delete their data. Default: ``false``. +* **auth-plugins** - Comma-separated list of Django authentication backends. + The authentication attempt is made until the first successful one in the order specified in the list. + Predefined options are: + + - `DJANGO` - Uses `django.contrib.auth.backends.ModelBackend`, which authenticates users against the default Django user model. + + - `LDAP` - Uses the LDAP authentication backend with parameters specified in `ldap-*` settings. This allows authentication against an LDAP directory. + + You can also specify custom authentication backends by providing their import paths. + For example, if you have a custom backend at `myapp.auth.MyCustomBackend`, you can include it in the list like so: + + .. sourcecode:: bash + + auth-plugins = DJANGO,LDAP,myapp.auth.MyCustomBackend .. _database: @@ -165,6 +184,43 @@ Finally, add some options to MySQL/MariaDB configuration: collation-server=utf8_unicode_ci +To simplify the configuration of database connections, you can use the ``DATABASE_URL`` environment variable in conjunction with the ``django-environ`` package. +This approach allows you to define your database connection in a single environment variable, +which is especially useful for managing different environments (development, testing, production) without changing the code. + +**DATABASE_URL** - An environment variable that contains the database connection URL. +This variable is parsed by ``django-environ`` to configure the database settings. The format of the URL is: + +.. sourcecode:: bash + + backend://user:password@host:port/database_name + + +**Examples:** + +- **PostgreSQL:** + + .. sourcecode:: bash + + DATABASE_URL=postgres://user:password@localhost:5432/mydatabase + + +- **MySQL:** + + .. sourcecode:: bash + + DATABASE_URL=mysql://user:password@localhost:3306/mydatabase + + +- **SQLite (file-based database):** + + .. sourcecode:: bash + + DATABASE_URL=sqlite:///path/to/mydatabase.sqlite3 + + +Note the three slashes after ``sqlite:`` indicating an absolute file path. + .. _cache: Cache settings @@ -181,6 +237,62 @@ additional plugins. You can find details about cache configs supported using client-server cache realizations. We recommend to use Redis in production environments. +To simplify the configuration of cache backends, you can use the ``CACHE_URL`` environment variable in conjunction with the ``django-environ`` package. +This approach allows you to define your cache configuration in a single environment variable, +making it easy to switch between different cache backends without changing the code. + +**CACHE_URL** - An environment variable that contains the cache backend connection URL. +This variable is parsed by django-environ to configure the cache settings in Django. +The format of the URL is: + +.. sourcecode:: bash + + backend://username:password@host:port + + +**Examples:** + +- Memcached using MemcacheCache backend + + .. sourcecode:: bash + + CACHE_URL=memcache://127.0.0.1:11211 + +- Memcached using PyLibMCCache backend + + .. sourcecode:: bash + + CACHE_URL=pymemcache://127.0.0.1:11211 + +- Redis cache + + .. sourcecode:: bash + + CACHE_URL=redis://127.0.0.1:6379/1 + +- Database cache + + .. sourcecode:: bash + + CACHE_URL=dbcache://my_cache_table + +- File-based cache + + .. sourcecode:: bash + + CACHE_URL=filecache:///var/tmp/django_cache + +- Dummy cache (for development) + + .. sourcecode:: bash + + CACHE_URL=dummycache:// + + +**LOCKS_CACHE_URL**, **SESSIONS_CACHE_URL**, **ETAG_CACHE_URL** - Environment variables for configuring specific cache backends for locks, session data, and ETag caching respectively. +These allow you to use different cache configurations for different purposes within your application. + + Tarantool Cache Backend for Django ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -289,6 +401,16 @@ This section require vstutils with `rpc` extra dependency. * **concurrency** - Count of celery worker threads. Default: 4. * **heartbeat** - Interval between sending heartbeat packages, which says that connection still alive. Default: 10. * **enable_worker** - Enable or disable worker with webserver. Default: true. +* **default_delivery_mode** - Sets the default delivery mode for Celery tasks. + This parameter determines whether messages are persisted to disk or kept in memory when sent to the broker. + Possible values are: + + - ``persistent`` - Messages are stored on disk by the broker, ensuring they survive broker restarts. This is suitable for tasks that must not be lost. + + - ``transient`` - Messages are kept in memory by the broker, which can improve performance but may result in message loss if the broker restarts. + + Use this setting to balance between performance and reliability based on your application's needs. Default: ``persistent``. + The following variables from :celery_docs:`Django settings ` are also supported (with the corresponding types): @@ -365,6 +487,11 @@ Developers often switch between these backends based on the context of their wor * **password** - Auth password for smtp-server connection. Default: ``""``. * **tls** - Enable/disable tls for smtp-server connection. Default: ``False``. * **send_confirmation** - Enable/disable confirmation message after registration. Default: ``False``. +* **ssl** - Enable or disable SSL for the SMTP server connection. + When set to ``True``, the connection to the SMTP server will be secured using SSL, typically on port 465. + Use this setting if your SMTP server requires an SSL connection for sending emails. + If both ``tls`` and ``ssl`` are set to ``True``, ``ssl`` will take precedence. + Default: ``False``. .. _web: @@ -374,13 +501,27 @@ Web settings Section ``[web]``. -These settings are related to web-server. Those settings includes: -session_timeout, static_files_url and pagination limit. - -* **allow_cors** - enable cross-origin resource sharing. Default: ``False``. -* **cors_allowed_origins**, **cors_allowed_origins_regexes**, **cors_expose_headers**, **cors_allow_methods**, - **cors_allow_headers**, **cors_preflight_max_age** - `Settings `_ - from ``django-cors-headers`` lib with their defaults. +These settings are related to the web server. They include configurations for session management, security headers, CORS (Cross-Origin Resource Sharing), and API behavior. + +* **allow_cors** - Enable Cross-Origin Resource Sharing (CORS). + When set to ``true``, the application will accept requests from origins other than its own domain, which is necessary when the API is accessed from different domains. + This setting corresponds to enabling ``CORSMiddleware`` in FastAPI. Default: ``false``. +* **cors_allowed_origins** - A list of origins that are allowed to make cross-origin requests. + This corresponds to the ``allow_origins`` parameter in ``fastapi.middleware.cors.CORSMiddleware``. + Each origin should be a string representing a domain, e.g., ``https://example.com``. + Wildcards like ``*`` are accepted to allow all origins. Default: ``*`` if ``allow_cors`` is set or empty list set. +* **cors_allow_methods** - A list of HTTP methods that are allowed when making cross-origin requests. + This corresponds to the ``allow_methods`` parameter in ``CORSMiddleware``. + By specifying this, you control which HTTP methods are permitted for CORS requests to your application. + Common methods include ``GET``, ``POST``, ``PUT``, ``PATCH``, ``DELETE``, and ``OPTIONS``. + Default: ``GET`` if ``allow_cors`` is not set. Else - ``GET``. +* **cors_allow_headers** - A list of HTTP headers that are allowed when making cross-origin requests. + This corresponds to the ``allow_headers`` parameter in ``CORSMiddleware``. + Use this setting to specify which HTTP headers are allowed in CORS requests. + Common headers include ``Content-Type``, ``Authorization``, etc. + Default: ``*`` if ``allow_cors`` is set or empty list set. +* **cors_allowed_credentials** - Indicate that cookies and authorization headers should be supported for cross-origin requests. + Default: ``true`` if allow_cors else ``false``. * **enable_gravatar** - Enable/disable gravatar service using for users. Default: ``True``. * **rest_swagger_description** - Help string in Swagger schema. Useful for dev-integrations. * **openapi_cache_timeout** - Cache timeout for storing schema data. Default: ``120``. @@ -390,11 +531,19 @@ session_timeout, static_files_url and pagination limit. * **etag_default_timeout** - Cache timeout for Etag headers to control models caching. Default: ``1d`` (one day). * **rest_page_limit** and **page_limit** - Default limit of objects in API list. Default: ``1000``. * **session_cookie_domain** - The domain to use for session cookies. + This setting defines the domain attribute of the session cookie, which determines which domains the cookie is sent to. + By setting this, you can allow the session cookie to be shared across subdomains. Read :django_docs:`more `. Default: ``None``. -* **csrf_trusted_origins** - A list of hosts which are trusted origins for unsafe requests. +* **csrf_trusted_origins** - A list of trusted origins for Cross-Site Request Forgery (CSRF) protection. + This setting specifies a list of hosts that are trusted when performing cross-origin POST/PUT/PATCH requests that require CSRF protection. + This is necessary when your application needs to accept POST/PUT/PATCH requests from other domains. Read :django_docs:`more `. Default: from **session_cookie_domain**. -* **case_sensitive_api_filter** - Enables/disables case sensitive search for name filtering. - Default: ``True``. +* **case_sensitive_api_filter** - Enable or disable case-sensitive search for name filtering in the API. + When set to ``true``, filters applied to fields such as ``name`` will be case-sensitive, + meaning that the search will distinguish between uppercase and lowercase letters. + When set to ``false``, the search will be case-insensitive. + Adjust this setting based on whether you want users to have case-sensitive searches. + Default: ``true``. * **secure_proxy_ssl_header_name** - Header name which activates SSL urls in responses. Read :django_docs:`more `. Default: ``HTTP_X_FORWARDED_PROTOCOL``. * **secure_proxy_ssl_header_value** - Header value which activates SSL urls in responses. @@ -416,10 +565,12 @@ The following variables from Django settings are also supported (with the corres The following settings affects prometheus metrics endpoint (which can be used for monitoring application): -* **metrics_throttle_rate** - Count of requests to ``/api/metrics/`` endpoint. Default: ``120``. +* **metrics_throttle_rate** - Count of requests to ``/api/metrics/`` endpoint per minute. Default: ``120``. * **enable_metrics** - Enable/disable ``/api/metrics/`` endpoint for app. Default: ``true`` -* **metrics_backend** - Python class path with metrics collector backend. Default: ``vstutils.api.metrics.DefaultBackend`` - Default backend collects metrics from uwsgi workers and python version info. +* **metrics_backend** - The Python class path of the metrics collector backend. + This class is responsible for collecting and providing metrics data for your application. + By default, it uses ``vstutils.api.metrics.DefaultBackend``, which collects basic metrics like worker status and Python version information. + You can specify a custom backend by providing the import path to your own class. Default: ``vstutils.api.metrics.DefaultBackend``. Section ``[uvicorn]``. @@ -854,7 +1005,7 @@ This section contains additional information for configure additional elements. #. If you need set ``https`` for your web settings, you can do it using HAProxy, Nginx, Traefik or configure it in ``settings.ini``. -.. sourcecode:: ini + .. sourcecode:: ini [uwsgi] addrport = 0.0.0.0:8443 @@ -865,7 +1016,7 @@ This section contains additional information for configure additional elements. #. We strictly do not recommend running the web server from root. Use HTTP proxy to run on privileged ports. -#. You can use `{ENV[HOME:-value]}` (where `HOME` is environment variable, `value` is default value) +#. You can use ``{ENV[HOME:-value]}`` (where ``HOME`` is environment variable, ``value`` is default value) in configuration values. #. You can use environment variables for setup important settings. But config variables has more priority then env. diff --git a/doc/locale/ru/LC_MESSAGES/config.po b/doc/locale/ru/LC_MESSAGES/config.po index ad1e5600..d78d85b7 100644 --- a/doc/locale/ru/LC_MESSAGES/config.po +++ b/doc/locale/ru/LC_MESSAGES/config.po @@ -7,14 +7,14 @@ msgid "" msgstr "" "Project-Id-Version: VST Utils 5.0.4\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-05 05:59+0000\n" +"POT-Creation-Date: 2024-10-01 20:28+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.15.0\n" +"Generated-By: Babel 2.16.0\n" #: ../../config.rst:2 msgid "Configuration manual" @@ -195,13 +195,19 @@ msgstr "" #: ../../config.rst:68 msgid "" -"**enable_django_logs** - Enable or disable Django logger to output. " -"Useful for debugging. Default: false." +"**enable_django_logs** - Enable or disable Django logger output. Useful " +"for debugging. When set to ``true``, logs generated by Django's internal " +"operations will be included in the application logs. This can be helpful " +"during development or troubleshooting to get more detailed information " +"about Django's internal processes. Default: ``false``." msgstr "" -"**enable_django_logs** - Включить или выключить вывод логов Django. " -"Полезно для отладки. По умолчанию: false." +"**enable_django_logs** - Включает или отключает вывод логов Django. " +"Полезно для отладки. При установке в ``true`` логи, генерируемые " +"внутренними операциями Django, будут включены в логи приложения. Это может " +"быть полезно во время разработки или устранения неполадок для получения более " +"подробной информации о внутренних процессах Django. По умолчанию: ``false``." -#: ../../config.rst:70 +#: ../../config.rst:72 msgid "" "**enable_admin_panel** - Enable or disable Django Admin panel. Default: " "false." @@ -209,7 +215,7 @@ msgstr "" "**enable_admin_panel** - Включить или выключить панели администратора " "Django. По умолчанию: false." -#: ../../config.rst:71 +#: ../../config.rst:73 msgid "" "**enable_registration** - Enable or disable user self-registration. " "Default: false." @@ -217,7 +223,7 @@ msgstr "" "**enable_registration** - Включить или выключить самостоятельную " "регистрацию пользователей. По умолчанию: false." -#: ../../config.rst:72 +#: ../../config.rst:74 msgid "" "**enable_user_self_remove** - Enable or disable user self-removing. " "Default: false." @@ -225,7 +231,7 @@ msgstr "" "**enable_user_self_remove** - Включить или выключить самоудаление " "пользователей. По умолчанию: false." -#: ../../config.rst:73 +#: ../../config.rst:75 msgid "" "**auth-plugins** - Comma separated list of django authentication " "backends. Authorization attempt is made until the first successful one in" @@ -235,7 +241,7 @@ msgstr "" "разделенных запятыми. Попытка авторизации повторяется до первой успешной " "в соответствии с порядком, указанным в списке." -#: ../../config.rst:75 +#: ../../config.rst:77 msgid "" "**auth-cache-user** - Enable or disable user instance caching. It " "increases session performance on each request but saves model instance in" @@ -253,15 +259,65 @@ msgstr "" "информацию можно найти в документации " ":class:`vstutils.utils.SecurePickling`. По умолчанию: false." +#: ../../config.rst:82 +msgid "" +"**enable_user_self_remove** - Enable or disable the ability for users to " +"delete their own accounts. When set to ``true``, users will have the " +"option to remove their own accounts from the system. This feature should " +"be enabled with caution, as it allows users to permanently delete their " +"data. Default: ``false``." +msgstr "" +"**enable_user_self_remove** - Включает или отключает возможность для пользователей " +"удалять свои учетные записи. Если установлено в ``true``, пользователи смогут " +"удалять свои учетные записи из системы. Следует включать эту функцию с осторожностью, " +"так как она позволяет пользователям безвозвратно удалить свои данные. По умолчанию: ``false``." + #: ../../config.rst:85 +msgid "" +"**auth-plugins** - Comma-separated list of Django authentication " +"backends. The authentication attempt is made until the first successful " +"one in the order specified in the list. Predefined options are:" +msgstr "" +"**auth-plugins** - Список Django аутентификационных бэкендов, разделенных запятыми. " +"Аутентификация выполняется по порядку до первой успешной попытки. Предопределенные варианты:" + +#: ../../config.rst:89 +msgid "" +"`DJANGO` - Uses `django.contrib.auth.backends.ModelBackend`, which " +"authenticates users against the default Django user model." +msgstr "" +"`DJANGO` - Использует `django.contrib.auth.backends.ModelBackend`, который " +"аутентифицирует пользователей с использованием модели пользователей по умолчанию в Django." + +#: ../../config.rst:91 +msgid "" +"`LDAP` - Uses the LDAP authentication backend with parameters specified " +"in `ldap-*` settings. This allows authentication against an LDAP " +"directory." +msgstr "" +"`LDAP` - Использует LDAP-бэкенд аутентификации с параметрами, указанными в " +"настройках `ldap-*`. Это позволяет выполнять аутентификацию через LDAP-директорию." + +#: ../../config.rst:93 +msgid "" +"You can also specify custom authentication backends by providing their " +"import paths. For example, if you have a custom backend at " +"`myapp.auth.MyCustomBackend`, you can include it in the list like so:" +msgstr "" +"Вы также можете указать собственные бэкенды аутентификации, указав пути для их импорта. " +"Например, если у вас есть собственный бэкенд в `myapp.auth.MyCustomBackend`, вы можете " +"включить его в список следующим образом:" + + +#: ../../config.rst:104 msgid "Databases settings" msgstr "Настройки базы данных" -#: ../../config.rst:87 +#: ../../config.rst:106 msgid "Section ``[databases]``." msgstr "Раздел ``[databases]``." -#: ../../config.rst:89 +#: ../../config.rst:108 msgid "" "The main section that is designed to manage multiple databases connected " "to the project." @@ -269,7 +325,7 @@ msgstr "" "Основной раздел, предназначенный для управления несколькими базами " "данных, которые подключены к проекту. " -#: ../../config.rst:92 +#: ../../config.rst:111 msgid "" "These settings are for all databases and are vendor-independent, with the" " exception of tablespace management." @@ -277,7 +333,7 @@ msgstr "" "Эти настройки актуальны для всех баз данных за исключением пространства " "таблиц." -#: ../../config.rst:95 +#: ../../config.rst:114 msgid "" "**default_tablespace** - Default tablespace to use for models that don’t " "specify one, if the backend supports it. A tablespace is a storage " @@ -301,7 +357,7 @@ msgstr "" "Это позволяет вам организовывать и управлять хранением таблиц вашей базы " "данных, указывая место на диске, где будут располагаться данные таблицы." -#: ../../config.rst:104 +#: ../../config.rst:123 msgid "" "**default_index_tablespace** - Default tablespace to use for indexes on " "fields that don’t specify one, if the backend supports it. Read more at " @@ -314,7 +370,7 @@ msgstr "" ":django_topics:`Объявление табличных пространств для индексов " "`.\"" -#: ../../config.rst:107 +#: ../../config.rst:126 msgid "" "**databases_without_cte_support** - A comma-separated list of database " "section names that do not support CTEs (Common Table Expressions)." @@ -322,7 +378,7 @@ msgstr "" "**databases_without_cte_support** - Разделенный запятыми список разделов " "баз данных которые не поддерживают CTEs (Common Table Expressions)." -#: ../../config.rst:111 +#: ../../config.rst:130 msgid "" "Although MariaDB supports Common Table Expressions, but database " "connected to MariaDB still needs to be added to " @@ -337,7 +393,7 @@ msgstr "" "стандартной форме. MySQL (начиная с версии 8.0) работает ожидаемым " "образом." -#: ../../config.rst:116 +#: ../../config.rst:135 msgid "" "Also, all subsections of this section are available connections to the " "DBMS. So the ``databases.default`` section will be used by django as the " @@ -347,7 +403,7 @@ msgstr "" "подключения к СУБД. Таким образом, раздел ``databases.default`` будет " "использоваться Django в качестве подключения по умолчанию." -#: ../../config.rst:119 +#: ../../config.rst:138 msgid "" "Here you can change settings related to database, which vstutils-based " "application will use. vstutils-based application supports all databases " @@ -368,7 +424,7 @@ msgstr "" "vstutils, на нескольких узлах (кластере) используйте клиент-серверную " "базу данных (SQLite не подходит), используемую всеми узлами." -#: ../../config.rst:127 +#: ../../config.rst:146 msgid "" "You can also set the base template for connecting to the database in the " "``database`` section." @@ -376,11 +432,11 @@ msgstr "" "Вы также можете задать базовый шаблон для подключения к базе данныхв " "разделе ``database``." -#: ../../config.rst:131 +#: ../../config.rst:150 msgid "Section ``[database]``." msgstr "Раздел ``[database]``." -#: ../../config.rst:133 +#: ../../config.rst:152 msgid "" "This section is designed to define the basic template for connections to " "various databases. This can be useful to reduce the list of settings in " @@ -396,11 +452,11 @@ msgstr "" "сведения можно найти в документации Django :django_topics:`о " "множественных базах данных `" -#: ../../config.rst:138 +#: ../../config.rst:157 msgid "There is a list of settings, required for MySQL/MariaDB database." msgstr "Здесь приведен список настроек, необходимых для базы данных MySQL/MariaDB" -#: ../../config.rst:140 +#: ../../config.rst:159 msgid "" "Firstly, if you use MySQL/MariaDB and you have set timezone different " "from \"UTC\" you should run command below:" @@ -408,7 +464,7 @@ msgstr "" "Во-первых, если вы используете MySQL/MariaDB и установили часовой пояс, " "отличный от \"UTC\", вам следует выполнить следующую команду:" -#: ../../config.rst:147 +#: ../../config.rst:166 msgid "" "Secondly, to use MySQL/MariaDB set following options in ``settings.ini`` " "file:" @@ -416,19 +472,64 @@ msgstr "" "Во-вторых, чтобы использовать MySQL/MariaDB установите следующие " "настройки в файле ``settings.ini``:" -#: ../../config.rst:155 +#: ../../config.rst:174 msgid "Finally, add some options to MySQL/MariaDB configuration:" msgstr "Наконец, добавьте некоторые настройки в конфигурацию MySQL/MariaDB" -#: ../../config.rst:171 +#: ../../config.rst:187 +msgid "" +"To simplify the configuration of database connections, you can use the " +"``DATABASE_URL`` environment variable in conjunction with the ``django-" +"environ`` package. This approach allows you to define your database " +"connection in a single environment variable, which is especially useful " +"for managing different environments (development, testing, production) " +"without changing the code." +msgstr "" +"Чтобы упростить настройку подключений к базе данных, вы можете использовать переменную " +"окружения ``DATABASE_URL`` вместе с пакетом ``django-environ``. Этот подход позволяет " +"определить подключение к базе данных в одной переменной окружения, что особенно полезно " +"для управления различными средами (разработка, тестирование, производство) без изменения кода." + +#: ../../config.rst:191 +msgid "" +"**DATABASE_URL** - An environment variable that contains the database " +"connection URL. This variable is parsed by ``django-environ`` to " +"configure the database settings. The format of the URL is:" +msgstr "" +"**DATABASE_URL** - Переменная окружения, которая содержит URL подключения к базе данных. " +"Эта переменная анализируется с помощью ``django-environ`` для настройки параметров базы данных. " +"Формат URL следующий:" + +#: ../../config.rst:199 ../../config.rst:253 +msgid "**Examples:**" +msgstr "**Примеры:**" + +#: ../../config.rst:201 +msgid "**PostgreSQL:**" +msgstr "**PostgreSQL:**" + +#: ../../config.rst:208 +msgid "**MySQL:**" +msgstr "**MySQL:**" + +#: ../../config.rst:215 +msgid "**SQLite (file-based database):**" +msgstr "**SQLite (файловая база данных):**" + +#: ../../config.rst:222 +msgid "Note the three slashes after ``sqlite:`` indicating an absolute file path." +msgstr "Обратите внимание на три косых черты после ``sqlite:``, указывающие на абсолютный путь к файлу." + + +#: ../../config.rst:227 msgid "Cache settings" msgstr "Настройки кэша" -#: ../../config.rst:173 +#: ../../config.rst:229 msgid "Section ``[cache]``." msgstr "Раздел ``[cache]``." -#: ../../config.rst:175 +#: ../../config.rst:231 msgid "" "This section is cache backend related settings used by vstutils-based " "application. vstutils supports all cache backends that Django does. " @@ -450,11 +551,72 @@ msgstr "" "клиент-серверного кэша. Мы рекомендуем использовать Redis в " "производственных окружениях." -#: ../../config.rst:185 +#: ../../config.rst:240 +msgid "" +"To simplify the configuration of cache backends, you can use the " +"``CACHE_URL`` environment variable in conjunction with the ``django-" +"environ`` package. This approach allows you to define your cache " +"configuration in a single environment variable, making it easy to switch " +"between different cache backends without changing the code." +msgstr "" +"Чтобы упростить настройку кэш-бэкендов, вы можете использовать переменную " +"окружения ``CACHE_URL`` вместе с пакетом ``django-environ``. Этот подход позволяет " +"определить конфигурацию кэша в одной переменной окружения, что облегчает " +"переключение между различными кэш-бэкендами без изменения кода." + +#: ../../config.rst:244 +msgid "" +"**CACHE_URL** - An environment variable that contains the cache backend " +"connection URL. This variable is parsed by django-environ to configure " +"the cache settings in Django. The format of the URL is:" +msgstr "" +"**CACHE_URL** - Переменная окружения, которая содержит URL подключения к кэш-бэкенду. " +"Эта переменная анализируется с помощью django-environ для настройки параметров кэша в Django. " +"Формат URL следующий:" + +#: ../../config.rst:255 +msgid "Memcached using MemcacheCache backend" +msgstr "Memcached с использованием бэкенда MemcacheCache" + +#: ../../config.rst:261 +msgid "Memcached using PyLibMCCache backend" +msgstr "Memcached с использованием бэкенда PyLibMCCache" + +#: ../../config.rst:267 +msgid "Redis cache" +msgstr "Кэш Redis" + +#: ../../config.rst:273 +msgid "Database cache" +msgstr "Кэш на основе базы данных" + +#: ../../config.rst:279 +msgid "File-based cache" +msgstr "Кэш на основе файлов" + +#: ../../config.rst:285 +msgid "Dummy cache (for development)" +msgstr "Фиктивный кэш (для разработки)" + +#: ../../config.rst:292 +msgid "" +"**LOCKS_CACHE_URL**, **SESSIONS_CACHE_URL**, **ETAG_CACHE_URL** - " +"Environment variables for configuring specific cache backends for locks, " +"session data, and ETag caching respectively. These allow you to use " +"different cache configurations for different purposes within your " +"application." +msgstr "" +"**LOCKS_CACHE_URL**, **SESSIONS_CACHE_URL**, **ETAG_CACHE_URL** - " +"Переменные окружения для настройки отдельных кэш-бэкендов для блокировок, " +"данных сессий и кэширования ETag соответственно. Это позволяет использовать " +"разные конфигурации кэша для различных целей в вашем приложении." + + +#: ../../config.rst:297 msgid "Tarantool Cache Backend for Django" msgstr "Tarantool в качестве сервера кеша для Django" -#: ../../config.rst:187 +#: ../../config.rst:299 msgid "" "The ``TarantoolCache`` is a custom cache backend for Django that allows " "you to use Tarantool as a caching mechanism. To use this backend, you " @@ -465,21 +627,21 @@ msgstr "" "использовать этот механизм необходимо выставить следующие настройки в " "конфигурации проекта:" -#: ../../config.rst:201 +#: ../../config.rst:313 msgid "Explanation of Settings:" msgstr "Расшифровка настроек" -#: ../../config.rst:203 +#: ../../config.rst:315 msgid "" "**location** - The host name and port for connecting to the Tarantool " "server." msgstr "**location** - Имя хоста и порт для подключения к серверу Tarantool." -#: ../../config.rst:204 +#: ../../config.rst:316 msgid "**backend** - The path to the TarantoolCache backend class." msgstr "**backend** - Путь до класса TarantoolCache бэкенда." -#: ../../config.rst:205 +#: ../../config.rst:317 msgid "" "**space** - The name of the space in Tarantool to use as the cache " "(default is ``DJANGO_CACHE``)." @@ -487,7 +649,7 @@ msgstr "" "**space** - Имя спейса в Tarantool для использования кешем (по умолчанию " "``DJANGO_CACHE``)." -#: ../../config.rst:206 +#: ../../config.rst:318 msgid "" "**user** - The username for connecting to the Tarantool server (default " "is ``guest``)." @@ -495,7 +657,7 @@ msgstr "" "**user** - Имя пользователя для подключения к Tarantool-серверу. (По " "умолчанию: ``guest``)." -#: ../../config.rst:207 +#: ../../config.rst:319 msgid "" "**password** - The password for connecting to the Tarantool server. " "Optional." @@ -503,7 +665,7 @@ msgstr "" "**password** - Пароль для подключения к серверу Tarantool. Не " "обязательный." -#: ../../config.rst:209 +#: ../../config.rst:321 msgid "" "Additionally, you can set the ``connect_on_start`` variable in the " "``[cache.options]`` section. When set to ``true`` value, this variable " @@ -516,7 +678,7 @@ msgstr "" "спейсов и настройки сервиса для автоматического удаления просроченных " "объектов." -#: ../../config.rst:214 +#: ../../config.rst:326 msgid "" "Note that this requires the ``expirationd`` module to be installed on the" " Tarantool server." @@ -524,7 +686,7 @@ msgstr "" "Обратите внимание, что это требует установки модуля ``expirationd`` на " "сервере Tarantool." -#: ../../config.rst:217 +#: ../../config.rst:329 msgid "" "When utilizing Tarantool as a cache backend in VST Utils, temporary " "spaces are automatically created to facilitate seamless operation. These " @@ -536,7 +698,7 @@ msgstr "" "динамически создаются по необходимости и нужны, чтобы хранить временные " "данные максимально эффективно." -#: ../../config.rst:220 ../../config.rst:320 +#: ../../config.rst:332 ../../config.rst:442 msgid "" "It's important to mention that while temporary spaces are automatically " "handled, if you intend to use persistent spaces on disk, it is necessary " @@ -554,7 +716,7 @@ msgstr "" "прежде чем создавать их на сервере Tarantool с аналогичными названиями. " "Это важно для стабильной и устойчивой работы." -#: ../../config.rst:226 +#: ../../config.rst:338 msgid "" "It's important to note that this cache driver is unique to vstutils and " "tailored to seamlessly integrate with the VST Utils framework." @@ -562,15 +724,15 @@ msgstr "" "Важно отметить, что этот драйвер кеша уникальный для vstutils и " "адаптирован для полной интеграции с фреймворком VST Utils." -#: ../../config.rst:233 +#: ../../config.rst:345 msgid "Locks settings" msgstr "Настройки блокировок" -#: ../../config.rst:235 +#: ../../config.rst:347 msgid "Section ``[locks]``." msgstr "Раздел ``[locks]``." -#: ../../config.rst:237 +#: ../../config.rst:349 msgid "" "Locks is a system that vstutils-based application uses to avoid damage " "from parallel actions working on the same entity simultaneously. It is " @@ -598,15 +760,15 @@ msgstr "" " этих целей. Бэкэнд кэша и блокировок могут быть одним и тем же, но не " "забывайте о требованиях, о которых мы говорили выше." -#: ../../config.rst:250 +#: ../../config.rst:362 msgid "Session cache settings" msgstr "Настройки кэша сессий" -#: ../../config.rst:252 +#: ../../config.rst:364 msgid "Section ``[session]``." msgstr "Раздел ``[session]``." -#: ../../config.rst:254 +#: ../../config.rst:366 msgid "" "vstutils-based application store sessions in database_, but for better " "performance, we use a cache-based session backend. It is based on Django " @@ -619,15 +781,15 @@ msgstr "" "группа настроек, аналогичных настройкам cache_. По умолчанию настройки " "получаются из cache_." -#: ../../config.rst:263 +#: ../../config.rst:375 msgid "Rpc settings" msgstr "Настройки RPC" -#: ../../config.rst:265 +#: ../../config.rst:377 msgid "Section ``[rpc]``." msgstr "Раздел ``[rpc]``." -#: ../../config.rst:267 +#: ../../config.rst:379 msgid "" "Celery is a distributed task queue system for handling asynchronous tasks" " in web applications. Its primary role is to facilitate the execution of " @@ -643,7 +805,7 @@ msgstr "" "требуют немедленной обработки, что повышает общую скорость отклика и " "производительность приложения." -#: ../../config.rst:271 +#: ../../config.rst:383 msgid "" "Key features and roles of Celery in an application with asynchronous " "tasks include:" @@ -651,7 +813,7 @@ msgstr "" "Ключевые функции и роли Celery в приложении с асинхронными задачами " "включают:" -#: ../../config.rst:273 +#: ../../config.rst:385 msgid "" "Asynchronous Task Execution: Celery allows developers to define tasks as " "functions or methods and execute them asynchronously. This is beneficial " @@ -663,7 +825,7 @@ msgstr "" "задач, которые могут занять значительное время, таких как отправка " "электронных писем, обработка данных или создание отчетов." -#: ../../config.rst:274 +#: ../../config.rst:386 msgid "" "Distributed Architecture: Celery operates in a distributed manner, making" " it suitable for large-scale applications. It can distribute tasks across" @@ -675,7 +837,7 @@ msgstr "" "распределять задачи между несколькими рабочими процессами или даже " "несколькими серверами, повышая масштабируемость и производительность." -#: ../../config.rst:275 +#: ../../config.rst:387 msgid "" "Message Queue Integration: Celery relies on message brokers (such as " "RabbitMQ, Redis, Tarantool, SQS or others) to manage the communication " @@ -689,7 +851,7 @@ msgstr "" " обеспечивает надежное выполнение задач и позволяет эффективно " "обрабатывать очереди задач." -#: ../../config.rst:276 +#: ../../config.rst:388 msgid "" "Periodic Tasks: Celery includes a scheduler that enables the execution of" " periodic or recurring tasks. This is useful for automating tasks that " @@ -702,7 +864,7 @@ msgstr "" "промежутки времени, например обновления данных или выполнения операций " "обслуживания." -#: ../../config.rst:277 +#: ../../config.rst:389 msgid "" "Error Handling and Retry Mechanism: Celery provides mechanisms for " "handling errors in tasks and supports automatic retries. This ensures " @@ -714,7 +876,7 @@ msgstr "" "повторные попытки. Это обеспечивает надежность выполнения задач, позволяя" " системе восстанавливаться после временных сбоев." -#: ../../config.rst:278 +#: ../../config.rst:390 msgid "" "Task Result Storage: Celery supports storing the results of completed " "tasks, which can be useful for tracking task progress or retrieving " @@ -726,7 +888,7 @@ msgstr "" "выполнения задач или получения результатов позже. Эта функция особенно " "ценна для длительных задач." -#: ../../config.rst:280 +#: ../../config.rst:392 msgid "" "vstutils-based application uses Celery for long-running async tasks. " "Those settings relate to this broker and Celery itself. Those kinds of " @@ -739,11 +901,11 @@ msgstr "" "процессов на узел и некоторые настройки, используемые для устранения " "проблем взаимодействия сервера, брокера и рабочих процессов." -#: ../../config.rst:286 +#: ../../config.rst:398 msgid "This section require vstutils with `rpc` extra dependency." msgstr "Для этого раздела требуется vstutils с дополнительной зависимостью rpc." -#: ../../config.rst:288 +#: ../../config.rst:400 msgid "" "**connection** - Celery :celery_docs:`broker connection " "`. Default: " @@ -753,13 +915,13 @@ msgstr "" "`. По умолчанию: " "``filesystem:///var/tmp``." -#: ../../config.rst:289 +#: ../../config.rst:401 msgid "**concurrency** - Count of celery worker threads. Default: 4." msgstr "" "**concurrency** - Количество потоков рабочего процесса Celery. По " "умолчанию: 4." -#: ../../config.rst:290 +#: ../../config.rst:402 msgid "" "**heartbeat** - Interval between sending heartbeat packages, which says " "that connection still alive. Default: 10." @@ -767,7 +929,7 @@ msgstr "" "**heartbeat** - Интервал между отправкой пакетов-сигналов, которые " "говорят, что соединение все еще активно. По умолчанию: 10." -#: ../../config.rst:291 +#: ../../config.rst:403 msgid "" "**enable_worker** - Enable or disable worker with webserver. Default: " "true." @@ -775,7 +937,44 @@ msgstr "" "**enable_worker** - Включить или отключить рабочий процесс с " "веб-сервером. По умолчанию: true." -#: ../../config.rst:293 +#: ../../config.rst:404 +msgid "" +"**default_delivery_mode** - Sets the default delivery mode for Celery " +"tasks. This parameter determines whether messages are persisted to disk " +"or kept in memory when sent to the broker. Possible values are:" +msgstr "" +"**default_delivery_mode** - Устанавливает режим доставки по умолчанию для задач Celery. " +"Этот параметр определяет, сохраняются ли сообщения на диск или хранятся в памяти при " +"отправке брокеру. Возможные значения:" + +#: ../../config.rst:408 +msgid "" +"``persistent`` - Messages are stored on disk by the broker, ensuring they" +" survive broker restarts. This is suitable for tasks that must not be " +"lost." +msgstr "" +"``persistent`` - Сообщения сохраняются на диск брокером, что гарантирует их " +"сохранность при перезапуске брокера. Это подходит для задач, которые не должны " +"быть потеряны." + +#: ../../config.rst:410 +msgid "" +"``transient`` - Messages are kept in memory by the broker, which can " +"improve performance but may result in message loss if the broker " +"restarts." +msgstr "" +"``transient`` - Сообщения хранятся в памяти брокером, что может повысить " +"производительность, но может привести к потере сообщений при перезапуске брокера." + +#: ../../config.rst:412 +msgid "" +"Use this setting to balance between performance and reliability based on " +"your application's needs. Default: ``persistent``." +msgstr "" +"Используйте эту настройку для балансировки между производительностью и надёжностью " +"в зависимости от потребностей вашего приложения. Значение по умолчанию: ``persistent``." + +#: ../../config.rst:415 msgid "" "The following variables from :celery_docs:`Django settings " "` are also supported" @@ -785,43 +984,43 @@ msgstr "" "Django ` (с " "соответствующими типами):" -#: ../../config.rst:296 +#: ../../config.rst:418 msgid "" "**prefetch_multiplier** - :celery_docs:`CELERYD_PREFETCH_MULTIPLIER " "`" msgstr "" -#: ../../config.rst:297 +#: ../../config.rst:419 msgid "" "**max_tasks_per_child** - :celery_docs:`CELERYD_MAX_TASKS_PER_CHILD " "`" msgstr "" -#: ../../config.rst:298 +#: ../../config.rst:420 msgid "" "**results_expiry_days** - :celery_docs:`CELERY_RESULT_EXPIRES " "`" msgstr "" -#: ../../config.rst:299 +#: ../../config.rst:421 msgid "" "**default_delivery_mode** - :celery_docs:`CELERY_DEFAULT_DELIVERY_MODE " "`" msgstr "" -#: ../../config.rst:300 +#: ../../config.rst:422 msgid "" "**task_send_sent_event** - :celery_docs:`CELERY_DEFAULT_DELIVERY_MODE " "`" msgstr "" -#: ../../config.rst:301 +#: ../../config.rst:423 msgid "" "**worker_send_task_events** - :celery_docs:`CELERY_DEFAULT_DELIVERY_MODE " "`" msgstr "" -#: ../../config.rst:303 +#: ../../config.rst:425 msgid "" "VST Utils provides seamless support for using Tarantool as a transport " "for Celery, allowing efficient and reliable message passing between " @@ -834,7 +1033,7 @@ msgstr "" "этой возможности на сервере Tarantool должны быть установлены модули " "`queue` и `expirationd`." -#: ../../config.rst:306 +#: ../../config.rst:428 msgid "" "To configure the connection, use the following example URL: " "``tarantool://guest@localhost:3301/rpc``" @@ -842,27 +1041,27 @@ msgstr "" "Для настройки подключения используйте в качестве примера следующий URL: " "``tarantool://guest@localhost:3301/rpc``" -#: ../../config.rst:308 +#: ../../config.rst:430 msgid "``tarantool://``: Specifies the transport." msgstr "``tarantool://``: Указывает тип транспорта." -#: ../../config.rst:309 +#: ../../config.rst:431 msgid "``guest``: Authentication parameters (in this case, no password)." msgstr "`guest``: Параметры аутентификации (в данном случае без пароля)." -#: ../../config.rst:310 +#: ../../config.rst:432 msgid "``localhost``: Server address." msgstr "``localhost``: Адрес сервера." -#: ../../config.rst:311 +#: ../../config.rst:433 msgid "``3301``: Port for connection." msgstr "``3301``: Порт для подключения." -#: ../../config.rst:312 +#: ../../config.rst:434 msgid "``rpc``: Prefix for queue names and/or result storage." msgstr "``rpc``: Префикс для имён очередей и/или спейса хранилища результата" -#: ../../config.rst:314 +#: ../../config.rst:436 msgid "" "VST Utils also supports Tarantool as a backend for storing Celery task " "results. Connection string is similar to the transport." @@ -871,7 +1070,7 @@ msgstr "" "результатов задач Celery. Строка подключения аналогична как и у " "транспорта." -#: ../../config.rst:317 +#: ../../config.rst:439 msgid "" "When utilizing Tarantool as a result backend or transport in VST Utils, " "temporary spaces and queues are automatically created to facilitate " @@ -883,25 +1082,25 @@ msgstr "" "этих операций. Эти временные хранилища создаются динамически по мере " "необходимости и необходимы для эффективного хранения временных данных." -#: ../../config.rst:328 +#: ../../config.rst:450 msgid "Worker settings" msgstr "Настройки рабочего процесса (worker`a)" -#: ../../config.rst:330 +#: ../../config.rst:452 msgid "Section ``[worker]``." msgstr "Раздел ``[worker]``." -#: ../../config.rst:333 +#: ../../config.rst:455 msgid "These settings are needed only for rpc-enabled applications." msgstr "" "Эти настройки необходимы только для приложений с включенной поддержкой " "RPC." -#: ../../config.rst:335 +#: ../../config.rst:457 msgid "Celery worker options:" msgstr "Настройки рабочего процесса celery:" -#: ../../config.rst:337 +#: ../../config.rst:459 msgid "" "**loglevel** - Celery worker log level. Default: from main_ section " "``log_level``." @@ -909,7 +1108,7 @@ msgstr "" "**loglevel** - Уровень логгирования рабочего процесса. По умолчанию: из " "раздела main_ ``log_level``." -#: ../../config.rst:338 +#: ../../config.rst:460 msgid "" "**pidfile** - Celery worker pidfile. Default: " "``/run/{app_name}_worker.pid``" @@ -917,7 +1116,7 @@ msgstr "" "**pidfile** - Файл pid для рабочего процесса Celery. по умолчанию: " "``/run/{app_name}_worker.pid``\"" -#: ../../config.rst:339 +#: ../../config.rst:461 msgid "" "**autoscale** - Options for autoscaling. Two comma separated numbers: " "max,min." @@ -925,25 +1124,25 @@ msgstr "" "**autoscale** - Параметры для автомасштабирования. Два числа, разделенных" " запятой: максимальное,минимальное." -#: ../../config.rst:340 +#: ../../config.rst:462 msgid "**beat** - Enable or disable celery beat scheduler. Default: ``true``." msgstr "" "**beat** - Включить или отключить планировщик celery beat. По умолчанию: " "``true``." -#: ../../config.rst:342 +#: ../../config.rst:464 msgid "See other settings via ``celery worker --help`` command." msgstr "Другие настройки можно увидеть с помощью команды ``celery worker --help``" -#: ../../config.rst:349 +#: ../../config.rst:471 msgid "SMTP settings" msgstr "SMTP-настройки" -#: ../../config.rst:351 +#: ../../config.rst:473 msgid "Section ``[mail]``." msgstr "Раздел ``[mail]``." -#: ../../config.rst:353 +#: ../../config.rst:475 msgid "" "Django comes with several email sending backends. With the exception of " "the SMTP backend (default when ``host`` is set), these backends are " @@ -954,7 +1153,7 @@ msgstr "" "установке ``host``), эти бэкэнды полезны только для тестирования и " "разработки." -#: ../../config.rst:356 +#: ../../config.rst:478 msgid "" "Applications based on vstutils uses only ``smtp`` and ``console`` " "backends. These two backends serve distinct purposes in different " @@ -975,7 +1174,7 @@ msgstr "" "работы, выбирая тот, который подходит для этапа разработки или " "тестирования." -#: ../../config.rst:362 +#: ../../config.rst:484 msgid "" "**host** - IP or domain for smtp-server. If it not set vstutils uses " "``console`` backends. Default: ``None``." @@ -983,17 +1182,17 @@ msgstr "" "**host** - IP-адрес или доменное имя smtp-сервера. Если не указано, " "vstutils использует бэкэнд ``console``. По умолчанию: ``None``." -#: ../../config.rst:363 +#: ../../config.rst:485 msgid "**port** - Port for smtp-server connection. Default: ``25``." msgstr "**port** - Порт для подключения к smtp-серверу. По умолчанию: ``25``." -#: ../../config.rst:364 +#: ../../config.rst:486 msgid "**user** - Username for smtp-server connection. Default: ``\"\"``." msgstr "" "**user** - Имя пользователя для подключения к SMTP-серверу. По умолчанию:" " ``\"\"``." -#: ../../config.rst:365 +#: ../../config.rst:487 msgid "" "**password** - Auth password for smtp-server connection. Default: " "``\"\"``." @@ -1001,7 +1200,7 @@ msgstr "" "**password** - Пароль для аутентификации на smtp-сервере. По умолчанию: " "``\"\"``." -#: ../../config.rst:366 +#: ../../config.rst:488 msgid "" "**tls** - Enable/disable tls for smtp-server connection. Default: " "``False``." @@ -1009,7 +1208,7 @@ msgstr "" "**tls** - Включить или отключить TLS для подключения к smtp-серверу. По " "умолчанию: ``False``" -#: ../../config.rst:367 +#: ../../config.rst:489 msgid "" "**send_confirmation** - Enable/disable confirmation message after " "registration. Default: ``False``." @@ -1017,43 +1216,108 @@ msgstr "" "**send_confirmation** - Включить или отключить отправку сообщения с " "подтверждением после регистрации. По умолчанию: ``False``." -#: ../../config.rst:373 +#: ../../config.rst:490 +msgid "" +"**ssl** - Enable or disable SSL for the SMTP server connection. When set " +"to ``True``, the connection to the SMTP server will be secured using SSL," +" typically on port 465. Use this setting if your SMTP server requires an " +"SSL connection for sending emails. If both ``tls`` and ``ssl`` are set to" +" ``True``, ``ssl`` will take precedence. Default: ``False``." +msgstr "" +"**ssl** - Включает или отключает SSL для подключения к серверу SMTP. При значении " +"``True`` соединение с сервером SMTP будет защищено с использованием SSL, обычно на порту 465. " +"Используйте эту настройку, если ваш SMTP-сервер требует SSL-соединения для отправки " +"электронных писем. Если одновременно установлены значения ``tls`` и ``ssl`` в ``True``, " +"предпочтение будет отдано ``ssl``. Значение по умолчанию: ``False``." + +#: ../../config.rst:500 msgid "Web settings" msgstr "Web-настройки" -#: ../../config.rst:375 +#: ../../config.rst:502 msgid "Section ``[web]``." msgstr "Раздел ``[web]``." -#: ../../config.rst:377 +#: ../../config.rst:504 msgid "" -"These settings are related to web-server. Those settings includes: " -"session_timeout, static_files_url and pagination limit." +"These settings are related to the web server. They include configurations" +" for session management, security headers, CORS (Cross-Origin Resource " +"Sharing), and API behavior." msgstr "" -"Эти настройки относятся к веб-серверу. Среди них: session_timeout, " -"static_files_url и лимит пагинации." +"Эти настройки связаны с веб-сервером. Они включают конфигурации для управления сессиями, " +"заголовков безопасности, CORS (междоменный обмен ресурсами) и поведения API." -#: ../../config.rst:380 -msgid "**allow_cors** - enable cross-origin resource sharing. Default: ``False``." -msgstr "" -"**allow_cors** - включить cross-origin resource sharing. По умолчанию: " -"``False``." +#: ../../config.rst:506 +msgid "" +"**allow_cors** - Enable Cross-Origin Resource Sharing (CORS). When set to" +" ``true``, the application will accept requests from origins other than " +"its own domain, which is necessary when the API is accessed from " +"different domains. This setting corresponds to enabling " +"``CORSMiddleware`` in FastAPI. Default: ``false``." +msgstr "" +"**allow_cors** - Включает поддержку CORS (междоменный обмен ресурсами). При значении " +"``true`` приложение будет принимать запросы от источников, отличных от его собственного домена, " +"что необходимо, когда API вызывается с других доменов. Эта настройка включает " +"``CORSMiddleware`` в FastAPI. Значение по умолчанию: ``false``." + +#: ../../config.rst:509 +msgid "" +"**cors_allowed_origins** - A list of origins that are allowed to make " +"cross-origin requests. This corresponds to the ``allow_origins`` " +"parameter in ``fastapi.middleware.cors.CORSMiddleware``. Each origin " +"should be a string representing a domain, e.g., ``https://example.com``. " +"Wildcards like ``*`` are accepted to allow all origins. Default: ``*`` if" +" ``allow_cors`` is set or empty list set." +msgstr "" +"**cors_allowed_origins** - Список источников, которым разрешено отправлять междоменные запросы. " +"Эта настройка соответствует параметру ``allow_origins`` в " +"``fastapi.middleware.cors.CORSMiddleware``. Каждый источник должен быть строкой, представляющей " +"домен, например, ``https://example.com``. Также принимаются подстановочные знаки вроде ``*``, " +"чтобы разрешить все источники. Значение по умолчанию: ``*``, если включен ``allow_cors`` или " +"установлен пустой список." + +#: ../../config.rst:513 +msgid "" +"**cors_allow_methods** - A list of HTTP methods that are allowed when " +"making cross-origin requests. This corresponds to the ``allow_methods`` " +"parameter in ``CORSMiddleware``. By specifying this, you control which " +"HTTP methods are permitted for CORS requests to your application. Common " +"methods include ``GET``, ``POST``, ``PUT``, ``PATCH``, ``DELETE``, and " +"``OPTIONS``. Default: ``GET`` if ``allow_cors`` is not set. Else - " +"``GET``." +msgstr "" +"**cors_allow_methods** - Список HTTP-методов, которые разрешены при выполнении междоменных " +"запросов. Эта настройка соответствует параметру ``allow_methods`` в ``CORSMiddleware``. " +"Определив это, вы контролируете, какие HTTP-методы разрешены для CORS-запросов к вашему " +"приложению. Обычные методы включают ``GET``, ``POST``, ``PUT``, ``PATCH``, ``DELETE`` и " +"``OPTIONS``. Значение по умолчанию: ``GET``, если ``allow_cors`` не установлен, иначе - ``GET``." + +#: ../../config.rst:518 +msgid "" +"**cors_allow_headers** - A list of HTTP headers that are allowed when " +"making cross-origin requests. This corresponds to the ``allow_headers`` " +"parameter in ``CORSMiddleware``. Use this setting to specify which HTTP " +"headers are allowed in CORS requests. Common headers include ``Content-" +"Type``, ``Authorization``, etc. Default: ``*`` if ``allow_cors`` is set " +"or empty list set." +msgstr "" +"**cors_allow_headers** - Список HTTP-заголовков, которые разрешены при выполнении междоменных " +"запросов. Эта настройка соответствует параметру ``allow_headers`` в ``CORSMiddleware``. " +"Используйте эту настройку для указания, какие HTTP-заголовки разрешены в CORS-запросах. " +"Обычно используются такие заголовки, как ``Content-Type``, ``Authorization`` и т.д. " +"Значение по умолчанию: ``*``, если ``allow_cors`` включен или установлен пустой список." -#: ../../config.rst:381 +#: ../../config.rst:523 msgid "" -"**cors_allowed_origins**, **cors_allowed_origins_regexes**, " -"**cors_expose_headers**, **cors_allow_methods**, **cors_allow_headers**, " -"**cors_preflight_max_age** - `Settings `_ from ``django-cors-headers`` lib " -"with their defaults." +"**cors_allowed_credentials** - Indicate that cookies and authorization " +"headers should be supported for cross-origin requests. Default: ``true`` " +"if allow_cors else ``false``." msgstr "" -"**cors_allowed_origins**, **cors_allowed_origins_regexes**, " -"**cors_expose_headers**, **cors_allow_methods**, **cors_allow_headers**, " -"**cors_preflight_max_age** - `Настройки `_ из библиотеки ``django-cors-" -"headers`` со значениями по умолчанию." +"**cors_allowed_credentials** - Указывает, что файлы cookie и заголовки авторизации должны " +"поддерживаться для междоменных запросов. Значение по умолчанию: ``true``, если ``allow_cors`` " +"включен, иначе ``false``." -#: ../../config.rst:384 +#: ../../config.rst:525 msgid "" "**enable_gravatar** - Enable/disable gravatar service using for users. " "Default: ``True``." @@ -1061,7 +1325,7 @@ msgstr "" "**enable_gravatar** - Включить/отключить использование сервиса Gravatar " "для пользователей. По умолчанию: ``True``." -#: ../../config.rst:385 +#: ../../config.rst:526 msgid "" "**rest_swagger_description** - Help string in Swagger schema. Useful for " "dev-integrations." @@ -1069,7 +1333,7 @@ msgstr "" "**rest_swagger_description** - Строка справки в схеме Swagger. Полезно " "для разработки интеграций." -#: ../../config.rst:386 +#: ../../config.rst:527 msgid "" "**openapi_cache_timeout** - Cache timeout for storing schema data. " "Default: ``120``." @@ -1077,7 +1341,7 @@ msgstr "" "**openapi_cache_timeout** - Время кэширования данных схемы. По умолчанию:" " ``120``." -#: ../../config.rst:387 +#: ../../config.rst:528 msgid "" "**health_throttle_rate** - Count of requests to ``/api/health/`` " "endpoint. Default: ``60``." @@ -1085,7 +1349,7 @@ msgstr "" "Количество запросов к конечной точке ``/api/health/``. По умолчанию: " "``60``." -#: ../../config.rst:388 +#: ../../config.rst:529 msgid "" "**bulk_threads** - Threads count for PATCH ``/api/endpoint/`` endpoint. " "Default: ``3``." @@ -1093,13 +1357,13 @@ msgstr "" "**bulk_threads** - Количество потоков для PATCH ``/api/endpoint/``. По " "умолчанию: ``3``." -#: ../../config.rst:389 +#: ../../config.rst:530 msgid "**session_timeout** - Session lifetime. Default: ``2w`` (two weeks)." msgstr "" "**session_timeout** - Время жизни сессии. По умолчанию: ``2w`` (две " "недели)." -#: ../../config.rst:390 +#: ../../config.rst:531 msgid "" "**etag_default_timeout** - Cache timeout for Etag headers to control " "models caching. Default: ``1d`` (one day)." @@ -1107,7 +1371,7 @@ msgstr "" "**etag_default_timeout** - Время кэширования заголовков Etag для " "управления кэшированием моделей. По умолчанию: ``1d`` (один день)." -#: ../../config.rst:391 +#: ../../config.rst:532 msgid "" "**rest_page_limit** and **page_limit** - Default limit of objects in API " "list. Default: ``1000``." @@ -1115,35 +1379,57 @@ msgstr "" "**rest_page_limit** and **page_limit** - Максимальное количество объектов" " в списке API. По умолчанию: ``1000``." -#: ../../config.rst:392 +#: ../../config.rst:533 msgid "" -"**session_cookie_domain** - The domain to use for session cookies. Read " +"**session_cookie_domain** - The domain to use for session cookies. This " +"setting defines the domain attribute of the session cookie, which " +"determines which domains the cookie is sent to. By setting this, you can " +"allow the session cookie to be shared across subdomains. Read " ":django_docs:`more `. " "Default: ``None``." msgstr "" -"**session_cookie_domain** - Домен, используемый для сессионных cookie. " -":django_docs:`Подробнее `. " -"По умолчанию: ``None``." - -#: ../../config.rst:394 -msgid "" -"**csrf_trusted_origins** - A list of hosts which are trusted origins for " -"unsafe requests. Read :django_docs:`more `. Default: from **session_cookie_domain**." -msgstr "" -"**csrf_trusted_origins** - Список хостов, которым доверяются небезопасные" -" запросы. :django_docs:`Подробнее `. По " -"умолчанию: значение из **session_cookie_domain**." - -#: ../../config.rst:396 -msgid "" -"**case_sensitive_api_filter** - Enables/disables case sensitive search " -"for name filtering. Default: ``True``." +"**session_cookie_domain** - Домен, используемый для сессионных файлов cookie. " +"Эта настройка определяет атрибут домена для сессионного cookie, который " +"определяет, на какие домены будет отправляться cookie. Установив это, вы можете " +"разрешить совместное использование сессионного cookie между поддоменами. Подробнее " +":django_docs:`здесь `. Значение по умолчанию: " +"``None``." + +#: ../../config.rst:537 +msgid "" +"**csrf_trusted_origins** - A list of trusted origins for Cross-Site " +"Request Forgery (CSRF) protection. This setting specifies a list of hosts" +" that are trusted when performing cross-origin POST/PUT/PATCH requests " +"that require CSRF protection. This is necessary when your application " +"needs to accept POST/PUT/PATCH requests from other domains. Read " +":django_docs:`more `. Default: from " +"**session_cookie_domain**." +msgstr "" +"**csrf_trusted_origins** - Список доверенных источников для защиты от межсайтовой подделки " +"запросов (CSRF). Эта настройка определяет список хостов, которым доверяют при выполнении " +"междоменных запросов POST/PUT/PATCH, требующих CSRF-защиты. Это необходимо, когда вашему " +"приложению требуется принимать POST/PUT/PATCH запросы с других доменов. Подробнее " +":django_docs:`здесь `. Значение по умолчанию: от " +"**session_cookie_domain**." + +#: ../../config.rst:541 +msgid "" +"**case_sensitive_api_filter** - Enable or disable case-sensitive search " +"for name filtering in the API. When set to ``true``, filters applied to " +"fields such as ``name`` will be case-sensitive, meaning that the search " +"will distinguish between uppercase and lowercase letters. When set to " +"``false``, the search will be case-insensitive. Adjust this setting based" +" on whether you want users to have case-sensitive searches. Default: " +"``true``." msgstr "" -"**case_sensitive_api_filter** - Включить/отключить чувствительность к " -"регистру при фильтрации по имени. По умолчанию: ``True``." +"**case_sensitive_api_filter** - Включает или отключает чувствительный к регистру поиск " +"для фильтрации по имени в API. При значении ``true`` фильтры, применяемые к таким полям, как " +"``name``, будут чувствительны к регистру, что означает, что поиск будет различать прописные и " +"строчные буквы. При значении ``false`` поиск будет нечувствительным к регистру. Настройте этот " +"параметр в зависимости от того, хотите ли вы, чтобы пользователи выполняли поиск с учетом " +"регистра. Значение по умолчанию: ``true``." -#: ../../config.rst:398 +#: ../../config.rst:547 msgid "" "**secure_proxy_ssl_header_name** - Header name which activates SSL urls " "in responses. Read :django_docs:`more `. По умолчанию: " "``HTTP_X_FORWARDED_PROTOCOL``." -#: ../../config.rst:400 +#: ../../config.rst:549 msgid "" "**secure_proxy_ssl_header_value** - Header value which activates SSL urls" " in responses. Read :django_docs:`more `. По " "умолчанию: ``https``." -#: ../../config.rst:404 +#: ../../config.rst:553 msgid "" "The following variables from Django settings are also supported (with the" " corresponding types):" @@ -1173,70 +1459,70 @@ msgstr "" "Также поддерживаются следующие переменные из настроек Django (с " "соответствующими типами):" -#: ../../config.rst:406 +#: ../../config.rst:555 msgid "" "**secure_browser_xss_filter** - :django_docs:`SECURE_BROWSER_XSS_FILTER " "`" msgstr "" -#: ../../config.rst:407 +#: ../../config.rst:556 msgid "" "**secure_content_type_nosniff** - " ":django_docs:`SECURE_CONTENT_TYPE_NOSNIFF `" msgstr "" -#: ../../config.rst:408 +#: ../../config.rst:557 msgid "" "**secure_hsts_include_subdomains** - " ":django_docs:`SECURE_HSTS_INCLUDE_SUBDOMAINS `" msgstr "" -#: ../../config.rst:409 +#: ../../config.rst:558 msgid "" "**secure_hsts_preload** - :django_docs:`SECURE_HSTS_PRELOAD `" msgstr "" -#: ../../config.rst:410 +#: ../../config.rst:559 msgid "" "**secure_hsts_seconds** - :django_docs:`SECURE_HSTS_SECONDS `" msgstr "" -#: ../../config.rst:411 +#: ../../config.rst:560 msgid "" "**password_reset_timeout_days** - " ":django_docs:`PASSWORD_RESET_TIMEOUT_DAYS `" msgstr "" -#: ../../config.rst:412 +#: ../../config.rst:561 msgid "" "**request_max_size** - :django_docs:`DATA_UPLOAD_MAX_MEMORY_SIZE " "`" msgstr "" -#: ../../config.rst:413 +#: ../../config.rst:562 msgid "" "**x_frame_options** - :django_docs:`X_FRAME_OPTIONS `" msgstr "" -#: ../../config.rst:414 +#: ../../config.rst:563 msgid "" "**use_x_forwarded_host** - :django_docs:`USE_X_FORWARDED_HOST " "`" msgstr "" -#: ../../config.rst:415 +#: ../../config.rst:564 msgid "" "**use_x_forwarded_port** - :django_docs:`USE_X_FORWARDED_PORT " "`" msgstr "" -#: ../../config.rst:417 +#: ../../config.rst:566 msgid "" "The following settings affects prometheus metrics endpoint (which can be " "used for monitoring application):" @@ -1244,15 +1530,15 @@ msgstr "" "Следующие настройки влияют на эндпоинт метрик Prometheus (который может " "использоваться для мониторинга приложения):" -#: ../../config.rst:419 +#: ../../config.rst:568 msgid "" "**metrics_throttle_rate** - Count of requests to ``/api/metrics/`` " -"endpoint. Default: ``120``." +"endpoint per minute. Default: ``120``." msgstr "" -"**metrics_throttle_rate** - Количество запросов к эндпоинту " -"``/api/metrics/``. По умолчанию: ``120``." +"**metrics_throttle_rate** - Количество запросов к конечной точке ``/api/metrics/`` " +"в минуту. Значение по умолчанию: ``120``." -#: ../../config.rst:420 +#: ../../config.rst:569 msgid "" "**enable_metrics** - Enable/disable ``/api/metrics/`` endpoint for app. " "Default: ``true``" @@ -1260,21 +1546,28 @@ msgstr "" "**enable_metrics** - Включить/отключить эндпоинт ``/api/metrics/`` для " "приложения. По умолчанию: ``true``." -#: ../../config.rst:421 +#: ../../config.rst:570 msgid "" -"**metrics_backend** - Python class path with metrics collector backend. " -"Default: ``vstutils.api.metrics.DefaultBackend`` Default backend collects" -" metrics from uwsgi workers and python version info." +"**metrics_backend** - The Python class path of the metrics collector " +"backend. This class is responsible for collecting and providing metrics " +"data for your application. By default, it uses " +"``vstutils.api.metrics.DefaultBackend``, which collects basic metrics " +"like worker status and Python version information. You can specify a " +"custom backend by providing the import path to your own class. Default: " +"``vstutils.api.metrics.DefaultBackend``." msgstr "" -"**metrics_backend** - Путь к классу Python с бэкендом сборщика метрик. По" -" умолчанию: ``vstutils.api.metrics.DefaultBackend``. Стандартный бэкенд " -"собирает метрики из рабочих процессов uwsgi и информацию о версии Python." +"**metrics_backend** - Путь к Python-классу для сбора метрик. Этот класс " +"отвечает за сбор и предоставление данных метрик для вашего приложения. По " +"умолчанию используется ``vstutils.api.metrics.DefaultBackend``, который " +"собирает базовые метрики, такие как статус рабочих процессов и информация о " +"версии Python. Вы можете указать собственный backend, предоставив путь к " +"своему классу. Значение по умолчанию: ``vstutils.api.metrics.DefaultBackend``." -#: ../../config.rst:425 +#: ../../config.rst:576 msgid "Section ``[uvicorn]``." msgstr "Раздел ``[uvicorn]``." -#: ../../config.rst:427 +#: ../../config.rst:578 msgid "" "You can configure the necessary settings to run the uvicorn server. " "``vstutils`` supports almost all options from the cli, except for those " @@ -1284,21 +1577,21 @@ msgstr "" "``vstutils`` поддерживает практически все опции из командной строки, за " "исключением тех, которые настраивают приложение и соединение." -#: ../../config.rst:430 +#: ../../config.rst:581 msgid "See all available uvicorn settings via ``uvicorn --help`` command." msgstr "" "Вы можете посмотреть все доступные настройки uvicorn, введя команду " "``uvicorn --help``" -#: ../../config.rst:435 +#: ../../config.rst:586 msgid "Centrifugo client settings" msgstr "Настройки клиента Centrifugo" -#: ../../config.rst:437 +#: ../../config.rst:588 msgid "Section ``[centrifugo]``." msgstr "Раздел ``[centrifugo]``." -#: ../../config.rst:439 +#: ../../config.rst:590 msgid "" "Centrifugo is employed to optimize real-time data updates within a Django" " application by orchestrating seamless communication among its various " @@ -1342,7 +1635,7 @@ msgstr "" "мгновенное и синхронизированное обновление данных, способствуя " "высококачественному пользовательскому опыту." -#: ../../config.rst:453 +#: ../../config.rst:604 msgid "" "To install app with centrifugo client, ``[centrifugo]`` section must be " "set. Centrifugo is used by application to auto-update page data. When " @@ -1357,27 +1650,27 @@ msgstr "" "первичным ключом. Без этой службы все клиенты GUI получают данные " "страницы каждые 5 секунд (по умолчанию)." -#: ../../config.rst:459 +#: ../../config.rst:610 msgid "**address** - Centrifugo server address." msgstr "**address** - Адрес сервера Centrifugo." -#: ../../config.rst:460 +#: ../../config.rst:611 msgid "**api_key** - API key for clients." msgstr "**api_key** - Ключ API для клиентов." -#: ../../config.rst:461 +#: ../../config.rst:612 msgid "**token_hmac_secret_key** - API key for jwt-token generation." msgstr "**token_hmac_secret_key** - Ключ API для генерации JWT-токена." -#: ../../config.rst:462 +#: ../../config.rst:613 msgid "**timeout** - Connection timeout." msgstr "**timeout** - Таймаут подключения." -#: ../../config.rst:463 +#: ../../config.rst:614 msgid "**verify** - Connection verification." msgstr "**verify** - Проверка подключения." -#: ../../config.rst:464 +#: ../../config.rst:615 msgid "" "**subscriptions_prefix** - Prefix used for generating update channels, by" " default \"{VST_PROJECT}.update\"." @@ -1385,7 +1678,7 @@ msgstr "" "**subscriptions_prefix** - Префикс, используемый для генерации каналов " "обновления, по умолчанию \"{VST_PROJECT}.update\"." -#: ../../config.rst:467 +#: ../../config.rst:618 msgid "" "These settings also add parameters to the OpenAPI schema and change how " "the auto-update system works in the GUI. ``token_hmac_secret_key`` is " @@ -1397,15 +1690,15 @@ msgstr "" "генерации JWT-токена (на основе времени истечения сессии). Токен будет " "использоваться для клиента Centrifugo-JS." -#: ../../config.rst:475 +#: ../../config.rst:626 msgid "Storage settings" msgstr "Настройки хранилища" -#: ../../config.rst:477 +#: ../../config.rst:628 msgid "Section ``[storages]``." msgstr "Раздел ``[storages]``." -#: ../../config.rst:479 +#: ../../config.rst:630 msgid "" "Applications based on ``vstutils`` supports filesystem storage out of " "box. Setup ``media_root`` and ``media_url`` in ``[storages.filesystem]`` " @@ -1418,7 +1711,7 @@ msgstr "" "``media_url`` в разделе [storages.filesystem]. По умолчанию они будут " "равны ``{/path/to/project/module}/media`` и ``/media/``." -#: ../../config.rst:484 +#: ../../config.rst:635 msgid "" "Applications based on ``vstutils`` supports store files in external " "services with `Apache Libcloud `_ and `Boto3" @@ -1429,7 +1722,7 @@ msgstr "" "`_ и `Boto3 " "`_." -#: ../../config.rst:487 +#: ../../config.rst:638 msgid "" "Apache Libcloud settings grouped by sections named " "``[storages.libcloud.provider]``, where ``provider`` is name of storage. " @@ -1446,7 +1739,7 @@ msgstr "" "storages.readthedocs.io/en/latest/backends/apache_libcloud.html#libcloud-" "providers>`_." -#: ../../config.rst:492 +#: ../../config.rst:643 msgid "" "This setting is required to configure connections to cloud storage " "providers. Each entry corresponds to a single ‘bucket’ of storage. You " @@ -1459,7 +1752,7 @@ msgstr "" "(например, несколько buckets S3), и вы можете определить buckets в " "нескольких провайдерах." -#: ../../config.rst:497 +#: ../../config.rst:648 msgid "" "For ``Boto3`` all settings grouped by section named ``[storages.boto3]``." " Section must contain following keys: ``access_key_id``, " @@ -1474,7 +1767,7 @@ msgstr "" "amazon-S3 `_." -#: ../../config.rst:502 +#: ../../config.rst:653 msgid "" "Storage has following priority to choose storage engine if multiple was " "provided:" @@ -1482,19 +1775,19 @@ msgstr "" "При выборе движка хранилища используется следующий приоритет, если их " "было предоставлено несколько:" -#: ../../config.rst:504 +#: ../../config.rst:655 msgid "Libcloud store when config contains this section." msgstr "Хранилище Libcloud, когда конфигурация содержит этот раздел." -#: ../../config.rst:506 +#: ../../config.rst:657 msgid "Boto3 store, when you have section and has all required keys." msgstr "Хранилище Boto3, когда у вас есть раздел и имеются все необходимые ключи." -#: ../../config.rst:508 +#: ../../config.rst:659 msgid "FileSystem store otherwise." msgstr "В противном случае хранилище FileSystem." -#: ../../config.rst:510 +#: ../../config.rst:661 msgid "" "Once you have defined your Libcloud providers, you have an option of " "setting one provider as the default provider of Libcloud storage. You can" @@ -1507,7 +1800,7 @@ msgstr "" "``[storages.libcloud.default]`` или же vstutils установит первое " "хранилище, как хранилище по умолчанию." -#: ../../config.rst:515 +#: ../../config.rst:666 msgid "" "If you configure default libcloud provider, vstutils will use it as " "global file storage. To override it set " @@ -1528,7 +1821,7 @@ msgstr "" "``default=storages.backends.apache_libcloud.LibCloudStorage`` в разделе " "``[storages]`` и используйте провайдера Libcloud, как по умолчанию." -#: ../../config.rst:523 +#: ../../config.rst:674 msgid "" "Here is example for boto3 connection to minio cluster with public read " "permissions, external proxy domain and internal connection support:" @@ -1536,15 +1829,15 @@ msgstr "" "Вот пример подключения boto3 к кластеру minio с публичными правами на " "чтение, внешним доменом прокси и поддержкой внутреннего подключения:" -#: ../../config.rst:552 +#: ../../config.rst:703 msgid "Throttle settings" msgstr "Настройки Throttle" -#: ../../config.rst:554 +#: ../../config.rst:705 msgid "Section ``[throttle]``." msgstr "Раздел ``[throttle]``." -#: ../../config.rst:556 +#: ../../config.rst:707 msgid "" "By including this section to your config, you can setup global and per-" "view throttle rates. Global throttle rates are specified under root " @@ -1557,13 +1850,13 @@ msgstr "" "индивидуальные throttle rates для конкретного View, вам нужно добавить " "дочернюю секцию." -#: ../../config.rst:560 +#: ../../config.rst:711 msgid "For example, if you want to apply throttle to ``api/v1/author``:" msgstr "" "Например, если вы хотите применить ограничение количества запросов для " "``api/v1/author``:" -#: ../../config.rst:568 +#: ../../config.rst:719 msgid "" "**rate** - Throttle rate in format number_of_requests/time_period. " "Expected time_periods: second/minute/hour/day." @@ -1572,7 +1865,7 @@ msgstr "" "number_of_requests/time_period. Expected time_periods: " "second/minute/hour/day." -#: ../../config.rst:569 +#: ../../config.rst:720 msgid "" "**actions** - Comma separated list of drf actions. Throttle will be " "applied only on specified here actions. Default: update, partial_update." @@ -1581,7 +1874,7 @@ msgstr "" "количества запросов будет применяться только к указанным здесь действиям." " По умолчанию: update, partial_update." -#: ../../config.rst:571 +#: ../../config.rst:722 msgid "" "More on throttling at `DRF Throttle docs `_." @@ -1589,15 +1882,15 @@ msgstr "" "Подробнее об ограничении количества запросов в `документации DRF Throttle" " `_." -#: ../../config.rst:577 +#: ../../config.rst:728 msgid "Web Push settings" msgstr "Настройки веб-уведомлений" -#: ../../config.rst:579 +#: ../../config.rst:730 msgid "Section ``[webpuwsh]``." msgstr "Раздел ``[webpuwsh]``." -#: ../../config.rst:581 +#: ../../config.rst:732 msgid "" "**enabled**: A boolean flag that enables or disables web push " "notifications. Set to `true` to activate web push notifications, and " @@ -1612,7 +1905,7 @@ msgstr "" "пользователя будут скрыты, и метод `send` класса уведомлений ничего не " "будет делать." -#: ../../config.rst:583 +#: ../../config.rst:734 msgid "" "**vapid_private_key**, **vapid_public_key**: These are the application " "server keys used for sending push notifications. The VAPID (Voluntary " @@ -1633,7 +1926,7 @@ msgstr "" "notifications-" "subscribing-a-user#how_to_create_application_server_keys>`_." -#: ../../config.rst:585 +#: ../../config.rst:736 msgid "" "**vapid_admin_email**: This setting specifies the email address of the " "administrator or the person responsible for the server. It is a contact " @@ -1645,7 +1938,7 @@ msgstr "" "службы push, чтобы связаться в случае каких-либо проблем или нарушений " "политики." -#: ../../config.rst:587 +#: ../../config.rst:738 msgid "" "**default_notification_icon**: URL of the default icon image to be used " "for web push notifications, to avoid confusion absolute URL is preferred." @@ -1662,7 +1955,7 @@ msgstr "" "`_." -#: ../../config.rst:589 +#: ../../config.rst:740 msgid "" "For more detailed guidance on using and implementing web push " "notifications in VSTUtils, refer to the Web Push manual provided " @@ -1672,7 +1965,7 @@ msgstr "" "веб-уведомлений в VSTUtils смотрите руководство по веб-уведомлениям, " ":ref:`here`." -#: ../../config.rst:591 +#: ../../config.rst:742 msgid "" "Remember, these settings are crucial for the proper functioning and " "reliability of web push notifications in your application. Ensure that " @@ -1682,23 +1975,23 @@ msgstr "" "надежности веб-уведомлений в вашем приложении. Убедитесь, что они " "настроены правильно для оптимальной производительности." -#: ../../config.rst:595 +#: ../../config.rst:746 msgid "OAuth 2 settings" msgstr "Настройки OAuth 2" -#: ../../config.rst:597 +#: ../../config.rst:748 msgid "Section ``[oauth]``." msgstr "Раздел ``[oauth]``." -#: ../../config.rst:599 ../../config.rst:604 +#: ../../config.rst:750 ../../config.rst:755 msgid "For custom OAuth2 server use the following settings:" msgstr "Для пользовательского сервера OAuth2 используйте следующие настройки:" -#: ../../config.rst:601 +#: ../../config.rst:752 msgid "**server_url**: URL of OAuth2 server." msgstr "**server_url**: URL сервера OAuth2." -#: ../../config.rst:602 +#: ../../config.rst:753 msgid "" "**server_token_endpoint_path**: Path of OAuth2 server token endpoint " "(used in swagger schema). If not provided, `/{API_URL}/oauth2/token/` " @@ -1708,17 +2001,17 @@ msgstr "" "сервера OAuth2 (используется в схеме swagger). Если не указано, будет " "использоваться `/{API_URL}/oauth2/token/`." -#: ../../config.rst:606 +#: ../../config.rst:757 msgid "**server_enable**: Enable or disable OAuth2 server. Default: `True`." msgstr "" "**server_enable**: Включить или отключить сервер OAuth2. По умолчанию: " "`True`." -#: ../../config.rst:607 +#: ../../config.rst:758 msgid "**server_issuer**: Issuer for JWT tokens. Must be provided." msgstr "**server_issuer**: Эмитент для JWT токенов. Должен быть указан." -#: ../../config.rst:608 +#: ../../config.rst:759 msgid "" "**server_jwt_key**: JWT key. Octet sequence (used to represent symmetric " "keys). Must be provided." @@ -1726,11 +2019,11 @@ msgstr "" "**server_jwt_key**: Ключ JWT. Последовательность октетов (используется " "для представления симметричных ключей). Должен быть указан." -#: ../../config.rst:609 +#: ../../config.rst:760 msgid "**server_jwt_alg**: JWT algorithm. Default: `HS256`." msgstr "**server_jwt_alg**: Алгоритм JWT. По умолчанию: `HS256`." -#: ../../config.rst:610 +#: ../../config.rst:761 msgid "" "**server_class**: Import path to OAuth2 server class. See `authlib docs " "`_" @@ -1743,7 +2036,7 @@ msgstr "" " для получения дополнительной информации. По умолчанию: " "`vstutils.oauth2.authorization_server.AuthorizationServer`." -#: ../../config.rst:611 +#: ../../config.rst:762 msgid "" "**server_enable_anon_login**: Enable or disable anonymous login using " "empty strings as username and password. Default: `False`." @@ -1752,7 +2045,7 @@ msgstr "" "используя пустые строки в качестве имени пользователя и пароля. По " "умолчанию: `False`." -#: ../../config.rst:612 +#: ../../config.rst:763 msgid "" "**server_jwt_extra_claims_provider**: Import path to function that " "receives user and returns extra claims for JWT token. Default: `None`." @@ -1761,7 +2054,7 @@ msgstr "" "принимает пользователя и возвращает дополнительные утверждения для JWT " "токена. По умолчанию: `None`." -#: ../../config.rst:613 +#: ../../config.rst:764 msgid "" "**server_allow_insecure**: If enabled then server will allow HTTP " "requests. Default: `False`." @@ -1769,7 +2062,7 @@ msgstr "" "**server_allow_insecure**: Если включено, сервер будет разрешать HTTP " "запросы. По умолчанию: `False`." -#: ../../config.rst:614 +#: ../../config.rst:765 msgid "" "**server_token_expires_in**: Token expiration time in seconds. Duration " "values can be used, for example `3d2h32m`. Default: `864000`." @@ -1778,7 +2071,7 @@ msgstr "" "использовать значения продолжительности, например `3d2h32m`. По " "умолчанию: `864000`." -#: ../../config.rst:615 +#: ../../config.rst:766 msgid "" "**server_client_authentication_methods**: List of client authentication " "methods. Default server supports following values `'client_secret_basic'," @@ -1790,7 +2083,7 @@ msgstr "" "`'client_secret_basic', 'client_secret_post', 'none'`. По умолчанию: " "`['client_secret_basic', 'client_secret_post']`." -#: ../../config.rst:616 +#: ../../config.rst:767 msgid "" "**server_authorization_endpoint**: Url of OAuth 2 Authorization endpoint." " Will appear in output of `/.well-known/oauth-authorization-server` and " @@ -1800,7 +2093,7 @@ msgstr "" "2. Появится в выводе `/.well-known/oauth-authorization-server` и `/.well-" "known/openid-configuration` точек обнаружения." -#: ../../config.rst:618 +#: ../../config.rst:769 msgid "" "By default one client can be configured using **server_simple_client_id**" " and **server_simple_client_secret**. Any other clients can be configured" @@ -1813,15 +2106,15 @@ msgstr "" "**OAUTH_SERVER_CLIENTS** в `settings.py`, где ключ - это `client_id`, а " "значение - `client_secret`." -#: ../../config.rst:622 +#: ../../config.rst:773 msgid "Production web settings" msgstr "Настройки для продакшн-сервера" -#: ../../config.rst:624 +#: ../../config.rst:775 msgid "Section ``[uwsgi]``." msgstr "Раздел ``[uwsgi]``." -#: ../../config.rst:626 +#: ../../config.rst:777 msgid "" "Settings related to web-server used by vstutils-based application in " "production (for deb and rpm packages by default). Most of them related to" @@ -1834,7 +2127,7 @@ msgstr "" "т. д.). Дополнительные настройки смотрите в `документации uWSGI. `_." -#: ../../config.rst:632 +#: ../../config.rst:783 msgid "" "But keep in mind that uWSGI is deprecated and may be removed in future " "releases. Use the uvicorn settings to manage your app server." @@ -1843,15 +2136,15 @@ msgstr "" "версиях. Используйте настройки uvicorn для управления сервером вашего " "приложения." -#: ../../config.rst:637 +#: ../../config.rst:788 msgid "Working behind the proxy server with TLS" msgstr "Работа за прокси-сервером с поддержкой TLS" -#: ../../config.rst:640 +#: ../../config.rst:791 msgid "Nginx" msgstr "Nginx" -#: ../../config.rst:642 +#: ../../config.rst:793 msgid "" "To configure vstutils for operation behind Nginx with TLS, follow these " "steps:" @@ -1859,11 +2152,11 @@ msgstr "" "Чтобы настроить vstutils для работы через Nginx с поддержкой TLS, " "выполните следующие шаги:" -#: ../../config.rst:644 +#: ../../config.rst:795 msgid "**Install Nginx:**" msgstr "**Установка Nginx:**" -#: ../../config.rst:646 +#: ../../config.rst:797 msgid "" "Ensure that Nginx is installed on your server. You can install it using " "the package manager specific to your operating system." @@ -1872,11 +2165,11 @@ msgstr "" "его с помощью менеджера пакетов, специфичного для вашей операционной " "системы." -#: ../../config.rst:648 +#: ../../config.rst:799 msgid "**Configure Nginx:**" msgstr "**Настройка Nginx:**" -#: ../../config.rst:650 +#: ../../config.rst:801 msgid "" "Create an Nginx configuration file for your vstutils application. Below " "is a basic example of an Nginx configuration. Adjust the values based on " @@ -1886,7 +2179,7 @@ msgstr "" "приведен базовый пример конфигурации Nginx. Измените значения в " "соответствии с вашей конкретной настройкой." -#: ../../config.rst:689 +#: ../../config.rst:840 msgid "" "Replace ``your_domain.com`` with your actual domain, and update the paths" " for SSL certificates." @@ -1894,11 +2187,11 @@ msgstr "" "Замените ``your_domain.com`` на ваш реальный домен и обновите пути к " "SSL-сертификатам." -#: ../../config.rst:691 ../../config.rst:774 ../../config.rst:826 +#: ../../config.rst:842 ../../config.rst:926 ../../config.rst:979 msgid "**Update vstutils settings:**" msgstr "**Обновление настроек vstutils:**" -#: ../../config.rst:693 ../../config.rst:776 ../../config.rst:828 +#: ../../config.rst:844 ../../config.rst:928 ../../config.rst:981 msgid "" "Ensure that your vstutils settings have the correct configurations for " "HTTPS. In your ``/etc/vstutils/settings.ini`` (or project " @@ -1908,21 +2201,21 @@ msgstr "" "HTTPS. В вашем ``/etc/vstutils/settings.ini`` (или в проекте " "``settings.ini``):" -#: ../../config.rst:701 +#: ../../config.rst:852 msgid "This ensures that vstutils recognizes the HTTPS connection." msgstr "Это гарантирует, что vstutils распознает соединение по протоколу HTTPS." -#: ../../config.rst:703 +#: ../../config.rst:854 msgid "**Restart Nginx:**" msgstr "**Перезапустите Nginx:**" -#: ../../config.rst:705 +#: ../../config.rst:856 msgid "After making these changes, restart Nginx to apply the new configurations:" msgstr "" "После внесения этих изменений перезапустите Nginx, чтобы применить новые " "конфигурации:" -#: ../../config.rst:711 +#: ../../config.rst:862 msgid "" "Now, your vstutils application should be accessible via HTTPS through " "Nginx. Adjust these instructions based on your specific environment and " @@ -1932,11 +2225,11 @@ msgstr "" "Nginx. Измените эти инструкции в зависимости от вашего конкретного " "окружения и требований к безопасности." -#: ../../config.rst:715 +#: ../../config.rst:866 msgid "Traefik" msgstr "Traefik" -#: ../../config.rst:717 +#: ../../config.rst:868 msgid "" "To configure vstutils for operation behind Traefik with TLS, follow these" " steps:" @@ -1944,11 +2237,11 @@ msgstr "" "Чтобы настроить vstutils для работы через Traefik с поддержкой TLS, " "выполните следующие шаги:" -#: ../../config.rst:719 +#: ../../config.rst:870 msgid "**Install Traefik:**" msgstr "**Установка Traefik:**" -#: ../../config.rst:721 +#: ../../config.rst:872 msgid "" "Ensure that Traefik is installed on your server. You can download the " "binary from the official website or use a package manager specific to " @@ -1958,11 +2251,11 @@ msgstr "" "двоичный файл с официального сайта или использовать менеджер пакетов, " "специфичный для вашей операционной системы." -#: ../../config.rst:723 +#: ../../config.rst:874 msgid "**Configure Traefik:**" msgstr "**Настройка Traefik:**" -#: ../../config.rst:725 +#: ../../config.rst:876 msgid "" "Create a Traefik configuration file ``/path/to/traefik.toml``. Here's a " "basic example:" @@ -1970,29 +2263,29 @@ msgstr "" "Создайте файл конфигурации Traefik ``/path/to/traefik.toml``. Вот базовый" " пример:" -#: ../../config.rst:747 +#: ../../config.rst:899 msgid "**Create Traefik Toml Configuration:**" msgstr "**Создайте конфигурацию Traefik Toml:**" -#: ../../config.rst:749 +#: ../../config.rst:901 msgid "" "Create the ``/path/to/traefik_config.toml`` file with the following " "content:" msgstr "Создайте файл ``/path/to/traefik_config.toml`` с следующим содержимым:" -#: ../../config.rst:772 +#: ../../config.rst:924 msgid "Make sure to replace ``your_domain.com`` with your actual domain." msgstr "Обязательно замените ``your_domain.com`` на ваш реальный домен." -#: ../../config.rst:783 +#: ../../config.rst:936 msgid "**Start Traefik:**" msgstr "**Запустите Traefik:**" -#: ../../config.rst:785 +#: ../../config.rst:938 msgid "Start Traefik with the following command:" msgstr "Запустите Traefik следующей командой:" -#: ../../config.rst:791 +#: ../../config.rst:944 msgid "" "Now, your vstutils application should be accessible via HTTPS through " "Traefik. Adjust these instructions based on your specific environment and" @@ -2002,15 +2295,15 @@ msgstr "" "Traefik. Измените эти инструкции в зависимости от вашего конкретного " "окружения и требований." -#: ../../config.rst:795 +#: ../../config.rst:948 msgid "HAProxy" msgstr "HAProxy" -#: ../../config.rst:797 +#: ../../config.rst:950 msgid "**Install HAProxy:**" msgstr "**Установка HAProxy:**" -#: ../../config.rst:799 +#: ../../config.rst:952 msgid "" "Ensure that HAProxy is installed on your server. You can install it using" " the package manager specific to your operating system." @@ -2019,11 +2312,11 @@ msgstr "" "его с помощью менеджера пакетов, специфичного для вашей операционной " "системы." -#: ../../config.rst:801 +#: ../../config.rst:954 msgid "**Configure HAProxy:**" msgstr "**Настройка HAProxy:**" -#: ../../config.rst:803 +#: ../../config.rst:956 msgid "" "Create an HAProxy configuration file for your vstutils application. Below" " is a basic example of an HAProxy configuration. Adjust the values based " @@ -2033,7 +2326,7 @@ msgstr "" "базовый пример конфигурации HAProxy. Измените значения в соответствии с " "вашей конкретной настройкой." -#: ../../config.rst:824 +#: ../../config.rst:977 msgid "" "Replace ``your_domain.com`` with your actual domain and update the paths " "for SSL certificates." @@ -2041,11 +2334,11 @@ msgstr "" "Замените ``your_domain.com`` на ваш реальный домен и обновите пути к " "SSL-сертификатам." -#: ../../config.rst:835 +#: ../../config.rst:989 msgid "**Restart HAProxy:**" msgstr "**Перезапуск HAProxy:**" -#: ../../config.rst:837 +#: ../../config.rst:991 msgid "" "After making these changes, restart HAProxy to apply the new " "configurations:" @@ -2053,7 +2346,7 @@ msgstr "" "После внесения этих изменений перезапустите HAProxy, чтобы применить " "новые конфигурации." -#: ../../config.rst:843 +#: ../../config.rst:997 msgid "" "Now, your vstutils application should be accessible via HTTPS through " "HAProxy. Adjust these instructions based on your specific environment and" @@ -2063,11 +2356,11 @@ msgstr "" "HAProxy. Измените эти инструкции в зависимости от вашего конкретного " "окружения и требований к безопасности." -#: ../../config.rst:847 +#: ../../config.rst:1001 msgid "Configuration options" msgstr "Параметры конфигурации" -#: ../../config.rst:849 +#: ../../config.rst:1003 msgid "" "This section contains additional information for configure additional " "elements." @@ -2075,7 +2368,7 @@ msgstr "" "В этом разделе содержится дополнительная информация для настройки " "дополнительных элементов." -#: ../../config.rst:851 +#: ../../config.rst:1005 msgid "" "If you need set ``https`` for your web settings, you can do it using " "HAProxy, Nginx, Traefik or configure it in ``settings.ini``." @@ -2084,7 +2377,7 @@ msgstr "" " сделать это с помощью HAProxy, Nginx, Traefik или настроить в файле " "``settings.ini``." -#: ../../config.rst:863 +#: ../../config.rst:1017 msgid "" "We strictly do not recommend running the web server from root. Use HTTP " "proxy to run on privileged ports." @@ -2092,15 +2385,15 @@ msgstr "" "Мы настоятельно не рекомендуем запускать веб-сервер от имени root. " "Используйте HTTP-прокси, чтобы работать на привилегированных портах." -#: ../../config.rst:865 +#: ../../config.rst:1019 msgid "" -"You can use `{ENV[HOME:-value]}` (where `HOME` is environment variable, " -"`value` is default value) in configuration values." +"You can use ``{ENV[HOME:-value]}`` (where ``HOME`` is environment variable, " +"``value`` is default value) in configuration values." msgstr "" -"Вы можете использовать `{ENV[HOME:-value]}` (где `HOME` - переменная " -"окружения, `value` - значение по умолчанию) в значениях конфигурации." +"Вы можете использовать ``{ENV[HOME:-value]}`` (где ``HOME`` - переменная " +"окружения, ``value`` - значение по умолчанию) в значениях конфигурации." -#: ../../config.rst:868 +#: ../../config.rst:1022 msgid "" "You can use environment variables for setup important settings. But " "config variables has more priority then env. Available settings are: " @@ -2113,15 +2406,15 @@ msgstr "" "``DJANGO_LOG_LEVEL``, ``TIMEZONE`` и некоторые настройки с префиксом " "``[ENV_NAME]``." -#: ../../config.rst:871 +#: ../../config.rst:1025 msgid "" "For project without special settings and project levels named ``project``" " these variables will start with ``PROJECT_`` prefix. There is a list of " "these variables: ``{ENV_NAME}_ENABLE_ADMIN_PANEL``, " "``{ENV_NAME}_ENABLE_REGISTRATION``, ``{ENV_NAME}_MAX_TFA_ATTEMPTS``, " "``{ENV_NAME}_ETAG_TIMEOUT``, ``{ENV_NAME}_SEND_CONFIRMATION_EMAIL``, " -"``{ENV_NAME}_SEND_EMAIL_RETRIES``, ``{ENV_NAME}_SEND_EMAIL_RETRY_DELAY``," -" ``{ENV_NAME}_MEDIA_ROOT`` (dir with uploads), " +"``{ENV_NAME}_SEND_EMAIL_RETRIES``, ``{ENV_NAME}_SEND_EMAIL_RETRY_DELAY``, " +"``{ENV_NAME}_MEDIA_ROOT`` (dir with uploads), " "``{ENV_NAME}_GLOBAL_THROTTLE_RATE``, and " "``{ENV_NAME}_GLOBAL_THROTTLE_ACTIONS``." msgstr "" @@ -2130,12 +2423,12 @@ msgstr "" "список этих переменных: ``{ENV_NAME}_ENABLE_ADMIN_PANEL``, " "``{ENV_NAME}_ENABLE_REGISTRATION``, ``{ENV_NAME}_MAX_TFA_ATTEMPTS``, " "``{ENV_NAME}_ETAG_TIMEOUT``, ``{ENV_NAME}_SEND_CONFIRMATION_EMAIL``, " -"``{ENV_NAME}_SEND_EMAIL_RETRIES``, ``{ENV_NAME}_SEND_EMAIL_RETRY_DELAY``," -"``{ENV_NAME}_MEDIA_ROOT`` (директория с загрузками), " -"``{ENV_NAME}_GLOBAL_THROTTLE_RATE``, и " +"``{ENV_NAME}_SEND_EMAIL_RETRIES``, " +"``{ENV_NAME}_SEND_EMAIL_RETRY_DELAY``, ``{ENV_NAME}_MEDIA_ROOT`` " +"(директория с загрузками), ``{ENV_NAME}_GLOBAL_THROTTLE_RATE``, и " "``{ENV_NAME}_GLOBAL_THROTTLE_ACTIONS``." -#: ../../config.rst:878 +#: ../../config.rst:1032 msgid "" "There are also URI-specific variables for connecting to various services " "such as databases and caches. There are ``DATABASE_URL``, ``CACHE_URL``, " @@ -2149,7 +2442,7 @@ msgstr "" "``SESSIONS_CACHE_URL`` и ``ETAG_CACHE_URL``. Как видно из названий, они " "тесно связаны с ключами и именами соответствующих секций конфигурации." -#: ../../config.rst:882 +#: ../../config.rst:1036 msgid "" "We recommend to install ``uvloop`` to your environment and setup ``loop =" " uvloop`` in ``[uvicorn]`` section for performance reasons." @@ -2157,7 +2450,7 @@ msgstr "" "Мы рекомендуем установить ``uvloop`` в ваше окружение и настроить ``loop " "= uvloop`` в разделе ``[uvicorn]`` для повышения производительности." -#: ../../config.rst:884 +#: ../../config.rst:1038 msgid "" "In the context of vstutils, the adoption of ``uvloop`` is paramount for " "optimizing the performance of the application, especially because " @@ -2175,7 +2468,7 @@ msgstr "" "библиотеки высокопроизводительного цикла событий, и специально разработан" " для оптимизации скорости выполнения асинхронного кода." -#: ../../config.rst:888 +#: ../../config.rst:1042 msgid "" "By leveraging ``uvloop``, developers can achieve substantial performance " "improvements in terms of reduced latency and increased throughput. This " @@ -2190,4 +2483,3 @@ msgstr "" "большое количество одновременных подключений. Улучшенная эффективность " "обработки цикла событий напрямую переводится в более быстрое время ответа" " и лучшую общую отзывчивость приложения." - diff --git a/yarn.lock b/yarn.lock index b7a9829f..411112ea 100644 --- a/yarn.lock +++ b/yarn.lock @@ -5214,9 +5214,9 @@ universalify@^2.0.0: integrity sha512-hAZsKq7Yy11Zu1DE0OzWjw7nnLZmJZYTDZZyEFHZdUhV8FkH5MCfoU1XMaxXovpyW5nq5scPqq0ZDP9Zyl04oQ== uplot@^1.6.15: - version "1.6.30" - resolved "https://registry.yarnpkg.com/uplot/-/uplot-1.6.30.tgz#1622a96b7cb2e50622c74330823c321847cbc147" - integrity sha512-48oVVRALM/128ttW19F2a2xobc2WfGdJ0VJFX00099CfqbCTuML7L2OrTKxNzeFP34eo1+yJbqFSoFAp2u28/Q== + version "1.6.31" + resolved "https://registry.yarnpkg.com/uplot/-/uplot-1.6.31.tgz#092a4b586590e9794b679e1df885a15584b03698" + integrity sha512-sQZqSwVCbJGnFB4IQjQYopzj5CoTZJ4Br1fG/xdONimqgHmsacvCjNesdGDypNKFbrhLGIeshYhy89FxPF+H+w== uri-js@^4.2.2, uri-js@^4.4.1: version "4.4.1"