import re
+from regexes import re_verwithext
+from dak_exceptions import UnknownFormatError
+
srcformats = []
+def get_format_from_string(txt):
+ """
+ Returns the SourceFormat class that corresponds to the specified .changes
+ Format value. If the string does not match any class, UnknownFormatError
+ is raised.
+ """
+
+ for format in srcformats:
+ if format.re_format.match(txt):
+ return format
+
+ raise UnknownFormatError, "Unknown format %r" % txt
+
+def parse_format(txt):
+ """
+ Parse a .changes Format string into a tuple representation for easy
+ comparison.
+
+ >>> parse_format('1.0')
+ (1, 0)
+ >>> parse_format('8.4 (hardy)')
+ (8, 4, 'hardy')
+
+ If the format doesn't match these forms, raises UnknownFormatError.
+ """
+
+ format = re_verwithext.search(txt)
+
+ if format is None:
+ raise UnknownFormatError, txt
+
+ format = format.groups()
+
+ if format[1] is None:
+ format = int(float(format[0])), 0, format[2]
+ else:
+ format = int(format[0]), int(format[1]), format[2]
+
+ if format[2] is None:
+ format = format[:2]
+
+ return format
+
class SourceFormat(type):
def __new__(cls, name, bases, attrs):
klass = super(SourceFormat, cls).__new__(cls, name, bases, attrs)
srcformats.append(klass)
assert str(klass.name)
+ assert iter(klass.requires)
+ assert iter(klass.disallowed)
+
klass.re_format = re.compile(klass.format)
return klass
-class FormatOne(object):
+ @classmethod
+ def reject_msgs(cls, has):
+ if len(cls.requires) != len([x for x in cls.requires if has[x]]):
+ yield "lack of required files for format %s" % cls.name
+
+ for key in cls.disallowed:
+ if has[key]:
+ yield "contains source files not allowed in format %s" % cls.name
+
+ @classmethod
+ def validate_format(cls, format, is_a_dsc=False, field='files'):
+ """
+ Raises UnknownFormatError if the specified format tuple is not valid for
+ this format (for example, the format (1, 0) is not valid for the
+ "3.0 (quilt)" format). Return value is undefined in all other cases.
+ """
+ pass
+
+class FormatOne(SourceFormat):
__metaclass__ = SourceFormat
name = '1.0'
format = r'1.0'
+ requires = ()
+ disallowed = ('debian_tar', 'more_orig_tar')
+
@classmethod
- def reject_msgs(cls, native_tar, native_tar_gz, debian_tar, debian_diff, orig_tar, orig_tar_gz, more_orig_tar):
- if not (native_tar_gz or (orig_tar_gz and debian_diff)):
+ def reject_msgs(cls, has):
+ if not (has['native_tar_gz'] or (has['orig_tar_gz'] and has['debian_diff'])):
yield "no .tar.gz or .orig.tar.gz+.diff.gz in 'Files' field."
- if (orig_tar_gz != orig_tar) or \
- (native_tar_gz != native_tar) or \
- debian_tar or more_orig_tar:
+ if has['native_tar_gz'] and has['debian_diff']:
+ yield "native package with diff makes no sense"
+ if (has['orig_tar_gz'] != has['orig_tar']) or \
+ (has['native_tar_gz'] != has['native_tar']):
yield "contains source files not allowed in format %s" % cls.name
-class FormatThree(object):
+ for msg in super(FormatOne, cls).reject_msgs(has):
+ yield msg
+
+ @classmethod
+ def validate_format(cls, format, is_a_dsc=False, field='files'):
+ msg = "Invalid format %s definition: %r" % (cls.name, format)
+
+ if is_a_dsc:
+ if format != (1, 0):
+ raise UnknownFormatError, msg
+ else:
+ if (format < (1,5) or format > (1,8)):
+ raise UnknownFormatError, msg
+ if field != "files" and format < (1,8):
+ raise UnknownFormatError, msg
+
+class FormatThree(SourceFormat):
__metaclass__ = SourceFormat
name = '3.x (native)'
format = r'3\.\d+ \(native\)'
+ requires = ('native_tar',)
+ disallowed = ('orig_tar', 'debian_diff', 'debian_tar', 'more_orig_tar')
+
@classmethod
- def reject_msgs(cls, native_tar, native_tar_gz, debian_tar, debian_diff, orig_tar, orig_tar_gz, more_orig_tar):
- if not native_tar:
- yield "lack of required files for format %s" % cls.name
- if orig_tar or debian_diff or debian_tar or more_orig_tar:
- yield "contains source files not allowed in format %s" % cls.name
+ def validate_format(cls, format, **kwargs):
+ if format != (3, 0, 'native'):
+ raise UnknownFormatError, "Invalid format %s definition: %r" % \
+ (cls.name, format)
-class FormatThreeQuilt(object):
+class FormatThreeQuilt(SourceFormat):
__metaclass__ = SourceFormat
name = '3.x (quilt)'
format = r'3\.\d+ \(quilt\)'
+ requires = ('orig_tar', 'debian_tar')
+ disallowed = ('debian_diff', 'native_tar')
+
@classmethod
- def reject_msgs(cls, native_tar, native_tar_gz, debian_tar, debian_diff, orig_tar, orig_tar_gz, more_orig_tar):
- if not(orig_tar and debian_tar):
- yield "lack of required files for format %s" % cls.name
- if debian_diff or native_tar:
- yield "contains source files not allowed in format %s" % cls.name
+ def validate_format(cls, format, **kwargs):
+ if format != (3, 0, 'quilt'):
+ raise UnknownFormatError, "Invalid format %s definition: %r" % \
+ (cls.name, format)