2015-12-17 5 views
2

Каково стандартное значение Python для «версии» и «выпуска»? В частности, я смущен тем, как сгладить использование Sphinx терминов с их использованием в PEP 0440.Каковы стандартные значения Python для «версии» и «выпуска»?

Например sphinx-quickstart запрашивает версию с

Sphinx имеет понятие «версия» и «освобождение» для программного обеспечения. Каждая версия может иметь несколько выпусков. Например, для Python версия - это что-то вроде 2.5 или 3.0, а релиз - это что-то , например 2.5.1 или 3.0a1. Если вам не нужна эта двойная структура, просто установите как на то же значение.

и создает конфигурационный файл, содержащий

# The short X.Y version. 
version = ... 
# The full version, including alpha/beta/rc tags. 
release = ... 

Но PEP 0440 описывает «освобождение» как имеющий он образует N(.N)*, кажется, использует термин «вариант», чтобы обратиться к «полной версии», которые используются Сфинкс (т. Е. Его «релиз»).

Что такое «версия» Python и как она отличается от «выпуска»? В частности, означает ли Sphinx стандартную интерпретацию этих терминов?

ответ

2

Это на самом деле очень последовательный. Это N(.N)* не относится к версии она описывает, как форматировать нумерацию в выпуска:

Сегмент высвобождения состоит из одного или более неотрицательных целых значений, разделенных точками

Если вы задаетесь вопросом, как определено релиз см PEP 0426:

«релизы» однозначно идентифицируются снимки проекта.

Так что да, Sphinx действительно представляет стандартную интерпретацию

+1

Да, но «один или более неотрицательные целые значения, разделенные точками» не примиряет с «включая альфа/бета/RC-тег». Кроме того, термин «версия», по-видимому, нигде не определен (и является типом циркуляра, используемым в комментариях Sphinx 'config.py'). Есть ли явное указание того, что означает это слово? – orome

+0

@raxacoricofallapatorius Это идентификатор распространения, как описано в PEP 0426: * «Идентификатор публичной или локальной версии дистрибутива» *, , а затем в PEP 0440: * «Схема версии используется как для описания версии распространения, предоставляемой конкретным дистрибутивный архив, а также устанавливать ограничения на версию зависимостей, необходимых для создания или запуска программного обеспечения »* – yuvi

 Смежные вопросы

  • Нет связанных вопросов^_^