bn-quik 0.2.1__tar.gz → 1.0.0__tar.gz

bn_quik-1.0.0/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: bn_quik
+Version: 1.0.0
+Summary: Backtrader-next connector for QUIK terminal
+Project-URL: Homepage, https://github.com/Alex-Shur/bn_quik
+Project-URL: Source, https://github.com/Alex-Shur/bn_quik
+Author: LEX
+License: GPL-3.0-or-later
+License-File: LICENSE
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.11
+Requires-Dist: backtrader-next>=2.3.2
+Requires-Dist: pytz
+Requires-Dist: quik-python>=1.2.0
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# bn_quik  
+
+[![PyPi Release](https://img.shields.io/pypi/v/bn_quik?color=32a852&label=PyPi)](https://pypi.org/project/bn_quik/)
+[![Total downloads](https://img.shields.io/pepy/dt/bn_quik?label=%E2%88%91&color=skyblue)](https://pypistats.org/packages/bn_quik)
+[![Made with Python](https://img.shields.io/badge/Python-3.11+-c7a002?logo=python&logoColor=white)](https://python.org "Go to Python homepage")
+[![License](https://img.shields.io/github/license/Alex-Shur/bn_quik?color=9c2400)](https://github.com/Alex-Shur/bn_quik/blob/master/LICENSE)
+</div>
+
+Интеграция [Backtrader-Next](https://github.com/smalinin/backtrader_next) с торговым терминалом QUIK для реальной торговли
+
+
+Установка
+================
+Внимание для работы **bn_quik** необходимо в торговом терминале QUIK установить и запустить Lua коннектор.
+```
+pip install bn_quik
+```
+
+Параметры объектов
+================
+
+#### QuikStore
+|Параметр| Значение по умолчанию | Обязательный |  |
+|---|---|---|---|
+|trade_account_id|  | Да | Торговый счет
+|client_code_for_orders| | Да(для Finam) | Номер торгового терминала. У брокера Финам требуется для совершения торговых операций|
+|host| "127.0.0.1"|  | Host с Quik Lua коннектором|
+|port| 34130 |  | |
+|lots| True | | # Входящий остаток в лотах (задается брокером)
+|limit_kind| 1 | | Основной режим торгов T1 (Для Demo Quik -1)
+|currency| "SUR" | |  Валюта |
+|futures_firm_id| "SPBFUT"| | Идентификатор фирмы для фьючерсов|
+|edp| False| | Единая денежная позиция
+|slippage_steps| 10 |  | Кол-во шагов цены для проскальзывания, для рыночных ордеров
+|data_dir| "DataQuik" | |  Каталог для хранения данных, свечные данные тикеров и состояние объекта Broker с ордерами
+----
+
+#### QuikData
+|Параметр| Значение по умолчанию | Обязательный |  |
+|---|---|---|---|
+|drop_price_doji| True | |  False - не пропускать дожи 4-х цен, True - пропускать
+|live_bars| False | | False - только история, True - история и новые бары
+|count| 2000 | | Количество запрашиваемых исторических баров по умолчанию
+
+Как получить Demo доступ к Quik
+================
+Демо доступ можно получить на сервере [ARQA](https://arqatech.com/ru/support/demo/)
+
+Примеры использования коннектора 
+================
+Все примеры находятся в папке **examples**
+
+Использование Lua коннектора
+================
+Cкопировать содержимое папки **lua** c [GIT репозитария](https://github.com/Alex-Shur/bn_quik) 
+в отдельную папку, которая будет доступна приложению QUIK.
+
+> ***ВНИМАНИЕ** Для корректной работы с получением свечных данных используйте обновлённые Lua скрипты из [QUIK Python](https://github.com/Alex-Shur/quik_python) 
+или [bn_quik](https://github.com/Alex-Shur/bn_quik)
+Данные Lua скрипты будут также корректно работать и с QUIKSharp клиентами.*
+
+В терминале QUIK, через диалоговое окно работы со скриптами Lua, запустить "QuikSharp.lua" из скопированной ранее папки. [Подробнее о Lua скриптах](lua/USAGE.RU.md).
+
+В случае возникновения проблем с работоспособностью демонстрационных приложений убедитесь что:
+1. Терминал QUIK загружен и подключен к сереверу.
+2. Скрипт QuikSharp.lua запущен и не выдает никаких ошибок в соответствующем диалоговом окне.
+3. Никакие сторонние программы не используют для своих нужд порты 34130 и 34131. 
+    Данные порты используются по умолчанию для связи библиотеки с терминалом.
+4. Проверьте настройки что соединения не блокируются в Windows Firewall. 

bn_quik-1.0.0/README.md

@@ -0,0 +1,71 @@
+<div align="center">
+
+# bn_quik  
+
+[![PyPi Release](https://img.shields.io/pypi/v/bn_quik?color=32a852&label=PyPi)](https://pypi.org/project/bn_quik/)
+[![Total downloads](https://img.shields.io/pepy/dt/bn_quik?label=%E2%88%91&color=skyblue)](https://pypistats.org/packages/bn_quik)
+[![Made with Python](https://img.shields.io/badge/Python-3.11+-c7a002?logo=python&logoColor=white)](https://python.org "Go to Python homepage")
+[![License](https://img.shields.io/github/license/Alex-Shur/bn_quik?color=9c2400)](https://github.com/Alex-Shur/bn_quik/blob/master/LICENSE)
+</div>
+
+Интеграция [Backtrader-Next](https://github.com/smalinin/backtrader_next) с торговым терминалом QUIK для реальной торговли
+
+
+Установка
+================
+Внимание для работы **bn_quik** необходимо в торговом терминале QUIK установить и запустить Lua коннектор.
+```
+pip install bn_quik
+```
+
+Параметры объектов
+================
+
+#### QuikStore
+|Параметр| Значение по умолчанию | Обязательный |  |
+|---|---|---|---|
+|trade_account_id|  | Да | Торговый счет
+|client_code_for_orders| | Да(для Finam) | Номер торгового терминала. У брокера Финам требуется для совершения торговых операций|
+|host| "127.0.0.1"|  | Host с Quik Lua коннектором|
+|port| 34130 |  | |
+|lots| True | | # Входящий остаток в лотах (задается брокером)
+|limit_kind| 1 | | Основной режим торгов T1 (Для Demo Quik -1)
+|currency| "SUR" | |  Валюта |
+|futures_firm_id| "SPBFUT"| | Идентификатор фирмы для фьючерсов|
+|edp| False| | Единая денежная позиция
+|slippage_steps| 10 |  | Кол-во шагов цены для проскальзывания, для рыночных ордеров
+|data_dir| "DataQuik" | |  Каталог для хранения данных, свечные данные тикеров и состояние объекта Broker с ордерами
+----
+
+#### QuikData
+|Параметр| Значение по умолчанию | Обязательный |  |
+|---|---|---|---|
+|drop_price_doji| True | |  False - не пропускать дожи 4-х цен, True - пропускать
+|live_bars| False | | False - только история, True - история и новые бары
+|count| 2000 | | Количество запрашиваемых исторических баров по умолчанию
+
+Как получить Demo доступ к Quik
+================
+Демо доступ можно получить на сервере [ARQA](https://arqatech.com/ru/support/demo/)
+
+Примеры использования коннектора 
+================
+Все примеры находятся в папке **examples**
+
+Использование Lua коннектора
+================
+Cкопировать содержимое папки **lua** c [GIT репозитария](https://github.com/Alex-Shur/bn_quik) 
+в отдельную папку, которая будет доступна приложению QUIK.
+
+> ***ВНИМАНИЕ** Для корректной работы с получением свечных данных используйте обновлённые Lua скрипты из [QUIK Python](https://github.com/Alex-Shur/quik_python) 
+или [bn_quik](https://github.com/Alex-Shur/bn_quik)
+Данные Lua скрипты будут также корректно работать и с QUIKSharp клиентами.*
+
+В терминале QUIK, через диалоговое окно работы со скриптами Lua, запустить "QuikSharp.lua" из скопированной ранее папки. [Подробнее о Lua скриптах](lua/USAGE.RU.md).
+
+В случае возникновения проблем с работоспособностью демонстрационных приложений убедитесь что:
+1. Терминал QUIK загружен и подключен к сереверу.
+2. Скрипт QuikSharp.lua запущен и не выдает никаких ошибок в соответствующем диалоговом окне.
+3. Никакие сторонние программы не используют для своих нужд порты 34130 и 34131. 
+    Данные порты используются по умолчанию для связи библиотеки с терминалом.
+4. Проверьте настройки что соединения не блокируются в Windows Firewall. 

{bn_quik-0.2.1 → bn_quik-1.0.0}/bn_quik/QuikData.py

@@ -26,7 +26,7 @@ class MetaQuikData(AbstractDataBase.__class__):
 class QuikData(with_metaclass(MetaQuikData, AbstractDataBase)):
     """Данные QUIK"""
     params = (
-        ('drop_price_doji', False),  # False - не пропускать дожи 4-х цен, True - пропускать
+        ('drop_price_doji', False),  # True - удалять дожи 4-х цен, False - пропускать
         ('live_bars', False),  # False - только история, True - история и новые бары
         ('count', 2000),
     )
@@ -43,7 +43,6 @@ class QuikData(with_metaclass(MetaQuikData, AbstractDataBase)):
     def __init__(self, **kwargs):
         self.store = QuikStore(**kwargs)  # Хранилище QUIK
         self.class_code, self.sec_code = QuikStore.run_sync(self.store.parse_ticker_name(self.p.dataname))
-        # tf = self.store._bt_timeframe_to_str(self.p.timeframe, self.p.compression)
         self.candle_interval = self.store._bt_timeframe_2_quik(self.p.timeframe, self.p.compression)
         self._data_id = self.store._get_data_id(self.class_code, self.sec_code, self.candle_interval)
         self.logger = logging.getLogger(f'QuikData.{self._data_id}')
@@ -56,6 +55,9 @@ class QuikData(with_metaclass(MetaQuikData, AbstractDataBase)):
         self.last_bar_received = False  # Получен последний бар
         self.live_mode = False  # Режим получения баров. False = История, True = Новые бары
         self.info = {}
+        # check if dir exists
+        if not os.path.exists(self.store.data_path):
+            os.makedirs(self.store.data_path)
 
     @property
     def data_id(self):
@@ -147,7 +149,7 @@ class QuikData(with_metaclass(MetaQuikData, AbstractDataBase)):
             self.store.stop()
 
     def load(self):
-        with self.store._lock_store_data:
+        with self.store.lock_store_data:
             return super().load()
 
     def _load(self):

{bn_quik-0.2.1 → bn_quik-1.0.0}/bn_quik/QuikStore.py

@@ -150,8 +150,8 @@ class QuikStore(with_metaclass(MetaSingleton, object)):
         ('host', '127.0.0.1'),
         ('port', 34130),
         ('lots', True),  # Входящий остаток в лотах (задается брокером)
-        # ('limit_kind', 1),  # Основной режим торгов T1
-        ('limit_kind', -1),  # Quik Demo
+        ('limit_kind', 1),  # Основной режим торгов T1
+        #('limit_kind', -1),  # Quik Demo
         ('currency', 'SUR'),  # Валюта
         ('futures_firm_id', "SPBFUT"),  # Идентификатор фирмы для фьючерсов
         ('edp', False),  # Единая денежная позиция
@@ -469,7 +469,7 @@ class QuikStore(with_metaclass(MetaSingleton, object)):
                 self._ticker_info[key] = None
                 return None
 
-    def _get_ticker_info_sync(self, class_code: str, sec_code: str) -> dict:
+    def get_ticker_info_sync(self, class_code: str, sec_code: str) -> dict:
         """Синхронное получение информации о тикере из QUIK"""
         info = QuikStore.run_sync(self.get_ticker_info(class_code, sec_code))
         return info.to_dict() if info else {}
@@ -680,7 +680,7 @@ class QuikStore(with_metaclass(MetaSingleton, object)):
         """Получение списка счетов"""
         with self._lock_accounts:
             if not self._accounts:
-                money_limits:MoneyLimitEx = await self._get_money_limits()
+                money_limits:MoneyLimitEx = await self.get_money_limits()
                 if len(money_limits) == 0:
                     self.logger.error('get_money_limts: Ошибка нет лимитов по деньгам')
                     return self._accounts

bn_quik-1.0.0/examples/README.md

@@ -0,0 +1,28 @@
+## Основные команды
+
+### Установка и настройка
+
+#### Способ 1: Установка UV через встроенный скрипт
+```bash
+# На Linux/macOS
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# На Windows (PowerShell)
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+#### Способ 2: Установка UV через pip
+```bash
+pip install uv
+```
+
+#### Инициализация проекта
+```bash
+uv sync
+```
+
+### Запуск примеров
+```bash
+uv run ex1.py
+```
+

bn_quik-1.0.0/examples/ex1.py

@@ -0,0 +1,78 @@
+import logging
+import backtrader_next as bt
+from bn_quik import QuikStore
+
+# Настройка логирования
+logging.basicConfig(
+    # level=logging.DEBUG,  # Уровень логирования (DEBUG, INFO, WARNING, ERROR, CRITICAL)
+    level=logging.INFO,  # Уровень логирования (DEBUG, INFO, WARNING, ERROR, CRITICAL)
+    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',  # Формат сообщений
+    datefmt='%Y-%m-%d %H:%M:%S'  # Формат времени
+)
+
+
+class StratPrintBars(bt.Strategy):
+    """
+    - Отображает статус подключения
+    - При приходе нового бара отображает его цены/объем
+    - Отображает статус перехода к новым барам
+    """
+    params = (  # Параметры торговой системы
+        ('name', None),  # Название торговой системы
+        ('wait_all_datas', False),  # Ждать прихода баров всех тикеров перед обработкой
+        ('symbols', None),  # Список торгуемых тикеров. По умолчанию торгуем все тикеры
+    )
+
+    def __init__(self):
+        """Инициализация торговой системы"""
+        self.isLive = False  # Сначала будут приходить исторические данные
+        self.logger = logging.getLogger('StratPrintBars')
+
+
+    def next(self):
+        """Приход нового бара тикера"""
+        if self.p.wait_all_datas:  # Ждать бары всех тикеров
+            lastdatetimes = [data.datetime.datetime(0) for data in self.datas]  # Дата и время последнего бара каждого тикера
+            if lastdatetimes.count(lastdatetimes[0]) != len(lastdatetimes):  # Если дата и время последних баров не идентичны
+                return  # то еще не пришли все новые бары.
+            print("================== NEXT for all datas =================")
+
+        for data in self.datas:  # Пробегаемся по всем запрошенным тикерам
+            if not self.p.symbols or data._name in self.p.symbols:  # Если торгуем все тикеры или данный тикер
+                self.logger.info(f'{data._name} - {bt.TimeFrame.Names[data.p.timeframe]} {data.p.compression} - Open={data.open[0]:.2f}, High={data.high[0]:.2f}, Low={data.low[0]:.2f}, Close={data.close[0]:.2f}, Volume={data.volume[0]:.0f} [{data.datetime.datetime(0)}]')
+
+    def notify_data(self, data, status, *args, **kwargs):
+        """Изменение статсуса приходящих баров"""
+        data_status = data._getstatusname(status)  # Получаем статус (только при LiveBars=True)
+        self.logger.info(f'Notify Data: {data._name} - Status: {data_status}')  # Статус приходит для каждого тикера отдельно
+        self.isLive = data_status == 'LIVE'  # В Live режим переходим после перехода первого тикера
+
+
+if __name__ == '__main__':
+    try:
+        # symbol = 'TQBR.SBER'  # Тикер
+        symbol = 'QJSIM.SBER' # Тикер для симуляции для Demo QUIK
+        # symbol = 'SPBFUT.SiZ5'  # Для фьючерсов: Si (RTS) - Z (December) - 5 (2025)
+
+        store = QuikStore(trade_account_id='NL0011XXXXXX', limit_kind=-1) #  limit_kind=-1 - только для Demo Quik
+        # store = QuikStore(trade_account_id='SPBFUT0XXXXX') # Срочный рынок
+
+        cerebro = bt.Cerebro(quicknotify=True)
+
+        # Исторические данные и новые бары будут загружены автоматически при установке live_bars=True
+        data = store.getdata(dataname=symbol, timeframe=bt.TimeFrame.Minutes, compression=1, live_bars=True)
+
+        cerebro.adddata(data)
+
+        broker = store.getbroker()
+        cerebro.setbroker(broker)
+
+        cerebro.addstrategy(StratPrintBars)
+        cerebro.run()
+
+    except KeyboardInterrupt:
+        print("\nПрервано пользователем (Ctrl+C)")
+    except Exception as e:
+        print(f"\nОшибка: {e}")
+        import traceback
+        traceback.print_exc()

bn_quik-1.0.0/examples/pyproject.toml

@@ -0,0 +1,9 @@
+[project]
+name = "examples"
+version = "0.1.0"
+description = "Examples of using bn_quik"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "bn-quik>=1.0.0"
+]

bn_quik-1.0.0/lua/QuikSharp.lua

@@ -0,0 +1,142 @@
+--~ Copyright (c) 2014-2020 QUIKSharp Authors https://github.com/finsight/QUIKSharp/blob/master/AUTHORS.md. All rights reserved.
+--~ Licensed under the Apache License, Version 2.0. See LICENSE.txt in the project root for license information.
+
+-- is running from Quik
+function is_quik()
+    if getScriptPath then return true else return false end
+end
+
+quikVersion = nil
+
+script_path = "."
+
+if is_quik() then
+    script_path = getScriptPath()
+    
+	quikVersion = getInfoParam("VERSION")
+
+	if quikVersion ~= nil then
+		local t={}
+		for str in string.gmatch(quikVersion, "([^%.]+)") do
+			table.insert(t, str)
+        end
+		quikVersion = tonumber(t[1]) * 100 + tonumber(t[2])
+	end
+
+	if quikVersion == nil then
+		message("QUIK# cannot detect QUIK version", 3)
+		return
+	else
+		libPath = "\\clibs"
+	end
+    
+    -- MD dynamic, requires MSVCRT
+    -- MT static, MSVCRT is linked statically with luasocket
+    -- package.cpath contains info.exe working directory, which has MSVCRT, so MT should not be needed in theory, 
+    -- but in one issue someone said it doesn't work on machines that do not have Visual Studio. 
+         local linkage = "MT"
+    
+	if quikVersion >= 811 then
+                libPath = libPath .. "64\\54_"..linkage.."\\"
+	elseif quikVersion >= 805 then
+                libPath = libPath .. "64\\53_"..linkage.."\\"
+	elseif quikVersion >= 800 then
+                libPath = libPath .. "64\\5.1_"..linkage.."\\"
+	else
+		libPath = "\\clibs\\5.1_"..linkage.."\\"
+	end
+end
+package.path = package.path .. ";" .. script_path .. "\\?.lua;" .. script_path .. "\\?.luac"..";"..".\\?.lua;"..".\\?.luac"
+package.cpath = package.cpath .. ";" .. script_path .. libPath .. '?.dll'..";".. '.' .. libPath .. '?.dll'
+
+local util = require("qsutils")
+local qf = require("qsfunctions")
+require("qscallbacks")
+
+log("Detected Quik version: ".. quikVersion .." and using cpath: "..package.cpath  , 0)
+
+local is_started = true
+
+-- we need two ports since callbacks and responses conflict and write to the same socket at the same time
+-- I do not know how to make locking in Lua, it is just simpler to have two independent connections
+-- To connect to a remote terminal - replace '127.0.0.1' with the terminal ip-address
+-- All this values could be replaced with values from config.json
+local response_host = '127.0.0.1'
+local response_port = 34130
+local callback_host = '127.0.0.1'
+local callback_port = response_port + 1
+
+function do_main()
+    log("Entered main function", 0)
+    while is_started do
+        -- if not connected, connect
+        util.connect(response_host, response_port, callback_host, callback_port)
+        -- when connected, process queue
+        -- receive message,
+        local requestMsg = receiveRequest()
+        if requestMsg then
+            -- if ok, process message
+            -- dispatch_and_process never throws, it returns lua errors wrapped as a message
+            local responseMsg, err = qf.dispatch_and_process(requestMsg)
+            if responseMsg then
+                -- send message
+                local res = sendResponse(responseMsg)
+            else
+                log("Could not dispatch and process request: " .. err, 3)
+            end
+        else
+            delay(1)
+        end
+    end
+end
+
+function main()
+    setup("QuikSharp")
+    run()
+end
+
+--- catch errors
+function run()
+    local status, err = pcall(do_main)
+    if status then
+        log("finished")
+    else
+        log(err, 3)
+    end
+end
+
+function setup(script_name)
+    if not script_name then
+        log("File name of this script is unknown. Please, set it explicity instead of scriptFilename() call inside your custom file", 3)
+        return false
+    end
+
+    local list = paramsFromConfig(script_name)
+    if list then
+        response_host = list[1]
+        response_port = list[2]
+        callback_host = list[3]
+        callback_port = list[4]
+        printRunningMessage(script_name)
+    elseif script_name == "QuikSharp" then
+        -- use default values for this file in case no custom config found for it
+        printRunningMessage(script_name)
+    else -- do nothing when config is not found
+        log("File config.json is not found or contains no entries for this script name: " .. script_name, 3)
+        return false
+    end
+
+    return true
+end
+
+function printRunningMessage(script_name)
+    log("Running from ".. script_name .. ", params: response " .. response_host .. ":" .. response_port ..", callback ".. " ".. callback_host ..":".. callback_port)
+end
+
+if not is_quik() then
+    log("Hello, QUIK#! Running outside Quik.")
+    setup("QuikSharp")
+    do_main()
+    logfile:close()
+end
+

bn_quik-1.0.0/lua/Quik_2.lua

@@ -0,0 +1,15 @@
+--~ Copyright (c) 2014-2020 QUIKSharp Authors https://github.com/finsight/QUIKSharp/blob/master/AUTHORS.md. All rights reserved.
+--~ Licensed under the Apache License, Version 2.0. See LICENSE.txt in the project root for license information.
+
+script_path = getScriptPath()
+package.path = package.path .. ";" .. script_path .. "\\?.lua;" .. script_path .. "\\?.luac"..";"..".\\?.lua;"..".\\?.luac"
+require("QuikSharp")
+
+-- Do not edit this file. Just copy it and save with a different name. Then write required params for it inside config.json file
+-- Не редактируйте этой файл. Просто скопируйте и сохраните под другим именем. После этого укажите настройки для него в файле config.json
+
+function main()
+    if setup(scriptFilename()) then
+        run()
+    end
+end

bn_quik-1.0.0/lua/USAGE.RU.md

@@ -0,0 +1,63 @@
+Использование Lua скриптов
+==========
+Lua скрипты из состава библиотеки позволяют работать с несколькими терминалами Quik одновременно.
+
+Как подключиться к двум терминалам сразу
+----------------------------------------
+
+Достаточно сделать ряд простых действий:
+1. Найти в файле `config.json` секцию `servers`, там будет название опции `scriptName` со значением `Quik_2`. В данном случае `Quik_2` является названием файла в папке lua (расширение `.lua` в `config.json` указывать нельзя).
+2. Изменить опции согласно вашим предпочтениям. По умолчанию, дополнительный сокет сервер будет запущен на localhost'e (т.е. опции `responseHostname` и `callbackHostname` имеют значение `127.0.0.1`), а порты (опции `responsePort` и `callbackPort`) равны `34132` для сервера запросов-ответов и `34133` для сервера коллбэков (данные, которые хочет отправить Квик). Порты не должны конфликтовать с уже указанными портами в файле `config.json`
+3. Добавить `Quik_2.lua` в Quik и запустить. При этом необязательно запускать `QuikSharp.lua`, если он вами не используется. Если используется и для него указаны другие порты, то, безусловно, можно запускать оба.
+
+Возможно, перед запуском скрипта, для его нормальной работы, на компьютере с терминалом потребуется установить DLL библиотеки c сайта MS 
+https://learn.microsoft.com/cpp/windows/latest-supported-vc-redist?view=msvc-170#latest-supported-redistributable-version
+для [CPU X64] https://aka.ms/vs/17/release/vc_redist.x64.exe
+
+Дополнение:
+Добавлена Lua socket  **core.dll**  для Lua 5.4.1 MT (static library), скомпилирована из Lua socket 3.1.0
+Для компилирования использовались файла от Lua 5.4.2, успешно протестировано в QUIK Junior 12.6.0.53 .
+Если хотите использовать Lua 5.4.1 в QUIK, надо отредактировать файл QuikShart.lua
+```
+        local linkage = "MT"
+    
+	if quikVersion >= 811 then
+            libPath = libPath .. "64\\54_"..linkage.."\\"
+	elseif quikVersion >= 805 then
+            libPath = libPath .. "64\\53_"..linkage.."\\"
+	elseif quikVersion >= 800 then
+            libPath = libPath .. "64\\5.1_"..linkage.."\\"
+	else
+            libPath = "\\clibs\\5.1_"..linkage.."\\"
+	end
+
+```
+
+
+
+
+Все!
+
+Вопросы и ответы
+----------------
+
+- Как добавить еще сервера?
+
+Скопируйте файл `Quik_2.lua` и сохраните его в той же папке под другим именем, например, `MyBroker.lua`. В файле `config.json` в секции `servers` скопируйте текст внутри фигурных скобок `{"scriptName"..."responseHostname"..."responsePort"..."callbackHostname"..."callbackPort"...}`, поставьте запятую после `}`, вставьте скопированный текст и измените в нем данные. Как минимум, нужно указать в `scriptName` название файла скрипта (в примере это `MyBroker`), а в опциях портов указать любые свободные номера портов. Такую процедуру можно делать столько раз, сколько серверов вам нужно. Не забудьте, что `responsePort` и `callbackPort` не могут быть одинаковыми и повторяться в файле.
+
+- Как обновляться на новые версии библиотеки и скриптов в частности?
+
+В новых версиях будет меняться код скриптов и код `config.json`. Но если вы вносили изменения в `config.json`, то сохраните в другом месте файл с вашими изменениями. После этого замените все старые файлы новыми. Обратите внимание, что, возможно, в одном из обновлений содержимое `Quik_2.lua` изменится и все созданные вами лично копии этого файла потребуется пересоздать на основе обновленного файла. Продолжаем. Отредактируйте файл `config.json` в соответствии с настройками из старого файла (если не меняли ничего, делать ничего не надо). Процесс обновления завершен.
+
+- Как сделать так, чтобы можно было подключаться к сокету из локальной сети WiFi с другого устройства?
+
+Нужно указать в `responseHostname` и `callbackHostname` значение `0.0.0.0`. Лучше так не делать и вот, почему. Когда компьютер подключен к роутеру, то разрешение подключаться к нему извне (а именно это делает `0.0.0.0`) открывает доступ к нему всему миру при допущении, что роутер недостаточно хорошо защищен и настроен. А так как при подключении к сокетам нет ни пароля, ни шифрования, открытый доступ всему миру открывает ваш Квик всем. Т.е. если вы все же хотите подключаться из локальной сети, позаботьтесь о безопасности и верных настройках роутера.
+
+- Можно ли переименовать `Quik_2.lua`?
+
+Да, только укажите новое имя в `scriptName` файла `config.json`.
+
+
+- Можно ли переименовать `QuikSharp.lua`?
+
+Нет. Этот файл обязательно должен сохранить свое имя, потому что все остальные скрипты используют часть его кода.

bn_quik-1.0.0/lua/config.json

@@ -0,0 +1,18 @@
+{
+    "servers": [
+        {
+            "scriptName": "QuikSharp",
+            "responseHostname": "127.0.0.1",
+            "responsePort": 34130,
+            "callbackHostname": "127.0.0.1",
+            "callbackPort": 34131
+        },
+        {
+            "scriptName": "Quik_2",
+            "responseHostname": "127.0.0.1",
+            "responsePort": 34132,
+            "callbackHostname": "127.0.0.1",
+            "callbackPort": 34133
+        }
+    ]
+}