This is an archive of the discontinued Mercurial Phabricator instance.

Status	Author	Revision
Closed	indygreg	D5822 configitems: use raw strings for hidden-{command,topic} items
Closed	indygreg	D5821 convert: use raw string for regular expressions
Closed	indygreg	D5820 graphmod: use raw string
Closed	indygreg	D5819 crecord: use raw string for regular expression
Closed	indygreg	D5818 patch: properly escape \ in string literals
Closed	indygreg	D5817 attr: make some docstrings raw strings
Closed	indygreg	D5816 global: make some docstrings raw strings
Closed	indygreg	D5815 global: use raw strings for regular expressions with escapes

Diff 13805

	"""			"""
	Sentinel to indicate the lack of a value when ``None`` is ambiguous.			Sentinel to indicate the lack of a value when ``None`` is ambiguous.
	"""			"""


	def attr(default=NOTHING, validator=None,			def attr(default=NOTHING, validator=None,
	repr=True, cmp=True, hash=None, init=True,			repr=True, cmp=True, hash=None, init=True,
	convert=None, metadata={}):			convert=None, metadata={}):
	"""			r"""
	Create a new attribute on a class.			Create a new attribute on a class.

	.. warning::			.. warning::

	Does not do anything unless the class is also decorated with			Does not do anything unless the class is also decorated with
	:func:`attr.s`!			:func:`attr.s`!

	:param default: A value that is used if an ``attrs``-generated ``__init__``			:param default: A value that is used if an ``attrs``-generated ``__init__``

	"""			"""
	return (			return (
	frozenset(cls for cls in what if isclass(cls)),			frozenset(cls for cls in what if isclass(cls)),
	frozenset(cls for cls in what if isinstance(cls, Attribute)),			frozenset(cls for cls in what if isinstance(cls, Attribute)),
	)			)


	def include(*what):			def include(*what):
	"""			r"""
	Whitelist what.			Whitelist what.

	:param what: What to whitelist.			:param what: What to whitelist.
	:type what: :class:`list` of :class:`type` or :class:`attr.Attribute`\ s			:type what: :class:`list` of :class:`type` or :class:`attr.Attribute`\ s

	:rtype: :class:`callable`			:rtype: :class:`callable`
	"""			"""
	cls, attrs = _split_what(what)			cls, attrs = _split_what(what)

	def include_(attribute, value):			def include_(attribute, value):
	return value.__class__ in cls or attribute in attrs			return value.__class__ in cls or attribute in attrs

	return include_			return include_


	def exclude(*what):			def exclude(*what):
	"""			r"""
	Blacklist what.			Blacklist what.

	:param what: What to blacklist.			:param what: What to blacklist.
	:type what: :class:`list` of classes or :class:`attr.Attribute`\ s.			:type what: :class:`list` of classes or :class:`attr.Attribute`\ s.

	:rtype: :class:`callable`			:rtype: :class:`callable`
	"""			"""
	cls, attrs = _split_what(what)			cls, attrs = _split_what(what)

	def exclude_(attribute, value):			def exclude_(attribute, value):
	return value.__class__ not in cls and attribute not in attrs			return value.__class__ not in cls and attribute not in attrs

	return exclude_			return exclude_