Starting an awesome-trio list #1262

jay-tuckey · 2019-10-19T06:37:27Z

Making a page right after the tutorial with some links to libraries that have trio support.

codecov · 2019-10-19T06:44:07Z

Codecov Report

Merging #1262 into master will increase coverage by <.01%.
The diff coverage is n/a.

@@            Coverage Diff             @@
##           master    #1262      +/-   ##
==========================================
+ Coverage   99.57%   99.57%   +<.01%     
==========================================
  Files         106      106              
  Lines       12827    12836       +9     
  Branches      984      985       +1     
==========================================
+ Hits        12772    12781       +9     
  Misses         35       35              
  Partials       20       20

Impacted Files	Coverage Δ
trio/_core/tests/test_run.py	`100% <0%> (ø)`	⬆️
trio/_core/_run.py	`99.73% <0%> (ø)`	⬆️

njsmith · 2019-10-20T08:04:24Z

docs/source/awesome-trio-libraries.rst

+However, to get much useful work done you will want to use some of
+the great libraries that support trio-flavoured concurrency. This list
+is not complete, but gives a starting point. Another great way to find
+trio-compatible libraries is to search on PyPI for the `Framework :: trio`


The single-backticks here are causing the CI build to fail: https://travis-ci.org/python-trio/trio/jobs/600224047

I think you want double-backticks, because ReST is annoying like that.

Also, let's capitalize Trio.

njsmith · 2019-10-20T08:08:13Z

docs/source/awesome-trio-libraries.rst

+* `trio-click <https://github.com/python-trio/trio-click>`__ - Python composable command line utility, trio-compatible version
+* `triopg <https://github.com/python-trio/triopg>`__ - PostgreSQL client for Trio based on asyncpg
+* `trio-mysql <https://github.com/python-trio/trio-mysql>`__ - Pure Python MySQL Client
+* `hypothesis-trio <https://github.com/python-trio/hypothesis-trio>`__ - Hypothesis plugin for trio


I'm actually not sure what the status is of anything below trio-click here... maybe just file them under categories, instead of "core" libraries?

trio-click → "Building command line apps"
triopg, trio-mysql → already listed under databases
hypothesis-trio → "Testing"

njsmith · 2019-10-20T08:08:28Z

docs/source/awesome-trio-libraries.rst

+----------------------
+
+* `asks <https://github.com/theelous3/asks>`__ - asks is an async requests-like http library
+* `trustme <https://github.com/python-trio/trustme>`__ - #1 quality TLS certs while you wait, for the discerning tester


trustme should also go under "Testing"

njsmith · 2019-10-20T08:09:43Z

docs/source/awesome-trio-libraries.rst

+---------------------------
+* `anyio <https://github.com/agronholm/anyio>`__ - AnyIO is a asynchronous compatibility API that allows applications and libraries written against it to run unmodified on asyncio, curio and trio.
+* `tractor <https://github.com/goodboy/tractor>`__ - tractor is an attempt to bring trionic structured concurrency to distributed multi-core Python.
+* `sniffio <https://github.com/python-trio/sniffio>`__ - This is a tiny package whose only purpose is to let you detect which async library your code is running under.


Maybe we should have a category for "Trio/Asyncio interoperability", listing trio-asyncio ("use asyncio libraries from a trio app"), anyio, sniffio?

And tractor could go under like... "Multi-core/multiprocessing"?

I feel like "Utility libraries" would be more like async-generator (Makes async generators work (better) on Python 3.5 and Python 3.6), tricycle, trio-util

njsmith · 2019-10-20T08:10:33Z

docs/source/awesome-trio-libraries.rst

+* `asks <https://github.com/theelous3/asks>`__ - asks is an async requests-like http library
+* `trustme <https://github.com/python-trio/trustme>`__ - #1 quality TLS certs while you wait, for the discerning tester
+* `trio-websocket <https://github.com/HyperionGray/trio-websocket>`__ - This library implements the WebSocket protocol, striving for safety, correctness, and ergonomics.
+* `quart-trio <https://gitlab.com/pgjones/quart-trio/>`__ - `Quart <https://gitlab.com/pgjones/quart>`__ is a Python ASGI web microframework with the same API as Flask and Quart-Trio is an extension for Quart to support the Trio event loop.


