Точки входа: Как определить точку входа на бирже?

Как найти правильную точку входа? Топ-5 способов

Выйти на новый уровень трейдинга

Представьте, что вы начинающий трейдер и дебютируете в биржевой игре с горящими глазами и в надежде получить первую прибыль. Но с чего начать? Как определить удачные точки входа в трейдинг? Как определить, когда лучше покупать торговую пару и какой самый подходящий момент для ее продажи? Иными словам, необходимо правильно установить точки входа и выхода в рынок, чтобы не упустить доход при снижении стоимости активов. Найти точки входа в биржевой рынок — значит найти самые удачные места, где нужно открывать сделку. Причем это могут быть как параметры цены, так и времени.

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

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

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

Итак, как правильно определить точку входа в рынок? Какие точки входа в рынок криптовалют? Как сделать точный вход в рынок форекс? В этой статье мы будем говорить именно об этом.

ТЕОРИЯ

Для начала немного теории. Для того чтобы выбрать наиболее удачную точку входа в трейдинг, трейдер должен проанализировать рынок. В классическом анализе используются три основных индикатора (уровня), по которым игрок ориентируется и принимает решение о входе или выходе из рынка. 

Три основных уровня:

• уровень поддержки — ценовой уровень, при достижении которого, график движения вниз разворачивается в обратную сторону. Данный уровень, будто поддерживает цену, не давая спуститься ей ниже;
• уровень сопротивления — ценовой уровень, при достижении которого, график движения вверх разворачивается в обратную сторону. В данном случае, уровень оказывает сопротивление цене, не давая ей вырасти выше;
• зеркальный уровень — этот уровень содержит максимальное количество информации. У него плавающая структура и момент его преобразования происходит, когда уровень сопротивления переходит в уровень поддержки или наоборот. В реальности это означает, что один из игроков рынка (быки или медведи) побеждает другого.

Другие уровни достаточно условны и могут использоваться трейдерами там, где они считают нужным их провести, например, чтобы определить индикатор входа в рынок форекс. Опытные игроки видят и выбирают точку опоры для будущих шагов достаточно легко. Однако, Александр Герчик советует новичкам чертить уровни около сильных точек — длинных проторговок или изломов тренда, дабы избежать лишнего риска.

ПРАКТИКА: ТОЧКИ ВХОДА В РЫНОК

Теперь от теории к практике. Как правильно определить точку входа в рынок? Как осуществить поиск точек входа в рынок? Как без помощи специальных индикаторов войти в рынок и начать торговать? Вашему вниманию 7 наиболее простых и эффективных точек входа на рынок.

ТОЧКА 1. Уровень поддержки восходящего тренда.

Первая и одна из самых простых точек входа — третье касание цены при восходящем тренде. Когда отслеживается рост цен (восходящий тренд), появляется возможность провести наклонную линию вверх на графике. Это необходимо делать по двум основаниям ценовых барьеров, которые последовательно повышаются и имеют абсолютное дно по отношению к двум предыдущим и двум следующим основаниям.

Именно третье касание линии графиком свидетельствует о том, что это наиболее удачная точка входа в трейдинг.

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

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

ТОЧКА 2. Уровень сопротивления нисходящего тренда.

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

Ориентироваться, как и в предыдущей точке, лучше на основании дневного графика, но для более точной информации не помешает использовать получасовые и часовые графики. 

Данный метод торгов крайне надежен и прост. Но, как и любой другой инструментарий имеет множество нюансов, о которых более подробно рассказывает Александр Герчик в своем курсе по трейдингу.

ТОЧКА 3. Открытие позиции при прорыве уровня сопротивления.

В момент сомнения как правильно определить точку входа в рынок, часто приходится наблюдать, как цены движутся вверх, причем это движение развивается зигзагообразно. Обычно, в первой трети роста цены актива, когда тренд уже обозначился и покупатели (быки) активно взяли инициативу в свои руки, продавцы (медведи) еще не утратили своих амбиций и им удается за каждым ценовым пиком сбить цены до уровня предпоследнего максимума. При уверенном тренде, глубина коррекции редко пересекает порог в 23% и совсем редко в 38% от последнего движения вниз, которое завершено.

Вот именно в этом промежутке — между точкой 38% и последней вершиной и следует покупать активы.

ТОЧКА 4. Открытие позиции при прорыве уровня поддержки.

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

