Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Pin factory_boy to latest version 2.12.0 #1044

Closed
wants to merge 1 commit into from

Conversation

pyup-bot
Copy link
Collaborator

@pyup-bot pyup-bot commented Aug 5, 2019

This PR pins factory_boy to the latest release 2.12.0.

Changelog

2.12.0

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

*New:*

 - Add support for Python 3.7
 - Add support for Django 2.1
 - Add :attr:`~factory.fuzzy.FuzzyChoice.getter` to :class:`~factory.fuzzy.FuzzyChoice` that mimics
   the behavior of ``getter`` in :class:`~factory.Iterator`
 - Make the ``extra_kwargs`` parameter of :meth:`~factory.faker.Faker.generate` optional
 - Add :class:`~factory.RelatedFactoryList` class for one-to-many support, thanks `Sean Harrington <https://github.com/seanharr11>`_.
 - Make the `locale` argument for :class:`~factory.faker.Faker` keyword-only

*Bugfix:*

 - Allow renamed arguments to be optional, thanks to `Justin Crown <https://github.com/mrname>`_.
 - Fix `django_get_or_create` behavior when using multiple fields with `unique=True`, thanks to `YPCrumble <https://github.com/YPCrumble>`

2.11.1

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

*Bugfix:*

 - Fix passing deep context to a :class:`~factory.SubFactory` (``Foo(x__y__z=factory.Faker('name')``)

2.11.0

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

*Bugfix:*

 - Fix :class:`~factory.fuzzy.FuzzyFloat` to return a 15 decimal digits precision float by default
 - :issue:`451`: Restore :class:`~factory.django.FileField` to a
   :class:`~factory.declarations.ParameteredAttribute`, relying on composition to parse the provided parameters.
 - :issue:`389`: Fix random state management with ``faker``.
 - :issue:`466`: Restore mixing :class:`~factory.Trait` and :meth:`~factory.post_generation`.

2.10.0

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

*Bugfix:*

 - :issue:`443`: Don't crash when calling :meth:`factory.Iterator.reset()` on a brand new iterator.

*New:*

 - :issue:`397`: Allow a :class:`factory.Maybe` to contain a :class:`~factory.PostGenerationDeclaration`.
   This also applies to :class:`factory.Trait`, since they use a :class:`factory.Maybe` declaration internally.

2.9.2

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

*Bugfix:*

 - Fix declaration corruption bug when a factory defined `foo__bar__baz=1` and a caller
   provided a `foo__bar=x` parameter at call time: this got merged into the factory's base
   declarations.

2.9.1

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

*Bugfix:*

 - Fix packaging issues (see https://github.com/zestsoftware/zest.releaser/issues/212)
 - Don't crash when debugging PostGenerationDeclaration

2.9.0

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

This version brings massive changes to the core engine, thus reducing the number of
corner cases and weird behaviourrs.

*New:*

 - :issue:`275`: `factory.fuzzy` and `factory.faker` now use the same random seed.
 - Add :class:`factory.Maybe`, which chooses among two possible declarations based
   on another field's value (powers the :class:`~factory.Trait` feature).
 - :class:`~factory.PostGenerationMethodCall` only allows to pass one positional argument; use keyword arguments for
   extra parameters.

*Deprecation:*

 - `factory.fuzzy.get_random_state` is deprecated, `factory.random.get_random_state` should be used instead.
 - `factory.fuzzy.set_random_state` is deprecated, `factory.random.set_random_state` should be used instead.
 - `factory.fuzzy.reseed_random` is deprecated, `factory.random.reseed_random` should be used instead.

2.8.1

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

*Bugfix:*

 - Fix packaging issues.

2.8.0

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

*New:*

 - :issue:`240`: Call post-generation declarations in the order they were declared,
   thanks to `Oleg Pidsadnyi <https://github.com/olegpidsadnyi>`_.
 - :issue:`309`: Provide new options for SQLAlchemy session persistence

*Bugfix:*

 - :issue:`334`: Adjust for the package change in ``faker``

2.7.0

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

*New:*

 - :pr:`267`: Add :class:`factory.LazyFunction` to remove unneeded lambda parameters,
   thanks to `Hervé Cauwelier <https://github.com/bors-ltd>`_.
 - :issue:`251`: Add :ref:`parameterized factories <parameters>` and :class:`traits <factory.Trait>`
 - :pr:`256`, :pr:`292`: Improve error messages in corner cases

*Removed:*

 - :pr:`278`: Formally drop support for Python2.6

.. warning:: Version 2.7.0 moves all error classes to
          `factory.errors`. This breaks existing import statements
          for any error classes except those importing
          `FactoryError` directly from the `factory` module.

2.6.1

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

*New:*

 - :pr:`262`: Allow optional forced flush on SQLAlchemy, courtesy of `Minjung <https://github.com/Minjung>`_.

2.6.0

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

*New:*

 - Add :attr:`factory.FactoryOptions.rename` to help handle conflicting names (:issue:`206`)
 - Add support for random-yet-realistic values through `fake-factory <https://pypi.org/project/fake-factory/>`_,
   through the :class:`factory.Faker` class.
 - :class:`factory.Iterator` no longer begins iteration of its argument at import time,
   thus allowing to pass in a lazy iterator such as a Django queryset
   (i.e ``factory.Iterator(models.MyThingy.objects.all())``).
 - Simplify imports for ORM layers, now available through a simple ``factory`` import,
   at ``factory.alchemy.SQLAlchemyModelFactory`` / ``factory.django.DjangoModelFactory`` / ``factory.mongoengine.MongoEngineFactory``.

*Bugfix:*

 - :issue:`201`: Properly handle custom Django managers when dealing with abstract Django models.
 - :issue:`212`: Fix :meth:`factory.django.mute_signals` to handle Django's signal caching
 - :issue:`228`: Don't load :func:`django.apps.apps.get_model()` until required
 - :pr:`219`: Stop using :meth:`mogo.model.Model.new()`, deprecated 4 years ago.

2.5.2

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

*Bugfix:*

 - Add support for Django 1.7/1.8
 - Add support for mongoengine>=0.9.0 / pymongo>=2.1

2.5.1

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

*Bugfix:*

 - Respect custom managers in :class:`~factory.django.DjangoModelFactory` (see :issue:`192`)
 - Allow passing declarations (e.g :class:`~factory.Sequence`) as parameters to :class:`~factory.django.FileField`
   and :class:`~factory.django.ImageField`.

2.5.0

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

*New:*

 - Add support for getting/setting :mod:`factory.fuzzy`'s random state (see :issue:`175`, :issue:`185`).
 - Support lazy evaluation of iterables in :class:`factory.fuzzy.FuzzyChoice` (see :issue:`184`).
 - Support non-default databases at the factory level (see :issue:`171`)
 - Make :class:`factory.django.FileField` and :class:`factory.django.ImageField` non-post_generation, i.e normal fields also available in ``save()`` (see :issue:`141`).

*Bugfix:*

 - Avoid issues when using :meth:`factory.django.mute_signals` on a base factory class (see :issue:`183`).
 - Fix limitations of :class:`factory.StubFactory`, that can now use :class:`factory.SubFactory` and co (see :issue:`131`).


*Deprecation:*

 - Remove deprecated features from :ref:`v2.4.0`
 - Remove the auto-magical sequence setup (based on the latest primary key value in the database) for Django and SQLAlchemy;
   this relates to issues :issue:`170`, :issue:`153`, :issue:`111`, :issue:`103`, :issue:`92`, :issue:`78`. See https://github.com/FactoryBoy/factory_boy/commit/13d310f for technical details.

.. warning:: Version 2.5.0 removes the 'auto-magical sequence setup' bug-and-feature.
          This could trigger some bugs when tests expected a non-zero sequence reference.

Upgrading
"""""""""

.. warning:: Version 2.5.0 removes features that were marked as deprecated in :ref:`v2.4.0 <v2.4.0>`.

All ``FACTORY_*``-style attributes are now declared in a ``class Meta:`` section:

.. code-block:: python

  Old-style, deprecated
 class MyFactory(factory.Factory):
     FACTORY_FOR = models.MyModel
     FACTORY_HIDDEN_ARGS = ['a', 'b', 'c']

  New-style
 class MyFactory(factory.Factory):
     class Meta:
         model = models.MyModel
         exclude = ['a', 'b', 'c']

A simple shell command to upgrade the code would be:

.. code-block:: sh

  sed -i: inplace update
  grep -l: only file names, not matching lines
 sed -i 's/FACTORY_FOR =/class Meta:\n        model =/' $(grep -l FACTORY_FOR $(find . -name '*.py'))

This takes care of all ``FACTORY_FOR`` occurrences; the files containing other attributes to rename can be found with ``grep -R  FACTORY .``

2.4.1

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

*Bugfix:*

 - Fix overriding deeply inherited attributes (set in one factory, overridden in a subclass, used in a sub-sub-class).

2.4.0

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

*New:*

 - Add support for :attr:`factory.fuzzy.FuzzyInteger.step`, thanks to `ilya-pirogov <https://github.com/ilya-pirogov>`_ (:pr:`120`)
 - Add :meth:`~factory.django.mute_signals` decorator to temporarily disable some signals, thanks to `ilya-pirogov <https://github.com/ilya-pirogov>`_ (:pr:`122`)
 - Add :class:`~factory.fuzzy.FuzzyFloat` (:issue:`124`)
 - Declare target model and other non-declaration fields in a ``class Meta`` section.

*Deprecation:*

 - Use of ``FACTORY_FOR`` and other ``FACTORY`` class-level attributes is deprecated and will be removed in 2.5.
   Those attributes should now declared within the :class:`class Meta <factory.FactoryOptions>` attribute:

   For :class:`factory.Factory`:

   * Rename :attr:`~factory.Factory.FACTORY_FOR` to :attr:`~factory.FactoryOptions.model`
   * Rename :attr:`~factory.Factory.ABSTRACT_FACTORY` to :attr:`~factory.FactoryOptions.abstract`
   * Rename :attr:`~factory.Factory.FACTORY_STRATEGY` to :attr:`~factory.FactoryOptions.strategy`
   * Rename :attr:`~factory.Factory.FACTORY_ARG_PARAMETERS` to :attr:`~factory.FactoryOptions.inline_args`
   * Rename :attr:`~factory.Factory.FACTORY_HIDDEN_ARGS` to :attr:`~factory.FactoryOptions.exclude`

   For :class:`factory.django.DjangoModelFactory`:

   * Rename :attr:`~factory.django.DjangoModelFactory.FACTORY_DJANGO_GET_OR_CREATE` to :attr:`~factory.django.DjangoOptions.django_get_or_create`

   For :class:`factory.alchemy.SQLAlchemyModelFactory`:

   * Rename :attr:`~factory.alchemy.SQLAlchemyModelFactory.FACTORY_SESSION` to :attr:`~factory.alchemy.SQLAlchemyOptions.sqlalchemy_session`

2.3.1

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

*Bugfix:*

 - Fix badly written assert containing state-changing code, spotted by `chsigi <https://github.com/chsigi>`_ (:pr:`126`)
 - Don't crash when handling objects whose __repr__ is non-pure-ascii bytes on Py2,
   discovered by `mbertheau <https://github.com/mbertheau>`_ (:issue:`123`) and `strycore <https://github.com/strycore>`_ (:pr:`127`)

2.3.0

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

*New:*

 - Add :class:`~factory.fuzzy.FuzzyText`, thanks to `jdufresne <https://github.com/jdufresne>`_ (:pr:`97`)
 - Add :class:`~factory.fuzzy.FuzzyDecimal`, thanks to `thedrow <https://github.com/thedrow>`_ (:pr:`94`)
 - Add support for :class:`~mongoengine.EmbeddedDocument`, thanks to `imiric <https://github.com/imiric>`_ (:pr:`100`)

2.2.1

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

*Bugfix:*

 - Fixed sequence counter for :class:`~factory.django.DjangoModelFactory` when a factory
   inherits from another factory relating to an abstract model.

2.2.0

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

*Bugfix:*

 - Removed duplicated :class:`~factory.alchemy.SQLAlchemyModelFactory` lurking in :mod:`factory`
   (:pr:`83`)
 - Properly handle sequences within object inheritance chains.
   If FactoryA inherits from FactoryB, and their associated classes share the same link,
   sequence counters will be shared (:issue:`93`)
 - Properly handle nested :class:`~factory.SubFactory` overrides

*New:*

 - The :class:`~factory.django.DjangoModelFactory` now supports the ``FACTORY_FOR = 'myapp.MyModel'``
   syntax, making it easier to shove all factories in a single module (:issue:`66`).
 - Add :meth:`factory.debug()` helper for easier backtrace analysis
 - Adding factory support for mongoengine with :class:`~factory.mongoengine.MongoEngineFactory`.

2.1.2

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

*New:*

 - The :class:`~factory.Factory.ABSTRACT_FACTORY` keyword is now optional, and automatically set
   to ``True`` if neither the :class:`~factory.Factory` subclass nor its parent declare the
   :class:`~factory.Factory.FACTORY_FOR` attribute (:issue:`74`)

2.1.1

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

*Bugfix:*

 - Properly retrieve the ``color`` keyword argument passed to :class:`~factory.django.ImageField`

2.1.0

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

*New:*

 - Add :class:`~factory.fuzzy.FuzzyDate` thanks to `saulshanabrook <https://github.com/saulshanabrook>`_
 - Add :class:`~factory.fuzzy.FuzzyDateTime` and :class:`~factory.fuzzy.FuzzyNaiveDateTime`.
 - Add a :attr:`~factory.builder.Resolver.factory_parent` attribute to the
   :class:`~factory.builder.Resolver` passed to :class:`~factory.LazyAttribute`, in order to access
   fields defined in wrapping factories.
 - Move :class:`~factory.django.DjangoModelFactory` and :class:`~factory.mogo.MogoFactory`
   to their own modules (:mod:`factory.django` and :mod:`factory.mogo`)
 - Add the :meth:`~factory.Factory.reset_sequence` classmethod to :class:`~factory.Factory`
   to ease resetting the sequence counter for a given factory.
 - Add debug messages to ``factory`` logger.
 - Add a :meth:`~factory.Iterator.reset` method to :class:`~factory.Iterator` (:issue:`63`)
 - Add support for the SQLAlchemy ORM through :class:`~factory.alchemy.SQLAlchemyModelFactory`
   (:pr:`64`, thanks to `Romain Commandé <https://github.com/rcommande>`_)
 - Add :class:`factory.django.FileField` and :class:`factory.django.ImageField` hooks for
   related Django model fields (:issue:`52`)

*Bugfix*

 - Properly handle non-integer pks in :class:`~factory.django.DjangoModelFactory` (:issue:`57`).
 - Disable :class:`~factory.RelatedFactory` generation when a specific value was
   passed (:issue:`62`, thanks to `Gabe Koscky <https://github.com/dhekke>`_)

*Deprecation:*

 - Rename :class:`~factory.RelatedFactory`'s ``name`` argument to ``factory_related_name`` (See :issue:`58`)

2.0.2

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

*New:*

 - When :attr:`~factory.django.DjangoModelFactory.FACTORY_DJANGO_GET_OR_CREATE` is
   empty, use ``Model.objects.create()`` instead of ``Model.objects.get_or_create``.

2.0.1

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

*New:*

 - Don't push ``defaults`` to ``get_or_create`` when
   :attr:`~factory.django.DjangoModelFactory.FACTORY_DJANGO_GET_OR_CREATE` is not set.

2.0.0

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

*New:*

 - Allow overriding the base factory class for :func:`~factory.make_factory` and friends.
 - Add support for Python3 (Thanks to `kmike <https://github.com/kmike>`_ and `nkryptic <https://github.com/nkryptic>`_)
 - The default :attr:`~factory.Sequence.type` for :class:`~factory.Sequence` is now :obj:`int`
 - Fields listed in :attr:`~factory.Factory.FACTORY_HIDDEN_ARGS` won't be passed to
   the associated class' constructor
 - Add support for ``get_or_create`` in :class:`~factory.django.DjangoModelFactory`,
   through :attr:`~factory.django.DjangoModelFactory.FACTORY_DJANGO_GET_OR_CREATE`.
 - Add support for :mod:`~factory.fuzzy` attribute definitions.
 - The :class:`Sequence` counter can be overridden when calling a generating function
 - Add :class:`~factory.Dict` and :class:`~factory.List` declarations (Closes :issue:`18`).

*Removed:*

 - Remove associated class discovery
 - Remove :class:`~factory.InfiniteIterator` and :func:`~factory.infinite_iterator`
 - Remove :class:`~factory.CircularSubFactory`
 - Remove ``extract_prefix`` kwarg to post-generation hooks.
 - Stop defaulting to Django's ``Foo.objects.create()`` when "creating" instances
 - Remove STRATEGY_*
 - Remove :meth:`~factory.Factory.set_building_function` / :meth:`~factory.Factory.set_creation_function`

1.3.0

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

.. warning:: This version deprecates many magic or unexplicit features that will be
          removed in v2.0.0.

          Please read the :ref:`changelog-1-3-0-upgrading` section, then run your
          tests with ``python -W default`` to see all remaining warnings.

New
"""

- **Global:**
 - Rewrite the whole documentation
 - Provide a dedicated :class:`~factory.mogo.MogoFactory` subclass of :class:`~factory.Factory`

- **The Factory class:**
 - Better creation/building customization hooks at :meth:`factory.Factory._build` and :meth:`factory.Factory.create`
 - Add support for passing non-kwarg parameters to a :class:`~factory.Factory`
   wrapped class through :attr:`~factory.Factory.FACTORY_ARG_PARAMETERS`.
 - Keep the :attr:`~factory.Factory.FACTORY_FOR` attribute in :class:`~factory.Factory` classes

- **Declarations:**
 - Allow :class:`~factory.SubFactory` to solve circular dependencies between factories
 - Enhance :class:`~factory.SelfAttribute` to handle "container" attribute fetching
 - Add a :attr:`~factory.Iterator.getter` to :class:`~factory.Iterator`
   declarations
 - A :class:`~factory.Iterator` may be prevented from cycling by setting
   its :attr:`~factory.Iterator.cycle` argument to ``False``
 - Allow overriding default arguments in a :class:`~factory.PostGenerationMethodCall`
   when generating an instance of the factory
 - An object created by a :class:`~factory.django.DjangoModelFactory` will be saved
   again after :class:`~factory.PostGeneration` hooks execution


Pending deprecation
"""""""""""""""""""

The following features have been deprecated and will be removed in an upcoming release.

- **Declarations:**
 - :class:`~factory.InfiniteIterator` is deprecated in favor of :class:`~factory.Iterator`
 - :class:`~factory.CircularSubFactory` is deprecated in favor of :class:`~factory.SubFactory`
 - The ``extract_prefix`` argument to :meth:`~factory.post_generation` is now deprecated

- **Factory:**
 - Usage of :meth:`~factory.Factory.set_creation_function` and :meth:`~factory.Factory.set_building_function`
   are now deprecated
 - Implicit associated class discovery is no longer supported, you must set the :attr:`~factory.Factory.FACTORY_FOR`
   attribute on all :class:`~factory.Factory` subclasses


.. _changelog-1-3-0-upgrading:

Upgrading
"""""""""

This version deprecates a few magic or undocumented features.
All warnings will turn into errors starting from v2.0.0.

In order to upgrade client code, apply the following rules:

- Add a ``FACTORY_FOR`` attribute pointing to the target class to each
:class:`~factory.Factory`, instead of relying on automagic associated class
discovery
- When using factory_boy for Django models, have each factory inherit from
:class:`~factory.django.DjangoModelFactory`
- Replace ``factory.CircularSubFactory('some.module', 'Symbol')`` with
``factory.SubFactory('some.module.Symbol')``
- Replace ``factory.InfiniteIterator(iterable)`` with ``factory.Iterator(iterable)``
- Replace ``factory.post_generation()`` with ``factory.post_generation``
- Replace ``factory.set_building_function(SomeFactory, building_function)`` with
an override of the :meth:`~factory.Factory._build` method of ``SomeFactory``
- Replace ``factory.set_creation_function(SomeFactory, creation_function)`` with
an override of the :meth:`~factory.Factory._create` method of ``SomeFactory``

1.2.0

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

*New:*

 - Add :class:`~factory.CircularSubFactory` to solve circular dependencies between factories

1.1.5

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

*Bugfix:*

 - Fix :class:`~factory.PostGenerationDeclaration` and derived classes.

1.1.4

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

*New:*

 - Add :meth:`~factory.use_strategy` decorator to override a
   :class:`~factory.Factory`'s default strategy
 - Improve test running (tox, python2.6/2.7)
 - Introduce :class:`~factory.PostGeneration` and
   :class:`~factory.RelatedFactory`

1.1.3

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

*Bugfix:*

- Fix packaging rules

1.1.2

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

*New:*

- Add :class:`~factory.Iterator` and :class:`~factory.InfiniteIterator` for :class:`~factory.Factory` attribute declarations.
- Provide :func:`~factory.Factory.generate` and :func:`~factory.Factory.simple_generate`, that allow specifying the instantiation strategy directly.
 Also provides :func:`~factory.Factory.generate_batch` and :func:`~factory.Factory.simple_generate_batch`.

1.1.1

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

*New:*

- Add :func:`~factory.Factory.build_batch`, :func:`~factory.Factory.create_batch` and :func:`~factory.Factory.stub_batch`, to instantiate factories in batch

1.1.0

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

*New:*

- Improve the :class:`~factory.SelfAttribute` syntax to fetch sub-attributes using the ``foo.bar`` syntax;
- Add :class:`~factory.ContainerAttribute` to fetch attributes from the container of a :class:`~factory.SubFactory`.
- Provide the :func:`~factory.make_factory` helper: ``MyClassFactory = make_factory(MyClass, x=3, y=4)``
- Add :func:`~factory.build`, :func:`~factory.create`, :func:`~factory.stub` helpers

*Bugfix:*

- Allow classmethod/staticmethod on factories

*Deprecation:*

- Auto-discovery of :attr:`~factory.Factory.FACTORY_FOR` based on class name is now deprecated

1.0.4

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

*New:*

- Improve the algorithm for populating a :class:`~factory.Factory` attributes dict
- Add ``python setup.py test`` command to run the test suite
- Allow custom build functions
- Introduce :data:`~factory.MOGO_BUILD` build function
- Add support for inheriting from multiple :class:`~factory.Factory`
- Base :class:`~factory.Factory` classes can now be declared :attr:`abstract <factory.Factory.ABSTRACT_FACTORY>`.
- Provide :class:`~factory.django.DjangoModelFactory`, whose :class:`~factory.Sequence` counter starts at the next free database id
- Introduce :class:`~factory.SelfAttribute`, a shortcut for ``factory.LazyAttribute(lambda o: o.foo.bar.baz``.

*Bugfix:*

- Handle nested :class:`~factory.SubFactory`
- Share sequence counter between parent and subclasses
- Fix :class:`~factory.SubFactory` / :class:`~factory.Sequence` interferences

1.0.2

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

*New:*

- Introduce :class:`~factory.SubFactory`

1.0.1

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

*New:*

- Allow :class:`~factory.Factory` inheritance
- Improve handling of custom build/create functions

*Bugfix:*

- Fix concurrency between :class:`~factory.LazyAttribute` and :class:`~factory.Sequence`

1.0.0

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

*New:*

- First version of factory_boy


Credits
-------

* Initial version by Mark Sandstrom (2010)
* Developed by Raphaël Barrois since 2011


.. vim:et:ts=4:sw=4:tw=119:ft=rst:
Links

@atodorov atodorov closed this Aug 5, 2019
@atodorov atodorov deleted the pyup-pin-factory_boy-2.12.0 branch August 5, 2019 10:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants