This is the documentation for the latest development branch of MicroPython and may refer to features that are not available in released versions.

If you are looking for the documentation for a specific release, use the drop-down menu on the left and select the desired version.

Python 3.6

Python 3.6 beta 1 was released on 12 Sep 2016, and a summary of the new features can be found here:

New Syntax Features		Status
PEP 498	Literal String Formatting	Complete
PEP 515	Underscores in Numeric Literals	Complete
PEP 525	Asynchronous Generators
PEP 526	Syntax for Variable Annotations (provisional)	Complete
PEP 530	Asynchronous Comprehensions
New Built-in Features
PEP 468	Preserving the order of kwargs in a function
PEP 487	Simpler customization of class creation
PEP 520	Preserving Class Attribute Definition Order
Standard Library Changes
PEP 495	Local Time Disambiguation
PEP 506	Adding A Secrets Module To The Standard Library
PEP 519	Adding a file system path protocol
CPython Internals
PEP 509	Add a private version to dict	Won’t do
PEP 523	Adding a frame evaluation API to CPython
Linux/Window Changes
PEP 524	Make os.urandom() blocking on Linux (during system startup)
PEP 528	Change Windows console encoding to UTF-8
PEP 529	Change Windows filesystem encoding to UTF-8

Other Language Changes:

A global or nonlocal statement must now textually appear before the first use of the affected name in the same scope. Previously this was a SyntaxWarning.
It is now possible to set a special method to None to indicate that the corresponding operation is not available. For example, if a class sets __iter__() to None , the class is not iterable.
Long sequences of repeated traceback lines are now abbreviated as [Previous line repeated {count} more times]
Import now raises the new exception ModuleNotFoundError when it cannot find a module. Code that currently checks for ImportError (in try-except) will still work.
Class methods relying on zero-argument super() will now work correctly when called from metaclass methods during class creation.

Changes to built-in modules:

array
Exhausted iterators of array.array will now stay exhausted even if the iterated array is extended.
binascii
The b2a_base64() function now accepts an optional newline keyword argument to control whether the newline character is appended to the return value	Complete
cmath
The new cmath.tau (τ) constant has been added
New constants: cmath.inf and cmath.nan to match math.inf and math.nan , and also cmath.infj and cmath.nanj to match the format used by complex repr
collections
The new Collection abstract base class has been added to represent sized iterable container classes
The new Reversible abstract base class represents iterable classes that also provide the __reversed__() method.
The new AsyncGenerator abstract base class represents asynchronous generators.
The namedtuple() function now accepts an optional keyword argument module, which, when specified, is used for the __module__ attribute of the returned named tuple class.
The verbose and rename arguments for namedtuple() are now keyword-only.
Recursive collections.deque instances can now be pickled.
hashlib
BLAKE2 hash functions were added to the module. blake2b() and blake2s() are always available and support the full feature set of BLAKE2.
The SHA-3 hash functions sha3_224(), sha3_256(), sha3_384(), sha3_512(), and SHAKE hash functions shake_128() and shake_256() were added.
The password-based key derivation function scrypt() is now available with OpenSSL 1.1.0 and newer.
json
json.load() and json.loads() now support binary input. Encoded JSON should be represented using either UTF-8, UTF-16, or UTF-32.
math
The new math.tau (τ) constant has been added	Complete
os
A new close() method allows explicitly closing a scandir() iterator. The scandir() iterator now supports the context manager protocol.
On Linux, os.urandom() now blocks until the system urandom entropy pool is initialized to increase the security.
The Linux getrandom() syscall (get random bytes) is now exposed as the new os.getrandom() function.
re
Added support of modifier spans in regular expressions. Examples: ‘(?i:p)ython’ matches ‘python’ and ‘Python’, but not ‘PYTHON’; ‘(?i)g(?-i:v)r’ matches ‘GvR’ and ‘gvr’, but not ‘GVR’.
Match object groups can be accessed by __getitem__, which is equivalent to group(). So mo[‘name’] is now equivalent to mo.group(‘name’).
Match objects now support index-like objects as group indices.
socket
The ioctl() function now supports the SIO_LOOPBACK_FAST_PATH control code.
The getsockopt() constants SO_DOMAIN , SO_PROTOCOL, SO_PEERSEC , and SO_PASSSEC are now supported.
The setsockopt() now supports the setsockopt(level, optname, None, optlen: int) form.
The socket module now supports the address family AF_ALG to interface with Linux Kernel crypto API. ALG_, SOL_ALG and sendmsg_afalg() were added.
New Linux constants TCP_USER_TIMEOUT and TCP_CONGESTION were added.
ssl
ssl supports OpenSSL 1.1.0. The minimum recommend version is 1.0.2.
3DES has been removed from the default cipher suites and ChaCha20 Poly1305 cipher suites have been added.
SSLContext has better default configuration for options and ciphers.
SSL session can be copied from one client-side connection to another with the new SSLSession class. TLS session resumption can speed up the initial handshake, reduce latency and improve performance.
The new get_ciphers() method can be used to get a list of enabled ciphers in order of cipher priority.
All constants and flags have been converted to IntEnum and IntFlags.
Server and client-side specific TLS protocols for SSLContext were added.
Added SSLContext.post_handshake_auth to enable and ssl.SSLSocket.verify_client_post_handshake() to initiate TLS 1.3 post-handshake authentication.
struct
now supports IEEE 754 half-precision floats via the ‘e’ format specifier.
sys
The new getfilesystemencodeerrors() function returns the name of the error mode used to convert between Unicode filenames and bytes filenames.
zlib
The compress() and decompress() functions now accept keyword arguments