Page MenuHomePhabricator

[RfC] Figure out the version format
Closed, ResolvedPublic

Description

There were multiple discussions about versioning around the Phab and Gerrit, some of them:

Let's move the discussion to one task. Current state (6/2018):

  • Pypi, GitHub, Differential, HISTORY.rst, docs/conf.py: 3.0.20180603
  • Pip: 3.0.dev0 (what? T198374)
  • ChangeLog: 3.0.20170713 (T196258)
  • pywikibot/__init__.py, scripts/version.py (python pwb.py version): 3.1.dev0
  • README-conversion.txt: version 3 (should be ok)

Event Timeline

CommunityTechBot renamed this task from 3gaaaaaaaa to [RfC] Figure out the version format.Jul 2 2018, 10:55 AM
CommunityTechBot raised the priority of this task from High to Needs Triage.
CommunityTechBot updated the task description. (Show Details)
CommunityTechBot added a subscriber: Aklapper.
Xqt triaged this task as High priority.Jan 8 2019, 9:56 AM

Implementing semver would require to change our deployment model to PyPI, or not?

No it does not.

Okay, still I'm lost with what would SemVer actually mean. The proposed SemVer patch does not seems to use SemVer and its description lacks how it would work.

(moved the discussion to the correct place)

Change 409823 had a related patch set uploaded (by Xqt; owner: Xqt):
[pywikibot/core@master] [PEP440] Enable semver versioning for pywikibot (PEP 440)

https://gerrit.wikimedia.org/r/409823

Proposal for versioning with given sample:

  • 4.0.0 - mayor release when the Python base is changed and older releases are given up such as Python 2.7 or Python 3.4 or MediaWiki support is changed and older releases are given up such as MW < 1.19 or framework code has mayor changes or significant framework has a breaking change or is removed without any announcement
  • 3.1.0 - minor release - the usual version increment even if the framework code has breaking changes which was announced previously
  • 3.0.3 - bugfixes and L10N/i18n updates only

Change 608046 had a related patch set uploaded (by Xqt; owner: Xqt):
[pywikibot/core@master] [doc] use version from pywikibot/__init__

https://gerrit.wikimedia.org/r/608046

Change 608046 merged by jenkins-bot:
[pywikibot/core@master] [doc] use version from pywikibot/__init__

https://gerrit.wikimedia.org/r/608046

Change 608419 had a related patch set uploaded (by Xqt; owner: Xqt):
[pywikibot/core@master] [IMPR] Use pywikibot.version for version informations

https://gerrit.wikimedia.org/r/c/pywikibot/core/ /608419

Change 608419 merged by jenkins-bot:
[pywikibot/core@master] [IMPR] Use pywikibot.version for version informations

https://gerrit.wikimedia.org/r/608419

Change 409823 merged by jenkins-bot:
[pywikibot/core@master] [IMPR] Use one central point for framework version

https://gerrit.wikimedia.org/r/409823

Xqt claimed this task.