collects 1.0.1__tar.gz

collects-1.0.1/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011-2026 Sergey Astanin and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

collects-1.0.1/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.4
+Name: collects
+Version: 1.0.1
+Summary: collects
+Author: ops
+License: Python Script
+License-File: LICENSE
+Requires-Dist: blessings~=1.7
+Provides-Extra: dev
+Requires-Dist: pytest>=3.2; extra == "dev"
+Dynamic: author
+Dynamic: license
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: summary

collects-1.0.1/README

@@ -0,0 +1 @@
+README.md

collects-1.0.1/collects/__init__.py

@@ -0,0 +1,56 @@
+"""collections_extended contains a few extra basic data structures."""
+from collections.abc import Collection
+
+from .bags import bag, frozenbag, UniqueElementsView, CountsView, Bag  # noqa
+from .bijection import bijection
+from .indexed_dict import IndexedDict
+from .range_map import RangeMap, MappedRange  # noqa
+from .setlists import frozensetlist, setlist, SetList
+
+__all__ = (
+	'Collection',
+	'Bag',
+	'bag',
+	'frozenbag',
+	'bijection',
+	'IndexedDict',
+	'RangeMap',
+	'SetList',
+	'frozensetlist',
+	'setlist',
+	)
+
+
+def collection(iterable=None, mutable=True, ordered=False, unique=False):
+	"""Return a :class:`Collection` with the specified properties.
+
+	Args:
+		iterable (Iterable): collection to instantiate new collection from.
+		mutable (bool): Whether or not the new collection is mutable.
+		ordered (bool): Whether or not the new collection is ordered.
+		unique (bool): Whether or not the new collection contains only unique values.
+	"""
+	if iterable is None:
+		iterable = tuple()
+	if unique:
+		if ordered:
+			if mutable:
+				return setlist(iterable)
+			else:
+				return frozensetlist(iterable)
+		else:
+			if mutable:
+				return set(iterable)
+			else:
+				return frozenset(iterable)
+	else:
+		if ordered:
+			if mutable:
+				return list(iterable)
+			else:
+				return tuple(iterable)
+		else:
+			if mutable:
+				return bag(iterable)
+			else:
+				return frozenbag(iterable)

collects-1.0.1/collects/_util.py

@@ -0,0 +1,70 @@
+"""util functions for collections_extended."""
+from functools import wraps
+import textwrap
+import warnings
+
+__all__ = ('hash_iterable', 'deprecated', 'deprecation_warning')
+
+
+def hash_iterable(it):
+	"""Perform a O(1) memory hash of an iterable of arbitrary length.
+
+	hash(tuple(it)) creates a temporary tuple containing all values from it
+	which could be a problem if it is large.
+
+	See discussion at:
+	https://groups.google.com/forum/#!msg/python-ideas/XcuC01a8SYs/e-doB9TbDwAJ
+	"""
+	hash_value = hash(type(it))
+	for value in it:
+		hash_value = hash((hash_value, value))
+	return hash_value
+
+
+def deprecation_warning(msg):
+	"""Raise a deprecation warning."""
+	warnings.warn(msg, category=DeprecationWarning, stacklevel=2)
+
+
+def deprecated(msg, dep_version):
+	"""Decorate a function, method or class to mark as deprecated.
+
+	Raise DeprecationWarning and add a deprecation notice to the docstring.
+
+	Args:
+		msg: The message to document
+		dep_version: The version in which this was deprecated
+	See:
+		https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-deprecated
+
+	"""
+	def wrapper(func):
+		docstring = func.__doc__ or ''
+		docstring_msg = '.. deprecated:: {version} {msg}'.format(
+			version=dep_version,
+			msg=msg,
+			)
+		if docstring:
+			# We don't know how far to indent this message
+			# so instead we just dedent everything.
+			string_list = docstring.splitlines()
+			first_line = string_list[0]
+			remaining = textwrap.dedent(''.join(string_list[1:]))
+			docstring = '\n'.join([
+				first_line,
+				remaining,
+				'',
+				docstring_msg,
+				])
+		else:
+			docstring = docstring_msg
+		func.__doc__ = docstring
+
+		@wraps(func)
+		def inner(*args, **kwargs):
+			deprecation_warning(msg)
+			return func(*args, **kwargs)
+
+		return inner
+
+	return wrapper

collects-1.0.1/collects/_version.py

@@ -0,0 +1,2 @@
+"""Module to store version so it can be imported in other modules."""
+__version__ = '2.0.2'