We should list hypercorn too (ASGI server with first-class Trio support)

In fact how about:

quart-trio – Like Flask, but for Trio. A simple and powerful framework for building async web applications and REST APIs. Tip: this is an ASGI-based framework, so you'll also need an HTTP server with ASGI support.

hypercorn – An HTTP server for hosting your ASGI apps. Supports HTTP/1.1, HTTP/2, HTTP/3, and Websockets. Can be run as a standalone server, or embedded in a larger Trio app. Use it with quart-trio, or any other Trio-compatible ASGI framework.

jay-tuckey · 2019-10-20T23:29:25Z

Thanks @njsmith , I'll update this afternoon when I'm done work.

njsmith · 2019-10-25T07:37:54Z

Test failure is #1231. I'll close/re-open to retry.

docs/source/awesome-trio-libraries.rst

njsmith · 2019-10-25T08:14:00Z

docs/source/awesome-trio-libraries.rst

+* `triopg <https://github.com/python-trio/triopg>`__ - PostgreSQL client for Trio based on asyncpg
+* `trio-mysql <https://github.com/python-trio/trio-mysql>`__ - Pure Python MySQL Client
+* `sqlalchemy_aio <https://github.com/RazerM/sqlalchemy_aio>`__ - Add asyncio and Trio support to SQLAlchemy core, derived from alchimia.
+* `sphinxcontrib-trio <https://github.com/python-trio/sphinxcontrib-trio>`__ - Make Sphinx better at documenting Python functions and methods


sphinxcontrib-trio doesn't have anything to do with databases :-).

Also probably worth mentioning that it makes it easy to document async functions.

njsmith · 2019-10-25T08:15:11Z

docs/source/awesome-trio-libraries.rst

+-----------------------------
+* `anyio <https://github.com/agronholm/anyio>`__ - AnyIO is a asynchronous compatibility API that allows applications and libraries written against it to run unmodified on asyncio, curio and trio
+* `sniffio <https://github.com/python-trio/sniffio>`__ - This is a tiny package whose only purpose is to let you detect which async library your code is running under
+* `trio-asyncio <https://github.com/python-trio/trio-asyncio>`__ - Trio-Asyncio is a re-implementation of the asyncio mainloop on top of Trio


While that's true, I think people will get a better idea of why they should care about trio-asyncio if we describe it as "Trio-Asyncio lets you use asyncio libraries from your Trio app."

many asyncio libraries. Not all of them, aiohttp being the most glaring counterexample.

njsmith · 2019-10-25T08:19:44Z

docs/source/awesome-trio-libraries.rst

+is not complete, but gives a starting point. Another great way to find
+Trio-compatible libraries is to search on PyPI for the ``Framework :: trio``
+tag -> `PyPI Search <https://pypi.org/search/?q=Framework+%3A%3A+trio>`__
+


Let's add a "Getting started" section at the top, that says something like:

cookiecutter-trio: A quickstart template for your Trio project, including pytest-trio for testing and sphinxcontrib-trio for documentation.

njsmith · 2019-11-08T20:39:46Z

@jay-tuckey Hey, just wanted to check in and see if you're still interested in working on this – I think it's pretty close, but also I know sometimes stuff comes up :-)

Co-Authored-By: Nathaniel J. Smith <njs@pobox.com>

codecov-io · 2019-11-15T23:39:39Z

Codecov Report

Merging #1262 into master will decrease coverage by 5.87%.
The diff coverage is n/a.

@@            Coverage Diff            @@
##           master   #1262      +/-   ##
=========================================
- Coverage   99.57%   93.7%   -5.88%     
=========================================
  Files         106     106              
  Lines       12827   13288     +461     
  Branches      984    1004      +20     
=========================================
- Hits        12772   12451     -321     
- Misses         35     790     +755     
- Partials       20      47      +27

