Coroutine-based network library

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for denik from gravatar.com denik Avatar for jamadden from gravatar.com jamadden

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: MIT License (MIT)
  • Author: Jason Madden
  • Tags greenlet, coroutine, cooperative, multitasking, light, threads, monkey
Classifiers

Project description

gevent is a coroutine-based Python networking library.

Features include:

  • Fast event loop based on libev.

  • Lightweight execution units based on greenlet.

  • Familiar API that re-uses concepts from the Python standard library.

  • Cooperative sockets with SSL support.

  • DNS queries performed through c-ares or a threadpool.

  • Ability to use standard library and 3rd party modules written for standard blocking sockets

gevent is inspired by eventlet but features more consistent API, simpler implementation and better performance. Read why others use gevent and check out the list of the open source projects based on gevent.

gevent is licensed under MIT license.

Get gevent

Gevent runs on Python >= 2.6, Python >= 3.3, or PyPy >= 4.0.1 (but not PyPy3) (Note: PyPy is not supported in Windows). On all platforms, installing setuptools is recommended (this is done automatically if working in a virtual environment).

While gevent v1.1 is not yet released, it has release candidates which are currently considered quite stable, with many bugfixes over v1.0. v1.1 is also necessary if you are running OS X 10.11 and/or Python 3 or PyPy. To install one of these release candidates, you can run:

pip install --pre gevent

Download the latest release from Python Package Index or clone the repository.

Read the documentation online at http://www.gevent.org

Post feedback and issues on the bug tracker, mailing list, blog and twitter (@gevent).

Development

To install the latest development version:

pip install setuptools 'cython>=0.23.4' git+git://github.com/gevent/gevent.git#egg=gevent

To hack on gevent (using a virtualenv):

$ git clone https://github.com/gevent/gevent.git
$ cd gevent
$ virtualenv env
$ source env/bin/activate
(env) $ pip install -r dev-requirements.txt

Running Tests

There are a few different ways to run the tests. To simply run the tests on one version of Python during development, try this:

python setup.py develop
cd greentest
PYTHONPATH=.. python testrunner.py --config ../known_failures.py

Before submitting a pull request, it’s a good idea to run the tests across all supported versions of Python, and to check the code quality using pep8 and pyflakes. This is what is done on Travis CI. Locally it can be done using tox:

pip install tox
tox

The testrunner accepts a --coverage argument to enable code coverage metrics through the coverage.py package. That would go something like this:

cd greentest
PYTHONPATH=.. python testrunner.py --config ../known_failures.py --coverage
coverage combine
coverage html -i
<open htmlcov/index.html>

Builds on Travis CI automatically submit updates to coveralls.io.

https://coveralls.io/repos/gevent/gevent/badge.svg?branch=master&service=github

Continuous integration

A test suite is run for every push and pull request submitted. Travis CI is used to test on Linux, and AppVeyor runs the builds on Windows.

https://travis-ci.org/gevent/gevent.svg?branch=master https://ci.appveyor.com/api/projects/status/q4kl21ng2yo2ixur?svg=true

Project details

Verified details

These details have been verified by PyPI
Maintainers
Avatar for denik from gravatar.com denik Avatar for jamadden from gravatar.com jamadden

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: MIT License (MIT)
  • Author: Jason Madden
  • Tags greenlet, coroutine, cooperative, multitasking, light, threads, monkey
Classifiers

Release history Release notifications | RSS feed

24.10.3

24.10.2

24.10.1

24.2.1

23.9.1

23.9.0.post1

23.9.0

23.7.0

22.10.2

22.10.1

22.8.0

21.12.0

21.8.0

21.1.2

21.1.1

21.1.0

20.12.1

20.12.0

20.9.0

20.6.2

20.6.1

20.6.0

20.5.2

20.5.1

20.5.0

20.4.0

1.5.0

1.5a4 pre-release

1.5a3 pre-release

1.5a2 pre-release

1.5a1 pre-release

1.4.0

1.3.7

1.3.6

1.3.5

1.3.4

1.3.3

1.3.2.post0

1.3.2

1.3.1

1.3.0

1.3b2 pre-release

1.3b1 pre-release

