k3priorityqueue 0.1.2__py3-none-any.whl → 0.1.3__py3-none-any.whl

k3priorityqueue/__init__.py

@@ -42,27 +42,20 @@ while True:
 print('consumed all: counts:', repr(count))
 """
 
-# from .proc import CalledProcessError
-# from .proc import ProcError
+from importlib.metadata import version
 
-__version__ = "0.1.2"
-__name__ = "k3priorityqueue"
+__version__ = version("k3priorityqueue")
 
 from .priorityqueue import (
     Empty,
-
     Producer,
     PriorityQueue,
-
     default_priority,
 )
 
 __all__ = [
-    'Empty',
-
-    'Producer',
-    'PriorityQueue',
-
-    'default_priority',
+    "Empty",
+    "Producer",
+    "PriorityQueue",
+    "default_priority",
 ]
-

k3priorityqueue/priorityqueue.py

@@ -30,7 +30,7 @@ class Producer(object):
     def __init__(self, producer_id, priority, iterable):
         self.consumed = 0
         self.iterable_lock = threading.RLock()
-        self.stat = {'get': 0}
+        self.stat = {"get": 0}
         self.cmp_key = (0, 0)
 
         self.producer_id = producer_id
@@ -38,22 +38,20 @@ class Producer(object):
         self.set_iterable(iterable)
 
     def get(self):
-
         with self.iterable_lock:
             try:
                 val = next(self.iterable)
-                self.stat['get'] += 1
+                self.stat["get"] += 1
                 self.consume()
                 return val
             except StopIteration:
-                raise Empty('no more item in ' + str(self))
+                raise Empty("no more item in " + str(self))
 
     def set_priority(self, priority):
-
         priority = float(priority)
 
         if priority <= 0:
-            raise ValueError('priority can not be less or euqal 0: ' + str(priority))
+            raise ValueError("priority can not be less or euqal 0: " + str(priority))
 
         self.priority = priority
         self.item_cost = default_priority / float(self.priority)
@@ -67,7 +65,7 @@ class Producer(object):
         self.cmp_key = (self.consumed, self.item_cost)
 
     def __str__(self):
-        return '[{producer_id}={priority} c={consumed}]'.format(
+        return "[{producer_id}={priority} c={consumed}]".format(
             producer_id=self.producer_id,
             priority=self.priority,
             consumed=self.consumed,
@@ -92,6 +90,7 @@ class PriorityQueue(object):
     To re-enable a producer, call `PriorityQueue.add_producer()` with the same
     `producer_id`.
     """
+
     def __init__(self):
         self.producer_by_id = {}
 
@@ -153,7 +152,6 @@ class PriorityQueue(object):
             del self.producer_by_id[producer_id]
 
     def _remove_from_heaps(self, producer):
-
         try:
             self.empty_heap.remove(producer)
         except k3heap.NotFound:
@@ -166,22 +164,20 @@ class PriorityQueue(object):
 
     def get(self):
         """
-            Returns an item.
+        Returns an item.
         """
         while True:
-
             with self.heap_lock:
                 try:
                     p = self.consumable_heap.get()
                 except k3heap.Empty:
-                    raise Empty('no more queue has any item')
+                    raise Empty("no more queue has any item")
 
                 try:
                     # NOTE: if p.iterable blocks, everything is blocked
                     val = p.get()
 
                 except Empty:
-
                     self.consumable_heap.remove(p)
                     self.empty_heap.push(p)
 
@@ -197,4 +193,4 @@ class PriorityQueue(object):
         for cq in self.producer_by_id.values():
             qs.append(str(cq))
 
-        return ' '.join(qs)
+        return " ".join(qs)

k3priorityqueue/synopsis.py

@@ -16,14 +16,14 @@ for _ in range(12):
     count[val] = count.get(val, 0) + 1
     print(val)
 
-print('respect priority ratio: counts:', repr(count))
+print("respect priority ratio: counts:", repr(count))
 
 while True:
     try:
         val = pq.get()
-    except k3priorityqueue.Empty as e:
+    except k3priorityqueue.Empty:
         break
     count[val] = count.get(val, 0) + 1
     print(val)
 
-print('consumed all: counts:', repr(count))
+print("consumed all: counts:", repr(count))

{k3priorityqueue-0.1.2.dist-info → k3priorityqueue-0.1.3.dist-info}/METADATA

