Методы для работы с регистром

• Substring
• Matched

              # НАЙДЕМ ПЕРВЫЙ `li`
- find:
    path: "li#li1"
    do:
    # КОМАНДОЙ `parse` ЗАПОЛНИМ РЕГИСТР ТЕКСТОМ, В РЕГИСТРЕ БУДЕТ "Text and text"
    - parse

    # ТЕПЕРЬ ИЗМЕНИМ ДАННЫЕ
    - normalize:
        routine: replace_substring
        args:
            # ПЕРВЫМ ДЕЛОМ ЗАМЕНИМ СЛОВО "text" НА "some another text"
            - text: 'some another text'
            # ПОСЛЕ ЭТОЙ ОПЕРАЦИИ В РЕГИСТРЕ НАХОДИТСЯ "Text and some another text"

            # ТЕПЕРЬ ЗАМЕНИМ СЛОВО "and" НА "or"
            - and: or
            # ПОСЛЕ ЭТОЙ ОПЕРАЦИИ В РЕГИСТРЕ НАХОДИТСЯ "Text or some another text"

            # И НАКОНЕЦ ЗАМЕНИМ СЛОВО "another" НА "other"
            - another: other

    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ "Text or some other text"
              

              # ОБРАТИТЕ ВНИМЕНИЕ!
# `replace_matched`, В ОТЛИЧИИ ОТ `replace_substring`, РАБОТАЕТ ДО ПЕРВОГО СОВПАДЕНИЯ

# НАЙДЕМ ПЕРВЫЙ `li`
- find:
    path: "li#li1"
    do:
    # ЗАПОЛНИМ РЕГИСТР ТЕКСТОМ
    - parse

    # ИЗМЕНИМ ДАННЫЕ
    - normalize:
        routine: replace_matched
        args:
            # ПЕРВЫМ ДЕЛОМ ЗАМЕНИМ ЗНАЧЕНИЕ РЕГИСТРА НА УКАЗАННОЕ "some another text"
            # ЕСЛИ В СОДЕРЖИМОМ РЕГИСТРА ПРИСУТСТВУЕТ СЛОВО "text"
            - text: 'some another text'
            # ПОСЛЕ ЭТОЙ ОПЕРАЦИИ В РЕГИСТРЕ НАХОДИТСЯ "some another text"

            # ВНИМАНИЕ! ВЫПОЛНЕНИЕ ПРЕКРАЩАЕТСЯ ТАК КАК ПРОИЗОШЛО СОВПАДЕНИЕ
            # ПО ПЕРВОМУ АРГУМЕНТУ, НИЖЕ ИДУЩИЕ АРГУМЕНТЫ БУДУТ ПРОИГНОРИРОВАНЫ
            - and: or
            - another: other

    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ "some another text"
              

• increment
• decrement
• capitalize
• upper_first
• upper
• lower

              # ДЛЯ ЭТОГО РЕЖИМА ДОПУСТИМЫ ТОЛЬКО ЦЕЛОЧИСЛЕННЫЕ ЗНАЧЕНИЯ (1,2,158,203040523421 И Т.Д) В РЕГИСТРЕ
# НАЙДЕМ ПЕРВЫЙ `li`
- find:
    path: "li#li1"
    do:
    # ЗАПОЛНИМ РЕГИСТР ЦИФРОЙ АТРИБУТА `id`
    - parse:
        attr: id
        filter: (\d+)
    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ "1"

    # ИЗМЕНИМ ДАННЫЕ
    - normalize:
        routine: increment

    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ "2"
              

              # ДЛЯ ЭТОГО РЕЖИМА ДОПУСТИМЫ ТОЛЬКО ЦЕЛОЧИСЛЕННЫЕ ЗНАЧЕНИЯ (1,2,158,203040523421 И Т.Д) В РЕГИСТРЕ
