Конвенции для устойчивости поля пакетов Cabal

StackOverflow https://stackoverflow.com/questions/3841218

  •  27-09-2019
  •  | 
  •  

Вопрос

Cabal позволяет бесплатно Устойчивость поле:

Стабильность: свободная форма

Уровень стабильности пакета, например alpha, experimental, provisional, stable.

Каковы общинные конвенции об этих значениях стабильности? Что считается experimental И что такое provisional? Я вижу, что только несколько пакетов объявляются как stable. Отказ Какую стабильность это относится к устойчивости открытого API или окончательное отсутствие состояния программного обеспечения?

Это было полезно?

Решение

Поле в основном несуществуется сейчас и не должно использоваться. Как сказал Макс, это, вероятно, будет заменено чем-то значимым в будущем.

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

Другие советы

В настоящее время это поле является очень низким руководством к стабильности библиотеки, поэтому в основном игнорируется. Coutts Дункан (один из главных разработчиков Cabal and Hackage) сказал, что в конечном итоге он планирует полностью заменить это поле целиком, с чем-то вроде системы социальной голосования на Hackage.

Лично (а я не одинок) Я просто всегда опускаю поле стабильности. Учитывая, что он уйдет, его, вероятно, не стоит потерять спать над тем, что в него вводить.

Оригинальные предполагаемые значения были:

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

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

Так как Саймон Марлоу Указывает, это описано в проектном предложении для первого набора иерархических библиотек Haskell. Оригинальная ссылка мертва, но вы можете найти копию в WAPEBAK MACHITE.

Лицензировано под: CC-BY-SA с атрибуция
Не связан с StackOverflow
scroll top