octopus oc corelibs sql helpers Скачать - octopus oc corelibs sql helpers Скачать исходный код

octopus oc corelibs sql helpers

AI Исходный код

1.0.3

Скачать

PL/SQL HELPERS классов

Инструменты для автоматической обработки и форматирования кода PL/SQL

Ограничения

Файлы с несколькими объектами не поддерживаются. Это означает: один файл - один объект с оператором create . Результаты обработки многообъективных файлов непредсказуемы, поэтому все инструменты (кроме Str_decoder ) поднимут исключение.
Имена объектов должны быть даны только с использованием символов ASCII .
Использование для определения объектов, не поддерживающих поддержки, также поднимет исключение. Поддерживаемые типы объектов:
- Процедура
- Функция
- УПАКОВКА
- Корпус упаковки

Подробности

str_decoder

Единственная функция decode_to_str пытается обнаружить кодировку линии и повторно кодировать ее в UTF-8 . Повышает valueError , если кодирование невозможно.

Синопсис

decode_to_str(line, probables=None)

line - bytes -объект с текстом для декодирования
probables - list str с первичными кодировками для проверки. По умолчанию: ['cp866', 'cp1251', 'koi8-r']
Возвращаемое значение - str (декодирован и перекодировано в UTF-8 )

Использование командной строки

Декодирование всего файла в другой файл. Запустите это, чтобы получить список аргументов:

python -m oc_sql_helpers.str_decoder --help

обертка

PLSQLWrapper Class-это инструмент для работы с источниками с оракулами.

Требования

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

Переменная среды ORACLE_HOME должна быть правильно установлена
wrap бинарное средство должно быть размещено под ${ORACLE_HOME}/bin и должно выполнить разрешение для эффективного пользователя

Синопсис

PLSQLWrapper() - создать экземпляр объекта для этого класса

Методы

wrap_path(path_in, write_to=None)
- path_in - str объект с абсолютным или относительным путем к файлу к завершению.
- write_to - один из:
  - None - результат обертывания будет возвращен этим методом как объект bytes
  - file - Результат будет записан в файловый объект, указанный здесь. Должен быть открыт в бинарном режиме чтения-записи ( 'w+b' ) и поддержкой операции seek .
  - str - Путь к выходному файлу, абсолютный или относительный. Результат будет написан там. Должен иметь расширение - это Featrue Oracle wrap . Он добавляет суффикс .plb сам по себе, если расширение опущено. Пожалуйста, укажите расширение всегда
- Возвращение значения : см. write_to выше
wrap_buf(fl_in, write_to=None)
- fl_in - file или file-like объект для обертывания данных. Должен быть открыт в бинарном режиме и операции поддержки seek ( 'rb' ).
- write_to - то же самое, что и для wrap_path
- возвращаемое значение : то же самое, что и для wrap_path
unwrap_path(path_in, write_to=None)
- path_in - str объект с абсолютным или относительным путем к файлу к развертыванию.
- write_to - один из:
  - None - результат развертывания будет возвращен этим методом в качестве объекта bytes
  - file - Результат будет записан в файловый объект, указанный здесь. Должен быть открыт в бинарном режиме чтения-записи ( 'w+b' ) и поддержкой операции seek .
  - str - Путь к выходному файлу, абсолютный или относительный. Результат будет написан там.
- Возвращение значения : см. write_to выше
unwrap_buf(fl_in, write_to=None)
- fl_in - file или file-like объект для обертывания данных. Должен быть открыт в бинарном режиме и операции поддержки seek ( 'rb' ).
- write_to - то же самое, что и для unwrap_path
- Возвращение значения : то же самое, что и для unwrap_path

Использование командной строки

Обертывание/развертывание всего файла в другой файл. Запустите это, чтобы получить список аргументов:

python -m oc_sql_helpers.wrapper --help

нормализатор

PLSQLNormalizer CLASS IS или PL/SQL НОРМАЗИВАНИЕ КОДА.

Термин нормализации

Нормализация означает почти то же самое, что и стиль кода , но менее строго. Это означает, что результат нормализации может быть непригодным для использования, даже если источник является правильным с точки зрения PL/SQL .