@@ -1,25 +1,39 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: k3priorityqueue
-Version: 0.1.2
-Summary: priorityQueue is a queue with priority support
-Home-page: https://github.com/pykit3/k3priorityqueue
-Author: Zhang Yanpo
-Author-email: drdr.xp@gmail.com
+Version: 0.1.3
+Summary: Priority queue with weighted producer support
+Author-email: Zhang Yanpo <drdr.xp@gmail.com>
 License: MIT
-Keywords: python,priorityqueue
-Platform: UNKNOWN
+Project-URL: Homepage, https://github.com/pykit3/k3priorityqueue
+Project-URL: Documentation, https://k3priorityqueue.readthedocs.io
+Keywords: queue,priority-queue,producer,weighted
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Topic :: Software Development :: Libraries
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: Implementation :: PyPy
-Requires-Python: >=3.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
-Requires-Dist: k3ut (<0.2,>=0.1.15)
-Requires-Dist: k3heap (<0.2,>=0.1.5)
-Requires-Dist: k3thread (<0.2,>=0.1.0)
+License-File: LICENSE
+Requires-Dist: k3heap
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: coverage; extra == "dev"
+Requires-Dist: k3thread; extra == "dev"
+Provides-Extra: publish
+Requires-Dist: build; extra == "publish"
+Requires-Dist: twine; extra == "publish"
+Requires-Dist: pk3; extra == "publish"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.5; extra == "docs"
+Requires-Dist: mkdocs-material>=9.0; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.24; extra == "docs"
+Dynamic: license-file
 
 # k3priorityqueue
 
@@ -126,4 +140,3 @@ Copyright (c) 2015 Zhang Yanpo (张炎泼) <drdr.xp@gmail.com>
 
 
 [pykit3]: https://github.com/pykit3
-

k3priorityqueue-0.1.3.dist-info/RECORD

@@ -0,0 +1,8 @@
+k3priorityqueue/__init__.py,sha256=P6snvBPPuHqLNIu9RSnhnfX6yeZI5WAEHEqhw3rziHY,1181
+k3priorityqueue/priorityqueue.py,sha256=Uf88QQ39CIQi4Z2anRaOI5PuqidHd8rki7fxrIIxVgg,6381
+k3priorityqueue/synopsis.py,sha256=7SWhWJfKeSrKvrvlayhVg8miTLZtkkiJPAtV3icHQgs,593
+k3priorityqueue-0.1.3.dist-info/licenses/LICENSE,sha256=efDc2MufKQpsx8k2CaRX7tYYsmT6CyOa76by7YATdm0,1066
+k3priorityqueue-0.1.3.dist-info/METADATA,sha256=oE96mVKPTsR9XjMuM_0FT-Tt1IMtN8jcI8CX2H5ypuI,3945
+k3priorityqueue-0.1.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+k3priorityqueue-0.1.3.dist-info/top_level.txt,sha256=xsFjs-FCGWMfu_k_yPPYAwXFbAWiIvW1uTqjR4abf_c,16
+k3priorityqueue-0.1.3.dist-info/RECORD,,

{k3priorityqueue-0.1.2.dist-info → k3priorityqueue-0.1.3.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.36.2)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

k3priorityqueue-0.1.3.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 张炎泼
+
+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.

k3priorityqueue/setup.py