ТОЧКА 5. Вход при прохождении контр-тренда снизу вверх.

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

Как раз этот момент и является еще одной точкой для входа в рынок.

ТОЧКА 6. Продажа от контр-тренда.

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

Иными словами, покупка и продажа на контр-тренде — удачная стратегия, если за линией самого тренда фиксируется восходящая альтернатива, и линия сопротивления переходит в линию поддержки. Если значения цены на графике находятся в касательстве с ней — это четкий сигнал покупать активы. Если же ситуация противоположная и уровень поддержки пробит контр-трендом, а затем трансформируется в линию сопротивления, то здесь необходимо зафиксировать прибыль. Особую удачу принесут находящиеся рядом отчетливые зоны коррекции.

ТОЧКА 7. Торговля во флете.

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

• в момент, когда рынок поднимается выше среднего уровня (50% коррекции) последнего из завершенных рыночных движений — нужно покупать;
• в момент, когда рынок падает ниже среднего уровня (50% коррекции) последнего из завершенных движений — нужно продавать. 

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

Чтобы чувствовать себя уверенно при торговле во флете, вам поможет обучающий курс Александра Герчика, где он подробно рассказывает об этом. 

Вышеперечисленные 7 точек входа на рынок не привязаны к какому-то конкретному рынку. Они универсальны. Вы можете использовать их как для входа на рынок форекс, крипто-рынок, фондовую или товарную биржу. Однако, это инструменты. Как определить наиболее оптимальную точку входа? Как их найти? Об этом далее.

 

Часто задаваемые вопросы

• 1

  Что такое Твх в трейдинге?

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

• 2

  Какие существуют индикаторы для входа и выхода из рынка?

  Главными индикаторами для точек входа и выхода есть уровень поддержки, уровень сопротивления и зеркальный уровень.

• 3

  Какие существуют точки входа на рынок торговли?

  Существует 7 основных точек входа на рынок: уровень поддержки восходящего тренда, уровень сопротивления нисходящего тренда, открытие позиции при прорыве уровня сопротивления, открытие позиции при прорыве уровня поддержки, вход при прохождении контр-тренда снизу вверх, продажа от контр-тренда и торговля во флэте.

Результаты в трейдинге индивидуальны и зависят от опыта и личной дисциплины. Улучшить свои навыки и дисциплину можно на нашем Курсе: «Трейдинг Основы»

Научитесь находить точки входа в рынок — Урок Форекс 2

Теперь, когда вы определили общее направление рынка валюты, вы можете продолжить поиск возможностей для трейдинга.

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

Используйте фракталы на 5-минутных графиках

Сначала переключитесь на 5-минутный таймфрейм.

Чтобы определить, насколько далеко от основного направления рынка должна откатиться цена, мы вновь используем фракталы. Вам нужно дождаться пробоя 5-минутного фрактала в направлении, противоположном движению рынка на 30-минутном таймфрейме. Примите во внимание, что этого можно ждать довольно долго – от 15 минут до 2 часов или даже ещё дольше.

Не забывайте следить за общим направлением рынка

Пока вы ждёте формирования и пробоя 5-минутного фрактала, общее направление рынка по 30-минутному графику может измениться. Вам следует проверять направление рынка каждые 30 минут, и если оно изменится, возвращайтесь к первому шагу.

Ваши точки входа зависят от направления рынка

Используйте следующие инструкции в зависимости от того, в каком направлении идёт цена на 30-минутном графике.

Рынок движется вверх: Ищем пробитый нижний фрактал

Как только вы переключитесь на 5-минутный таймфрейм, поставьте вертикальную линию на последней свече графика, как показано ниже. Всё, что было до этого (слева от вертикальной линии), вас не должно интересовать. Вы будете заключать сделку на основании новых данных, которые будут появляться справа от вертикальной линии.

1. Вертикальная линия после перехода к 5-минутному графику: искать точку входа вы будете после этой линии.

Дождитесь формирования и пробоя нижнего фрактала после вертикальной линии

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

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

1. Вертикальная линия показывает момент, когда вы переключились на 5-минутный таймфрейм.
2. После вертикальной линии образовался нижний фрактал.

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

Если до пробоя нашего нижнего фрактала сформируется другой нижний фрактал, дождитесь подтверждения этого фрактала, а затем переместите свою горизонтальную линию на свечу нового фрактала и дожидайтесь её пробоя.

