Version 0.1

Author: danie1k

README.rst

@@ -2,11 +2,60 @@
 deps
 ****
 
-Python >=3.6 dependency injection based on attrs
+Python >=3.6 dependency injection based on attrs. Very simple, yet powerful.
 
 Inspired by `inject-attrs <https://github.com/dradetsky/inject-attrs/>`_.
 
 
+Usage
+-----
+``deps`` **works only with typing annotations defined as presented below!**
+
+1. First, replace your ``@attr.s(...)`` decorators:
+    .. code-block:: python
+
+      @attr.s(auto_attribs=True, <other args/kwargs...>)
+      class Thing:
+        cfg: Config
+        some_dep: SomeClass
+
+   With:
+    .. code-block:: python
+
+      import deps
+
+      @deps.s(<other args/kwargs...>)
+      class Thing:
+          cfg: IConfig
+          some_dep: ISomeClass
+
+   Notice that ``auto_attribs=True`` is no more needed, it will be forced by this package.
+
+2. Next you have to prepare - somewhere in your codebase - an abstract interfaces classes for your attributes:
+    .. code-block:: python
+
+      import deps
+
+      class IConfig(deps.Interface)
+          # ...
+
+      class ISomeClass(deps.Interface)
+          # ...
+
+3. Now prepare interfaces implementations:
+    .. code-block:: python
+
+      from interfaces import IConfig, ISomeClass
+
+      class Config(IConfig)
+          # ...
+
+      class SomeClass(ISomeClass)
+          # ...
+
+4. Finally, configure dependency injection bindings provided by `Inject <https://pypi.org/project/Inject/>`_ package, using ``bind_to_constructor`` directive.
+
+
 License
 -------
 MIT

deps.py

@@ -0,0 +1,28 @@
+from typing import get_type_hints
+
+from attr import attrs as original_attrs, Factory
+import inject
+
+__all__ = ('attributes', 'attrs', 's', 'Interface')
+__version__ = '0.1'
+
+
+class Interface:
+    pass
+
+
+def attrs(*args, **kwargs):
+    def wrap(cls):
+        hints = get_type_hints(cls)
+
+        for property_name, property_type in hints.items():
+            if isinstance(property_type, type) and issubclass(property_type, Interface):
+                setattr(cls, property_name, Factory(lambda: inject.instance(property_type)))
+
+        kwargs['auto_attribs'] = True
+        return original_attrs(*args, **kwargs)(cls)
+
+    return wrap
+
+
+s = attributes = attrs

setup.py

@@ -0,0 +1,44 @@
+import ast
+import os
+import re
+from setuptools import setup
+
+current_dir = os.path.abspath(os.path.dirname(__file__))
+_version_re = re.compile(r'__version__\s+=\s+(?P<version>.*)')
+
+with open(os.path.join(current_dir, 'deps.py'), 'r') as f:
+    version = _version_re.search(f.read()).group('version')
+    version = str(ast.literal_eval(version))
+
+
+setup(
+    name='deps',
+    license='MIT',
+    version=version,
+    description='Dependency injection based on attrs',
+    long_description=open('README.rst').read(),
+    author='Daniel Kuruc',
+    author_email='[email protected]',
+    url='https://github.com/danie1k/deps',
+    py_modules=[
+        'deps',
+    ],
+    zip_safe=False,
+    python_requires='>=3.6',
+    tests_require=['pytest'],
+    install_requires=[
+        'attrs < 19.4',
+        'Inject < 3.6',
+    ],
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3 :: Only",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+    ],
+)