Metadata-Version: 1.1
Name: rutimeparser
Version: 1.1.0
Summary: Recognize date and time in russian text.
Home-page: https://github.com/orsinium/rutimeparser
Author: orsinium
Author-email: master_fess@mail.ru
License: GNU Lesser General Public License v3.0
Download-URL: https://github.com/orsinium/rutimeparser/tarball/master
Description: RuTimeParser
        ============
        
        Данный модуль содержит базовый класс и упрощающие работу с ним функции
        для извлечения даты и времени из текста на русском языке.
        
        Установка
        ---------
        
        ``sudo pip3 install rutimeparser``
        
        Использование
        -------------
        
        Примеры ниже приведены для 2 апреля 2017 года.
        
        Извлечение даты и времени:
        
        .. code:: python
        
            >>> from rutimeparser import parse
            >>> parse('завтра')
            datetime.date(2017, 4, 3)
            >>> parse('завтра утром')
            datetime.datetime(2017, 4, 3, 9, 0)
            >>> parse('Напомни мне завтра утром составить список дел.')
            datetime.datetime(2017, 4, 3, 9, 0)
        
        Извлечение текста, не относящегося к дате и времени:
        
        .. code:: python
        
            >>> from rutimeparser import get_clear_text, get_last_clear_text
            >>> get_clear_text('Напомни мне завтра утром составить список дел.')
            'напомни мне составить список дел'
            >>> get_last_clear_text('Напомни мне завтра утром составить список дел.')
            'составить список дел'
        
        Неявные ситуации
        ----------------
        
        -  ``утром`` - в 09:00
        -  ``днём`` - в 15:00
        -  ``вечером`` - в 21:00
        -  ``ночью`` - в 03:00
        -  ``на следующей неделе`` - на следующей неделе в понедельник.
        -  ``через неделю`` - ровно через 7 суток.
        -  ``через неделю утром`` - через 7 дней утром.
        -  ``в следующем месяце`` - 1 число следующего месяца.
        
        Больше примеров в `tests.py <tests.py>`__
        
        API reference
        -------------
        
        Параметры ``rutimeparser.parse``:
        
        -  ``words`` (str, list, tuple) -- Строка с текстом или список слов.
           Параметр является необязательным, т.к. может быть передан
           непосредственно в метод ``parse``.
        -  ``tz`` (str) -- Название часового пояса. Если не указано,
           возвращается наивное время.
        -  ``now`` (datetime.datetime) -- От какого момента считать текущее
           время
        -  ``allowed_results`` (list, tuple) -- Список объектов, которые могут
           быть возвращены методом ``parse``. Возможные значения -- datetime,
           date, time, None.
        -  ``default_time`` (datetime.time) -- Время по умолчанию. Используется
           только в том случае, если из текста удалось получить только date, но
           необходимо вернуть datetime. По умолчанию 09:00.
        -  ``default_datetime`` (datetime.datetime) -- Дата и время по
           умолчанию. Возвращается методом ``parse``, если в тексте не удалось
           найти значение, подходящее под ``allowed_results``. По умолчанию
           равен значению параметра ``now``.
        
        TODO
        ----
        
        -  Перейти на ``pymorphy``
        -  Добавить поддержку AM/PM (например, "в два часа дня")
        
Keywords: timeparser parse date time datetime russian text
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Plugins
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
Classifier: Natural Language :: Russian
Classifier: Programming Language :: Python
Classifier: Topic :: Scientific/Engineering :: Human Machine Interfaces
Requires: python (>= 3.4)
