{"id":13937570,"url":"https://github.com/geertj/gruvi","last_synced_at":"2025-10-30T20:08:37.815Z","repository":{"id":5855779,"uuid":"7072569","full_name":"geertj/gruvi","owner":"geertj","description":"Async IO for Python, Simplified","archived":false,"fork":false,"pushed_at":"2017-09-05T11:24:34.000Z","size":894,"stargazers_count":92,"open_issues_count":2,"forks_count":12,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-12-09T02:46:41.679Z","etag":null,"topics":["async","fibers","libuv","python"],"latest_commit_sha":null,"homepage":"http://gruvi.readthedocs.org/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/geertj.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-12-08T21:49:57.000Z","updated_at":"2024-11-28T16:31:01.000Z","dependencies_parsed_at":"2022-09-06T01:11:34.705Z","dependency_job_id":null,"html_url":"https://github.com/geertj/gruvi","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geertj%2Fgruvi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geertj%2Fgruvi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geertj%2Fgruvi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geertj%2Fgruvi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/geertj","download_url":"https://codeload.github.com/geertj/gruvi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230171948,"owners_count":18184480,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["async","fibers","libuv","python"],"created_at":"2024-08-07T23:03:41.417Z","updated_at":"2025-10-30T20:08:32.762Z","avatar_url":"https://github.com/geertj.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"**************************************\nGruvi: Async IO for Python, Simplified\n**************************************\n\n.. image:: https://secure.travis-ci.org/geertj/gruvi.png\n    :target: http://travis-ci.org/geertj/gruvi\n\n.. image:: https://coveralls.io/repos/geertj/gruvi/badge.png?branch=master\n    :target: https://coveralls.io/r/geertj/gruvi?branch=master \n\n.. image:: https://badge.fury.io/py/gruvi.png\n    :target: http://badge.fury.io/py/gruvi\n\n*Improved ergonomics for Python programmers wanting to use asynchronous IO.*\n\nGruvi is an asynchronous IO library for Python. It focuses on the following\ndesirable properties:\n\n* *Simple*. Async IO code should look just like normal code, with simple,\n  sequential control flow and regular functions.\n\n* *Efficient*. An IO library should have a very low memory and CPU overhead,\n  so that it can scale to small systems or to many concurrent connections.\n\n* *Powerful*. Common protocols like SSL/TLS and HTTP should be part of every\n  IO library.\n\nGruvi uses libuv_ (via pyuv_) as the underlying high-performance event-based\nI/O layer, and coroutines based on fibers_ to create a traditional sequential\nprogramming model on top of the libuv_ completion/callback model.\n\nGruvi is similar in concept existing async IO frameworks like asyncio_,\ngevent_, and eventlet_. For a comparison, see Rationale_.\n\nFeatures\n========\n\nGruvi has the following features:\n\n* Excellent platform support (mostly thanks to libuv). Linux, Mac OSX and\n  Windows are all first-class citizens.\n* PEP-3156 compatible transport/protocol interface.\n* A traditional, sequential programming model based on green threads, where\n  there is no distinction between asynchronous and normal functions.\n* Great SSL/TLS support, also on Windows. The `asynchronous SSL`_ support in the\n  Python standard library came from Gruvi before it was included into the stdlib.\n* Small core and focus on low memory usage and fast performance. This makes\n  Gruvi very suitable for mobile applications and embedded web servers.\n* A full suite of synchronization primitives including locks, conditions and queues.\n* Thread and fiber pools with a ``concurrent.futures`` interface.\n* Batteries includes: built-in client/server support for HTTP, JSON-RPC and D-BUS.\n* Support for Python 2.7.x and 3.3+.\n\nExample\n=======\n\nAn simple echo server, using a StreamServer_::\n\n  import gruvi\n\n  def echo_handler(stream, transport, protocol):\n      while True:\n          buf = stream.read1()\n          if not buf:\n              break\n          stream.write(buf)\n\n  server = gruvi.StreamServer(echo_handler)\n  server.listen(('localhost', 7777))\n  server.run()\n\n\nRequirements\n============\n\nYou need Python 2.7 or 3.3+.\n\nThe following operating systems are currently supported:\n\n* Linux (might work on other Posix OSs)\n* macOS (not currently tested via CI)\n* Windows (not currently tested via CI)\n\nInstallation\n============\n\nDevelopment install in a virtualenv::\n\n  $ git clone https://github.com/geertj/gruvi\n  $ cd gruvi\n  $ pip install -r requirements.txt\n  $ python setup.py build\n  $ python setup.py install\n\nTo run the test suite::\n\n  $ python runtests.py unit\n\nFor other installation options, see the Installation_ section in the manual.\n\nDocumentation\n=============\n\nThe documentation is available on readthedocs_.\n\nLicense\n=======\n\nGruvi is free software, provided under the MIT license.\n\nContact\n=======\n\nFeel free to contact the author at geertj@gmail.com. You can also submit\ntickets or suggestions for improvements on Github_.\n\n.. _libuv: https://github.com/libuv/libuv\n.. _pyuv: http://pyuv.readthedocs.org/en/latest\n.. _fibers: http://python-fibers.readthedocs.org/en/latest\n.. _asyncio: http://docs.python.org/3.4/library/asyncio.html\n.. _gevent: http://gevent.org/\n.. _eventlet: http://eventlet.net/\n.. _Rationale: http://gruvi.readthedocs.org/en/latest/rationale.html\n.. _asynchronous SSL: https://docs.python.org/3/library/ssl.html#ssl.SSLObject\n.. _StreamServer: http://gruvi.readthedocs.org/en/latest/streams.html\n.. _Installation: http://gruvi.readthedocs.org/en/latest/install.html\n.. _readthedocs: https://gruvi.readthedocs.org/\n.. _Github: https://github.com/geertj/gruvi\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeertj%2Fgruvi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeertj%2Fgruvi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeertj%2Fgruvi/lists"}