# НАЙДЕМ ВТОРОЙ `li`
- find:
    path: "li#li2"
    do:
    # ЗАПОЛНИМ РЕГИСТР ЦИФРОЙ АТРИБУТА `id`
    - parse:
        attr: id
        filter: (\d+)
    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ "2"

    # ИЗМЕНИМ ДАННЫЕ
    - normalize:
        routine: decrement

    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ "1"
              

              # ЗАМЕНИМ ВСЕ ПЕРВЫЕ БУКВЫ ВСЕХ СЛОВ (КРОМЕ СОЕДИНИТЕЛЬНЫХ) В ПРЕДЛОЖЕНИИ НА ЗАГЛАВНЫЕ
# НАЙДЕМ ПЕРВЫЙ `li`
- find:
    path: "li#li1"
    do:
    # ЗАПОЛНИМ РЕГИСТР ТЕКСТОВЫМ СОДЕРЖИМЫМ БЛОКА
    - parse
    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ "Text and text"

    # ИЗМЕНИМ ДАННЫЕ
    - normalize:
        routine: capitalize

    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ "Text and Text"
              

              # ЗАМЕНИМ ТОЛЬКО ПЕРВУЮ БУКВУ В ТЕКСТЕ НА ЗАГЛАВНУЮ
# НАЙДЕМ ВТОРОЙ `li`
- find:
    path: "li#li2"
    do:
    # ЗАПОЛНИМ РЕГИСТР ТЕКСТОВЫМ СОДЕРЖИМЫМ БЛОКА
    - parse
    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ "text and text"

    # ИЗМЕНИМ ДАННЫЕ
    - normalize:
        routine: upper_first

    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ "Text and text"
              

              # ЗАМЕНИМ ВСЕ БУКВЫ В ТЕКСТЕ НА ЗАГЛАВНЫЕ
# НАЙДЕМ ВТОРОЙ `li`
- find:
    path: "li#li2"
    do:
    # ЗАПОЛНИМ РЕГИСТР ТЕКСТОВЫМ СОДЕРЖИМЫМ БЛОКА
    - parse
    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ "text and text"

    # ИЗМЕНИМ ДАННЫЕ
    - normalize:
        routine: upper

    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ "TEXT AND TEXT"
              

              # ЗАМЕНИМ ВСЕ БУКВЫ В ТЕКСТЕ НА СТРОЧНЫЕ
# НАЙДЕМ ПЕРВЫЙ `li`
- find:
    path: "li#li1"
    do:
    # ЗАПОЛНИМ РЕГИСТР ТЕКСТОВЫМ СОДЕРЖИМЫМ БЛОКА
    - parse
    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ "Text and text"

    # ИЗМЕНИМ ДАННЫЕ
    - normalize:
        routine: lower

    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ "text and text"
              

• url
• escape_html
• unescape_html

              # ПРИВЕДЕНИЕ ОТНОСИТЕЛЬНЫХ ССЫЛОК К АБСОЛЮТНОМУ ВИДУ
# НАЙДЕМ `a`
- find:
    path: a
    do:
    # ЗАПОЛНИМ РЕГИСТР ЗНАЧЕНИЕМ АТРИБУТА `href`
    - parse:
        attr: href
    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ: sandbox.html

    # ИЗМЕНИМ ДАННЫЕ
    - normalize:
        routine: url

    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ: https://www.diggernaut.com/sandbox.html
              

              # ЗАМЕНИМ <, >, " И Т.П. НА HTML entities
# НАЙДЕМ ПЕРВЫЙ `li`
- find:
    path: "li#li1"
    do:
    # ЗАПОЛНИМ РЕГИСТР СОДЕРЖИМЫМ 
    - parse:
        format: html
    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ: <li class="item" id="1">Text and text</li>

    # ИЗМЕНИМ ДАННЫЕ
    - normalize:
        routine: escape_html

    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ: 
                

              # ЗАМЕНИМ  HTML entities НА <, >, " И Т.П.