Нормализация по умолчанию :

Все линейные окончания заменяются на Unix -стиль
Весь мусор перед первым неуместным оператором CREATE удален.
Сам CREATE создает в первой линейке до (или IS или WRAPPED ) AS , включая имя объекта, тип и схемы. Дополнительные космические символы и комментарии заменяются одним пространством.
Первая строка (с упорядоченным оператором CREATE ) поднята , включая схемы и имя объекта .
Если схема или имя объекта дано в двойных цитатах " тогда эти двойные цитаты будут SCHEMA.NAME , где это возможно. Пример: "schema"."name" "ANOTHER.SCHEMA"."ANOTHER.NAME" "another.schema"."another.name" будет схемой.
Остальная часть тела определения объекта не будет изменена

Другие флаги нормализации :

uppercase : Все лексики языка в корпусе объекта будут опережаем, кроме литералов.
no-comments : Все комментарии внутри тела, включая сами знаки комментариев, будут заменены одним пространством.
no-spaces : все повторяющиеся космические характеристики (само пространство, Newline, Tabulation ...) будут заменены общим единственным пространством. Пример: var := 'the value' будет переведено в var := 'the value' . Обратите внимание, что замены не выполняются внутри буквального 'the value' . Этот флаг не может быть использован без no-comments
no-literals : все строки буквальных значений будут заменены на пустые. Сами буквальные знаки не изменяются.
comments-only : отбросьте весь файл, но комментарии, включая сами знаки комментариев. Каждый комментарий будет начат с новой линии. Этот флаг не совместим с кем -либо выше

Синопсис

PLSQLNormalizer() - создать объект для этого класса

Методы

normalize_path(path, flags=None, lines=None, write_to=None)
- path - str объект с абсолютным или относительным путем к файлу для нормализации.
- flags - Флаги нормализации, list целых чисел из PLSQLNormalizationFlags Перечисление, см. Ниже. None значения означает, что дефолт ( CREATE определение) только нормализация.
- lines - int , линии линии нормализации (подсчитано от источника ). По умолчанию : None , означает нормализовать весь источник
- write_to - один из:
  - None - результат обертывания будет возвращен этим методом как объект bytes
  - file - Результат будет записан в файловый объект, указанный здесь. Должен быть открыт в бинарном режиме чтения-записи ( 'w+b' ) и поддержкой операции seek .
  - str - Путь к выходному файлу, абсолютный или относительный. Результат будет написан там. Должен иметь расширение - это Featrue Oracle wrap . Он добавляет суффикс .plb сам по себе, если расширение опущено. Пожалуйста, укажите расширение всегда
- Возвращение значения : см. write_to выше
normalize(fl, flags, lines=None write_to=None)
- fl - один из:
  - file или file-like объект для нормализации данных. Должен быть открыт в бинарном режиме и операции поддержки seek ( 'rb' ).
  - str - строковые данные для нормализации
  - bytes - «двоичные» данные для нормализации
- flags - так же, как и для normalize_path
- lines - так же, как и для normalize_path
- write_to - так же, как и для normalize_path
- Возвращение значения : то же самое, что и для normalize_path
is_sql(fl) - Проверьте данные, предоставленные данные PL/SQL CODE
- fl - так же, как и для normalize
- Значение повторного повторного возмещения - bool , обернутый код PL/SQL или нет
is_sql_path(path) - так же, как is_sql , но аргумент рассматривается как путь к файлу с возможным кодом
is_wrapped(fl) - проверьте данные, подтверждается оберщенным кодом PL/SQL
- fl - так же, как и для normalize
- Значение повторного повторного возмещения - bool , поддерживаемый код PL/SQL или нет
is_wrapped_path(path) - так же, как и is_wrapped , но аргумент рассматривается как путь к файлу с возможным кодом
is_wrappable(fl) - Проверьте данные , предоставленные
- fl - так же, как и для normalize
- Значение повторного повторного возмещения - bool , Объект PL/SQL -объект в коде или нет
is_wrappable_path(path) - так же, как is_wrappable , но аргумент рассматривается как путь к файлу с возможным кодом