{ "componentChunkName": "component---src-templates-doc-page-js", "path": "/docs/ru/common/bot_structure/modules/", "result": {"data":{"site":{"siteMetadata":{"title":"Gatsby-doc-engine"}},"markdownRemark":{"id":"0360e044-95b3-5444-bdb2-ae10dd1402c7","excerpt":"Зависимости Разрабатывать сложные проекты со множеством тем, справочников и скриптовых расширений может быть неудобно и неэффективно, если хранить весь код…","html":"

Зависимости

\n
\n

Разрабатывать сложные проекты со множеством тем, справочников и скриптовых расширений может быть неудобно и неэффективно, если хранить весь код проекта в одном сценарии.

\n

Вместо этого JAICP позволяет разбивать код сценария на изолированные составные части и подключать их в основной сценарий как зависимости. Такой подход имеет ряд преимуществ:

\n\n

В качестве зависимостей также можно подключить системные модули — наборы готовых именованных паттернов, функций и т. д.\nИх можно подключить в любой проект без дополнительного объявления.

\n

Подключение

\n

Зависимости указываются в разделе dependencies конфигурационного файла chatbot.yaml. В каждом из элементов списка зависимостей должны быть указаны следующие поля:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ПолеОписаниеДопустимые значения
nameИмя зависимости, по которому она будет подключаться в сценарий.Произвольная строка.
typeТип зависимости: внешний репозиторий или локальный модуль.git, module.
urlАдрес внешнего репозитория.Строка, начинающаяся с https://, git:// или file://.
versionНазвание ветки, где содержится код зависимости.<имя_ветки> или heads/<имя_ветки>.
\n

Поля url и version применимы только к зависимостям с типом git.

\n

Локальные модули

\n

Зависимости с типом module полезны в случае, когда один большой сценарий требуется разбить на множество мелких сценариев в рамках одного проекта.

\n

Структура проекта

\n

Предположим, что имеется существующий проект, состоящий из двух файлов:

\n\n

Пример фрагмента offtopic.sc:

\n
patterns:\n    $you = (~ты/~вы)\n\ntheme: /\n\n    state: WhatCanYouDo\n        q!: * {~что * [$you] * (~уметь/научил*/способ*)} *\n        q!: * ([~что] $you/что-то) [еще] * (уме*/мож*/научил*/способ*) [делать] *\n        q!: * как* * $you * [поставлен*/установлен*] (сервис*/программ*) *\n        a: Я умею отвечать на вопросы.
\n

Структура директории проекта имеет следующий вид:

\n
├── chatbot.yaml\n├── src\n│   ├── main.sc\n│   └── offtopic.sc\n└── test\n    └── test.xml
\n
\n

Если «болталку» планируется расширять новой функциональностью, например специализированной темой о вымышленной биографии бота или своими функциями для обработки данных, целесообразно вынести ее в отдельный модуль, независимый от основного сценария.

\n

В таком случае необходимо создать в корне вложенные директории под основной сценарий, например main, и под создаваемую зависимость. Все файлы, относящиеся к зависимости, нужно перенести в эту директорию, добившись следующего расположения файлов:

\n
├── main\n│   ├── chatbot.yaml\n│   ├── src\n│   │   └── main.sc\n│   └── test\n│       └── test.xml\n└── offtopic\n    └── src\n        └── offtopic.sc
\n

В зависимостях наличие конфигурационного файла chatbot.yaml и XML-тестов не требуется.

\n

Подключение зависимости

\n

Проделайте следующие шаги, чтобы подключить зависимость.

\n
    \n
  1. Перейдите в меню редактирования проекта. На вкладке Размещение смените значение поля Путь на название новой корневой директории проекта — main.
    2. \n
\n

Если поле Путь не отображается на вкладке, обратитесь к своему аккаунт-менеджеру.

\n
    \n
  1. Укажите в chatbot.yaml раздел dependencies. В типе зависимости укажите module, а в имени — название соответствующей директории:
    2. \n
\n
dependencies:\n  - name: offtopic\n    type: module
\n
    \n
  1. Добавьте в сценарный файл main.sc название подключаемого файла и имя зависимости при помощи тега require.
    2. \n
\n

После этого из основного сценария станет доступно содержимое подключенных файлов: стейт WhatCanYouDo и именованный паттерн $you.

\n
require: offtopic.sc\n    module = offtopic\n\ntheme: /\n\n    state: You\n        q!: * $you *\n        a: Я понял, что вы ко мне обратились, но не понял, зачем.\n\n    state: CatchAll\n        q!: *\n        a: Извините, я вас не понял.
\n

Внешние зависимости

\n

Если модуль содержит типовую функциональность, которая может потребоваться во множестве разных проектов, ее целесообразно вынести в отдельный проект. Далее такой проект можно переиспользовать, подключив его как зависимость с типом git.

\n

Например, в такие зависимости могут быть вынесены готовые фрагменты сценариев, часто используемые функции и справочники.

\n

Структура проекта

\n

Рассмотрим ранее приведенный пример файла offtopic.sc. В случае внешней зависимости его нужно расположить в директории со стандартной структурой:

\n
└── src\n    └── offtopic.sc
\n

Далее создайте в корневой директории проекта Git-репозиторий и зафиксируйте созданный файл в системе контроля версий, после чего опубликуйте репозиторий.

\n

Репозиторий может быть размещен на любом внешнем хостинге, например Bitbucket, GitLab или GitHub.

\n

Подключение зависимости

\n

Подключение внешней зависимости отличается от локального модуля необходимостью указать адрес репозитория и нужную ветку:

\n
dependencies:\n  - name: offtopic\n    type: git\n    url: https://github.com/example/offtopic\n    version: master
\n

После этого из сценария, в который подключена зависимость, так же становится доступно содержимое зависимости.

\n

Вы можете просмотреть код подключенных к проекту внешних зависимостей в редакторе сценариев.

","frontmatter":{"title":"","description":null},"headings":[{"value":"Зависимости"}]}},"pageContext":{"slug":"/docs/ru/common/bot_structure/modules/","previous":{"fields":{"slug":"/docs/ru/common/bot_structure/sc/"},"frontmatter":{"title":"","description":null}},"next":{"fields":{"slug":"/docs/ru/common/bot_structure/js/"},"frontmatter":{"title":"","description":null}}}}, "staticQueryHashes": ["1209419333"]}