@@ -1,23 +0,0 @@
-# DO NOT EDIT!!! built with `python _building/build_setup.py`
-import setuptools
-setuptools.setup(
-    name="k3priorityqueue",
-    packages=["k3priorityqueue"],
-    version="0.1.2",
-    license='MIT',
-    description='priorityQueue is a queue with priority support',
-    long_description="# k3priorityqueue\n\n[![Action-CI](https://github.com/pykit3/k3priorityqueue/actions/workflows/python-package.yml/badge.svg)](https://github.com/pykit3/k3priorityqueue/actions/workflows/python-package.yml)\n[![Build Status](https://travis-ci.com/pykit3/k3priorityqueue.svg?branch=master)](https://travis-ci.com/pykit3/k3priorityqueue)\n[![Documentation Status](https://readthedocs.org/projects/k3priorityqueue/badge/?version=stable)](https://k3priorityqueue.readthedocs.io/en/stable/?badge=stable)\n[![Package](https://img.shields.io/pypi/pyversions/k3priorityqueue)](https://pypi.org/project/k3priorityqueue)\n\npriorityQueue is a queue with priority support\n\nk3priorityqueue is a component of [pykit3] project: a python3 toolkit set.\n\n\nPriorityQueue is a queue with priority support:\n\nThe numbers of items it pops from each producer matches exactly the ratio of their priority:\nIf the priorities of 3 producer A, B and C are 1, 3 and 7, and it runs long\nenough, it is expected that the number of items popped from A, B and C are\n1:3:7.\n\nimport k3priorityqueue\n\nproducers = (\n    # id, priority, iterable\n    (1, 1, [1] * 10),\n    (2, 2, [2] * 10),\n    (3, 3, [3] * 10),\n)\npq = k3priorityqueue.PriorityQueue()\nfor pid, prio, itr in producers:\n    pq.add_producer(pid, prio, itr)\n\ncount = {}\nfor _ in range(12):\n    val = pq.get()\n    count[val] = count.get(val, 0) + 1\n    print(val)\n\nprint('respect priority ratio: counts:', repr(count))\n\nwhile True:\n    try:\n        val = pq.get()\n    except k3priorityqueue.Empty as e:\n        break\n    count[val] = count.get(val, 0) + 1\n    print(val)\n\nprint('consumed all: counts:', repr(count))\n\n\n\n\n# Install\n\n```\npip install k3priorityqueue\n```\n\n# Synopsis\n\n```python\n\nimport k3priorityqueue\n\nproducers = (\n    # id, priority, iterable\n    (1, 1, [1] * 10),\n    (2, 2, [2] * 10),\n    (3, 3, [3] * 10),\n)\npq = k3priorityqueue.PriorityQueue()\nfor pid, prio, itr in producers:\n    pq.add_producer(pid, prio, itr)\n\ncount = {}\nfor _ in range(12):\n    val = pq.get()\n    count[val] = count.get(val, 0) + 1\n    print(val)\n\nprint('respect priority ratio: counts:', repr(count))\n\nwhile True:\n    try:\n        val = pq.get()\n    except k3priorityqueue.Empty as e:\n        break\n    count[val] = count.get(val, 0) + 1\n    print(val)\n\nprint('consumed all: counts:', repr(count))\n```\n\n#   Author\n\nZhang Yanpo (张炎泼) <drdr.xp@gmail.com>\n\n#   Copyright and License\n\nThe MIT License (MIT)\n\nCopyright (c) 2015 Zhang Yanpo (张炎泼) <drdr.xp@gmail.com>\n\n\n[pykit3]: https://github.com/pykit3",
-    long_description_content_type="text/markdown",
-    author='Zhang Yanpo',
-    author_email='drdr.xp@gmail.com',
-    url='https://github.com/pykit3/k3priorityqueue',
-    keywords=['python', 'priorityqueue'],
-    python_requires='>=3.0',
-
-    install_requires=['k3ut>=0.1.15,<0.2', 'k3heap>=0.1.5,<0.2', 'k3thread>=0.1.0,<0.2'],
-    classifiers=[
-        'Development Status :: 4 - Beta',
-        'Intended Audience :: Developers',
-        'Topic :: Software Development :: Libraries',
-    ] + ['Programming Language :: Python :: 3.6', 'Programming Language :: Python :: 3.7', 'Programming Language :: Python :: 3.8', 'Programming Language :: Python :: Implementation :: PyPy'],
-)

k3priorityqueue-0.1.2.dist-info/RECORD

@@ -1,8 +0,0 @@
-k3priorityqueue/__init__.py,sha256=-vq5WAJCt3jhl2uDu128V0BjK3ab-O8tYAM-BgctT48,1226
-k3priorityqueue/priorityqueue.py,sha256=JsCy7CdChf5Sn08g2zs1GMZTbXe6XyqXxCARW4SleqE,6389
-k3priorityqueue/setup.py,sha256=NvgpbHFr62c4e2xIbpckou8-PP5MXWGq4fUID-SkdFQ,3592
-k3priorityqueue/synopsis.py,sha256=IXZyCRgE6MXiut681ZW5qSyczlzl-z1B7jzsKmz6l4U,598
-k3priorityqueue-0.1.2.dist-info/METADATA,sha256=FribGlDXvmwg_BJJpztHmbaHhczWUzLjH-1aPF4I7U4,3336
-k3priorityqueue-0.1.2.dist-info/WHEEL,sha256=OqRkF0eY5GHssMorFjlbTIq072vpHpF60fIQA6lS9xA,92
-k3priorityqueue-0.1.2.dist-info/top_level.txt,sha256=xsFjs-FCGWMfu_k_yPPYAwXFbAWiIvW1uTqjR4abf_c,16
-k3priorityqueue-0.1.2.dist-info/RECORD,,