uasyncio server awrite documentation?

[GM-Script-Writer-62850]

I came across this: https://github.com/orgs/micropython/discussions/10745

I have always seen and used writer.write(my_data_string) what is this asynchronous writer i see in that thread (await writer.awrite(my_data_string))

[peterhinch]

See this explanation.

[GM-Script-Writer-62850]

Not seeing anything about this '_a_write()'

[peterhinch]

To quote from the above reference:

Writing to a StreamWriter occurs in two stages. The synchronous .write method concatenates data for later transmission. The asynchronous .drain causes transmission. To avoid allocation call .drain after each call to .write.

[GM-Script-Writer-62850]

that was my understanding of how it works

writer.write()
await writer.drain()

but i was asking were this comes from

await writer.awrite() # what is this???
await writer.drain()

[peterhinch]

It's legacy code and is deprecated. From the source:

# Legacy uasyncio compatibility

async def stream_awrite(self, buf, off=0, sz=-1):
    if off != 0 or sz != -1:
        buf = memoryview(buf)
        if sz == -1:
            sz = len(buf)
        buf = buf[off : off + sz]
    self.write(buf)
    await self.drain()


Stream.aclose = Stream.wait_closed
Stream.awrite = stream_awrite

As you can see, internally it does what is described above.

[GM-Script-Writer-62850]

thanks