https://github.com/esss/oop-ext

OOP Extensions is a set of utilities for object oriented programming which is missing on Python core libraries.
https://github.com/esss/oop-ext

hacktoberfest object-oriented-programming

Last synced: 8 months ago
JSON representation

OOP Extensions is a set of utilities for object oriented programming which is missing on Python core libraries.

• Host: GitHub
• URL: https://github.com/esss/oop-ext
• Owner: ESSS
• License: mit
• Created: 2019-03-08T12:02:00.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2024-11-11T11:17:52.000Z (about 1 year ago)
• Last Synced: 2024-11-11T12:24:46.698Z (about 1 year ago)
• Topics: hacktoberfest, object-oriented-programming
• Language: Python
• Homepage:
• Size: 400 KB
• Stars: 14
• Watchers: 6
• Forks: 2
• Open Issues: 5
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE

Awesome Lists containing this project

README

          
======================================================================

OOP Extensions

======================================================================

.. image:: https://img.shields.io/pypi/v/oop-ext.svg

    :target: https://pypi.python.org/pypi/oop-ext

.. image:: https://img.shields.io/pypi/pyversions/oop-ext.svg

    :target: https://pypi.org/project/oop-ext

.. image:: https://github.com/ESSS/oop-ext/workflows/build/badge.svg

    :target: https://github.com/ESSS/oop-ext/actions

.. image:: https://codecov.io/gh/ESSS/oop-ext/branch/master/graph/badge.svg

    :target: https://codecov.io/gh/ESSS/oop-ext

.. image:: https://img.shields.io/readthedocs/oop-extensions.svg

    :target: https://oop-extensions.readthedocs.io/en/latest/

.. image:: https://results.pre-commit.ci/badge/github/ESSS/oop-ext/master.svg

    :target: https://results.pre-commit.ci/latest/github/ESSS/oop-ext/master

.. image:: https://sonarcloud.io/api/project_badges/measure?project=ESSS_oop-ext&metric=alert_status

    :target: https://sonarcloud.io/project/overview?id=ESSS_oop-ext

What is OOP Extensions ?

================================================================================

OOP Extensions is a set of utilities for object oriented programming which is missing on Python core libraries.

Usage

================================================================================

``oop_ext`` brings a set of object oriented utilities, it supports the concept of interfaces,

abstract/overridable methods and more. ``oop_ext`` carefully checks that implementations

have the same method signatures as the interface it implements and raises exceptions otherwise.

Here's a simple example showing some nice features:

.. code-block:: python

    from oop_ext.interface import Interface, ImplementsInterface

    class IDisposable(Interface):

        def dispose(self):

            """

            Clears this object

            """

        def is_disposed(self) -> bool:

            """

            Returns True if the object has been cleared

            """

    @ImplementsInterface(IDisposable)

    class MyObject(Disposable):

        def __init__(self):

            super().__init__()

            self._data = [0] * 100

            self._is_disposed = False

        def is_disposed(self) -> bool:

            return self._is_disposed

        def dispose(self):

            self._is_disposed = True

            self._data = []

If any of the two methods in ``MyObject`` are not implemented or have differ signatures than

the ones declared in ``IDisposable``, the ``ImplementsInterface`` decorator will raise an

error during import.

Arbitrary objects can be verified if they implement a certain interface by using ``IsImplementation``:

.. code-block:: python

    from oop_ext.interface import IsImplementation

    my_object = MyObject()

    if IsImplementation(my_object, IDisposable):

        # my_object is guaranteed to implement IDisposable completely

        my_object.dispose()

Alternatively you can assert that an object implements the desired interface with ``AssertImplements``:

.. code-block:: python

    from oop_ext.interface import AssertImplements

    my_object = MyObject()

    AssertImplements(my_object, IDisposable)

    my_object.dispose()

Type Checking

-------------

As of ``1.1.0``, ``oop-ext`` includes inline type annotations and exposes them to user programs.

If you are running a type checker such as mypy on your tests, you may start noticing type errors indicating incorrect usage.

If you run into an error that you believe to be incorrect, please let us know in an issue.

The types were developed against ``mypy`` version 0.800.

See `the docs `__

for more information.

Contributing

------------

For guidance on setting up a development environment and how to make a

contribution to oop_ext, see the `contributing guidelines`_.

.. _contributing guidelines: https://github.com/ESSS/oop-ext/blob/master/CONTRIBUTING.rst

Release

-------

A reminder for the maintainers on how to make a new release.

Note that the VERSION should follow the semantic versioning as ``X.Y.Z`` (e.g. ``v1.0.5``).

1. Create a ``release-VERSION`` branch from ``upstream/master``.

2. Update ``CHANGELOG.rst``.

3. Push a branch with the changes.

4. Once all builds pass, push a ``VERSION`` tag to ``upstream``.

5. Merge the PR.