+ WBiRRtRtRt^RIt^RIt^RIt^RIt^RIt^RIt^RI t ^RI t ^RI H t ^RI HtHtHtHt^RIt^RIt^RIHtHtHt!RR]P04t!R R 4t!R R ] P64t!R R4tR#)z3unittest.TestCase convenience methods for DBusMocksz Martin PittzH (c) 2012 Canonical Ltd. (c) 2017 - 2022 Martin Pitt NPath)AnyDictOptionalTuple) MOCK_IFACEOBJECT_MANAGER_IFACE load_modulecva]tRt^ toRtRtRt]V3RlRl4tV3RlRlt Rt R V3R lR llt R t Vt R #)BusTypez"Represents a system or session bussessionsystemcF<V^8dQhRS[S[S[S[,3,/#return)rstrr)format __classdict__s"6/usr/lib/python3.14/site-packages/dbusmock/testcase.py __annotate__BusType.__annotate__'s"sHSM12c RVPP4 R2p\PP V4pW3#)zDReturns the name and value of this bus' address environment variableDBUS_ _BUS_ADDRESS)valueupperosenvironget)selfenvrs& rr BusType.environ&s:djj&&()6 s#zrcH<V^8dQhRS[PP/#r)dbusbus Connection)rrs"rrr-s!! 3 3!rc VPwrV'd \PPV4#V\P 8Xd\P !4#\P!4#)a;Get a dbus.bus.BusConnection() object to this bus. This uses the current environment variables for this bus (if any) and falls back to dbus.SystemBus() or dbus.SessionBus() otherwise. This is preferrable to dbus.SystemBus() and dbus.SessionBus() as those do not get along with multiple changing local test buses. )r r&r' BusConnectionr SYSTEM SystemBus SessionBus)r"_vals& rget_connectionBusType.get_connection-sM 88))#. . 7>> !>># #  rc VP4pVPRR4p\P!VR4pVP 4R#)z9Notify this bus that it needs to reload the configurationzorg.freedesktop.DBusz/org/freedesktop/DBusN)r0 get_objectr& Interface ReloadConfig)r"r'dbus_objdbus_ifs& rreload_configurationBusType.reload_configuration=s?!!#>>"8:QR..+ABrc,<V^8dQhRS[RS[RS[/#)rdestpathtimeout)rfloat)rrs"rrrDs'YYY3YYrc VP4pRpV^8dVPV4'dH\P!VP W4\P R7pVP 4M!VR,p\P!R4KV^8:dV^8gQRV RV 24hR#R# \PPd#pTpR\T49dRp?KVRp?L|Rp?ii;i)zWait for an object to appear on D-Bus Raise an exception if object does not appear within one minute. You can change the timeout in seconds with the "timeout" keyword argument. Ndbus_interfacez.UnknownInterfaceg?z#timed out waiting for D-Bus object z: ) r0name_has_ownerr&r4r3INTROSPECTABLE_IFACE Introspect exceptions DBusExceptionrtimesleep)r"r;r<r=r'last_excpes&&&& rwait_for_bus_objectBusType.wait_for_bus_objectDs !!#k!!$''s~~d'ARVRkRklALLN sNG JJsO a<Q; X"EdV2hZ X X; 44 H*c!f45sAB88C9C44C9N)gN@)__name__ __module__ __qualname____firstlineno____doc__SESSIONr+propertyr r0r8rL__static_attributes____classdictcell__rs@rr r sE,G F  !! YYYrr ca]tRt^atoRtV3RlRltV3RlRltRt]V3RlRl4t ]V3R lR l4t ]V3R lR l4t R t Rt V3RlRltRtRtVtR#) PrivateDBusa+A D-Bus daemon instance that represents a private session or system bus. If used as a context manager it will automatically start the bus and clean up after itself on exit: >>> with PrivateDBus(BusType.SESSION) as bus: >>> do_something(bus) Otherwise, `start()` and `stop()` manually. c <V^8dQhRS[/#)rbustype)r )rrs"rrPrivateDBus.__annotate__ms   rc WnRVn\\P!RR74VnVP VPP R2, VnV\P8XdRMRpVP V, Vn VPPRR7VPRVPP R 2, Vn VPPR VPP R VP R VPP R VP R2 4R#)Ndbusmock_data_)prefixz _bus.socketsystem-servicesservicesT)parents dbusmock__cfgz z4 unix:path=z, z )r\_daemonrtempfilemkdtemp_datadirr_socketr r+ _servicedirmkdir_config write_text)r"r\subdirs&& r__init__PrivateDBus.__init__ms 37 X--5EFG }}$,,*<*<)=['II &-&?"Z==61 t,''Idll6H6H5I*NN   \\   !'##'<<#5#5"67##$%  rc<V^8dQhRR/#)rrrZrN)rrs"rrr]s=rcBVPfVP4V#N)rfstartr"s&r __enter__PrivateDBus.__enter__s <<  JJL rcFVPeVP4R#R#rt)rfstopr"exc_typeexc_valexc_tbs&&&&r__exit__PrivateDBus.__exit__s << # IIK $rc <V^8dQhRS[/#rr)rrs"rrr]s+++rc JVPfQR4hRVP 2#)znReturns this D-Bus' address in the environment variable format, i.e. something like unix:path=/path/to/socket Call start() firstz unix:path=)rfrjrvs&raddressPrivateDBus.addresss+ ||'=)=='DLL>**rc <V^8dQhRS[/#rr)rrs"rrr]s  D rc VP#)zcThe services directory (full path) for any ``.service`` files that need to be known to this D-Bus. )rkrvs&r servicedirPrivateDBus.servicedirs rc <V^8dQhRS[/#r)int)rrs"rrr]s  S rc XVPfQR4hVPP#)z+Return the pid of this D-Bus daemon processr)rfpidrvs&rrPrivateDBus.pids*||'=)=='||rc nRRVP 2R.p\P!V\PR7VnVPP fQhVPP P 4P4p\V4VPP8XgQR4hVPP P4VPP4'gQR4hVPPwr4VP\ PV&R#)zStart the D-Bus daemonz dbus-daemonz--config-file=z --print-pid=1)stdoutNzdbus-daemon pid mismatchzD-Bus socket not created)rm subprocessPopenPIPErfrreadlinestriprrcloserjexistsr\r rr)r"argvrr#r.s& rruPrivateDBus.starts ~>P!''Z__E ||""...ll!!**,2243x4<<+++G-GG+ !!#||""$$@&@@$%%,, 3rc xVP'd@VPP4VPP^R7RTn\P!VPRR7R# \PdTPP 4L\i;i \ dLmi;i)zStop the D-Bus daemonr=NT) ignore_errors) rf terminatewaitrTimeoutExpiredkillProcessLookupErrorshutilrmtreerirvs&rrzPrivateDBus.stops <<<  &&((LL%%a%0  DL dmm48 "00(LL%%'(%  s.B+A66/B(%B+'B((B++ B98B9c <V^8dQhRS[/#)rservicer)rrs"rrr]s00c0rc R\PPR4;'gRpVP\P 8XdRMRpVP R4Fp\V4R, V, V R2, pVP4'gK>VPP4'gQhVPV R2, PV4M \RV R V R 24hVP'dVPP4R #R #) aDEnable the given well-known service name inside dbusmock This symlinks a service file from the usual dbus service directories into the dbusmock environment. Doing that allows the service to be launched automatically if they are defined within $XDG_DATA_DIRS. The daemon configuration is reloaded if a test bus is running. XDG_DATA_DIRSz/usr/local/share/:/usr/share/rarb:zdbus-1.serviceService z not found in XDG_DATA_DIRS ()N)rr r!r\r r+splitrrrk symlink_toAssertionErrorrfr8)r"r xdg_data_dirsrodsrcs&& renable_servicePrivateDBus.enable_services 7ZZ;Z &*llgnn&D"*$$S)Aq'H$v-7)80DDCzz||''..0000!!wix$88DDSI *!8G94QR_Q``a!bc c <<< LL - - / rc VPV R2, P4TP'dTP P 4R#R# \d\RT R24Rhi;i)Disable the given well known service name inside dbusmock This unlink's the .service file for the service and reloads the daemon configuration if a test bus is running. rrz not foundN)rkunlinkOSErrorrrfr\r8)r"rs&&rdisable_servicePrivateDBus.disable_serviceso  K   7)8 4 4 < < > <<< LL - - /  K 8G9J!?@d J Ks $AA2)rmrfrirkrjr\N)rOrPrQrRrSrprwrrUrrrrurzrrrVrWrXs@rrZrZas}   : ++    '" 900. 0 0rrZca]tRt^toRtRtRtRt]PR]PR/t ] V3RlRl4t ] RV3RlRll4t]R4t]V3RlR l4t]V3R lR l4t]V3R lR l4t] RV3RlRll4t] RV3RlRll4t] RV3RlRll4t] RV3RlRll4t] RV3RlRll4t] RV3RlRll4tV3RltRtVtR#) DBusTestCaseaBase class for D-Bus mock tests. This provides some convenience API to start/stop local D-Buses, so that you can run a private local session and/or system bus to run mocks on. This also provides a spawn_server() static method to run the D-Bus mock server in a separate process. Nc&<V^8dQhRS[RS[/#)rr\r)r rZ)rrs"rrDBusTestCase.__annotate__s--g-+-rc \PPV4'g\V4\PV&\PV,#)zJReturn (and create if necessary) the singleton DBus for the given bus type)r_bussesr!rZr\s&r_busDBusTestCase._bussA##''00,7,@L  )##G,,rc&<V^8dQhRS[RS[/#r system_busr)boolr)rrs"rrr s##T#c#rc \PV'd\PM\PR7p\ VP 4#)zReturns the private services directory for the bus type in question. This allows dropping in a .service file so that the dbus server inside dbusmock can launch it. r)rrr r+rTrr)rr's& rget_services_dirDBusTestCase.get_services_dir s2 *'//Z3>>""rc\Fkp\PPV4pV'gK,VP 4\ \VP R2R4\PVKm R#)_bus_pidN)r rrr!rzsetattrr)clsr\r's& r tearDownClassDBusTestCase.tearDownClasssUG&&**73Cs  x&@$G ((1 rc<V^8dQhRR/#rrNrN)rrs"rrrsCCdCrcT\V4p\\VP R24pVe QRV R24h\PP V4eQh\P V4pVP4\\VP R2VP4R#)rNzPID z still alive?) r getattrrrrr!rrurr)rbus_typer\old_pidr's&& r __start_busDBusTestCase.__start_buss(#,7==/(BC=$wi} ==##''0888(  x8#''Brc<V^8dQhRR/#rrN)rrs"rrr's##$#rc (VPR4R#)zWSet up a private local session bus This gets stopped automatically at class teardown. r N_DBusTestCase__start_busrs&rstart_session_busDBusTestCase.start_session_bus&s  "rc<V^8dQhRR/#rrN)rrs"rrr/s"""rc (VPR4R#)zVSet up a private local system bus This gets stopped automatically at class teardown. rNrrs&rstart_system_busDBusTestCase.start_system_bus.s !rc:<V^8dQhRS[RS[P/#r)rr&Bus)rrs"rrr7s ( (T (dhh (rc rV'd\PM\PpVP4#)aGet a dbus.bus.BusConnection() object to this bus This is preferrable to dbus.SystemBus() and dbus.SessionBus() as those do not get along with multiple changing local test buses. This is a legacy method kept for backwards compatibility, use BusType.get_connection() instead. )r r+rTr0)rr\s& rget_dbusDBusTestCase.get_dbus6s$%/'..GOO%%''rc2<V^8dQhRS[RS[RS[RS[/#)rr;r<rr=)rrr)rrs"rrrDs0 @ @# @S @d @UX @rc V'd\PM\PpVPWVR, 4R#)a)Wait for an object to appear on D-Bus Raise an exception if object does not appear within one minute. You can change the timeout with the "timeout" keyword argument which specifies deciseconds. This is a legacy method kept for backwards compatibility, use BusType.wait_for_bus_object() instead. g$@N)r r+rTrL)r;r<rr=r\s&&&& rrL DBusTestCase.wait_for_bus_objectCs)%/'..GOO##D$?rc L<V^8dQhRS[RS[RS[RS[RS[P/#)rnamer< interfacerr)rrrr)rrs"rrrRs73ccteoeueurc  V'd\PM\Pp\P WW%VRR7pVP #)aRun a DBusMockObject instance in a separate process The daemon will terminate automatically when the D-Bus that it connects to goes down. If that does not happen (e. g. you test on the actual system/session bus), you need to kill it manually. This function blocks until the spawned DBusMockObject is ready and listening on the bus. Returns the Popen object of the spawned daemon. This is a legacy method kept for backwards compatibility, use SpawnedMock.spawn_for_name() instead. Nrstderr)r r+rT SpawnedMockspawn_for_nameprocess)rr<rrrr\servers&&&&& r spawn_serverDBusTestCase.spawn_serverQs: %/'..GOO++D SYbf+g~~rc <V^8dQhRS[RS[S[S[S[3,,RS[S[,RS[S[PS[PP3,/#)rtemplate parametersrr) rrrrrrrrr&proxies ProxyObject)rrs"rrrfsZ***#+DcN#;*]efj]k* z!9!99 :*rc Ve*V'd\PM\PpMRp\P WWBRR7pVP VP 3#)aRun a D-Bus mock template instance in a separate process This starts a D-Bus mock process and loads the given template with (optional) parameters into it. For details about templates see dbusmock.DBusMockObject.AddTemplate(). Usually a template should specify SYSTEM_BUS = False/True to select whether it gets loaded on the session or system bus. This can be overridden with the system_bus parameter. For templates which don't set SYSTEM_BUS, this parameter has to be set. The daemon will terminate automatically when the D-Bus that it connects to goes down. If that does not happen (e. g. you test on the actual system/session bus), you need to kill it manually. This function blocks until the spawned DBusMockObject is ready and listening on the bus. Returns a pair (daemon Popen object, main dbus object). This is a legacy method kept for backwards compatibility, use SpawnedMock.spawn_with_template() instead. N)r)r r+rTrspawn_with_templaterobj)rrrrr\rs&&&& rspawn_server_template"DBusTestCase.spawn_server_templateesK4  !(2gnnGG00w_c0d~~vzz))rc$<V^8dQhRS[RR/#rrrNr)rrs"rrrs$$D$T$rc V'd\PM\Pp\P V4pVP V4R#)aEnable the given well known service name inside dbusmock This symlinks a service file from the usual dbus service directories into the dbusmock environment. Doing that allows the service to be launched automatically if they are defined within $XDG_DATA_DIRS. The daemon configuration is reloaded if a test bus is running. This is a legacy method kept for backwards compatibility. Use PrivateDBus.enable_service() instead. N)r r+rTrrrrrr\r's&& rrDBusTestCase.enable_services3%/'..GOO( 7#rc$<V^8dQhRS[RR/#rr)rrs"rrrs%%T%d%rc V'd\PM\Pp\P V4pVP V4R#)rN)r r+rTrrrrs&& rrDBusTestCase.disable_services3%/'..GOO( G$rc<<V^8dQh/S[S[S[3,;R&#)rr)rr rZ)rrs"rrrs';& 'rrN)F)FiX)FN)NNN)rOrPrQrRrSsession_bus_pidsystem_bus_pid_DBusTestCase__datadirr rTr+r staticmethodrr classmethodrrrrrrLrrrr__annotate_func__rVrWrXs@rrrsVON!+G -- ###22CC##"" ( ( ( @ @ @&***@$$$ %%%OrrcRa]tRtRtoRtV3RlRlt]V3RlRl4t]R4tV3RlR lt R t R t ]R 4t ]R 4t ]]P ]P$]P$3V3RlRll4t]RR]P$]P$3V3RlRll4tRtVtR#)riz An instance of a D-Bus mock template instance in a separate process. See SpawnedMock.spawn_for_name() and SpawnedMock.spawn_with_template() the typical entry points. cb<V^8dQhRS[PRS[PP/#)rrr)rrr&rr)rrs"rrSpawnedMock.__annotate__s+ 0 0t||7O7Orc,WnRVnW nR#)TN)_process_process_is_running_obj)r"rrs&&&rrpSpawnedMock.__init__s #'  rc4<V^8dQhRS[P/#r)rr)rrs"rrrs))rc VP#)z.Returns the process that is this mock template)rrvs&rrSpawnedMock.processs}}rc VP#)z,The D-Bus object this server was spawned for)rrvs&rrSpawnedMock.objsyyrc<V^8dQhRR/#)rrrrN)rrs"rrrs=rcV#rtrNrvs&rrwSpawnedMock.__enter__s rc&VP4R#rt)rr{s&&&&rrSpawnedMock.__exit__s  rc VPPfVPP4VPPfVPP'd%VPPP 4VPP 'd%VPP P 4VPP 4VPP^R7R#R# \PdTPP4R#i;i \dR#i;i)zTerminate the processNr) r returncodepollrrrrrrrrrrvs&rrSpawnedMock.terminates == # # + MM   == # # +}}### $$**,}}### $$**,  ''))MM&&q&1 ,"00)MM&&()%  s0 D='D/D:6D=9D::D== E  E c .VPP#)zu The stdout of the process, if no caller-specific stdout was specified in spawn_for_name() or spawn_with_template(). )rrrvs&rrSpawnedMock.stdout }}###rc .VPP#)zu The stderr of the process, if no caller-specific stderr was specified in spawn_for_name() or spawn_with_template(). )rrrvs&rrSpawnedMock.stderrr+rc 6<V^8dQhRS[RS[RS[RS[RR/#)rrr<rr\rr)rr )rrs"rrrs=!,!,!,!, !,  !, !,rc :\PRRRVP 2WV.pVP4pVP V4'd\ RV R24h\ P!WuVR7p VPW4VPW4p V!WR7#)aRun a DBusMockObject instance in a separate process The daemon will terminate automatically when the D-Bus that it connects to goes down. If that does not happen (e. g. you test on the actual system/session bus), you need to kill it manually. This function blocks until the spawned DBusMockObject is ready and listening on the bus. By default, stdout and stderr of the spawned process is available via the SpawnedMock.stdout and SpawnedMock.stderr properties on the returned object. z-mdbusmockz--z"Trying to spawn a server for name z but it is already owned!r)rr) sys executablerr0rBrrrrLr3) rrr<rr\rrrr'daemonrs &&&&&&& rrSpawnedMock.spawn_for_names,jBw}}o2FT]^$$&   d # # #EdVKd!ef f!!$fE ##D/nnT(6++rNcb<V^8dQhRS[RS[S[S[S[3,,RS[S[,/#)rrrr\)rrrrr )rrs"rrrs;///T#s(^,/'" /rc \V4p\VR4'd VPMRpV'd\VR4'g\pM VPpVf3VP 'd\ PM\ PpVfQh\PVPVPWWE4p V'g\P!/RR7pV PP!W\"R7V #)a/Run a D-Bus mock template instance in a separate process This starts a D-Bus mock process and loads the given template with (optional) parameters into it. For details about templates see dbusmock.DBusMockObject.AddTemplate(). Usually a template should specify SYSTEM_BUS = False/True to select whether it gets loaded on the session or system bus. This can be overridden with the system_bus parameter. For templates which don't set SYSTEM_BUS, this parameter has to be set. The daemon will terminate automatically when the D-Bus that it connects to goes down. If that does not happen (e. g. you test on the actual system/session bus), you need to kill it manually. This function blocks until the spawned DBusMockObject is ready and listening on the bus. Returns a pair (daemon Popen object, main dbus object). IS_OBJECT_MANAGERF MAIN_IFACEsv) signaturer@)r hasattrr7r r8 SYSTEM_BUSr r+rTrrBUS_NAMEMAIN_OBJr& Dictionaryr AddTemplater) rrrr\rrmoduleis_object_managerinterface_namers &&&&&& rrSpawnedMock.spawn_with_templates<X&8?H[8\8\F44bg WV\%B%B1N#..N ?(.(9(9(9gnnwG"""++FOOV__ngmvtrOs9     -- MM>Ydii>YBM0M0`o%8$$o%dTTr