mirror of
https://github.com/CCOSTAN/Home-AssistantConfig.git
synced 2026-06-19 14:07:08 +00:00
236 lines
23 KiB
Plaintext
236 lines
23 KiB
Plaintext
|
î
|
|||
|
|
²¾ûW h ã
|
|||
|
|
@ sµ d Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l m Z m
|
|||
|
|
Z
|
|||
|
|
m Z d d l m Z m
|
|||
|
|
Z
|
|||
|
|
m Z e j ƒ Z Gd d „ d e ƒ Z Gd d „ d e ƒ Z y d d l Z d d l Z Wn e k
|
|||
|
|
rú d \ Z Z Yn XGd d
|
|||
|
|
„ d
|
|||
|
|
e ƒ Z Gd d „ d e ƒ Z Gd
|
|||
|
|
d „ d e ƒ Z Gd d „ d e
|
|||
|
|
ƒ Z Gd d „ d e e j ƒ Z Gd d „ d e ƒ Z Gd d „ d e ƒ Z Gd d „ d e ƒ Z d S)z2Site services for use with a Web Site Process Bus.é N)Ú
|
|||
|
|
text_or_bytesÚ
|
|||
|
|
get_daemonÚget_thread_ident)ÚntobÚTimerÚSetDaemonPropertyc @ s@ e Z d Z d Z d Z d d „ Z d d „ Z d d „ Z d S) Ú SimplePluginzCPlugin base class which auto-subscribes methods for known channels.Nc C s
|
|||
|
|
| | _ d S)N)Úbus)Úselfr © r ú</tmp/pip-build-fa7b9uy2/cherrypy/cherrypy/process/plugins.pyÚ__init__( s zSimplePlugin.__init__c C sO xH | j j D]: } t | | d ƒ } | d k r
|
|||
|
|
| j j | | ƒ q
|
|||
|
|
q
|
|||
|
|
Wd S)z>Register this object as a (multi-channel) listener on the bus.N)r Ú listenersÚgetattrÚ subscribe)r
|
|||
|
|
ÚchannelÚmethodr r r r + s zSimplePlugin.subscribec C sO xH | j j D]: } t | | d ƒ } | d k r
|
|||
|
|
| j j | | ƒ q
|
|||
|
|
q
|
|||
|
|
Wd S)z0Unregister this object as a listener on the bus.N)r r r Ú unsubscribe)r
|
|||
|
|
r r r r r r 3 s zSimplePlugin.unsubscribe)Ú__name__Ú
|
|||
|
|
__module__Ú __qualname__Ú__doc__r r
|
|||
|
|
r r r r r r r s
|
|||
|
|
r c @ sæ e Z d Z d Z i Z i Z xL e e ƒ j ƒ D]8 \ Z Z
|
|||
|
|
e j d ƒ r1 e j d ƒ r1 e e e
|
|||
|
|
<q1 q1 W[ [
|
|||
|
|
d d „ Z d d d d „ Z
|
|||
|
|
d d
|
|||
|
|
„ Z d d „ Z d
|
|||
|
|
d „ Z d d d „ Z d d d d „ Z d d „ Z d S)Ú
|
|||
|
|
SignalHandlerañ Register bus channels (and listeners) for system signals.
|
|||
|
|
|
|||
|
|
You can modify what signals your application listens for, and what it does
|
|||
|
|
when it receives signals, by modifying :attr:`SignalHandler.handlers`,
|
|||
|
|
a dict of {signal name: callback} pairs. The default set is::
|
|||
|
|
|
|||
|
|
handlers = {'SIGTERM': self.bus.exit,
|
|||
|
|
'SIGHUP': self.handle_SIGHUP,
|
|||
|
|
'SIGUSR1': self.bus.graceful,
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
The :func:`SignalHandler.handle_SIGHUP`` method calls
|
|||
|
|
:func:`bus.restart()<cherrypy.process.wspbus.Bus.restart>`
|
|||
|
|
if the process is daemonized, but
|
|||
|
|
:func:`bus.exit()<cherrypy.process.wspbus.Bus.exit>`
|
|||
|
|
if the process is attached to a TTY. This is because Unix window
|
|||
|
|
managers tend to send SIGHUP to terminal windows when the user closes them.
|
|||
|
|
|
|||
|
|
Feel free to add signals which are not available on every platform.
|
|||
|
|
The :class:`SignalHandler` will ignore errors raised from attempting
|
|||
|
|
to register handlers for unknown signals.
|
|||
|
|
ZSIGZSIG_c C s« | | _ i | j j d 6| j d 6| j j d 6| _ t j d d … d k r� | j d =| j j | j d <| j j d ƒ | j | j d <n i | _ t
|
|||
|
|
j ƒ | _ d S) NÚSIGTERMÚSIGHUPÚSIGUSR1é ÚjavaÚSIGUSR2zASIGUSR1 cannot be set on the JVM platform. Using SIGUSR2 instead.ÚSIGINT)
|
|||
|
|
r ÚexitÚ
|
|||
|
|
handle_SIGHUPÚgracefulÚhandlersÚsysÚplatformÚlogÚ_jython_SIGINT_handlerÚ_previous_handlersÚosÚgetpidÚ
|
|||
|
|
_original_pid)r
|
|||
|
|
r r r r r
|
|||
|
|
` s
|
|||
|
|
|
|||
|
|
zSignalHandler.__init__Nc C s! | j j d ƒ | j j ƒ d S)Nz%Keyboard Interrupt: shutting down bus)r r& r )r
|
|||
|
|
ÚsignumÚframer r r r' t s z$SignalHandler._jython_SIGINT_handlerc C s: | j t j ƒ k r2 t j t j j ƒ ƒ r2 d Sd Sd S)aí Return boolean indicating if the current process is
|
|||
|
|
running as a daemon.
|
|||
|
|
|
|||
|
|
The criteria to determine the `daemon` condition is to verify
|
|||
|
|
if the current pid is not the same as the one that got used on
|
|||
|
|
the initial construction of the plugin *and* the stdin is not
|
|||
|
|
connected to a terminal.
|
|||
|
|
|
|||
|
|
The sole validation of the tty is not enough when the plugin
|
|||
|
|
is executing inside other process like in a CI tool
|
|||
|
|
(Buildbot, Jenkins).
|
|||
|
|
TFN)r+ r) r* Úisattyr$ ÚstdinÚfileno)r
|
|||
|
|
r r r Ú_is_daemonizedy s
|
|||
|
|
z SignalHandler._is_daemonizedc C sM xF | j j ƒ D]5 \ } } y | j | | ƒ Wq t k
|
|||
|
|
rD Yq Xq Wd S)z#Subscribe self.handlers to signals.N)r# ÚitemsÚ set_handlerÚ
|
|||
|
|
ValueError)r
|
|||
|
|
ÚsigÚfuncr r r r � s
|
|||
|
|
|
|||
|
|
zSignalHandler.subscribec
|
|||
|
|
C s÷ xð | j j ƒ D]ß \ } } | j | } | d k rU | j j d | ƒ t j } n | j j d | | f ƒ yE t j | | ƒ } | d k r³ | j j d | | f d d ƒn Wq t k
|
|||
|
|
rî | j j d | | f d d d d
|
|||
|
|
ƒYq Xq Wd S) z'Unsubscribe self.handlers from signals.Nz Restoring %s handler to SIG_DFL.zRestoring %s handler %r.z?Restored old %s handler %r, but our handler was not registered.Úlevelé z Unable to restore %s handler %r.é( Ú tracebackT) r( r2 Úsignalsr r& Ú_signalÚSIG_DFLÚsignalr4 )r
|
|||
|
|
r, ÚhandlerÚsignameZ our_handlerr r r r • s
|
|||
|
|
|
|||
|
|
zSignalHandler.unsubscribec C sá t | t ƒ rI t t | d ƒ } | d k r@ t d | ƒ ‚ n | } n< y | j | } Wn" t k
|
|||
|
|
r~ t d | ƒ ‚ Yn X| } t j | | j ƒ } | | j | <| d k rÝ | j
|
|||
|
|
j d | ƒ | j
|
|||
|
|
j | | ƒ n d S)a= Subscribe a handler for the given signal (number or name).
|
|||
|
|
|
|||
|
|
If the optional 'listener' argument is provided, it will be
|
|||
|
|
subscribed as a listener for the given signal's channel.
|
|||
|
|
|
|||
|
|
If the given signal name or number is not available on the current
|
|||
|
|
platform, ValueError is raised.
|
|||
|
|
NzNo such signal: %rzListening for %s.)
|
|||
|
|
Ú
|
|||
|
|
isinstancer r r< r4 r; ÚKeyErrorr> Ú_handle_signalr( r r& r )r
|
|||
|
|
r> Zlistenerr, r@ Úprevr r r r3 ª s
|
|||
|
|
|
|||
|
|
zSignalHandler.set_handlerc C s5 | j | } | j j d | ƒ | j j | ƒ d S)z?Python signal handler (self.set_handler subscribes it for you).zCaught signal %s.N)r; r r& Úpublish)r
|
|||
|
|
r, r- r@ r r r rC Æ s
|
|||
|
|
z SignalHandler._handle_signalc C sM | j ƒ r, | j j d ƒ | j j ƒ n | j j d ƒ | j j ƒ d S)z!Restart if daemonized, else exit.z+SIGHUP caught while daemonized. Restarting.z*SIGHUP caught but not daemonized. Exiting.N)r1 r r& Úrestartr )r
|
|||
|
|
r r r r! Ì s
|
|||
|
|
zSignalHandler.handle_SIGHUP)r r r r r# r; Úvarsr< r2 ÚkÚvÚ
|
|||
|
|
startswithr
|
|||
|
|
r' r1 r r r3 rC r! r r r r r < s r c @ sÇ e Z d Z d Z d d d d d „ Z d d „ Z d d „ Z e e e d d
|
|||
|
|
ƒZ d d „ Z d
|
|||
|
|
d „ Z
|
|||
|
|
e e e
|
|||
|
|
d d ƒZ d d „ Z d d „ Z
|
|||
|
|
e e e
|
|||
|
|
d d ƒZ d d „ Z d e _ d S)ÚDropPrivilegesz§Drop privileges. uid/gid arguments not available on Windows.
|
|||
|
|
|
|||
|
|
Special thanks to `Gavin Baker <http://antonym.org/2005/12/dropping-privileges-in-python.html>`_
|
|||
|
|
Nc C s8 t j | | ƒ d | _ | | _ | | _ | | _ d S)NF)r r
|
|||
|
|
Ú finalizedÚuidÚgidÚumask)r
|
|||
|
|
r rO rM rN r r r r
|
|||
|
|
å s
|
|||
|
|
zDropPrivileges.__init__c C s | j S)N)Ú_uid)r
|
|||
|
|
r r r Ú_get_uidì s zDropPrivileges._get_uidc C sl | d k r_ t d k r7 | j j d d d ƒd } q_ t | t ƒ r_ t j | ƒ d } q_ n | | _ d S)Nz'pwd module not available; ignoring uid.r7 r8 é )Úpwdr r& rA r ÚgetpwnamrP )r
|
|||
|
|
Úvalr r r Ú_set_uidï s zDropPrivileges._set_uidÚdocz/The uid under which to run. Availability: Unix.c C s | j S)N)Ú_gid)r
|
|||
|
|
r r r Ú_get_gidû s zDropPrivileges._get_gidc C sl | d k r_ t d k r7 | j j d d d ƒd } q_ t | t ƒ r_ t j | ƒ d } q_ n | | _ d S)Nz'grp module not available; ignoring gid.r7 r8 rR )Úgrpr r& rA r ÚgetgrnamrX )r
|
|||
|
|
rU r r r Ú_set_gidþ s zDropPrivileges._set_gidz/The gid under which to run. Availability: Unix.c C s | j S)N)Ú_umask)r
|
|||
|
|
r r r Ú
|
|||
|
|
_get_umask
|
|||
|
|
s zDropPrivileges._get_umaskc C sX | d k rK y t j WqK t k
|
|||
|
|
rG | j j d d d ƒd } YqK Xn | | _ d S)Nz-umask function not available; ignoring umask.r7 r8 )r) rO ÚAttributeErrorr r& r] )r
|
|||
|
|
rU r r r Ú
|
|||
|
|
_set_umask
|
|||
|
|
s
|
|||
|
|
zDropPrivileges._set_umaskz½The default permission mode for newly created files and
|
|||
|
|
directories.
|
|||
|
|
|
|||
|
|
Usually expressed in octal format, for example, ``0644``.
|
|||
|
|
Availability: Unix, Windows.
|
|||
|
|
c C s® d d „ } | j rP | j d k o0 | j d k s| j j d | ƒ ƒ qnÅ | j d k r– | j d k r– t sz t r| j j d d d ƒqn | j j d | ƒ ƒ | j d k rÜ t j | j ƒ t j g ƒ n | j d k rþ t j
|
|||
|
|
| j ƒ n | j j d | ƒ ƒ | j rJ| j d k r¡| j j d | j ƒ q¡nW | j d k rr| j j d
|
|||
|
|
d d ƒn/ t j | j ƒ } | j j d | | j f ƒ d | _ d S)
|
|||
|
|
Nc S sZ d \ } } t r. t j t j ƒ ƒ d } n t rP t j t j ƒ ƒ d } n | | f S)z+Return the current (uid, gid) if available.Nr )NN)rS Úgetpwuidr) ÚgetuidrZ ÚgetgrgidÚgetgid)ÚnameÚgroupr r r Ú current_ids" s z)DropPrivileges.start.<locals>.current_idsz"Already running as uid: %r gid: %rzuid/gid not setr7 r8 zStarted as uid: %r gid: %rzRunning as uid: %r gid: %rzumask already set to: %03oz
|
|||
|
|
umask not setzumask old: %03o, new: %03oT) rL rM rN r r& rS rZ r) ÚsetgidÚ setgroupsÚsetuidrO )r
|
|||
|
|
rg Z old_umaskr r r Ústart s0 zDropPrivileges.startéM )r r r r r
|
|||
|
|
rQ rV ÚpropertyrM rY r\ rN r^ r` rO rk Úpriorityr r r r rK Þ s$ ,rK c @ s@ e Z d Z d Z d d d d d „ Z d d „ Z d e _ d S) Ú
|
|||
|
|
Daemonizera¿ Daemonize the running script.
|
|||
|
|
|
|||
|
|
Use this with a Web Site Process Bus via::
|
|||
|
|
|
|||
|
|
Daemonizer(bus).subscribe()
|
|||
|
|
|
|||
|
|
When this component finishes, the process is completely decoupled from
|
|||
|
|
the parent environment. Please note that when this component is used,
|
|||
|
|
the return code from the parent process will still be 0 if a startup
|
|||
|
|
error occurs in the forked children. Errors in the initial daemonizing
|
|||
|
|
process still return proper exit codes. Therefore, if you use this
|
|||
|
|
plugin to daemonize, don't use the return code as an accurate indicator
|
|||
|
|
of whether the process fully started. In fact, that return code only
|
|||
|
|
indicates if the process succesfully finished the first fork.
|
|||
|
|
z /dev/nullc C s8 t j | | ƒ | | _ | | _ | | _ d | _ d S)NF)r r
|
|||
|
|
r/ ÚstdoutÚstderrrL )r
|
|||
|
|
r r/ rp rq r r r r
|
|||
|
|
a s
|
|||
|
|
zDaemonizer.__init__c C sY | j r | j j d ƒ n t j ƒ d k rQ | j j d t j ƒ d d ƒn t j j ƒ t j j ƒ y< t
|
|||
|
|
j ƒ } | d k r‰ n | j j d ƒ t
|
|||
|
|
j d ƒ WnI t
|
|||
|
|
k
|
|||
|
|
rò t j ƒ d } t j d t j d | j | j f ƒ Yn Xt
|
|||
|
|
j ƒ y< t
|
|||
|
|
j ƒ } | d k r8| j j d ƒ t
|
|||
|
|
j d ƒ n WnI t
|
|||
|
|
k
|
|||
|
|
r„t j ƒ d } t j d
|
|||
|
|
t j d | j | j f ƒ Yn Xt
|
|||
|
|
j d ƒ t
|
|||
|
|
j d ƒ t | j d ƒ } t | j d
|
|||
|
|
ƒ } t | j d
|
|||
|
|
ƒ } t
|
|||
|
|
j | j ƒ t j j ƒ ƒ t
|
|||
|
|
j | j ƒ t j j ƒ ƒ t
|
|||
|
|
j | j ƒ t j j ƒ ƒ | j j d t
|
|||
|
|
j ƒ ƒ d | _ d S)NzAlready deamonized.é zHThere are %r active threads. Daemonizing now may cause strange failures.r7 r8 r z
|
|||
|
|
Forking once.z %s: fork #1 failed: (%d) %s
|
|||
|
|
zForking twice.z %s: fork #2 failed: (%d) %s
|
|||
|
|
ú/Úrza+zDaemonized to PID: %sT)rL r r& Ú threadingÚ activeCountÚ enumerater$ rp Úflushrq r) ÚforkÚ_exitÚOSErrorÚexc_infor ÚargvÚerrnoÚstrerrorÚsetsidÚchdirrO Úopenr/ Údup2r0 r* )r
|
|||
|
|
ÚpidÚexcÚsiÚsoÚser r r rk i sJ
|
|||
|
|
|
|||
|
|
|
|||
|
|
#
|
|||
|
|
|
|||
|
|
#
|
|||
|
|
|
|||
|
|
zDaemonizer.startéA N)r r r r r
|
|||
|
|
rk rn r r r r ro O s
|
|||
|
|
Cro c @ sC e Z d Z d Z d d „ Z d d „ Z d e _ d d „ Z d S)
|
|||
|
|
ÚPIDFilez!Maintain a PID file via a WSPBus.c C s& t j | | ƒ | | _ d | _ d S)NF)r r
|
|||
|
|
ÚpidfilerL )r
|
|||
|
|
r r‹ r r r r
|
|||
|
|
³ s zPIDFile.__init__c C s… t j ƒ } | j r5 | j j d | | j f ƒ nL t | j d ƒ j t d | d ƒ ƒ | j j d | | j f ƒ d | _ d S)Nz PID %r already written to %r.Úwbz%s
|
|||
|
|
Úutf8zPID %r written to %r.T) r) r* rL r r& r‹ r‚ Úwriter )r
|
|||
|
|
r„ r r r rk ¸ s & z
|
|||
|
|
PIDFile.startéF c C sT y+ t j | j ƒ | j j d | j ƒ Wn" t t f k
|
|||
|
|
rH ‚ Yn Yn Xd S)NzPID file removed: %r.)r) Úremover‹ r r& ÚKeyboardInterruptÚ
|
|||
|
|
SystemExit)r
|
|||
|
|
r r r r  s z PIDFile.exitN)r r r r r
|
|||
|
|
rk rn r r r r r rŠ ¯ s
|
|||
|
|
rŠ c s4 e Z d Z d Z ‡ f d d † Z d d „ Z ‡ S)ÚPerpetualTimera A responsive subclass of threading.Timer whose run() method repeats.
|
|||
|
|
|
|||
|
|
Use this timer only when you really need a very interruptible timer;
|
|||
|
|
this checks its 'finished' condition up to 20 times a second, which can
|
|||
|
|
results in pretty high CPU usage
|
|||
|
|
c s2 | j d d ƒ | _ t t | ƒ j | | Ž d S)z:Override parent constructor to allow 'bus' to be provided.r N)Úpopr Úsuperr“ r
|
|||
|
|
)r
|
|||
|
|
ÚargsÚkwargs)Ú __class__r r r
|
|||
|
|
Õ s zPerpetualTimer.__init__c C s‘ xŠ | j j | j ƒ | j j ƒ r) d Sy | j | j | j Ž Wq t k
|
|||
|
|
r‰ | j r‚ | j j d | j d d d d ƒn ‚ Yq Xq d S)Nz,Error in perpetual timer thread function %r.r7 r9 r: T)
|
|||
|
|
ÚfinishedÚwaitÚintervalÚisSetÚfunctionr– r— Ú Exceptionr r& )r
|
|||
|
|
r r r ÚrunÚ s
|
|||
|
|
zPerpetualTimer.run)r r r r r
|
|||
|
|
rŸ r r )r˜ r r“ Ì s r“ c @ sC e Z d Z d Z g i d d d „ Z d d „ Z d d „ Z d S) ÚBackgroundTaska¥ A subclass of threading.Thread whose run() method repeats.
|
|||
|
|
|
|||
|
|
Use this class for most repeating tasks. It uses time.sleep() to wait
|
|||
|
|
for each interval, which isn't very responsive; that is, even if you call
|
|||
|
|
self.cancel(), you'll have to wait until the sleep() call finishes before
|
|||
|
|
the thread stops. To compensate, it defaults to being daemonic, which means
|
|||
|
|
it won't delay stopping the whole process.
|
|||
|
|
Nc C sS t j j | ƒ | | _ | | _ | | _ | | _ d | _ | | _ d | _ d S)NFT)
|
|||
|
|
ru ÚThreadr
|
|||
|
|
r› r� r– r— Úrunningr Údaemon)r
|
|||
|
|
r› r� r– r— r r r r r
|
|||
|
|
õ s zBackgroundTask.__init__c C s
|
|||
|
|
d | _ d S)NF)r¢ )r
|
|||
|
|
r r r Úcancel s zBackgroundTask.cancelc C s› d | _ x‹ | j r– t j | j ƒ | j s2 d Sy | j | j | j Ž Wq t k
|
|||
|
|
r’ | j r‹ | j j d | j d d d d ƒn ‚ Yq Xq Wd S)NTz,Error in background task thread function %r.r7 r9 r: )
|
|||
|
|
r¢ ÚtimeÚsleepr› r� r– r— rž r r& )r
|
|||
|
|
r r r rŸ s
|
|||
|
|
zBackgroundTask.run)r r r r r
|