На графике ниже цена пробивает уровень нижнего фрактала.

1. Вертикальная линия показывает момент, когда вы переключились на 5-минутный таймфрейм.
2. После вертикальной линии образовался нижний фрактал.
3. Цена пробила недавно сформировавшийся нижний фрактал number_2 – это ваша торговая возможность.

Рынок движется вниз: Ищем пробитый верхний фрактал

Как только вы переключитесь на 5-минутный таймфрейм, поставьте вертикальную линию на последней свече графика, как показано ниже. Всё, что было до этого (слева от вертикальной линии), вас не должно интересовать. Вы будете заключать сделку на основании новых данных, которые будут появляться справа от вертикальной линии.

1. Вертикальная линия после перехода к 5-минутному графику: искать точку входа вы будете после этой линии.

Дождитесь формирования и пробоя верхнего фрактала после вертикальной линии

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

На графике ниже показано, что у свечи, сформировавшейся после вертикальной линии, образовался верхний фрактал. Поставьте горизонтальную линию на верхней части свечи – вам нужно дождаться, когда цена пробьёт эту линию.

1. Вертикальная линия показывает момент, когда вы переключились на 5-минутный таймфрейм.
2. После вертикальной линии образовался верхний фрактал.

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

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

На графике ниже цена пробивает уровень верхнего фрактала.

1. Вертикальная линия показывает момент, когда вы переключились на 5-минутный таймфрейм.
2. После вертикальной линии образовался верхний фрактал.
3. Цена пробила недавно сформировавшийся верхний фрактал number_2 – это ваша торговая возможность.

Спецификация точек входа

— Руководство пользователя упаковки Python

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

• В дистрибутивах можно указать console_scripts точек входа, каждая из которых ссылается на функция. Когда pip (или другой установщик, поддерживающий console_scripts) устанавливается дистрибутива, он создаст оболочку командной строки для каждой точки входа.

• Приложения могут использовать точки входа для загрузки плагинов; например Пигменты (синтаксис инструмент выделения) может использовать дополнительные лексеры и стили отдельно установленные пакеты. Подробнее об этом см. Создание и обнаружение плагинов.

Формат файла точки входа изначально был разработан для создания пакетов с setuptools для предоставления метаданных точки интеграции, которые будут считываться в среда выполнения с importlib.metadata . Теперь это определяется как интероперабельность PyPA. спецификация, чтобы позволить инструментам сборки, отличным от setuptools, публиковать importlib.metadata совместимые метаданные точки входа и библиотеки времени выполнения другие чем importlib. metadata для переносимого чтения опубликованных метаданных точки входа (возможно, с различными стратегиями кэширования и разрешения конфликтов).

Модель данных

Концептуально точка входа определяется тремя обязательными свойствами:

• Группа , к которой принадлежит точка входа, указывает, к какому объекту она относится. обеспечивает. Например, группа 9.0009 console_scripts для точек входа ссылаясь на функции, которые можно использовать как команду, в то время как pygments.styles — это группа классов, определяющих стили пигментов. Потребитель обычно определяет ожидаемый интерфейс. Чтобы избежать столкновений, потребители, определяющие новую группу, должны использовать имена, начинающиеся с имени PyPI принадлежит потребительскому проекту, за которым следует . . Имена групп должны быть одним или больше групп букв, цифр и знаков подчеркивания, разделенных точками (regex \w+(\.\w+)*$ ).

