more refactoring of docs

Author: zancas

f5/bigip/resource.py

@@ -40,8 +40,8 @@
 We refer to a server-provided resource as a "service".  Thus far all URI
 referenced resources are "services" in this sense.
 
-We use methods named Create, Refresh, Update, Load, Modify, and Delete to manipulate
-BIG-IP® device services.
+We use methods named Create, Refresh, Update, Load, Modify, and Delete to
+manipulate BIG-IP® device services.
 
 Methods:
 
@@ -69,7 +69,7 @@
       construction.
     * ResourceBase -- only `refresh` is generally supported in all resource
       types, this class provides `refresh`. ResourceBase objects are usually
-      instantiated via setting lazy attributes. 
+      instantiated via setting lazy attributes.
       All ResourceBase objects (except BIG-IPs) have a container (BIG-IPs
       contain themselves).  The container is the object the ResourceBase is an
       attribute of.
@@ -83,6 +83,10 @@
       post (via _create) they uniquely depend on 2 uri's, a uri that supports
       the creating post, and the returned uri of the newly created resource.
         Example URI_path:  /mgmt/tm/ltm/nat/~Common~testnat1
+    * UnnamedResource -- Some resources correspond to URIs that do not have
+      unique names, therefore the class does _not_ support create-or-delete,
+      and supports a customized 'load' that doesn't require name/partition
+      parameters.
 """
 import keyword
 import re

f5/bigip/test/test_resource.py

@@ -670,15 +670,13 @@ def test_collection_s():
 class TestPathElement(object):
 
     def test_missing_req_param_true(self):
-        p = PathElement(mock.MagicMock())
         rqset = set(['FOOPAR1', 'FOOPAR2'])
         fakearg = {'FOOPAR1': 'FOOVAL'}
         mrq = _missing_required_parameters(rqset, **fakearg)
         assert mrq
         assert mrq == ['FOOPAR2']
 
     def test_missing_req_param_false(self):
-        p = PathElement(mock.MagicMock())
         rqset = set(['FOOPAR1'])
         fakearg = {'FOOPAR1': 'FOOVAL'}
         mrq = _missing_required_parameters(rqset, **fakearg)