# НАЙДЕМ ПЕРВЫЙ `li`
- find:
    path: "li#li1"
    do:
    # ЗАПОЛНИМ РЕГИСТР СОДЕРЖИМЫМ 
    - register_set:

    # ИЗМЕНИМ ДАННЫЕ
    - normalize:
        routine: unescape_html

    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ: <li class="item" id="1">Text and text</li>
              

• JSON2XML

              # ПРЕОБРАЗОВАНИЕ JSON ДОКУМЕНТА В XML БЛОК ДЛЯ ДАЛЬНЕЙШЕЙ РАБОТЫ С НИМ СТАНДАРТНЫМИ СРЕДСТВАМИ
# НАЙДЕМ ПЕРВЫЙ `script`
- find:
    path: script
    slice: 0
    do:
    # ЗАПОЛНИМ РЕГИСТР ТЕКСТОВЫМ СОДЕРЖИМЫМ 
    - parse
    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ: var items = {"items":[{"item": {"somefield1": "text", "somefield2": "another text"}}]};

    # УДАЛИМ ЛИШНЕЕ
    - normalize:
        routine: replace_substring
        args:
            - \s*var\s*items\s*=\s*: ''
            - \s*;\s*$: '' 
    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ JSON: {"items":[{"item": {"somefield1": "text", "somefield2": "another text"}}]}

    # ПРЕОБРАЗУЕМ ЕГО В XML
    - normalize:
        routine: json2xml
    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ:
    # <body_safe>
    #   <items>
    #     <item>
    #       <somefield1>text</somefield1>
    #       <somefield2>another text</somefield2>
    #     </item>
    #   </items>
    # </body_safe>

    # РАСПАРСИМ ЭТОТ КОНТЕНТ, ПРЕОБРАЗУЕМ ЕГО В БЛОК И ПЕРЕЙДЕМ В НЕГО
    - to_block

    # ТЕПЕРЬ МЫ НАХОДИМСЯ В НОВОМ БЛОКЕ, И МОЖЕМ ХОДИТЬ ПО ЕГО DOM СТРУКТУРЕ
    - find:
        path: item > somefield1
        do:
        - parse
        # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ "text"
              

• date_format

              # ПРЕОБРАЗОВАНИЕ ДАТ
