Rename 'find_all' to 'match'

tests/test_imports.py

@@ -28,7 +28,7 @@ def test_from_top_decorators():
 def test_from_top_utilities():
     from yorm import create
     from yorm import find
-    from yorm import find_all
+    from yorm import match
     from yorm import load
     from yorm import save
     from yorm import delete

yorm/__init__.py

@@ -17,7 +17,7 @@
     from . import bases, types
     from .common import UUID
     from .decorators import sync, sync_object, sync_instances, attr
-    from .utilities import create, find, find_all, load, save, delete
+    from .utilities import create, find, match, load, save, delete
     from .bases import Container, Converter, Mappable, Convertible
 except ImportError:  # pragma: no cover (manual test)
     pass

yorm/test/test_utilities.py

@@ -83,11 +83,11 @@ def it_requires_a_mapped_class_or_instance():
             utilities.find(Mock)
 
 
-def describe_find_all():
+def describe_match():
 
     def it_is_not_yet_implemented():
         with expect.raises(NotImplementedError):
-            utilities.find_all(Mock)
+            utilities.match(Mock)
 
 
 def describe_load():

yorm/utilities.py

@@ -38,8 +38,8 @@ def find(class_or_instance, *args, create=False):  # pylint: disable=redefined-o
         return None
 
 
-def find_all(cls, **kwargs):
-    """Return a list of all matching mapped objects."""
+def match(cls, **kwargs):
+    """Yield all matching mapped objects."""
     log.debug((cls, kwargs))
     raise NotImplementedError