Merge pull request #58 from barseghyanartur/dev

Fix/fixes (#57)

README.rst

@@ -25,6 +25,7 @@ fake.py
 .. _Creating DOCX: https://fakepy.readthedocs.io/en/latest/creating_docx.html
 .. _Creating images: https://fakepy.readthedocs.io/en/latest/creating_images.html
 .. _Contributor guidelines: https://fakepy.readthedocs.io/en/latest/contributor_guidelines.html
+.. _Examples: https://github.com/barseghyanartur/fake.py/tree/main/examples
 
 Minimalistic, standalone alternative fake data generator with no dependencies.
 
@@ -106,6 +107,7 @@ Documentation
 - For tips on ``DOCX`` creation see `Creating DOCX`_.
 - For tips on images creation see `Creating images`_.
 - For guidelines on contributing check the `Contributor guidelines`_.
+- For various implementation examples, see the `Examples`_.
 
 Usage
 =====

examples/README.rst

@@ -0,0 +1,11 @@
+fake.py examples
+================
+
+- `Customization <customization/README.rst>`_.
+- `Dataclasses <dataclasses/README.rst>`_.
+- `Django <django/README.rst>`_.
+- `Hypothesis <hypothesis/README.rst>`_.
+- `Lazy/Fuzzy <lazyfuzzy/README.rst>`_.
+- `Pydantic <pydantic/README.rst>`_.
+- `SQLAlchemy <sqlalchemy/README.rst>`_.
+- `TortoiseORM <tortoise/README.rst>`_.

examples/customization/README.rst

@@ -0,0 +1,8 @@
+Customization
+=============
+Various customization examples:
+
+- Address provider implementation.
+- Band provider implementation.
+- Replace built-in fake data corpus/vocabulary with a custom one.
+- Override default data.

examples/dataclasses/README.rst

@@ -0,0 +1,4 @@
+Dataclasses
+===========
+Example factories for models based on
+`dataclasses <https://docs.python.org/3/library/dataclasses.html>`_.

examples/django/README.rst

@@ -0,0 +1,3 @@
+Django
+======
+Example factories for `Django <https://www.djangoproject.com/>`_ models.

examples/hypothesis/README.rst

@@ -0,0 +1,3 @@
+Hypothesis
+==========
+Additional tests using `hypothesis <https://hypothesis.readthedocs.io>`_.

examples/lazyfuzzy/README.rst

@@ -0,0 +1,5 @@
+Lazy/Fuzzy
+==========
+- A sample ``FuzzyChoice`` alternative implementation based on
+  ``LazyFunction`` and ``functools.partial``.
+- Various usage examples of ``LazyFunction`` and ``LazyAttribute``.

examples/pydantic/README.rst

@@ -0,0 +1,3 @@
+Pydantic
+========
+Example factories for models based on `Pydantic <https://docs.pydantic.dev>`_.

examples/sqlalchemy/README.rst

@@ -0,0 +1,3 @@
+SQLAlchemy
+==========
+Example factories for models based on `SQLAlchemy <https://sqlalchemy.org>`_.

examples/sqlalchemy/article/factories.py

@@ -70,15 +70,15 @@ def add_to_group(user: User, name: str) -> None:
 class UserFactory(SQLAlchemyModelFactory):
     """User factory."""
 
-    username = FACTORY.username()  # mypy: ignore
-    first_name = FACTORY.first_name()  # mypy: ignore
-    last_name = FACTORY.last_name()  # mypy: ignore
-    email = FACTORY.email()  # mypy: ignore
-    date_joined = FACTORY.date_time()  # mypy: ignore
-    last_login = FACTORY.date_time()  # mypy: ignore
+    username = FACTORY.username()  # type: ignore
+    first_name = FACTORY.first_name()  # type: ignore
+    last_name = FACTORY.last_name()  # type: ignore
+    email = FACTORY.email()  # type: ignore
+    date_joined = FACTORY.date_time()  # type: ignore
+    last_login = FACTORY.date_time()  # type: ignore
     is_superuser = False
     is_staff = False
-    is_active = FACTORY.pybool()  # mypy: ignore
+    is_active = FACTORY.pybool()  # type: ignore
     password = PreSave(set_password, password="test1234")  # type: ignore
     group = PostSave(add_to_group, name="TestGroup1234")  # type: ignore
 
@@ -109,14 +109,14 @@ def _post_save_method(self, instance):
 class ArticleFactory(SQLAlchemyModelFactory):
     """Article factory."""
 
-    title = FACTORY.sentence()  # mypy: ignore
-    slug = FACTORY.slug()  # mypy: ignore
-    content = FACTORY.text()  # mypy: ignore
-    image = FACTORY.png_file(storage=STORAGE)  # mypy: ignore
-    pub_date = FACTORY.date()  # mypy: ignore
-    safe_for_work = FACTORY.pybool()  # mypy: ignore
-    minutes_to_read = FACTORY.pyint(min_value=1, max_value=10)  # mypy: ignore
-    author = SubFactory(UserFactory)  # mypy: ignore
+    title = FACTORY.sentence()  # type: ignore
+    slug = FACTORY.slug()  # type: ignore
+    content = FACTORY.text()  # type: ignore
+    image = FACTORY.png_file(storage=STORAGE)  # type: ignore
+    pub_date = FACTORY.date()  # type: ignore
+    safe_for_work = FACTORY.pybool()  # type: ignore
+    minutes_to_read = FACTORY.pyint(min_value=1, max_value=10)  # type: ignore
+    author = SubFactory(UserFactory)  # type: ignore
 
     class Meta:
         model = Article

examples/tortoise/README.rst

@@ -0,0 +1,4 @@
+TortoiseORM
+===========
+Example factories for models based on
+`TortoiseORM <https://tortoise.github.io>`_.

fake.py

@@ -2523,9 +2523,9 @@ def get_provider_for_type(cls, field_type) -> Optional[Callable]:
             return None
         if (
             hasattr(field_type, "__origin__")
-            and field_type.__origin__ is Optional
+            and field_type.__origin__ is Optional  # noqa
         ):
-            field_type = field_type.__args__[0]
+            field_type = field_type.__args__[0]  # noqa
         return cls.TYPE_TO_PROVIDER.get(field_type)
 
     @classmethod