Known subclasses: gbp.deb.policy.DebianPkgPolicy, gbp.rpm.policy.RpmPkgPolicy

Common helpers for packaging policy.

Class Variable packagename_re Undocumented
Class Variable packagename_msg Undocumented
Class Variable upstreamversion_re Undocumented
Class Variable upstreamversion_msg Undocumented
Class Method is_valid_packagename Is this a valid package name?
Class Method is_valid_upstreamversion Is this a valid upstream version number?
Class Method is_valid_orig_archive Is this a valid orig source archive
Static Method guess_upstream_src_version Guess the package name and version from the filename of an upstream archive.
Static Method has_orig Check if orig tarball exists in dir
Static Method symlink_orig symlink orig tarball from orig_dir to output_dir @return: True if link was created or src == dst False in case of error or src doesn't exist
packagename_re =
Undocumented
packagename_msg =
Undocumented
upstreamversion_re =
Undocumented
upstreamversion_msg =
Undocumented
@classmethod
def is_valid_packagename(cls, name):

Is this a valid package name?

>>> PkgPolicy.is_valid_packagename('doesnotmatter')
Traceback (most recent call last):
...
NotImplementedError: Class needs to provide packagename_re
@classmethod
def is_valid_upstreamversion(cls, version):

Is this a valid upstream version number?

>>> PkgPolicy.is_valid_upstreamversion('doesnotmatter')
Traceback (most recent call last):
...
NotImplementedError: Class needs to provide upstreamversion_re
@classmethod
def is_valid_orig_archive(cls, filename):

Is this a valid orig source archive

@staticmethod
def guess_upstream_src_version(filename, extra_regex=""""""):

Guess the package name and version from the filename of an upstream archive.

Parametersfilenamefilename (archive or directory) from which to guess (type: string)
extra_regexadditional regex to apply, needs a 'package' and a 'version' group
Returns(package name, version) or ('', '') (type: tuple
>>> PkgPolicy.guess_upstream_src_version('foo-bar_0.2.orig.tar.gz')
('foo-bar', '0.2')
>>> PkgPolicy.guess_upstream_src_version('foo-Bar_0.2.orig.tar.gz')
('', '')
>>> PkgPolicy.guess_upstream_src_version('git-bar-0.2.tar.gz')
('git-bar', '0.2')
>>> PkgPolicy.guess_upstream_src_version('git-bar-0.2-rc1.tar.gz')
('git-bar', '0.2-rc1')
>>> PkgPolicy.guess_upstream_src_version('git-bar-0.2:~-rc1.tar.gz')
('git-bar', '0.2:~-rc1')
>>> PkgPolicy.guess_upstream_src_version('git-Bar-0A2d:rc1.tar.bz2')
('git-Bar', '0A2d:rc1')
>>> PkgPolicy.guess_upstream_src_version('git-1.tar.bz2')
('git', '1')
>>> PkgPolicy.guess_upstream_src_version('kvm_87+dfsg.orig.tar.gz')
('kvm', '87+dfsg')
>>> PkgPolicy.guess_upstream_src_version('foo-Bar-a.b.tar.gz')
('', '')
>>> PkgPolicy.guess_upstream_src_version('foo-bar_0.2.orig.tar.xz')
('foo-bar', '0.2')
>>> PkgPolicy.guess_upstream_src_version('foo-bar_0.2.orig.tar.lzma')
('foo-bar', '0.2')
>>> PkgPolicy.guess_upstream_src_version('foo-bar-0.2.zip')
('foo-bar', '0.2')
>>> PkgPolicy.guess_upstream_src_version('foo-bar-0.2.tlz')
('foo-bar', '0.2')
>>> PkgPolicy.guess_upstream_src_version('foo-bar_0.2.tar.gz')
('foo-bar', '0.2')
)
@staticmethod
def has_orig(orig_file, dir):

Check if orig tarball exists in dir

@staticmethod
def symlink_orig(orig_file, orig_dir, output_dir, force=(False)):

symlink orig tarball from orig_dir to output_dir

ReturnsTrue if link was created or src == dst False in case of error or src doesn't exist
API Documentation for git-buildpackage, generated by pydoctor at 2020-05-22 08:50:00.