Impacted Files	Coverage Δ
trio/_core/_windows_cffi.py	`0% <0%> (-100%)`	⬇️
trio/_wait_for_object.py	`0% <0%> (-100%)`	⬇️
trio/_subprocess_platform/windows.py	`0% <0%> (-100%)`	⬇️
trio/_windows_pipes.py	`0% <0%> (-100%)`	⬇️
trio/_core/_io_windows.py	`0% <0%> (-91.29%)`	⬇️
trio/tests/test_wait_for_object.py	`10.37% <0%> (-89.63%)`	⬇️
trio/_core/tests/test_windows.py	`17.3% <0%> (-82.7%)`	⬇️
trio/tests/test_windows_pipes.py	`21.62% <0%> (-78.38%)`	⬇️
trio/_subprocess_platform/__init__.py	`59.37% <0%> (-40.63%)`	⬇️
trio/hazmat.py	`77.77% <0%> (-22.23%)`	⬇️
... and 58 more

Co-Authored-By: Nathaniel J. Smith <njs@pobox.com>

jay-tuckey · 2019-11-16T00:03:29Z

Hi @njsmith , sorry about the delay. I got caught up in work and a busy life, but I've gone through and updated the PR now with the changes as discussed. I also fixed a few small typos and some consistency.

Your suggestions and @smurfix are great, keep them coming. 🙂

smurfix · 2019-11-24T18:59:32Z

Addition: distmqtt https://github.com/smurfix/distmqtt.git which is a mostly-reasonable MQTT client and broker (an anyio-ified fork of hbmqtt).

energizah · 2019-11-24T21:02:08Z

The Urwid TUI library has Trio support now https://github.com/urwid/urwid/pull/372/files

goodboy · 2019-11-26T00:27:22Z

docs/source/awesome-trio-libraries.rst

+* `trio-click <https://github.com/python-trio/trio-click>`__ - Python composable command line utility, trio-compatible version.
+
+
+Multi-Core/Multiprocessing


Might be worth tossing trio_run_in_process here as well.

parity3 · 2019-12-30T23:38:43Z

This is a constantly moving target so we should just merge-then-iterate right? A few opinions:

would like to see triopg/trio-mysql only under Database Libraries and removed from Core Trio Libraries. If opinions differ, then where is sqlalchemy_aio in core?
there should probably be an awesome-anyio as well?
trio_asyncio should probably be on the list?
httpx is probably mature enough to put on the list?

dhirschfeld · 2020-01-10T23:34:30Z

Such a list has been requested a number of times:

As @parity3 says, this list will never be complete - there will (hopefully) always be new, awesome trio projects being developed so I think it would be great to get an initial version in and then new libraries can be added as new PRs on an incremental, ongoing basis.

dhirschfeld · 2020-01-10T23:37:59Z

@jay-tuckey, thanks for kicking this off! I think what we have here is a great start so if there are no more projects you'd like to add now it would be good to remove the [WIP] so we can get this merged and then continually iterate/update.

jay-tuckey · 2020-01-27T11:06:42Z

Ok, I have removed the [WIP] as suggested, and also added a few more of the libraries people have mentioned.

trio-bot · 2020-01-27T11:18:53Z

Hey @jay-tuckey, it looks like that was the first time we merged one of your PRs! Thanks so much! 🎉 🎂

If you want to keep contributing, we'd love to have you. So, I just sent you an invitation to join the python-trio organization on Github! If you accept, then here's what will happen:

