+ Z 4i\Rt^RIHt^RIHt!RR]4t!RR4tRtRtR t !R R 4t !R R ] 4t !RR] 4t !RR] 4t R#)aTesting API allows fake data to be used in unit tests. Testing launchpadlib code is tricky, because it depends so heavily on a remote, unique webservice: Launchpad. This module helps you write tests for your launchpadlib application that can be run locally and quickly. Say you were writing some code that needed to call out to Launchpad and get the branches owned by the logged-in person, and then do something to them. For example, something like this:: def collect_unique_names(lp): names = [] for branch in lp.me.getBranches(): names.append(branch.unique_name) return names To test it, you would first prepare a L{FakeLaunchpad} object, and give it some sample data of your own devising:: lp = FakeLaunchpad() my_branches = [dict(unique_name='~foo/bar/baz')] lp.me = dict(getBranches: lambda status: my_branches) Then, in the test, call your own code and assert that it behaves correctly given the data. names = collect_unique_names(lp) self.assertEqual(['~foo/bar/baz'], names) And that's it. The L{FakeLaunchpad} code uses a WADL file to type-check any objects created or returned. This means you can be sure that you won't accidentally store sample data with misspelled attribute names. The WADL file that we use by default is for version 1.0 of the Launchpad API. If you want to work against a more recent version of the API, download the WADL yourself (see ) and construct your C{FakeLaunchpad} like this:: from wadllib.application import Application lp = FakeLaunchpad( Application('https://api.launchpad.net/devel/', '/path/to/wadl.xml')) Where 'https://api.launchpad.net/devel/' is the URL for the WADL file, found also in the WADL file itelf. )Callable)datetimec]tRt^HtRtRtR#)IntegrityErrorzERaised when bad sample data is used with a L{FakeLaunchpad} instance.N__name__ __module__ __qualname____firstlineno____doc____static_attributes__r@/usr/lib/python3/dist-packages/launchpadlib/testing/launchpad.pyrrHsOrrcva]tRt^LtoRtR RltRtRt]R Rl4t ]R Rl4t ]R Rl4t R t Vt R#) FakeLaunchpadzA fake Launchpad API class for unit tests that depend on L{Launchpad}. @param application: A C{wadllib.application.Application} instance for a Launchpad WADL definition file. NcVf^RIHpV!4p\V4pVPP RVRVRV/4R#)Nget_application credentials _application _service_root)launchpadlib.testing.resourcesrFakeRoot__dict__update) selfr service_rootcachetimeout proxy_info applicationr root_resources &&&&&&& r__init__FakeLaunchpad.__init__SsE   F)+K -  {   rc 6VPp\W1V4R#)zSet sample data. @param name: The name of the attribute. @param values: A dict representing an object matching a resource defined in Launchpad's WADL definition. N)rsetattr)rnamevaluesrs&&& r __setattr__FakeLaunchpad.__setattr__is))  F+rc .\VPV4#):Get sample data. @param name: The name of the attribute. )getattrr)rr's&&r __getattr__FakeLaunchpad.__getattr__ss t))400rc <^RIHpV!\4V!4R7#)z.Convenience for setting up access credentials.rr!rrobject) cls consumer_name token_string access_secretrrrr rs &&&&&&&& rloginFakeLaunchpad.loginzs C68):;;rc <^RIHpV!\4V!4R7#)z=Get credentials from Launchpad and log into the service root.rr1r2)r4r5rrrr rs&&&&&& rget_token_and_login!FakeLaunchpad.get_token_and_login C68):;;rc <^RIHpV!\4V!4R7#)z5Log in to Launchpad with possibly cached credentials.rr1r2)r4r5rlaunchpadlib_dirrr rs&&&&&& r login_withFakeLaunchpad.login_withr=rr)NNNNNN)NNNN)rr r r r r#r)r. classmethodr8r;r@r __classdictcell__ __classdict__s@rrrLsU  ,,1 < < < < < >rca]tRt^toRtR.tRRltRt]!43Rlt Rt Rt R t R t R tR tR tRtRtRtRtRtRtRtRtVtR#) FakeResourcea Represents valid sample data on L{FakeLaunchpad} instances. @ivar _children: A dictionary of child resources, each of type C{FakeResource}. @ivar _values: A dictionary of values associated with this resource. e.g. "display_name" or "date_created". The values of this dictionary will never be C{FakeResource}s. Note that if C{_children} has a key, then C{_values} will not, and vice versa. That is, they are distinct dicts. lp_saveNc  XVf/pVPPRVRVR/RV/4R#)aConstruct a FakeResource. @param application: A C{waddlib.application.Application} instance. @param resource_type: A C{wadllib.application.ResourceType} instance for this resource. @param values: Optionally, a dict representing attribute key/value pairs for this resource. Nr_resource_type _children_values)rr)rr! resource_typer(s&&&&rr#FakeResource.__init__s9 >F   -R6   rc \V\4'd!VPW4VPV&R#/pVP VP 4W#V&VP VPV4W0PR&R#)zSet sample data. C{value} can be a dict representing an object matching a resource defined in the WADL definition. Alternatively, C{value} could be a resource itself. Either way, it is checked for type correctness against the WADL definition. r\N) isinstancedict_create_child_resourcer[rr\_check_resource_typerZr)rr'rIr(s&&& rr)FakeResource.__setattr__sj eT " "#'#>#>t#KDNN4 F MM$,, ' 4L  % %d&9&96 B'-MM) $rc VPPW4pW2JdCVPPW4p\V\4'dVP W4#WP 9dR#W2Jd\V: RV: R24hV#)r,cR#)Trrrr*FakeResource.__getattr__..s4rz has no attribute '')r[rGr\r`r _wrap_methodspecial_methodsAttributeError)rr'_markerresults&&& rr.FakeResource.__getattr__s} ##D2  \\%%d4F&(++((66 '' '    tT!JK K rc aaaVVV3RlpV#)zWrapper around methods validates results when it's run. @param name: The name of the method. @param method: The callable to run when the method is called. c2<SP!SS.VO5/VB#rM) _run_method)argskwargsmethodr'rs*,rwrapper*FakeResource._wrap_method..wrappers ##D&B4B6B Brr)rr'rurvsfff rrjFakeResource._wrap_methods Crc BVPVPR4pVPPV,pVP V4Uu/uFpVP VbK ppRpVP VR,4pVfRpVP VR,4pVf\V: R24hVPV4p V'd(VPW4\VPW4#VPW4wr\VPV VVV 4#uupi)aq Ensure that C{values} is a valid object for the C{name} attribute and return a resource object to represent it as API data. @param name: The name of the attribute to check the C{values} object against. @param values: A dict with key/value pairs representing attributes and methods of an object matching the C{name} resource's definition. @return: A L{FakeEntry} for an ordinary resource or a L{FakeCollection} for a resource that represents a collection. @raises IntegrityError: Raised if C{name} isn't a valid attribute for this resource or if C{values} isn't a valid object for the C{name} attribute. rGF_collection_linkT_linkz isn't a valid property.) _find_representation_idrZrrepresentation_definitionsparamsr'rGr_get_resource_typerc FakeEntry_check_collection_typeFakeCollection) rr'r(xml_idrepresentationrJr~is_linkparamr]child_resource_types &&& rrb#FakeResource._create_child_resource s%--d.A.A5I**EEfM(..~> > JJ >   4"445 =GJJtg~.E = !GH H//6   % %m <T.. F F(,(C(C) %D"!!#  ' s Dc VPP\R44pVPR4pVPP V4#)zGet the resource type for C{param}. @param param: An object representing a C{_link} or C{_collection_link} parameter. @return: The resource type for the parameter, or None if one isn't available. linkr])tagfindrUrGrget_resource_type)rrrr's&& rrFakeResource._get_resource_type6s@yy~~hv./xx(  22488rc VP4F@wr4\V\4'dVPW4K.VP WV4KB R#)a3 Ensure that attributes and methods defined for C{partial_object} match attributes and methods defined for C{resource_type}. @param resource_type: The resource type to check the attributes and methods against. @param partial_object: A dict with key/value pairs representing attributes and methods. N)itemsr`r _get_method_check_attribute)rr]partial_objectr'rIs&&& rrc!FakeResource._check_resource_typeBsD*//1KD%**  5%%m5A 2rc RpRpVP4F\wr5VR8XdVPW4wr4K!\V\4'dVP W4KJVP WV4K^ W43#)a Ensure that attributes and methods defined for C{partial_object} match attributes and methods defined for C{resource_type}. Collection entries are treated specially. @param resource_type: The resource type to check the attributes and methods against. @param partial_object: A dict with key/value pairs representing attributes and methods. @return: (name, resource_type), where 'name' is the name of the child resource type and 'resource_type' is the corresponding resource type. Nentries)r_check_entriesr`rrr)rr]rr'rrIs&&& rr#FakeResource._check_collection_typeSs}")//1KDy ,0,?,?!-))E8,,  5%%m5A2((rc VPW4pVF@pVF7pVPR4pVfKVPPV4uu# KB R#)zFind the WADL XML id for the representation of C{resource_type}. Looks in the WADL for the first representiation associated with the method for a resource type. :return: An XML id (a string). hrefN)rrGr lookup_xml_id)rr]r' get_methodresponserrepresentation_urls&&& rr|$FakeResource._find_representation_idosW%%m: "H"*%3%7%7%?"%1,,::;MNN#+#rc NVPVR4pVPWBV4R#)ag Ensure that C{value} is a valid C{name} attribute on C{resource_type}. Does this by finding the representation for the default, canonical GET method (as opposed to the many "named" GET methods that exist.) @param resource_type: The resource type to check the attribute against. @param name: The name of the attribute. @param value: The value to check. rGN)r|_check_attribute_representation)rr]r'rIrs&&&& rrFakeResource._check_attribute~s&--mUC ,,V5Arc VPPV,pVPV4Uu/uFpVPVbK ppVR,V9d4VP WbR,,4pVP Ws4wrR#VR,V9d2VP WbR,,4pVP Ws4R#VPV4p V f\RV,4hV Pf+\V\4'g\V: RV: 24hR#V PR8Xd+\V\4'g\V: RV: 24hR#R#uupi)a Ensure that C{value} is a valid value for C{name} with the representation definition matching C{xml_id}. @param xml_id: The XML ID for the representation to check the attribute against. @param name: The name of the attribute. @param value: The value to check. @raises IntegrityError: Raised if C{name} is not a valid attribute name or if C{value}'s type is not valid for the attribute. rzr{Nz %s not foundz is not a str or unicode for z xsd:dateTimez is not a datetime for ) rr}r~r'rrrcrGrtyper`strr) rrr'rIrrJr~r] child_namerrs &&&& rr,FakeResource._check_attribute_representations]**EEfM(..~> > JJ >   $ $ . 33001M/3.I.I/ +J+G^v % 33F'>4JKM  % %m ;JJt$E}$^d%:;;zz!!%--(?DdK.~-!%22(9>E3./ sE%c W P9dR#VPPR4pV: RV: 2p\VPRV4wpV# \d\ T: RT: 24hi;i)aGet the C{name} method on C{resource_type}. @param resource_type: The method's resource type. @param name: The name of the method. @raises IntegrityError: Raised if a method called C{name} is not available on C{resource_type}. @return: The XML element for the method from the WADL. Nid-z is not a method of )rkrrGrK ValueErrorr)rr]r' resource_namerrs&&& rrFakeResource._get_methods| '' ' %))--d3 )40 ,]->->fMLZ    .2MB  s AA1c vV!V/VBpWP9gVfV#VPVPW4#)aRun a method and convert its result into a L{FakeResource}. If the result represents an object it is validated against the WADL definition before being returned. @param name: The name of the method. @param method: A callable. @param args: Arguments to pass to the callable. @param kwargs: Keyword arguments to pass to the callable. @return: A L{FakeResource} representing the result if it's an object. @raises IntegrityError: Raised if the return value from the method isn't valid. )rk_create_resourcerZ)rr'rursrtrns&&&*, rrrFakeResource._run_methodsA(( '' '6>M(()<)Mfg. **99 9 k !F#00??G ??+ , ,(,(C(C$) %D"!!$#    % %&: C !2!24HIH+1<<>' k:,:Orc 8VPVR4pVPPV,p\VPRR4wp\ V4wpVP R4pVPR4^,pVVPPV43#)aGet the name and resource type for the entries in a collection. @param resource_type: The resource type for a collection. @return: (name, resource_type), where 'name' is the name of the child resource type and 'resource_type' is the corresponding resource type. rGr' entry_linksr]#) r|rr}rKrlistrGsplitr)rr]rrepresentation_definitionrresource_type_urlresource_type_names&& r_get_child_resource_type%FakeResource._get_child_resource_types--mUC    8 8 @ "* % ) )6= {+)--o>.44S9!<     / /0A B  rc bVPV4wr4VFpVPWE4K W43#)awEnsure that C{entries} are valid for a C{resource_type} collection. @param resource_type: The resource type of the collection the entries are in. @param entries: A list of dicts representing objects in the collection. @return: (name, resource_type), where 'name' is the name of the child resource type and 'resource_type' is the corresponding resource type. )rrc)rr]rr'rentrys&&& rrFakeResource._check_entriess>%)$A$A % !E  % %&9 A((rc  2VPPPR4pRpVPPRV4pVPPRV4pRVPP : RV: RV: R\ \V44: R2 #)z} The resource type, identifier if available, and memory address are used to generate a representation of this fake resource. rr3r'< z at >)rZrrGr\ __class__rhexr)rr'keys& r__repr__FakeResource.__repr__1sy ""&&**40lltS)llvs+ NN # #   4M   rrrM)rr r r r rkr#r)r3r.rjrbrrcrr|rrrrrrrrrr rCrDs@rrWrWs{ !kO (.&)/ *X 9B")8 O B(T*L(%N 0)$  rrWc6aa]tRtRtoRtV3RltRtVtV;t#)riBz$Fake root object for an application.c j<VPVPR,4p\SV` W4R#)zCreate a L{FakeResource} for the service root of C{application}. @param application: A C{wadllib.application.Application} instance. z #service-rootN)r markup_urlsuperr#)rr!r]rs&& rr#FakeRoot.__init__Es2 $55  " "_ 4  4rr) rr r r r r#r rC __classcell__rrEs@@rrrBs.55rrc]tRtRtRtRtR#)riPzA fake resource for an entry.rNrrrrrrPs'rrcFaa]tRtRtoRtRV3RlltRtRtRtVt V;t #)riTz!A fake resource for a collection.cf<\SV`WV4VPPRVRV/4R#)_name_child_resource_typeN)rr#rr)rr!r]r(r'rrs&&&&&&rr#FakeCollection.__init__Ws4 V<  d24G H rc# "VPPRR4pVF,pVPVPVPV4xK. R#5i)z;Iterate items if this resource has an C{entries} attribute.rNr)r\rGrrr)rrrs& r__iter__FakeCollection.__iter__dsI,,""9b1E''))4::u sAAc V\V4p\V\4'dXVP;'g^pVPpV^8d \ R4hV^8d \ R4hVP V4#\V\4'dVP V4#\R4h)zLook up a slice, or a subordinate resource by index. @param key: An individual object key or a C{slice}. @raises IndexError: Raised if an invalid key is provided. @return: A L{FakeResource} instance for the entry matching C{key}. z6Collection slices must have a nonnegative start point.z>Collection slices must have a definite, nonnegative end point.z!Do not support index lookups yet.) rr`slicestartstopr __getitem__int IndexError)rrrrrs&& rrFakeCollection.__getitem__lst* c5 ! !IINNE88Dqy Oax -&&s+ + S ! !&&s+ +@A Arr)NNN) rr r r r r#rrr rCrrs@@rrrTs+  BBrrN)r collections.abcrr ExceptionrrrKrRrUrWrrrrrrrsq&/b%PYPX<X