From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 901B5138350 for ; Fri, 27 Mar 2020 17:53:05 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 5738AE106A; Fri, 27 Mar 2020 17:53:04 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 2A627E106A for ; Fri, 27 Mar 2020 17:53:04 +0000 (UTC) Received: from oystercatcher.gentoo.org (unknown [IPv6:2a01:4f8:202:4333:225:90ff:fed9:fc84]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 3186634F91D for ; Fri, 27 Mar 2020 17:53:02 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id C4E2D104 for ; Fri, 27 Mar 2020 17:52:59 +0000 (UTC) From: "Alessandro Barbieri" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Alessandro Barbieri" Message-ID: <1585330021.94f6517bed68e1e3d19e90f0d53e70c011e79aec.Alessandro-Barbieri@gentoo> Subject: [gentoo-commits] repo/proj/guru:dev commit in: dev-python/websockets/ X-VCS-Repository: repo/proj/guru X-VCS-Files: dev-python/websockets/metadata.xml dev-python/websockets/websockets-8.1.ebuild X-VCS-Directories: dev-python/websockets/ X-VCS-Committer: Alessandro-Barbieri X-VCS-Committer-Name: Alessandro Barbieri X-VCS-Revision: 94f6517bed68e1e3d19e90f0d53e70c011e79aec X-VCS-Branch: dev Date: Fri, 27 Mar 2020 17:52:59 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: 118c4dfc-3d1f-4b5d-92bc-9f2e17a5f9bf X-Archives-Hash: 26ac1e831acd00c0066cf30796465fa0 commit: 94f6517bed68e1e3d19e90f0d53e70c011e79aec Author: Alessandro Barbieri gmail com> AuthorDate: Fri Mar 27 17:27:01 2020 +0000 Commit: Alessandro Barbieri gmail com> CommitDate: Fri Mar 27 17:27:01 2020 +0000 URL: https://gitweb.gentoo.org/repo/proj/guru.git/commit/?id=94f6517b dev-python/websockets: longdescription Package-Manager: Portage-2.3.96, Repoman-2.3.21 Signed-off-by: Alessandro Barbieri gmail.com> dev-python/websockets/metadata.xml | 34 +++++++++++++++++++++++++---- dev-python/websockets/websockets-8.1.ebuild | 7 ++++-- 2 files changed, 35 insertions(+), 6 deletions(-) diff --git a/dev-python/websockets/metadata.xml b/dev-python/websockets/metadata.xml index 628ab20..e98572b 100644 --- a/dev-python/websockets/metadata.xml +++ b/dev-python/websockets/metadata.xml @@ -2,8 +2,34 @@ - - andrewammerlaan@riseup.net - Andrew Ammerlaan - + + andrewammerlaan@riseup.net + Andrew Ammerlaan + + +What is websockets? + +websockets is a library for building WebSocket servers and clients in Python with a focus on correctness and simplicity. + +Built on top of asyncio, Python's standard asynchronous I/O framework, it provides an elegant coroutine-based API. +Why should I use websockets? + +The development of websockets is shaped by four principles: + + Simplicity: all you need to understand is msg = await ws.recv() and await ws.send(msg); websockets takes care of managing connections so you can focus on your application. + Robustness: websockets is built for production; for example it was the only library to handle backpressure correctly before the issue became widely known in the Python community. + Quality: websockets is heavily tested. Continuous integration fails under 100% branch coverage. Also it passes the industry-standard Autobahn Testsuite. + Performance: memory use is configurable. An extension written in C accelerates expensive operations. It's pre-compiled for Linux, macOS and Windows and packaged in the wheel format for each system and Python version. + +Documentation is a first class concern in the project. Head over to Read the Docs and see for yourself. +Why shouldn't I use websockets? + + If you prefer callbacks over coroutines: websockets was created to provide the best coroutine-based API to manage WebSocket connections in Python. Pick another library for a callback-based API. + If you're looking for a mixed HTTP / WebSocket library: websockets aims at being an excellent implementation of RFC 6455: The WebSocket Protocol and RFC 7692: Compression Extensions for WebSocket. Its support for HTTP is minimal — just enough for a HTTP health check. + If you want to use Python 2: websockets builds upon asyncio which only works on Python 3. websockets requires Python ≥ 3.6.1. + + + aaugustin/websockets + websockets + diff --git a/dev-python/websockets/websockets-8.1.ebuild b/dev-python/websockets/websockets-8.1.ebuild index e6b3c0c..37a9046 100644 --- a/dev-python/websockets/websockets-8.1.ebuild +++ b/dev-python/websockets/websockets-8.1.ebuild @@ -8,7 +8,10 @@ PYTHON_COMPAT=( python3_{6,7} ) inherit distutils-r1 DESCRIPTION="An implementation of the WebSocket Protocol (RFC 6455 & 7692)" -HOMEPAGE="https://github.com/aaugustin/websockets https://pypi.org/project/websockets/" +HOMEPAGE=" + https://github.com/aaugustin/websockets + https://pypi.org/project/websockets/ +" SRC_URI="https://github.com/aaugustin/${PN}/archive/${PV}.tar.gz -> ${P}.tar.gz" LICENSE="BSD" @@ -16,7 +19,7 @@ SLOT="0" KEYWORDS="~amd64 ~x86" python_prepare_all() { - # these tests fail, proabably because of + # these tests fail, probably because of # a permission error (no internet) rm tests/test_client_server.py || die rm tests/test_protocol.py || die