CircuitPython - a Python implementation for teaching coding with microcontrollers https://git.suspectdevices.com/suspect-devices/circuitpython/atom?h=v1.8.3 2016-07-30T17:05:56+00:00 2016-07-30T17:05:56+00:00 Paul Sokolovsky pfalcon@users.sourceforge.net 2016-07-30T17:05:56+00:00 urn:sha1:61e77a4e88c4b6971fd997191de01e5ab08e46c5 To filter out even prototypes of mp_stream_posix_*() functions, which require POSIX types like ssize_t & off_t, which may be not available in some ports. 2016-07-29T21:25:06+00:00 Paul Sokolovsky pfalcon@users.sourceforge.net 2016-07-29T21:25:06+00:00 urn:sha1:4f1b0292dbc5920457673a31cadfd894239cc1b9 Previoussly such read() and write() methods were used by modussl_axtls, move to py/stream for reuse. 2016-07-26T21:39:10+00:00 Paul Sokolovsky pfalcon@users.sourceforge.net 2016-07-26T21:39:10+00:00 urn:sha1:a60b0263ba97f655c01f0982df74299c14457b1c 2016-07-13T22:44:50+00:00 Paul Sokolovsky pfalcon@users.sourceforge.net 2016-07-13T22:44:50+00:00 urn:sha1:ad9b9c7621a8a2d85e8056321c3da3287717ec18 3-arg form: stream.write(data, offset, length) 2-arg form: stream.write(data, length) These allow efficient buffer writing without incurring extra memory allocation for slicing or creating memoryview() object, what is important for low-memory ports. All arguments must be positional. It might be not so bad idea to standardize on 3-arg form, but 2-arg case would need check and raising an exception anyway then, so instead it was just made to work. 2016-06-18T15:44:57+00:00 Paul Sokolovsky pfalcon@users.sourceforge.net 2016-06-18T15:19:24+00:00 urn:sha1:07209f8592f15435d6abbccaad5347cea2c7722e It's now used for more than just stream protocol (e.g. pin protocol), so don't use false names. 2016-05-20T18:18:49+00:00 Paul Sokolovsky pfalcon@users.sourceforge.net 2016-05-20T18:16:58+00:00 urn:sha1:497660fcda77ae819f5ea1f6a92b8fb5006d8213 2016-05-17T23:41:45+00:00 Paul Sokolovsky pfalcon@users.sourceforge.net 2016-05-17T23:40:03+00:00 urn:sha1:7f7c84b10a5f3b2f783955b01f55e0f913ac459f Both read and write operations support variants where either a) a single call is made to the undelying stream implementation and returned buffer length may be less than requested, or b) calls are repeated until requested amount of data is collected, shorter amount is returned only in case of EOF or error. These operations are available from the level of C support functions to be used by other C modules to implementations of Python methods to be used in user-facing objects. The rationale of these changes is to allow to write concise and robust code to work with *blocking* streams of types prone to short reads, like serial interfaces and sockets. Particular object types may select "exact" vs "once" types of methods depending on their needs. E.g., for sockets, revc() and send() methods continue to be "once", while read() and write() thus converted to "exactly" versions. These changes don't affect non-blocking handling, e.g. trying "exact" method on the non-blocking socket will return as much data as available without blocking. No data available is continued to be signaled as None return value to read() and write(). From the point of view of CPython compatibility, this model is a cross between its io.RawIOBase and io.BufferedIOBase abstract classes. For blocking streams, it works as io.BufferedIOBase model (guaranteeing lack of short reads/writes), while for non-blocking - as io.RawIOBase, returning None in case of lack of data (instead of raising expensive exception, as required by io.BufferedIOBase). Such a cross-behavior should be optimal for MicroPython needs. 2016-04-10T11:41:28+00:00 Damien George damien.p.george@gmail.com 2016-04-10T11:41:28+00:00 urn:sha1:358e5d8bada558e7197f59221989ff6357a915e4 2016-04-10T11:37:59+00:00 Damien George damien.p.george@gmail.com 2016-04-10T11:37:59+00:00 urn:sha1:657aef66ff3cc308155ea1519ae0c701b326033a Saves 16 bytes of code. Also, use mp_obj_get_int_truncated to allow integers as big as a machine word to be passed as the value. 2016-04-10T10:36:44+00:00 Paul Sokolovsky pfalcon@users.sourceforge.net 2016-04-10T10:36:44+00:00 urn:sha1:558fd5d228d3c610958c4aae41b1ede0b6487c35