/usr/lib/python3/dist-packages/Quamash-0.6.0.egg-info/PKG-INFO is in python3-quamash 0.6.0~dfsg-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 | Metadata-Version: 1.1
Name: Quamash
Version: 0.6.0
Summary: Implementation of the PEP 3156 Event-Loop with Qt.
Home-page: https://github.com/harvimt/quamash
Author: Mark Harviston, Arve Knudsen
Author-email: mark.harviston@gmail.com, arve.knudsen@gmail.com
License: BSD
Description-Content-Type: UNKNOWN
Description: =======
Quamash
=======
Implementation of the `PEP 3156`_ Event-Loop with Qt
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
:author: Mark Harviston <mark.harviston@gmail.com>, Arve Knudsen <arve.knudsen@gmail.com>
.. image:: https://img.shields.io/pypi/v/quamash.svg
:target: https://pypi.python.org/pypi/quamash/
:alt: Latest Version
.. image:: https://img.shields.io/pypi/dm/quamash.svg
:target: https://pypi.python.org/pypi/quamash/
:alt: Downloads
.. image:: https://img.shields.io/pypi/pyversions/quamash.svg
:target: https://pypi.python.org/pypi/quamash/
:alt: Supported Python versions
.. image:: https://img.shields.io/pypi/l/quamash.svg
:target: https://pypi.python.org/pypi/quamash/
:alt: License
.. image:: https://img.shields.io/pypi/status/Django.svg
:target: https://pypi.python.org/pypi/quamash/
:alt: Development Status
.. image:: https://travis-ci.org/harvimt/quamash.svg?branch=master
:target: https://travis-ci.org/harvimt/quamash
:alt: Linux (Travis CI) Build Status
.. image:: https://img.shields.io/appveyor/ci/harvimt/quamash.svg
:target: https://ci.appveyor.com/project/harvimt/quamash/branch/master
:alt: Windows (Appveyor) Build Status
.. image:: https://badges.gitter.im/Join%20Chat.svg
:target: https://gitter.im/harvimt/quamash?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge
:alt: Gitter
Requirements
============
Quamash requires Python 3.4 or Python 3.3 with the backported ``asyncio`` library and either PyQt4, PyQt5 or PySide.
Installation
============
``pip install quamash``
Upgrade from Version 0.4 to 0.5
===============================
The loop context manager will no longer set the event loop only close it.
Instead of:
.. code:: python
with loop:
loop.run_forever()
do:
.. code:: python
asyncio.set_event_loop(loop)
# ...
with loop:
loop.run_forever()
It is recommended that you call ``asyncio.set_event_loop`` as early as possible (immediately after instantiating the loop),
to avoid running asynchronous code before ``asyncio.set_event_loop`` is called.
If you're using multiple different loops in the same application, you know what you're doing (or at least you hope you do),
then you can ignore this advice.
Usage
=====
.. code:: python
import sys
import asyncio
import time
from PyQt5.QtWidgets import QApplication, QProgressBar
from quamash import QEventLoop, QThreadExecutor
app = QApplication(sys.argv)
loop = QEventLoop(app)
asyncio.set_event_loop(loop) # NEW must set the event loop
progress = QProgressBar()
progress.setRange(0, 99)
progress.show()
async def master():
await first_50()
with QThreadExecutor(1) as exec:
await loop.run_in_executor(exec, last_50)
# TODO announce completion?
async def first_50():
for i in range(50):
progress.setValue(i)
await asyncio.sleep(.1)
def last_50():
for i in range(50,100):
loop.call_soon_threadsafe(progress.setValue, i)
time.sleep(.1)
with loop: ## context manager calls .close() when loop completes, and releases all resources
loop.run_until_complete(master())
Changelog
=========
Version 0.6.0
-------------
* Lots of bugfixes and performance improvements.
Version 0.5.5
-------------
* Fix `#62`_ a serious memory leak by switching from ``QTimer`` to ``QObject.timerEvent``.
Version 0.5.4
-------------
* Remove unnecessary QObjects
* Officially add Python 3.5 support (CI configuration and setup.py change)
* Fix `#55`_
* Better compatibility with behavior of default event loop (`#59`_)
* Remove _easycallback and replace with _makeSignaller
Version 0.5.3
-------------
* Fix to `#34`_
Version 0.5.2
-------------
* Fixes to tests, and CI configuration
* Fixes `#35`_ and `#31`_ (both minor bugs)
* Uploade wheels to PyPI
Version 0.5.1
-------------
* Fixes rst syntax error in this README
Version 0.5
-----------
* Deprecation of event loop as means to ``asyncio.set_event_loop``, now must be called explicitly.
* Possible fix to notifiers being called out-of-order (see #25, #27, and e64119e)
* Better loop cleanup
* CI Tests pass on windows now
* Testing improvements
* Python 3.3 Support. (probably always supported, but it's offially supported/tested now)
Version 0.4.1
-------------
* Improvements to PEP-3156 Conformance
* Minor Test Improvements
Version 0.4
-----------
* Major improvements to tests
- integration with Travis CI
- more tests
- all tests pass
- cross platform/configuration tests
* Bug #13 discovered and fixed
* Force which Qt Implementation to use with ``QUQMASH_QTIMPL`` environment variable.
* Implement ``QEventLoop.remove_reader`` and ``QEventLoop.remove_writer``
* PyQt4 Support
* PyQt5 Support
* Support ``multiprocessing`` executors (``ProcessPoolExecutor``))
* Improvements to code quality
Version 0.3
-----------
First version worth using.
Testing
=======
Quamash is tested with pytest_; in order to run the test suite, just install pytest
and execute py.test on the commandline. The tests themselves are beneath the 'tests' directory.
Testing can also be done with tox_. The current tox setup in tox.ini requires PyQT4/5 and PySide to
be installed globally. (pip can't install PyQt into a virtualenv which is what tox will try to do).
For this reason it may be good to run tox tests while specificying which environments to run. e.g.
``tox -e py34-pyqt5`` to test python 3.4 with PyQt5. It is unlikely this tox configuration will
work well on Windows especially since PyQt5 and PyQt4 cannot coexist in the same python installation
on Windows. Also the PyQt4 w/ Qt5 oddity appears to be mostly a windows only thing too.
Style testing is also handled by tox. Run ``tox -e flake8``.
Code Coverage
-------------
Getting a full coverage support is quite time consuming. In theory this could by done with `pytest-xdist`_,
but I haven't had time to make that work. Install ``pytest-cov`` with ``pip install pytest-cov`` then
run ``py.test --cov quamash`` then append a dot and an identifier the generated ``.coverage`` file. For example,
``mv .coverage .coverage.nix.p33.pyside`` then repeat on all the platforms you want to run on. (at least linux
and windows). Put all the ``.coverage.*`` files in one directory that also has quamash source code in it.
``cd`` to that directory and run ``coverage combine`` finally run ``coverage html`` for html based reports
or ``coverage report`` for a simple report. These last commands may fail with errors about not being able to
find source code. Use the ``.coveragerc`` file to specify equivelant paths. The default configuration has linux
source code in ``/quamash`` and windows source at ``C:\quamash``.
Continuous Integration & Supported Platforms
--------------------------------------------
This project uses Travis CI to perform tests on linux (Ubuntu 12.04 LTS "Precise Pangolin") and
Appveyor (Windows Server 2012 R2, similar to Windows 8) to perform continuous integration.
On linux, Python 3.3 and 3.4 with PySide, PyQt4, and PyQt5 are tested. On windows, Python 3.4 with
PySide, PyQt4 and PyQt5 are tested, but Python 3.3 is only tested with PySide since binary installers
for PyQt are not provided for Python 3.3 (at least not the newest versions of PyQt), and compiling
from source probably isn't worth it.
Python 3.5 is now tested on linux with PyQt4 and PyQt5.
Testing Matrix
~~~~~~~~~~~~~~
+----------------------+---------+---------+--------------+----------------+
| | PyQt4 | PyQt5 | PySide (Qt4) | PySide 2 (Qt5) |
+======================+=========+=========+==============+================+
| Linux - Python 3.3 | yes | yes | yes | planned |
+----------------------+---------+---------+--------------+----------------+
| Linux - Python 3.4 | yes | yes | yes | planned |
+----------------------+---------+---------+--------------+----------------+
| Linux - Python 3.5 | yes | yes | n/a | planned |
+----------------------+---------+---------+--------------+----------------+
| Windows - Python 3.3 | no | no | yes | no |
+----------------------+---------+---------+--------------+----------------+
| Windows - Python 3.4 | yes | yes | yes | planned |
+----------------------+---------+---------+--------------+----------------+
| Windows - Python 3.5 | planned | planned | planned | planned |
+----------------------+---------+---------+--------------+----------------+
License
=======
You may use, modify, and redistribute this software under the terms of the `BSD License`_.
See LICENSE.
Name
====
Tulip related projects are being named after other flowers, Quamash is one of the few flowers that
starts with a "Q".
.. _`PEP 3156`: http://python.org/dev/peps/pep-3156/
.. _`pytest`: http://pytest.org
.. _`BSD License`: http://opensource.org/licenses/BSD-2-Clause
.. _tox: https://tox.readthedocs.org/
.. _pytest-xdist: https://pypi.python.org/pypi/pytest-xdist
.. _#31: https://github.com/harvimt/quamash/issues/31
.. _#34: https://github.com/harvimt/quamash/issues/34
.. _#35: https://github.com/harvimt/quamash/issues/35
.. _#55: https://github.com/harvimt/quamash/issues/55
.. _#59: https://github.com/harvimt/quamash/pull/59
.. _#62: https://github.com/harvimt/quamash/pull/62
Keywords: Qt,asyncio
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: BSD License
Classifier: Intended Audience :: Developers
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Environment :: X11 Applications :: Qt
|