1.3a2 pre-release

1.3a1 pre-release

1.2.2

1.2.1

1.2.0

1.2a2 pre-release

1.2a1 pre-release

1.1.2

1.1.1

1.1.0

1.1rc5 pre-release

This version

1.1rc4 pre-release

1.1rc3 pre-release

1.1rc2 pre-release

1.1rc1 pre-release

1.1b6 pre-release

1.1b5 pre-release

1.1b4 pre-release

1.1b3 pre-release

1.1b2 pre-release

1.1b1 pre-release

1.1a2 pre-release

1.1a1 pre-release

1.0.2

1.0.1

1.0

0.13.8

0.13.7

0.13.6

0.13.5

0.13.4

0.13.3

0.13.2

0.13.1

0.13.0

0.12.2

0.12.1

0.12.0

0.11.2

0.11.1

0.11.0

0.10.0

0.9.3

0.9.2

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gevent-1.1rc4.tar.gz (1.9 MB view hashes)

Uploaded Source

Built Distributions

gevent-1.1rc4.win-amd64-py3.5.exe (517.9 kB view hashes)

Uploaded Source

gevent-1.1rc4.win-amd64-py3.4.exe (605.1 kB view hashes)

Uploaded Source

gevent-1.1rc4.win-amd64-py3.3.exe (606.0 kB view hashes)

Uploaded Source

gevent-1.1rc4.win-amd64-py2.7.exe (608.9 kB view hashes)

Uploaded Source

gevent-1.1rc4.win32-py3.5.exe (477.1 kB view hashes)

Uploaded Source

gevent-1.1rc4.win32-py3.4.exe (547.0 kB view hashes)

Uploaded Source

gevent-1.1rc4.win32-py3.3.exe (546.8 kB view hashes)

Uploaded Source

gevent-1.1rc4.win32-py2.7.exe (550.4 kB view hashes)

Uploaded Source

gevent-1.1rc4-pp240-pp240u-macosx_10_11_x86_64.whl (374.6 kB view hashes)

Uploaded PyPy macOS 10.11+ x86-64

gevent-1.1rc4-cp35-cp35m-win_amd64.whl (376.9 kB view hashes)

Uploaded CPython 3.5m Windows x86-64

gevent-1.1rc4-cp35-cp35m-win32.whl (343.3 kB view hashes)

Uploaded CPython 3.5m Windows x86

gevent-1.1rc4-cp35-cp35m-macosx_10_6_intel.whl (466.4 kB view hashes)

Uploaded CPython 3.5m macOS 10.6+ intel

gevent-1.1rc4-cp34-cp34m-win_amd64.whl (378.1 kB view hashes)

Uploaded CPython 3.4m Windows x86-64

gevent-1.1rc4-cp34-cp34m-win32.whl (351.2 kB view hashes)

Uploaded CPython 3.4m Windows x86

gevent-1.1rc4-cp34-cp34m-macosx_10_6_intel.whl (467.7 kB view hashes)

Uploaded CPython 3.4m macOS 10.6+ intel

gevent-1.1rc4-cp33-cp33m-win_amd64.whl (379.0 kB view hashes)

Uploaded CPython 3.3m Windows x86-64

gevent-1.1rc4-cp33-cp33m-win32.whl (351.0 kB view hashes)

Uploaded CPython 3.3m Windows x86

gevent-1.1rc4-cp33-cp33m-macosx_10_11_x86_64.whl (427.2 kB view hashes)

Uploaded CPython 3.3m macOS 10.11+ x86-64

gevent-1.1rc4-cp27-cp27m-win_amd64.whl (380.4 kB view hashes)

Uploaded CPython 2.7m Windows x86-64

gevent-1.1rc4-cp27-cp27m-win32.whl (349.6 kB view hashes)

Uploaded CPython 2.7m Windows x86

gevent-1.1rc4-cp27-cp27m-macosx_10_6_intel.whl (464.8 kB view hashes)

Uploaded CPython 2.7m macOS 10.6+ intel

gevent-1.1rc4-cp26-cp26m-macosx_10_11_intel.whl (717.7 kB view hashes)

Uploaded CPython 2.6m macOS 10.11+ intel

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page