Skip to content

An 1C:Enterprise/OneScript and CLI toolbox for integration with APIs of popular online services (Telegram, VK, Viber, Notion, Drive, Slack, etc.)

License

Notifications You must be signed in to change notification settings

oscript-library/oint-cli

 
 

Repository files navigation

Important

Это форк основного репозитория для OneScript-пкета oint-cli

Конкретно его исходные файлы находятся в каталогах src/ru/cli и src/en/cli



This page, but on English, here: Click!


Main Main-light

Открытый пакет интеграций

Версия OpenYellow


Набор инструментов для интеграции с популярными API посредством CLI (Windows/Linux) и библиотеки (расширения) для 1C:Enterprise/OneScript


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

На сегодняшний день реализованы методы для работы со следующими API:


Релизы

GitHub Downloads (all assets, all releases)



Релизы библиотеки выходят в пяти вариантах:

  • Как CLI приложение для Windows и Linux (exe, rpm, deb)
  • Как XML выгрузка расширения
  • Как EDT проект расширения
  • Как отдельный файл расширения формата cfe
  • Как OneScript пакет расширения ospx



При использовании версий для 1С и OneScript, вы также можете просто скопировать код общих модулей из релизов в свой проект руками. Однако, вне зависимости от выбранного сопособа установки, получать файлы необходимо из Release, так как в самих исходных файлах репозитория бывают промежуточные данные и функции, находящиеся в процессе разработки.


  • Для начала работы в 1С достаточно подключить расширение в свою конфигуарцию
  • Для начала работы в OneScript необходимо установить пакет

Из хаба пакетов:

    opm install oint

Или из скачанного ospx файла:

    opm install -f "./OInt-x.x.x.ospx"

  • Для начала работы с CLI необходимо скачать из релизов установщик или один из вариантов пакета, в зависимости от используемой операционной системы. Дополнительно требуется наличие установленного .Net Framework 4.8 или Mono соответствующей версии. При установке из rpm или deb пакетов устанавливается автоматически

Warning

Не рекомендуется напрямую использовать методы служебных модулей (OPI_Инструменты, OPI_Криптография) в вашем проекте (если вы собираетесь обновляться до новых версий в дальнейшем). Для сохранения обратной совместимости, количество/назначение параметров и типы возвращаемых значений для методов работы с API не изменяются, но это не применимо к служебным модулям, которые могут изменяться как угодно для оптимизации и дополнения под новые нужды. Если вам необходим функционал из служебных модулей, рекомендуется скопировать его себе отдельно.


Документация

У ОПИ есть подробная документация с примерами по адресу https://openintegrations.dev. Там вы можете найти как общие положения о начале работы с каждым конкретным API, так и описания каждого метода с примерами кода, параметров и возвращаемых значений.

Docs

CLI версия ОПИ имеет собственную встроенную справку по всем методам. Показ справки осуществляется при вызове библиотеки без метода, метода без опций или при указании опции --help



Infostart

Статьи на Инфостарте:


  • Открытый Пакет интеграций (OpenIntegrations)
    Licensed under the MIT License
    Список зависимостей находится в файле NOTICE

About

An 1C:Enterprise/OneScript and CLI toolbox for integration with APIs of popular online services (Telegram, VK, Viber, Notion, Drive, Slack, etc.)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • 1C Enterprise 99.9%
  • Other 0.1%