dephell-versioning 0.1.2

dephell_versioning

提升项目版本的库。

可用方案

• calver
• comver
• pep
• roman
• romver
• semver
• serial
• zerover

可用规则（及其别名）

• init -- 初始化版本控制
• 主要部分
  • major （破坏性）
  • minor （特性）
  • patch （修复，微观）
• 附加部分
  • dev
  • local
  • post
• 预发布管理
  • pre （rc，alpha，beta）
  • premajor （预破坏性）
  • preminor （预特性）
  • prepatch （预修复，预微观）
  • release

在dephell项目提升的文档中了解更多关于方案和规则的信息。

安装

从PyPI安装

python3 -m pip install --user dephell_versioning

用法

获取可用方案、规则和别名

from dephell_versioning import get_aliases, get_rules, get_schemes
get_schemes()
# frozenset({'roman', 'pep', ..., 'comver'})

get_rules()
# frozenset({'local', 'minor', ..., 'dev', 'preminor'})

get_aliases()
# frozenset({'alpha', 'rc', ..., 'micro', 'breaking'})

# get rules for some scheme:
get_rules(scheme='calver')
# frozenset({'major', 'patch', 'init'})

# get aliases for specific rules:
get_aliases(rules={'major', 'minor'})
# frozenset({'feature', 'breaking'})

提升版本

from dephell_versioning import bump_version

bump_version(version='1.2.3', rule='minor', scheme='semver')
# '1.3.0'

# pass aliase instead of rule:
bump_version(version='1.2.3', rule='feature', scheme='semver')
# '1.3.0'

# start rule from `+` to attach local version number:
bump_version(version='1.2.3', rule='+456', scheme='semver')
# '1.2.3+456'

# for `init` version is optional
bump_version(version='', rule='init', scheme='semver')
# '0.1.0'

在Python文件中提升版本

from dephell_versioning import bump_file
from pathlib import Path

# returns `True` if version was bumped
bump_file(path=Path('dephell_versioning', '__init__.py'), old='0.1.0', new='0.1.1')
# True

# old version is optional: any version will be bumped if old isn't found
bump_file(path=Path('dephell_versioning', '__init__.py'), old='', new='0.1.2')
# True

使用dephell_discover来查询Python项目的当前版本

from dephell_discover import Root
from pathlib import Path
root = Root(path=Path(), name='dephell_discover')

# root.metainfo can be None if project isn't found in the given directory
if root.metainfo:
    print(root.metainfo.version)
# '0.1.2'