Github will automatically subscribe you to notifications on all our repositories. (But you can unsubscribe again if you don't want the spam.)
You'll be able to help us manage issues (add labels, close them, etc.)
You'll be able to review and merge other people's pull requests
You'll get a [member] badge next to your name when participating in the Trio repos, and you'll have the option of adding your name to our member's page and putting our icon on your Github profile (details)

If you want to read more, here's the relevant section in our contributing guide.

Alternatively, you're free to decline or ignore the invitation. You'll still be able to contribute as much or as little as you like, and I won't hassle you about joining again. But if you ever change your mind, just let us know and we'll send another invitation. We'd love to have you, but more importantly we want you to do whatever's best for you.

If you have any questions, well... I am just a humble Python script, so I probably can't help. But please do post a comment here, or in our chat, or on our forum, whatever's easiest, and someone will help you out!

pquentin · 2020-01-27T11:19:31Z

Thanks! Merged. The PyPI search does not appears to include too many results but we can fix that in another pull request.

starting an awesome-trio list

74ae345

Jay Tuckey added 2 commits October 20, 2019 09:58

Added anyio

aba83f4

Added tractor, sniffio, quart-trio to list

84cdc68

njsmith reviewed Oct 20, 2019

View reviewed changes

Updating with more libs + njsmith suggestions

8b33e7b

njsmith closed this Oct 25, 2019

njsmith reopened this Oct 25, 2019

njsmith reviewed Oct 25, 2019

View reviewed changes

Update docs/source/awesome-trio-libraries.rst

399b80d

Co-Authored-By: Nathaniel J. Smith <njs@pobox.com>

jay-tuckey and others added 2 commits November 16, 2019 09:09

Update docs/source/awesome-trio-libraries.rst

21f06e0

Co-Authored-By: Nathaniel J. Smith <njs@pobox.com>

Updating as per discussion in github

e19b675

goodboy reviewed Nov 26, 2019

View reviewed changes

Add next round of suggestions

111c676

jay-tuckey changed the title ~~[WIP] starting an awesome-trio list~~ Starting an awesome-trio list Jan 27, 2020

pquentin merged commit c0ec767 into python-trio:master Jan 27, 2020

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Starting an awesome-trio list #1262

Starting an awesome-trio list #1262

jay-tuckey commented Oct 19, 2019

codecov bot commented Oct 19, 2019 •

edited

Loading

njsmith Oct 20, 2019

njsmith Oct 20, 2019

njsmith Oct 20, 2019

njsmith Oct 20, 2019

njsmith Oct 20, 2019

njsmith Oct 20, 2019

njsmith Oct 20, 2019

jay-tuckey commented Oct 20, 2019

njsmith commented Oct 25, 2019

njsmith Oct 25, 2019

njsmith Oct 25, 2019

smurfix Oct 25, 2019

njsmith Oct 25, 2019

njsmith commented Nov 8, 2019

codecov-io commented Nov 15, 2019 •

edited by codecov bot

Loading

jay-tuckey commented Nov 16, 2019

smurfix commented Nov 24, 2019

energizah commented Nov 24, 2019

goodboy Nov 26, 2019

parity3 commented Dec 30, 2019 •

edited

Loading

dhirschfeld commented Jan 10, 2020

dhirschfeld commented Jan 10, 2020

jay-tuckey commented Jan 27, 2020

trio-bot bot commented Jan 27, 2020

pquentin commented Jan 27, 2020

		* `trio-click <https://github.com/python-trio/trio-click>`__ - Python composable command line utility, trio-compatible version.


		Multi-Core/Multiprocessing

Starting an awesome-trio list #1262

Starting an awesome-trio list #1262

Conversation

jay-tuckey commented Oct 19, 2019

codecov bot commented Oct 19, 2019 • edited Loading

Codecov Report

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

jay-tuckey commented Oct 20, 2019

njsmith commented Oct 25, 2019

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

njsmith commented Nov 8, 2019

codecov-io commented Nov 15, 2019 • edited by codecov bot Loading

Codecov Report

jay-tuckey commented Nov 16, 2019

smurfix commented Nov 24, 2019

energizah commented Nov 24, 2019

Choose a reason for hiding this comment

parity3 commented Dec 30, 2019 • edited Loading

dhirschfeld commented Jan 10, 2020

dhirschfeld commented Jan 10, 2020

jay-tuckey commented Jan 27, 2020

trio-bot bot commented Jan 27, 2020

pquentin commented Jan 27, 2020

codecov bot commented Oct 19, 2019 •

edited

Loading

codecov-io commented Nov 15, 2019 •

edited by codecov bot

Loading

parity3 commented Dec 30, 2019 •

edited

Loading