backlib
=======

|PyPI Version| |PyPI Downloads| |License| |Python Version|

Key Features
------------

-  Provides backports for the standard library;
-  Compatible with Python 3.9+;
-  Almost dependency-free.

Getting Started
---------------

Installation
~~~~~~~~~~~~

The library is available as `backlib <https://pypi.org/project/backlib/>`__ on PyPI:

.. code:: shell

   pip install backlib

Usage
~~~~~

builtins
^^^^^^^^

For more, see the `documentation <https://backlib.readthedocs.io/en/latest/backports/index.html>`__.

.. code:: python

   from backlib.py310 import builtins

   assert issubclass(builtins.EncodingWarning, Warning)

errno
^^^^^

For more, see the `documentation <https://backlib.readthedocs.io/en/latest/backports/index.html>`__.

.. code:: python

   from backlib.py311 import errno

   assert errno.ENOTCAPABLE == 93

io [SOON]
^^^^^^^^^

.. code:: python

   from backlib.py311 import io

   encoding = io.text_encoding(None)

   assert encoding == "utf-8"

json
^^^^

For more, see the `documentation <https://backlib.readthedocs.io/en/latest/backports/index.html>`__.

.. code:: python

   from backlib.py310 import json

   data = json.loads("{\"backlib\": \"pypi\"}")

   assert data == {"backlib": "pypi"}

operator
^^^^^^^^

For more, see the `documentation <https://backlib.readthedocs.io/en/latest/backports/index.html>`__.

.. code:: python

   from backlib.py311 import operator

   value = operator.call(abs, -42)

   assert value == 42

os
^^

For more, see the `documentation <https://backlib.readthedocs.io/en/latest/backports/index.html>`__.

.. code:: python

   from backlib.py312 import os

   st = os.stat("pyproject.toml")

   assert st.st_birthtime_ns > 0

os.path
^^^^^^^

For more, see the `documentation <https://backlib.readthedocs.io/en/latest/backports/index.html>`__.

.. code:: python

   from backlib.py313 import os

   assert os.path.isreserved("NUL")

stat
^^^^

For more, see the `documentation <https://backlib.readthedocs.io/en/latest/backports/index.html>`__.

.. code:: python

   from backlib.py313 import stat

   assert stat.SF_SYNTHETIC == 0xC0000000

tomllib
^^^^^^^

For more, see the `documentation <https://backlib.readthedocs.io/en/latest/backports/index.html>`__.

.. code:: python

   from backlib.py311 import tomllib

   data = tomllib.loads("\"backlib\" = \"pypi\"")

   assert data == {"backlib": "pypi"}

Documentation
-------------

.. toctree::
    :maxdepth: 3

    backports/index

License
-------

MIT License, Copyright (c) 2025 Sergei Y. Bogdanov. See
`LICENSE <https://github.com/syubogdanov/backlib/tree/main/LICENSE>`__
file.


.. |PyPI Version| image:: https://img.shields.io/pypi/v/backlib.svg?color=green
   :target: https://pypi.org/project/backlib/

.. |PyPI Downloads| image:: https://img.shields.io/pypi/dm/backlib.svg?color=green
   :target: https://pypi.org/project/backlib/

.. |License| image:: https://img.shields.io/pypi/l/backlib.svg?color=green
   :target: https://github.com/syubogdanov/backlib/tree/main/LICENSE

.. |Python Version| image:: https://img.shields.io/pypi/pyversions/backlib.svg?color=green
   :target: https://pypi.org/project/backlib/