Merge pull request #122 from jacebrowning/release/v1.0

Release v1.0

CHANGES.md

@@ -1,5 +1,9 @@
 # Revision History
 
+## 1.0 (2016/05/22)
+
+- Initial stable release.
+
 ## 0.8.1 (2016/04/28)
 
 - Now invoking `__init__` in `Dictionary` converters to run custom validations.

setup.py

@@ -30,7 +30,7 @@
     long_description=(DESCRIPTION),
     license='MIT',
     classifiers=[
-        'Development Status :: 4 - Beta',
+        'Development Status :: 5 - Production/Stable',
         'Intended Audience :: Developers',
         'License :: OSI Approved :: MIT License',
         'Natural Language :: English',

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

@@ -3,7 +3,7 @@
 import sys
 
 __project__ = 'YORM'
-__version__ = '0.8.1.post1'
+__version__ = '1.0'
 
 VERSION = __project__ + '-' + __version__
 
@@ -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