From bb7cfcc124d6d33215d8319cf05c2a59aca5adcd Mon Sep 17 00:00:00 2001
From: Roman Mogilatov <roman.mogilatov@cupid.com>
Date: Mon, 8 Jun 2015 11:33:27 +0300
Subject: [PATCH] Finishing of Factory provider docs

---
 docs/images/factory_attribute_injections.png  | Bin 0 -> 6366 bytes
 docs/images/factory_init_injections.png       | Bin 0 -> 4112 bytes
 .../factory_init_injections_and_contexts.png  | Bin 0 -> 7370 bytes
 docs/images/factory_method_injections.png     | Bin 0 -> 8747 bytes
 docs/providers.rst                            | 158 ++++++++++++++++--
 .../providers/factory_attribute_injections.py |  52 ++++++
 examples/providers/factory_init_injections.py |   4 +-
 .../factory_init_injections_and_contexts.py   |  12 +-
 .../providers/factory_method_injections.py    |  60 +++++++
 9 files changed, 268 insertions(+), 18 deletions(-)
 create mode 100644 docs/images/factory_attribute_injections.png
 create mode 100644 docs/images/factory_init_injections.png
 create mode 100644 docs/images/factory_init_injections_and_contexts.png
 create mode 100644 docs/images/factory_method_injections.png
 create mode 100644 examples/providers/factory_attribute_injections.py
 create mode 100644 examples/providers/factory_method_injections.py

diff --git a/docs/images/factory_attribute_injections.png b/docs/images/factory_attribute_injections.png
new file mode 100644
index 0000000000000000000000000000000000000000..29b982510cae00ed543e0e8555e80537c7fc305e
GIT binary patch
literal 6366
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
bC$}d7|6E`Wq3nAsK&P+sK)dvgUHHEN|G>}r

literal 0
HcmV?d00001

diff --git a/docs/images/factory_init_injections.png b/docs/images/factory_init_injections.png
new file mode 100644
index 0000000000000000000000000000000000000000..31ddc5b77e14da81ff5e558ffdc24fbac2076f5f
GIT binary patch
literal 4112
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
Q?m0jZdM4NFbZ_4K7b&}hYybcN

literal 0
HcmV?d00001

diff --git a/docs/images/factory_init_injections_and_contexts.png b/docs/images/factory_init_injections_and_contexts.png
new file mode 100644
index 0000000000000000000000000000000000000000..a3328ed00ceb77c36fa18bc30df5aa26edce29d6
GIT binary patch
literal 7370
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
R#Y!?DQ;<`UErGr8|2KeBw50$5

literal 0
HcmV?d00001