# НАЙДЕМ ТРЕТИЙ `li`
- find:
    path: 'li#li3'
    do:
    # ЗАПОЛНИМ РЕГИСТР ТЕКСТОВЫМ СОДЕРЖИМЫМ БЛОКА
    - parse
    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ: 01/21/2017

    # ПРЕОБРАЗУЕМ ДАТУ В unix time
    - normalize:
        routine: date_format
        args:
            format_in: "%m/%d/%Y"
            format_out: "%s"
    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ: 1484956800

    # -----------------------------------------------------
    # СНОВА ЗАПОЛНИМ РЕГИСТР ТЕКСТОВЫМ СОДЕРЖИМЫМ БЛОКА
    - parse
    # В РЕГИСТРЕ СНОВА ПЕРВОНАЧАЛЬНОЕ ЗНАЧЕНИЕ: 01/21/2017

    # ДОБАВИМ ДАТЕ ДВА ГОДА
    - normalize:
        routine: date_format
        args:
            format_in: "%m/%d/%Y"
            add_years: 2
            format_out: "%m/%d/%Y"
    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ: 01/21/2019

    # -----------------------------------------------------
    # СНОВА ВОЗЬМЕМ ПЕРВОНАЧАЛЬНОЕ ЗНАЧЕНИЕ
    - parse

    # ВЫЧТЕМ ОДИН ГОД, И ИЗМЕНИМ ФОРМАТ
    - normalize:
        routine: date_format
        args:
            format_in: "%m/%d/%Y"
            add_years: -1
            format_out: "%B,%d %Y"
    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ: January,21 2016

    # -----------------------------------------------------
    # ТЕПЕРЬ ЗАПИШЕМ В РЕГИСТР СОБСТВЕННОЕ ЗНАЧЕНИЕ
    - register_set: '01/21/2017 00:00:00 +0400 UTC'

    # И ПРЕОБРАЗУЕМ ЕГО ПОД НУЖНУЮ НАМ ВРЕМЕННУЮ ЗОНУ: America/New_York
    - normalize:
        routine: date_format
        args:
            format_in: "%m/%d/%Y %T %z %Z"
            timezone: 'America/New_York'
            format_out: "%m/%d/%Y %T %z %Z"
    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ: 01/20/2017 19:00:00 -0500 EST

    # -----------------------------------------------------
    # ДЛЯ АРГУМЕНТА add_* ДОСТУПНЫ СЛЕДУЮЩИЕ ВАРИАНТЫ:
    # add_years   - ГОДЫ
    # add_months  - МЕСЯЦЫ
    # add_days    - ДНИ
    # add_hours   - ЧАСЫ
    # add_minutes - МИНУТЫ
    # add_seconds - СЕКУНДЫ
    # ТАК ЖЕ ЭТИ АРГУМЕНТЫ МОЖНО ПРИМЕНЯТЬ ВМЕСТЕ
    - register_set: '01/21/2017 00:00:00 +0400 UTC'
    - normalize:
        routine: date_format
        args:
            format_in: "%m/%d/%Y %T %z %Z"
            add_years: 10
            add_months: 5
            add_days: 1
            add_hours: 6
            add_minutes: 15
            add_seconds: 50
            format_out: "%m/%d/%Y %T %z %Z"
    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ: 06/22/2027 06:15:50 +0000 UTC
                

• signature

              # СОЗДАНИЕ ПОДПИСИ
# НАЙДЕМ ПЕРВЫЙ `li`
- find:
    path: 'li#li1'
    do:
    # ЗАПОЛНИМ РЕГИСТР ТЕКСТОВЫМ СОДЕРЖИМЫМ БЛОКА
    - parse

    # В РЕГИСТРЕ "Text and text"
    - normalize:
        routine: signature
        args:
            algo: HMAC
            cypher: SHA256
            encode: Base64
            secret: A6A7A8A9

    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ: eQZxtV7Ae/wu3Enx8C2po9L7j3cefePEwoFZiTmkb7M=
              

• base64
• md5

              # НАЙДЕМ ПЕРВЫЙ `li`
- find:
    path: 'li#li1'
    do:
    # ЗАПОЛНИМ РЕГИСТР ТЕКСТОВЫМ СОДЕРЖИМЫМ БЛОКА
    - parse
    # В РЕГИСТРЕ "Text and text"

    - normalize:
        routine: base64
    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ: VGV4dCBhbmQgdGV4dA==
              

              # НАЙДЕМ ПЕРВЫЙ `li`
- find:
    path: 'li#li1'
    do:
    # ЗАПОЛНИМ РЕГИСТР ТЕКСТОВЫМ СОДЕРЖИМЫМ БЛОКА
    - parse
    # В РЕГИСТРЕ "Text and text"

    - normalize:
        routine: md5
    # В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ: be8bde1051516b04402f02e00b4687b7
              

• base64zlib_decode

              # УСТАНОВИМ ЗНАЧЕНИЕ РЕГИСТРА В ФОРМАТЕ BASE64 ZLIB
# ЗДЕСЬ МЫ ИМЕЕМ ЗАКОДИРОВАННОЕ ЗНАЧЕНИЕ ДЛЯ СТРОКИ: some text
- register_set: eJwrzs9NVShJrSgBABHoA5o=

# ДЕКОДИРУЕМ ЗНАЧЕНИЕ
- normalize:
    routine: Base64ZLIBDecode

# В РЕГИСТРЕ ТЕПЕРЬ НАХОДИТСЯ: some text