• Имя идентифицирует эту точку входа в своей группе. Точное значение это зависит от потребителя. Для консольных скриптов имя точки входа это команда, которая будет использоваться для его запуска. В раздаче запись имена точек должны быть уникальными. Если разные дистрибутивы предоставляют одинаковые имя, потребитель решает, как справляться с такими конфликтами. Имя может содержать любые символы, кроме = , но не могут начинаться или заканчиваться пробелами или начните с [ . Для новых точек входа рекомендуется используйте только буквы, цифры, символы подчеркивания, точки и тире (regex [\w.-]+ ).

• Ссылка на объект указывает на объект Python. Он либо в форме importable.module или importable.module:object.attr . Каждая из частей разделены точками, а двоеточие является допустимым идентификатором Python. Его нужно искать так:

   импортировать импортную библиотеку
  modname, qualname_separator, qualname = object_ref. partition(':')
  obj = importlib.import_module(modname)
  если qualname_separator:
      для атрибута в qualname.split('.'):
          obj = getattr(obj, attr)
   

Примечание

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

Также есть необязательное свойство: extras представляют собой набор строк определение дополнительных функций дистрибутива, обеспечивающих точку входа. Если они указаны, точка входа требует зависимости этих «дополнения». См. поле метаданных Provides-Extra (многократное использование).

Использование дополнений для точки входа больше не рекомендуется. Потребители должны поддерживают разбор их из существующих дистрибутивов, но затем могут их игнорировать. Новые инструменты публикации не должны поддерживать указание дополнений. Функциональность работа с дополнительными функциями была привязана к модели setuptools по управлению «яичными» пакетами, но более новые инструменты, такие как pip и virtualenv, используют другую модель.

Формат файла

Точки входа определены в файле с именем entry_points.txt в *.dist-info Каталог дистрибутива. Это каталог описано в разделе Запись установленных проектов для установленных дистрибутивов, и в бинарном формате дистрибутива для колес. В файле используется кодировка символов UTF-8.

Содержимое файла находится в формате INI, прочитанном Python’s configparser модуль. Однако по умолчанию configparser обрабатывает имена как нечувствительные к регистру. тогда как имена точек входа чувствительны к регистру. Анализатор конфигурации с учетом регистра можно сделать так:

 импорт конфигпарсера
класс CaseSensitiveConfigParser (configparser.ConfigParser):
    optionxform = статический метод (строка)
 

Файл точек входа всегда должен использовать = , чтобы отделить имена от значений. (тогда как configparser также позволяет использовать : ).

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

Внутри значения читатели должны принимать и игнорировать пробелы (включая множественные последовательные пробелы) до или после двоеточия, между ссылкой на объект и левая квадратная скобка, между дополнительными именами и квадратными скобками и двоеточия, разделяющие их, и после правой квадратной скобки. Синтаксис для extras официально указан как часть PEP 508 (как extras ) и ограничения на значения, указанные в PEP 685 . Для инструментов, записывающих файл, рекомендуется только вставлять пробел между ссылка на объект и левая квадратная скобка.

Например:

 [console_scripts]
foo = foomod:основной
# Тот, который зависит от дополнений:
foobar = foomod:main_bar [бар,баз]
# плагины pytest ссылаются на модуль, поэтому нет ':obj'
[pytest11]
nbval = nbval.plugin
 

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

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

Например, точка входа mycmd = mymod:main создаст команду mycmd запуск такого скрипта:

 система импорта
из mymod import main
sys.exit(основной())
 

Разница между console_scripts и gui_scripts затрагивает только Системы Windows. console_scripts завернуты в исполняемый файл консоли, поэтому они подключены к консоли и могут использовать sys.stdin , sys.stdout и sys.stderr для ввода и вывода. gui_scripts завернуты в графический интерфейс исполняемые, поэтому их можно запускать без консоли, но нельзя использовать стандартные потоки, если код приложения не перенаправляет их. На других платформах нет такое же различие.

Предполагается, что инструменты установки установят оболочки для console_scripts и gui_scripts в каталоге scripts схемы установки. Они не отвечает за размещение этого каталога в ПУТЬ переменная среды который определяет, где находятся инструменты командной строки.

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

точек входа — setuptools 67.7.0.post20230420 документация

Точки входа — это тип метаданных, которые могут предоставляться пакетами при установке. Это очень полезная функция экосистемы Python. и особенно пригодится в двух сценариях:

1. Пакет должен предоставить команды для запуска на терминале. Эта функция известна как сценарии консоли . Команда также может откройте графический интерфейс, и в этом случае он известен как сценарий GUI . Пример консольного скрипта предоставляется пакетом pip, который позволяет запускать в терминале такие команды, как pip install .

2. Пакет хотел бы разрешить настройку своих функций через плагины . Например, тестовая среда pytest позволяет настройка через pytest11 точка входа и синтаксис выделение пигментов инструмента позволяет указать дополнительные стили используя точку входа pygments.styles .

Консольные сценарии

Начнем с консольных скриптов. Сначала рассмотрим пример без точек входа. Представьте пакет определяется таким образом:

 проект_корневой_каталог
├── pyproject.toml # и/или setup.cfg, setup.py
└── источник
    └── тимминс
        ├── __init__.py
        └── ...
 

с __init__.py как:

 защита hello_world():
    print("Привет, мир")
 

Теперь предположим, что мы хотели бы обеспечить некоторый способ выполнения функция hello_world() из командной строки. Один из способов сделать это заключается в создании файла src/timmins/__main__.py , предоставляющего хук как следует:

 из . импортировать hello_world
если __name__ == '__main__':
    Привет, мир()
 

Затем, после установки пакета timmins , мы можем вызвать привет_мир() работать следующим образом, через runpy модуль:

 $ python -m тимминс
Привет, мир
 

Вместо этого подхода с использованием __main__.py вы также можете создать удобный исполняемый файл CLI, который можно вызывать напрямую без python -m . В приведенном выше примере для создания команды hello-world , которая вызывает timmins.hello_world , добавьте точку входа консольного скрипта в свой конфигурация:

pyproject.toml

 [проект.скрипты]
привет-мир = "тимминс: привет_мир"
 

setup.cfg

 [options. entry_points]
console_scripts =
    привет-мир = тимминс: привет_мир
 

setup.py

 из настройки импорта setuptools
настраивать(
    # ...,
    entry_points={
        'консольные_скрипты': [
            'привет-мир = тимминс: привет_мир',
        ]
    }
)
 

После установки пакета пользователь может вызвать эту функцию, просто вызвав hello-world в командной строке:

 $ привет-мир
Привет, мир
 

Обратите внимание, что любая функция, используемая в качестве консольного скрипта, например hello_world() в этот пример не должен принимать никаких аргументов. Если ваша функция требует каких-либо входных данных от пользователя, вы можете использовать обычные утилиты разбора аргументов командной строки, такие как argparse в теле функция анализа пользовательского ввода, заданного через sys.argv .

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

Скрипты графического интерфейса

В дополнение к console_scripts , Setuptools поддерживает gui_scripts , которые запустит приложение с графическим интерфейсом без запуска в окне терминала.

Например, если у нас есть проект с той же структурой каталогов, что и раньше, с файлом __init__.py , содержащим следующее:

 импортировать PySimpleGUI как sg
определение hello_world():
    sg.Window(title="Hello world", layout=[[]], margins=(100, 50)).read()
 

Затем мы можем добавить точку входа GUI-скрипта:

pyproject.toml

 [project. gui-скрипты]
привет-мир = "тимминс: привет_мир"
 

setup.cfg

 [options.entry_points]
gui_scripts =
    привет-мир = тимминс: привет_мир
 

setup.py

 из настройки импорта setuptools
настраивать(
    # ...,
    entry_points={
        'gui_scripts': [
            'привет-мир = тимминс: привет_мир',
        ]
    }
)
 

Note

Чтобы иметь возможность импортировать PySimpleGUI , вам нужно добавить pysimplegui в зависимости вашего пакета. Дополнительные сведения см. в разделе Управление зависимостями в Setuptools.

Сейчас работает:

 $ привет-мир
 

откроет небольшое окно приложения с заголовком «Hello world».

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

Примечание

Разница между console_scripts и gui_scripts влияет только на Системы Windows. [1] console_scripts завернуты в консоль исполняемый, поэтому они подключены к консоли и могут использовать системный стандарт , sys.stdout и sys.stderr для ввода и вывода. gui_scripts есть завернуты в исполняемый файл с графическим интерфейсом, поэтому их можно запускать без консоли, но не может использовать стандартные потоки, если код приложения не перенаправляет их. Другой платформы не имеют такого же различия.

Примечание

Сценарии консоли и графического интерфейса работают, потому что за кулисами установщики, такие как pip создавать сценарии-оболочки вокруг вызываемых функций. Например, hello-world точка входа в двух приведенных выше примерах создаст команда hello-world запускающая такой скрипт: [1]

 import sys
из тимминса импортировать hello_world
sys. exit(hello_world())
 

Рекламное поведение

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

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

Сценарии консоли/графического интерфейса работают аналогично, когда библиотеки объявляют свои команды и такие инструменты, как pip , создают сценарии-оболочки, которые вызывают эти команды.

Точки входа для плагинов

Давайте рассмотрим простой пример, чтобы понять, как мы можем реализовать точки входа соответствующие плагинам. Скажем, у нас есть пакет timmins со следующим структура каталогов:

 тимминов
├── pyproject.toml # и/или setup.cfg, setup.py
└── источник
    └── тимминс
        └── __init__.py
 

и в src/timmins/__init__.py имеем следующий код:

 защита hello_world():
    print('Привет, мир')
 

По сути, мы определили функцию hello_world() , которая будет печатать текст ‘Привет, мир’. Теперь предположим, что мы хотим напечатать текст «Hello world» на разных языках. способы. Текущая функция просто печатает текст как есть — скажем, нам нужен другой стиль, в котором текст заключен в восклицательные знаки:

 !!! Привет, мир !!!
 

Давайте посмотрим, как это можно сделать с помощью плагинов. Во-первых, давайте разделим стиль печать текста из самого текста. Другими словами, мы можем изменить код в src/timmins/__init__.py примерно так:

 по умолчанию дисплей (текст):
    печать (текст)
определение hello_world():
    display('Привет, мир')
 

Здесь функция display() управляет стилем печати текста, а функция hello_world() вызывает display() функция для вывода текста «Привет мир`.

Прямо сейчас функция display() просто печатает текст как есть. Чтобы иметь возможность чтобы настроить его, мы можем сделать следующее. Введем новую группу точек входа с именем timmins.display и ожидайте, что пакеты плагинов реализуют эту точку входа для предоставления display() -подобной функции. Далее, чтобы иметь возможность автоматически обнаруживать плагин пакеты, которые реализуют эту точку входа, мы можем использовать модуль importlib.metadata , следующим образом:

 из importlib.metadata import entry_points
display_eps = entry_points (group = 'timmins.display')
 

Примечание

Каждый объект importlib.metadata.EntryPoint представляет собой объект, содержащий имя , группа и значение . Например, после настройки пакета плагина как описанном ниже, display_eps в приведенном выше коде будет выглядеть так: [2]

 (
    EntryPoint(name='excl', value='timmins_plugin_fancy:excl_display', group='timmins. display'),
    ...,
)
 

display_eps теперь будет списком из объектов EntryPoint , каждый из которых ссылается на display() -подобно функции, определенные одним или несколькими установленными пакетами плагинов. Затем, чтобы импортировать определенный display() -подобная функция — давайте выберем ту, которая соответствует первой обнаруженной точка входа — мы можем использовать метод load() следующим образом:

 дисплей = display_eps[0].load()
 

Наконец, разумным поведением было бы то, что если мы не можем найти какие-либо пакеты плагинов, настраивающие display() , мы должны вернуться к нашей реализации по умолчанию, которая печатает текст как есть. С учетом этого поведения код в src/timmins/__init__.py наконец становится:

 из importlib.metadata import entry_points
display_eps = entry_points (group = 'timmins.display')
пытаться:
    дисплей = display_eps[0]. load()
кроме IndexError:
    дисплей защиты (текст):
        печать (текст)
определение hello_world():
    display('Привет, мир')
 

Это завершает настройку на timmins со стороны. Далее нам нужно реализовать плагин который реализует точку входа timmins.display . Назовем этот плагин timmins-plugin-fancy и настройте его со следующей структурой каталогов:

 timmins-плагин-фантазия
├── pyproject.toml # и/или setup.cfg, setup.py
└── источник
    └── timmins_plugin_fancy
        └── __init__.py
 

И затем внутри src/timmins_plugin_fancy/__init__.py мы можем поместить функцию по имени excl_display() , который печатает заданный текст, окруженный восклицательными знаками:

 определение excl_display (текст):
    печать('!!!', текст, '!!!')
 

Это display() -подобная функция, которую мы хотим предоставить пакет тимминс . Мы можем сделать это, добавив следующее в конфигурацию из timmins-plugin-fancy :

pyproject. toml

 # Обратите внимание на кавычки вокруг timmins.display , чтобы избежать точки .
[проект.entry-points."timmins.display"]
excl = "timmins_plugin_fancy:excl_display"
 

setup.cfg

 [options.entry_points]
timmins.display =
    excl = timmins_plugin_fancy:excl_display
 

setup.py

 из настройки импорта setuptools
настраивать(
    # ...,
    вход_точки = {
        'timmins.display': [
            'искл = timmins_plugin_fancy:excl_display'
        ]
    }
)
 

По сути, в этой конфигурации указано, что мы являемся точкой входа под группой timmins.display . Точка входа имеет имя кроме и это относится к функции excl_display , определенной пакетом timmins-plugin-fancy .

Теперь, если мы установим оба timmins и timmins-plugin-fancy , мы должны получить следующее:

 >>> из timmins импортировать hello_world
>>> привет_мир()
!!! Привет, мир !!!
 

, тогда как если мы установим только timmins , а не timmins-plugin-fancy , мы должны получить следующее:

 >>> из тимминса импортировать hello_world
>>> привет_мир()
Привет, мир
 

Следовательно, наш плагин работает.

Наш плагин также мог бы определить несколько точек входа в группе timmins.display . Например, в src/timmins_plugin_fancy/__init__.py у нас может быть два display() -подобных функции следующим образом:

 определение excl_display (текст):
    печать('!!!', текст, '!!!')
определение lined_display (текст):
    print(''.join(['-' вместо _ в тексте]))
    печать (текст)
    print(''.join(['-' вместо _ в тексте]))
 

Конфигурация timmins-plugin-fancy изменится на:

pyproject.toml

 [проект.entry-points."timmins.display"]
excl = "timmins_plugin_fancy:excl_display"
lineed = "timmins_plugin_fancy:lined_display"
 

setup.cfg

 [options.entry_points]
timmins.display =
    excl = timmins_plugin_fancy:excl_display
    выровненный = timmins_plugin_fancy:lined_display
 

setup. py

 из настройки импорта setuptools
настраивать(
    # ...,
    вход_точки = {
        'timmins.display': [
            'искл = timmins_plugin_fancy:excl_display',
            'lined = timmins_plugin_fancy:lined_display',
        ]
    }
)
 

На стороне timmins мы также можем использовать другую стратегию загрузки входа точки. Например, мы можем искать определенный стиль отображения:

.

 display_eps = entry_points (group = 'timmins.display')
пытаться:
    дисплей = display_eps['выровненный'].load()
кроме KeyError:
    # если 'линейный' дисплей недоступен, используйте что-то другое
    ...
 

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

 display_eps = entry_points (group = 'timmins.display')
для ep в display_eps:
    дисплей = ep.load()
    # делаем что-нибудь с дисплеем
    ...
 

Другое дело, что в этом конкретном примере мы использовали плагины для настроить поведение функции ( display() ). В общем, мы можем использовать запись указывает, чтобы плагины могли не только настраивать поведение функций, но и целых классов и модулей. Это не похоже на сценарии консоли/графического интерфейса, где точки входа могут ссылаться только на функции. Синтаксис, используемый для указания точки входа остаются теми же, что и для консольных/графических сценариев, и обсуждаются в последний раздел.

Совет

Рекомендуемый подход к загрузке и импорту точек входа: модуль importlib.metadata , которая является частью стандартной библиотеки, начиная с Python 3.8. Для старых версий Python, следует использовать его бэкпорт importlib_metadata. При использовании backport, единственное изменение, которое необходимо сделать, это заменить importlib.metadata с importlib_metadata , т.е.

 из importlib_metadata import entry_points
...
 

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

Синтаксис точек входа

Синтаксис для точек входа указан следующим образом:

 <имя> = <пакет_или_модуль>[:<объект>[.<атрибут>[.<вложенный-атрибут>]*]]
 

Здесь квадратные скобки [] обозначают необязательность, а звездочка * обозначает повторение. имя — это имя сценария/точки входа, которую вы хотите создать, левая рука сторона : — это пакет или модуль, содержащий объект, который вы хотите вызвать. (подумайте об этом как о чем-то, что вы написали бы в операторе импорта), и право сторона стороны — это объект, который вы хотите вызвать (например, функция).

Чтобы сделать этот синтаксис более понятным, рассмотрим следующие примеры:

Упаковка или модуль

При поставке:

 <имя> = <пакет_или_модуль>
 

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

 импорт 
parsed_value = 
 

Объект уровня модуля

Если вы поставляете:

 <имя> = <пакет_или_модуль>:<объект>
 

где <объект> не содержит . , это будет грубо интерпретироваться как:

 из <пакета_или_модуля> импортировать <объект>
parsed_value = <объект>
 

Вложенный объект

Если указать:

 <имя> = <пакет_или_модуль>:<объект>.<атрибут>.<вложенный_атрибут>
 

это будет приблизительно интерпретироваться как:

 из <пакета_или_модуля> импортировать <объект>
parsed_value = <объект>.<атрибут>.<вложенный_атрибут>
 

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