diff --git a/docs/images/factory_method_injections.png b/docs/images/factory_method_injections.png
new file mode 100644
index 0000000000000000000000000000000000000000..95a44af706bacc859c92f6481a847537928ab125
GIT binary patch
literal 8747
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
bf9YuN|33>fNVYiK2;ga|={`lMJb(Kii-q>!

literal 0
HcmV?d00001

diff --git a/docs/providers.rst b/docs/providers.rst
index 84f96890..55f665a9 100644
--- a/docs/providers.rst
+++ b/docs/providers.rst
@@ -72,6 +72,8 @@ Example below shows how to create ``Factory`` of particular class with
 ``__init__`` keyword argument injections which injectable values are also
 provided by another factories:
 
+.. image:: images/factory_init_injections.png
+
 .. code-block:: python
 
     """`Factory` providers with init injections example."""
@@ -105,8 +107,8 @@ provided by another factories:
                             KwArg('main_photo', photos_factory))
 
     # Creating several User objects:
-    user1 = users_factory()  # Same as: User(main_photo=Photo())
-    user2 = users_factory()  # Same as: User(main_photo=Photo())
+    user1 = users_factory()  # Same as: user1 = User(main_photo=Photo())
+    user2 = users_factory()  # Same as: user2 = User(main_photo=Photo())
 
     # Making some asserts:
     assert isinstance(user1, User)
@@ -125,6 +127,8 @@ passes positional context arguments to class's ``__init__`` method, but
 keyword context arguments have priority on ``KwArg`` injections (this could be
 useful for testing). So, please, follow the example below:
 
+.. image:: images/factory_init_injections_and_contexts.png
+
 .. code-block:: python
 
     """`Factory` providers with init injections and context arguments example."""
@@ -177,12 +181,12 @@ useful for testing). So, please, follow the example below:
                             KwArg('credit_card', credit_cards_factory))
 
     # Creating several User objects:
-    user1 = users_factory(1)  # Same as: User(1,
-                              #               main_photo=Photo(),
-                              #               credit_card=CreditCard())
-    user2 = users_factory(2)  # Same as: User(2,
-                              #               main_photo=Photo(),
-                              #               credit_card=CreditCard())
+    user1 = users_factory(1)  # Same as: user1 = User(1,
+                              #                       main_photo=Photo(),
+                              #                       credit_card=CreditCard())
+    user2 = users_factory(2)  # Same as: user2 = User(2,
+                              #                       main_photo=Photo(),
+                              #                       credit_card=CreditCard())
 
     # Making some asserts:
     assert user1.id == 1
@@ -211,12 +215,146 @@ useful for testing). So, please, follow the example below:
 Factory providers and attribute injections
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    - Attributes example.
+Example below shows how to create ``Factory`` of particular class with
+attribute injections. Those injections are done by setting specified attributes
+with injectable values right after object's creation.
+
+.. image:: images/factory_attribute_injections.png
+
+.. code-block:: python
+
+    """`Factory` providers with attribute injections example."""
+
+    from objects.providers import Factory
+    from objects.injections import Attribute
+
+
+    class User(object):
+
+        """Example class User."""
+
+        def __init__(self):
+            """Initializer."""
+            self.main_photo = None
+            self.credit_card = None
+
+
+    class Photo(object):
+
+        """Example class Photo."""
+
+
+    class CreditCard(object):
+
+        """Example class CreditCard."""
+
+
+    # User, Photo and CreditCard factories:
+    credit_cards_factory = Factory(CreditCard)
+    photos_factory = Factory(Photo)
+    users_factory = Factory(User,
+                            Attribute('main_photo', photos_factory),
+                            Attribute('credit_card', credit_cards_factory))
+
+    # Creating several User objects:
+    user1 = users_factory()  # Same as: user1 = User()
+                             #          user1.main_photo = Photo()
+                             #          user1.credit_card = CreditCard()
+    user2 = users_factory()  # Same as: user2 = User()
+                             #          user2.main_photo = Photo()
+                             #          user2.credit_card = CreditCard()
+
+    # Making some asserts:
+    assert user1 is not user2
+
+    assert isinstance(user1.main_photo, Photo)
+    assert isinstance(user1.credit_card, CreditCard)
+
+    assert isinstance(user2.main_photo, Photo)
+    assert isinstance(user2.credit_card, CreditCard)
+
+    assert user1.main_photo is not user2.main_photo
+    assert user1.credit_card is not user2.credit_card
+
 
 Factory providers and method injections
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    - Method example.
+Current example shows how to create ``Factory`` of particular class with
+method injections. Those injections are done by calling of specified method
+with injectable value right after object's creation and attribute injections
+are done.
+
+Method injections are not very popular in Python due Python best practices
+(usage of public attributes instead of setter methods), but it may appear in
+some cases.
+
+.. image:: images/factory_method_injections.png
+
+.. code-block:: python
+
+    """`Factory` providers with method injections example."""
+
+    from objects.providers import Factory
+    from objects.injections import Method
+
+
+    class User(object):
+
+        """Example class User."""
+
+        def __init__(self):
+            """Initializer."""
+            self.main_photo = None
+            self.credit_card = None
+
+        def set_main_photo(self, photo):
+            """Set user's main photo."""
+            self.main_photo = photo
+
+        def set_credit_card(self, credit_card):
+            """Set user's credit card."""
+            self.credit_card = credit_card
+
+
+    class Photo(object):
+
+        """Example class Photo."""
+
+
+    class CreditCard(object):
+
+        """Example class CreditCard."""
+
+
+    # User, Photo and CreditCard factories:
+    credit_cards_factory = Factory(CreditCard)
+    photos_factory = Factory(Photo)
+    users_factory = Factory(User,
+                            Method('set_main_photo', photos_factory),
+                            Method('set_credit_card', credit_cards_factory))
+
+    # Creating several User objects:
+    user1 = users_factory()  # Same as: user1 = User()
+                             #          user1.set_main_photo(Photo())
+                             #          user1.set_credit_card(CreditCard())
+    user2 = users_factory()  # Same as: user2 = User()
+                             #          user2.set_main_photo(Photo())
+                             #          user2.set_credit_card(CreditCard())
+
+    # Making some asserts:
+    assert user1 is not user2
+
+    assert isinstance(user1.main_photo, Photo)
+    assert isinstance(user1.credit_card, CreditCard)
+
+    assert isinstance(user2.main_photo, Photo)
+    assert isinstance(user2.credit_card, CreditCard)
+
+    assert user1.main_photo is not user2.main_photo
+    assert user1.credit_card is not user2.credit_card
+
+
 
 Instance providers & Injections
 -------------------------------
diff --git a/examples/providers/factory_attribute_injections.py b/examples/providers/factory_attribute_injections.py
new file mode 100644
index 00000000..1e5f1e79
--- /dev/null
+++ b/examples/providers/factory_attribute_injections.py
@@ -0,0 +1,52 @@
+"""`Factory` providers with attribute injections example."""
+
+from objects.providers import Factory
+from objects.injections import Attribute
+
+
+class User(object):
+
+    """Example class User."""
+
+    def __init__(self):
+        """Initializer."""
+        self.main_photo = None
+        self.credit_card = None
+
+
+class Photo(object):
+
+    """Example class Photo."""
+
+
+class CreditCard(object):
+
+    """Example class CreditCard."""
+
+
+# User, Photo and CreditCard factories:
+credit_cards_factory = Factory(CreditCard)
+photos_factory = Factory(Photo)
+users_factory = Factory(User,
+                        Attribute('main_photo', photos_factory),
+                        Attribute('credit_card', credit_cards_factory))
+
+# Creating several User objects:
+user1 = users_factory()  # Same as: user1 = User()
+                         #          user1.main_photo = Photo()
+                         #          user1.credit_card = CreditCard()
+user2 = users_factory()  # Same as: user2 = User()
+                         #          user2.main_photo = Photo()
+                         #          user2.credit_card = CreditCard()
+
+# Making some asserts:
+assert user1 is not user2
+
+assert isinstance(user1.main_photo, Photo)
+assert isinstance(user1.credit_card, CreditCard)
+
+assert isinstance(user2.main_photo, Photo)
+assert isinstance(user2.credit_card, CreditCard)
+
+assert user1.main_photo is not user2.main_photo
+assert user1.credit_card is not user2.credit_card
diff --git a/examples/providers/factory_init_injections.py b/examples/providers/factory_init_injections.py
index 02d79998..9d068ed3 100644
--- a/examples/providers/factory_init_injections.py
+++ b/examples/providers/factory_init_injections.py
@@ -29,8 +29,8 @@ users_factory = Factory(User,
                         KwArg('main_photo', photos_factory))
 
 # Creating several User objects:
-user1 = users_factory()  # Same as: User(main_photo=Photo())
-user2 = users_factory()  # Same as: User(main_photo=Photo())
+user1 = users_factory()  # Same as: user1 = User(main_photo=Photo())
+user2 = users_factory()  # Same as: user2 = User(main_photo=Photo())
 
 # Making some asserts:
 assert isinstance(user1, User)
diff --git a/examples/providers/factory_init_injections_and_contexts.py b/examples/providers/factory_init_injections_and_contexts.py
index de78273a..a43e5f5a 100644
--- a/examples/providers/factory_init_injections_and_contexts.py
+++ b/examples/providers/factory_init_injections_and_contexts.py
@@ -48,12 +48,12 @@ users_factory = Factory(User,
                         KwArg('credit_card', credit_cards_factory))
 
 # Creating several User objects:
-user1 = users_factory(1)  # Same as: User(1,
-                          #               main_photo=Photo(),
-                          #               credit_card=CreditCard())
-user2 = users_factory(2)  # Same as: User(2,
-                          #               main_photo=Photo(),
-                          #               credit_card=CreditCard())
+user1 = users_factory(1)  # Same as: user1 = User(1,
+                          #                       main_photo=Photo(),
+                          #                       credit_card=CreditCard())
+user2 = users_factory(2)  # Same as: user2 = User(2,
+                          #                       main_photo=Photo(),
+                          #                       credit_card=CreditCard())
 
 # Making some asserts:
 assert user1.id == 1
diff --git a/examples/providers/factory_method_injections.py b/examples/providers/factory_method_injections.py
new file mode 100644
index 00000000..83897a52
--- /dev/null
+++ b/examples/providers/factory_method_injections.py
@@ -0,0 +1,60 @@
+"""`Factory` providers with method injections example."""
+
+from objects.providers import Factory
+from objects.injections import Method
+
+
+class User(object):
+
+    """Example class User."""
+
+    def __init__(self):
+        """Initializer."""
+        self.main_photo = None
+        self.credit_card = None
+
+    def set_main_photo(self, photo):
+        """Set user's main photo."""
+        self.main_photo = photo
+
+    def set_credit_card(self, credit_card):
+        """Set user's credit card."""
+        self.credit_card = credit_card
+
+
+class Photo(object):
+
+    """Example class Photo."""
+
+
+class CreditCard(object):
+
+    """Example class CreditCard."""
+
+
+# User, Photo and CreditCard factories:
+credit_cards_factory = Factory(CreditCard)
+photos_factory = Factory(Photo)
+users_factory = Factory(User,
+                        Method('set_main_photo', photos_factory),
+                        Method('set_credit_card', credit_cards_factory))
+
+# Creating several User objects:
+user1 = users_factory()  # Same as: user1 = User()
+                         #          user1.set_main_photo(Photo())
+                         #          user1.set_credit_card(CreditCard())
+user2 = users_factory()  # Same as: user2 = User()
+                         #          user2.set_main_photo(Photo())
+                         #          user2.set_credit_card(CreditCard())
+
+# Making some asserts:
+assert user1 is not user2
+
+assert isinstance(user1.main_photo, Photo)
+assert isinstance(user1.credit_card, CreditCard)
+
+assert isinstance(user2.main_photo, Photo)
+assert isinstance(user2.credit_card, CreditCard)
+
+assert user1.main_photo is not user2.main_photo
+assert user1.credit_card is not user2.credit_card