Metadata-Version: 2.1
Name: OverloadingFixed
Version: 1.0.4
Summary: Function overloading for Python 3
Home-page: https://github.com/toto112358/overloading.py
Author: L. Pham-Trong
Author-email: spam@lucasanss.xyz
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.0
Description-Content-Type: text/x-rst


``overloading`` is a module that provides function and method dispatching
based on the types and number of runtime arguments.

When an overloaded function is invoked, the dispatcher compares the supplied
arguments to available signatures and calls the implementation providing the
most accurate match:

.. code:: python

    @overload
    def biggest(items: Iterable[int]):
        return max(items)

    @overload
    def biggest(items: Iterable[str]):
        return max(items, key=len)

.. code:: python

    >>> biggest([2, 0, 15, 8, 7])
    15
    >>> biggest(['a', 'abc', 'bc'])
    'abc'


Features
========

* Function validation during registration and comprehensive resolution rules
  guarantee a well-defined outcome at invocation time.
* Supports the `typing`_ module introduced in Python 3.5.
* Supports optional parameters.
* Supports variadic signatures (``*args`` and ``**kwargs``).
* Supports class-/staticmethods.
* Evaluates both positional and keyword arguments.
* No dependencies beyond the standard library

.. _typing:   https://docs.python.org/3/library/typing.html


Documentation
=============

The full documentation is available at https://overloading.readthedocs.org/.




