
    \dH              
          d Z ddlZddlZddlZddlmZ ddlmZmZ ddl	m
Z
mZ ddlmZ ddlmZmZmZ ddlmZ dd	lmZ d
Zdddddddddd	Zi Ze                                D ]
\  ZZeee<   [[i dddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6i d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXi dYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtdudvdwdxdydzd{d:d|Zd}d~ddZd Zd Z e             Z! G d d          Z"d Z# G d d          Z$ddZ%d Z&ddZ' G d de(          Z) G d de)          Z* G d d          Z+ G d de+          Z, G d de+          Z- G d dej.                  Z/ G d dej0                  Z1 G d de
          Z2 G d d          Z3 G d de
          Z4 G d de
          Z5 G d de1          Z6 G d de
          Z7 G d de6          Z8 ee4e5           G d d                      Z9dS )zP
Session Initialization Protocol.

Documented in RFC 2543.
[Superseded by 3261]
    N)OrderedDict)DictList)	Interfaceimplementer)cred)deferprotocolreactor)basic)logi  imelcfstv)	call-idcontactzcontent-encodingcontent-lengthzcontent-typefromsubjecttoviad   Trying   Ringing   zCall Is Being Forwarded   Queued   zSession Progress   OKi,  zMultiple Choicesi-  zMoved Permanentlyi.  zMoved Temporarilyi/  z	See Otheri1  z	Use Proxyi|  zAlternative Service  zBad Request  Unauthorizedi  zPayment Requiredi  	Forbidden  z	Not Foundi  zMethod Not Allowedi  zNot Acceptablei  zProxy Authentication Requiredi  zRequest Timeouti  Conflicti  Gonei  zLength Requiredi  zRequest Entity Too Largei  zRequest-URI Too Largei  zUnsupported Media Typei  zUnsupported URI Schemei  zBad Extensioni  zExtension Requiredi  zInterval Too Briefi  zTemporarily Unavailablei  zCall/Transaction Does Not Existi  zLoop Detectedi  zToo Many Hopsi  zAddress Incompletei  	Ambiguousi  z	Busy Herei  zRequest Terminatedi  zNot Acceptable Herei  zRequest Pendingi  Undecipherable  zInternal Server Error  zNot Implementedi  zBad Gatewayi  zService Unavailablei  zServer Time-outi  zSIP Version not supportedi  zMessage Too LargeiX  zBusy Everywherei[  DeclinezDoes not exist anywhere)i\  i^  CSeqzCall-IDzWWW-Authenticate)cseqr   www-authenticatec                 f    d                     d |                     d          D                       S )zK
    Capitalize a string, making sure to treat '-' as a word separator
    -c                 6    g | ]}|                                 S  )
capitalize).0xs     5lib/python3.11/site-packages/twisted/protocols/sip.py
<listcomp>z"dashCapitalize.<locals>.<listcomp>p   s     :::Q\\^^:::    )joinsplitr   s    r>   dashCapitalizerD   l   s/     88::QWWS\\:::;;;r@   c                 R    | d         | d         cxk    rdk    rn n
| dd         S | S )Nr   "   r:   rC   s    r>   unqrI   s   s>    tqu2wHr@   c                   f    e Zd ZdZeddddeddfdZed             Zej	        d             Zd Z
dS )	Viaa  
    A L{Via} is a SIP Via header, representing a segment of the path taken by
    the request.

    See RFC 3261, sections 8.1.1.7, 18.2.2, and 20.42.

    @ivar transport: Network protocol used for this leg. (Probably either "TCP"
    or "UDP".)
    @type transport: C{str}
    @ivar branch: Unique identifier for this request.
    @type branch: C{str}
    @ivar host: Hostname or IP for this leg.
    @type host: C{str}
    @ivar port: Port used for this leg.
    @type port C{int}, or None.
    @ivar rportRequested: Whether to request RFC 3581 client processing or not.
    @type rportRequested: C{bool}
    @ivar rportValue: Servers wishing to honor requests for RFC 3581 processing
    should set this parameter to the source port the request was received
    from.
    @type rportValue: C{int}, or None.

    @ivar ttl: Time-to-live for requests on multicast paths.
    @type ttl: C{int}, or None.
    @ivar maddr: The destination multicast address, if any.
    @type maddr: C{str}, or None.
    @ivar hidden: Obsolete in SIP 2.0.
    @type hidden: C{bool}
    @ivar otherParams: Any other parameters in the header.
    @type otherParams: C{dict}
    UDPNFc
                 P   || _         || _        || _        || _        || _        || _        |du r+t          j        dt          d           d| _	        d| _
        n7|d| _	        d| _
        n&|t          u rd| _	        d| _
        n|| _	        d| _
        || _        |	| _        |
| _        dS )a(  
        Set parameters of this Via header. All arguments correspond to
        attributes of the same name.

        To maintain compatibility with old SIP
        code, the 'rport' argument is used to determine the values of
        C{rportRequested} and C{rportValue}. If None, C{rportRequested} is set
        to True. (The deprecated method for doing this is to pass True.) If an
        integer, C{rportValue} is set to the given value.

        Any arguments not explicitly named here are collected into the
        C{otherParams} dict.
        Tz+rport=True is deprecated since Twisted 9.0.   )
stacklevelNF)	transporthostportttlhiddenreceivedwarningswarnDeprecationWarning
rportValuerportRequested_absentbranchmaddrotherParams)selfrQ   rR   rP   rS   rT   rU   rportr\   r]   kws              r>   __init__zVia.__init__   s    4 #		 D==M="   
 #DO"&D]"DO"&Dg"DO"'D#DO"'D
r@   c                 <    | j         dk    rdS | j        | j        S dS )zG
        Returns the rport value expected by the old SIP code.
        TN)rZ   rY   r_   s    r>   r`   z	Via.rport   s,    
 $&&4_(?"4r@   c                 "    || _         d| _        dS )z
        L{Base._fixupNAT} sets C{rport} directly, so this method sets
        C{rportValue} based on that.

        @param newRPort: The new rport value.
        @type newRPort: C{int}
        FN)rY   rZ   )r_   newRPorts     r>   r`   z	Via.rport   s     ##r@   c                 `   d| j          d| j         d| j         }| j        r|dz  }dD ]}t	          | |          }||d| d| z  } | j        r|d	z  }n| j        |d
| j         z  }t          | j	        
                                          }|D ]\  }}|	|d|z   z  }|d| d| z  }|S )zI
        Serialize this header for use in a request or response.
        zSIP/2.0/ :z;hidden)rS   r\   r]   rU   N;=z;rportz;rport=)rP   rQ   rR   rT   getattrrZ   rY   r`   sortedr^   items)r_   r   nvalueetckr   s          r>   toStringzVia.toString   s	    @t~??	??DI??; 	NA5 	% 	%AD!$$E ___U__$ 	(MAA_('4:'''AT%++--.. 	! 	!DAqyS1W[[[Q[[ r@   )__name__
__module____qualname____doc__PORTr[   rb   propertyr`   setterrs   r:   r@   r>   rK   rK   |   s         F 4 4 4 4l 	 	 X	 \	$ 	$ \	$    r@   rK   c                 
   |                      d          }|d         |dd         }}|                     dd          \  }}|                                }i }|                     d          \  }}}	|dk    s|dk    rt          d	|           |	|d
<   d|v r0|                     d          \  }
}t          |          |d<   |
|d<   n||d<   |D ]}|                                                     dd          }t	          |          dk    r|d         d}}n|\  }}|dk    rd|d<   Y|                     dd          }t	          |          dk    r|d         d} }n|\  }} |dv rt          |           } | ||<   t          di |S )za
    Parse a Via header.

    @return: The parsed version of this header.
    @rtype: L{Via}
    rj   r   rH   Nrh   /SIPz2.0zwrong protocol or version: rP   ri   rR   rQ    rT   Trk   )r`   rS   r:   )rB   strip
ValueErrorintlenrK   )rp   partssentparamsprotocolinfobyresultpnamepversionrP   rQ   rR   pcommentnames                  r>   parseViaHeaderr     s    KKE8U122Y&Dzz#q))L"	BF!-!3!3C!8!8E8Y~~U**@u@@AAA#F;
byyXXc]]
dTvvv  GGIIOOC##q66Q;;1rwAAJAw==#F8Qu::??(D%DDKD%'''E

t====r@   c                   T    e Zd ZdZ	 	 	 	 	 	 	 	 	 	 	 ddZdefdZdefdZdefdZdS )	URLz
    A SIP URL.
    Nc                     || _         || _        || _        || _        || _        || _        || _        |
| _        || _        |	| _	        |d k    rg | _
        n|| _
        |d k    r	i | _        d S || _        d S N)usernamerQ   passwordrR   rP   usertypemethodtagrS   r]   otherheaders)r_   rQ   r   r   rR   rP   r   r   rS   r]   r   r   r   s                r>   rb   zURL.__init__4  s     !	 	" 
D==DJJDJd??DLLL"DLLLr@   returnc                    g }|j         } |d           | j        d k    r9 || j                   | j        d k    r |d| j        z              |d            || j                   | j        d k    r |d| j        z             | j        d k    r |d| j        z             dD ])}t          | |          }|d k    r |d| d|            *| j        D ]} |d	|z             | j        rJ |d
            |d	                    d | j        
                                D                                  d	                    |          S )Nsip:z:%s@z:%dz;user=%srP   rS   r]   r   r   rj   rk   z;%s?&c                 p    g | ]3\  }}t                               |          pt          |           d | 4S )rk   )specialCasesgetrD   )r<   hr   s      r>   r?   z URL.toString.<locals>.<listcomp>n  sU       "Q ),,Q//D>!3D3DJJqJJ  r@   r~   )appendr   r   rQ   rR   r   rl   r   r   rA   rn   )r_   r   wro   r   s        r>   rs   zURL.toStringV  s   H	&			=D  Adm}$$%$-'(((AcFFF	$)9Aedi   =D  Aj4=()))? 	 	Aa  ADyy+a++!++ 	 	AAeaiLLLL< 		AcFFFA &*l&8&8&:&:      wwqzzr@   c                 *    |                                  S r   )rs   rd   s    r>   __str__zURL.__str__v  s    }}r@   c                 f    d                     | j        | j        | j        | j        | j                  S )Nz<URL {}:{}@{}:{!r}/{}>)formatr   r   rQ   rR   rP   rd   s    r>   __repr__zURL.__repr__y  s3    '..MMIIN
 
 	
r@   )NNNNNNNNNNN)	rt   ru   rv   rw   rb   strrs   r   r   r:   r@   r>   r   r   /  s           #  #  #  #D#    @    
# 
 
 
 
 
 
r@   r   c                    i }|                      d          st          d| dd         z             | dd                             d          }|d         |dd         }}|                    dd          }t          |          d	k    rQ|\  }}	|                    d
d          }
t          |
          dk    r|
d         |d<   n|
d         |d<   |
d         |d<   n|d         }	|	                    d
d          }t          |          dk    r|d         |d<   n#|d         |d<   t	          |d                   |d<   |dk    r||d<   |dk    r||d<   |D ]}||d         k    rYd|v rUi x|d<   }|                    dd          \  }}|                    d          D ]}|                    d          \  }}|||<    |                    dd          }t          |          dk    r*|                    dg                               |           |\  }}|dk    r||d<   |dv r|dk    rt	          |          }|||<   |                    dg                               |           t          di |S )zV
    Return string into URL object.

    URIs are of form 'sip:user@example.com'.
    r   zunsupported scheme: N   rj   r   rH   r   rN   ri   r   r   rQ   rR   rF   r   r   r   rk   r   userr   r   rS   r:   )
startswithr   rB   r   r   
setdefaultr   r   )urlrQ   rR   dr   
userdomainr   udpartsuserpasshostportuppartshppartsr   r   r   headerrr   r   nvr   rp   s                        r>   parseURLr     s    	A>>&!! ;/#bqb'9:::GMM#Eq59JsA&&G
7||q$(..a((w<<1#AJAjMM#AJAjM#AJAjMM1:nnS!$$G
7||qAJ&		AJ&	
OO&	t||&	t||&	 0 0r
??saxx!!AiL1aJAw!--,,  ||C((1!WWS!__r77a<<LL"%%,,Q///e6>>!AjMMCCCu}}E

AdGGLL"%%,,Q////8888Or@   c                 >    d| _         d| _        d| _        i | _        dS )z*
    Clean a URL from a Request line.
    N)rP   r]   rS   r   )r   s    r>   cleanRequestURLr     s$     CMCICGCKKKr@   c                    |                                  } |                     d          rdt          | ||          i fS i }|                     dd          \  }}|                                 }|                    d          r
|dd         }|                    d          r
|dd         }|                    d	d          \  }}t          |||          }|                                 }|r8|                    d
          D ]"}|s|                    d          \  }	}
|
||	<   #|rd|_        i |_        d|_        d|_        |||fS )z
    Return (name, uri, params) for From/To/Contact header.

    @param clean: remove unnecessary info, usually for From and To headers.
    r   r~   rQ   rR   <rH   rG   NrF   >rj   rk   )	r   r   r   rB   endswithrS   r   rP   r]   )addressrQ   rR   cleanr   r   r   paramstringr   rr   r   s              r>   parseAddressr     sj    mmooG&!! ?8G$T:::B>>Fc1%%ID#::<<Ds ABBx}}S CRCyyya((C
3T
-
-
-C##%%K ""3'' 	 	A 773<<DAqF1II 	fr@   c                       e Zd ZddZdS )SIPErrorNc                     |t           |         }t                              | d||fz             || _        || _        d S )NzSIP error (%d): %s)statusCodes	Exceptionrb   codephrase)r_   r   r   s      r>   rb   zSIPError.__init__  sC    > &F4!5v!FGGG	r@   r   rt   ru   rv   rb   r:   r@   r>   r   r     s(             r@   r   c                       e Zd ZdZdS )RegistrationErrorz(
    Registration was not possible.
    Nrt   ru   rv   rw   r:   r@   r>   r   r                r@   r   c                   :    e Zd ZdZdZd Zd Zd Zd Zd Z	d Z
dS )	Messagez
    A SIP message.
    Nc                 H    t                      | _        d| _        d| _        d S )Nr~   r   )r   r   bodyfinishedrd   s    r>   rb   zMessage.__init__  s    "}}	r@   c                     |                                 }t                              ||          }|dk    rt          |          | _        | j                            |g                               |           d S )Nr   )lowerlongHeadersr   r   lengthr   r   r   )r_   r   rp   s      r>   	addHeaderzMessage.addHeader  sg    zz||tT**###e**DKb))0077777r@   c                 &    | xj         |z  c_         d S r   )r   r_   datas     r>   bodyDataReceivedzMessage.bodyDataReceived	  s    		T				r@   c                     | j         d k    r,| j         t          | j                  k    rt          d          d| _        d S )Nzwrong body lengthrH   )r   r   r   r   r   rd   s    r>   creationFinishedzMessage.creationFinished  s=    K4dkS^^&C&C0111r@   c                     d|                                  z  }| j                                        D ]<\  }}|D ]4}|t                              |          pt          |           d| dz  }5=|dz  }|| j        z  }|S )Nz%s
z: z
)_getHeaderLiner   rn   r   r   rD   r   )r_   r   ro   vsr   s        r>   rs   zMessage.toString  s    t**,,,\'')) 	L 	LEAr L L((++@~a/@/@KKAKKKKL	V	TYr@   c                     t           r   NotImplementedErrorrd   s    r>   r   zMessage._getHeaderLine  s    !!r@   )rt   ru   rv   rw   r   rb   r   r   r   rs   r   r:   r@   r>   r   r     s          F  
8 8 8    
  " " " " "r@   r   c                   ,    e Zd ZdZddZdefdZd ZdS )	Requestz
    A Request for a URI
    SIP/2.0c                     t                               |            || _        t          |t                    r	|| _        d S t          |          | _        t          | j                   d S r   )r   rb   r   
isinstancer   urir   r   )r_   r   r   versions       r>   rb   zRequest.__init__#  s]    c3 	&DHHH}}DHDH%%%%%r@   r   c                 d    dt          |           | j        | j                                        fz  S )Nz<SIP Request %d:%s %s>)idr   r   rs   rd   s    r>   r   zRequest.__repr__,  s*    '2d88T[$(BSBSBUBU*VVVr@   c                 J    | j          d| j                                         dS )Nrh   z SIP/2.0)r   r   rs   rd   s    r>   r   zRequest._getHeaderLine/  s)    +== 1 1 3 3====r@   N)r   rt   ru   rv   rw   rb   r   r   r   r:   r@   r>   r   r     sa         & & & &W# W W W W> > > > >r@   r   c                   ,    e Zd ZdZddZdefdZd ZdS )	Responsez%
    A Response to a URI Request
    Nr   c                 |    t                               |            || _        |d k    rt          |         }|| _        d S r   )r   rb   r   r   r   )r_   r   r   r   s       r>   rb   zResponse.__init__8  s;    	T>> &Fr@   r   c                 4    dt          |           | j        fz  S )Nz<SIP Response %d:%s>)r   r   rd   s    r>   r   zResponse.__repr__?  s    %D49(===r@   c                 &    d| j          d| j         S )NzSIP/2.0 rh   )r   r   rd   s    r>   r   zResponse._getHeaderLineB  s    3$)33dk333r@   )Nr   r   r:   r@   r>   r   r   3  s\            ># > > > >4 4 4 4 4r@   r   c                   f    e Zd ZdZdZdZdZdZdZd Z	ddZ
d	 Zd
 Zd Zd Zd Zd ZddZd ZdS )MessagesParserz
    A SIP messages parser.

    Expects dataReceived, dataDone repeatedly,
    in that order. Shouldn't be connected to actual transport.
    r   rH   	firstliner   c                 <    || _         |                                  d S r   )messageReceivedreset)r_   messageReceivedCallbacks     r>   rb   zMessagesParser.__init__U  s    6

r@   r~   c                 v    d| _         d | _        d| _        d | _        d | _        |                     |           d S )Nr   r   )stater   bodyReceivedmessager   setLineModer_   remainingDatas     r>   r   zMessagesParser.resetY  s@     
'''''r@   c                 <    d| _         |                                  d S )Ninvalid)r  
setRawModerd   s    r>   invalidMessagezMessagesParser.invalidMessagea  s    
r@   c                 2   |                                   | j        dk    rdS | j        dk    r|                                  dS | j        dk    r|                                  dS | j        | j        k     r|                                  dS t          d          )zI
        Clear out any buffered data that may be hanging around.
        r   Nr   zthis should never happen)clearLineBufferr  r   r   messageDoner  RuntimeErrorrd   s    r>   dataDonezMessagesParser.dataDonee  s     	:$$F:JJLLLF;$[4,,,JJLLLLL 9:::r@   c                    	 t          |t                    r|                    d          }t          j                            | |           d S # t          $ r+ t          j                     | 	                                 Y d S w xY w)Nutf-8)
r   r   encoder   LineReceiverdataReceivedr   r   errr  r   s     r>   r  zMessagesParser.dataReceivedy  s    	"$$$ ,{{7++++D$77777 	" 	" 	"GIII!!!!!!	"s   A
A 1BBc                     t           )z2
        Expected to create self.message.
        r   r_   lines     r>   handleFirstLinezMessagesParser.handleFirstLine  s
     "!r@   c                 .    |                                   d S r   )r  r  s     r>   lineLengthExceededz!MessagesParser.lineLengthExceeded  s    r@   c                 <   t          |t                    r|                    d          }| j        dk    r>|                    d          s|                    d          r4|dd          }|                    d          |                    d          4|sd S 	 |                    dd          \  }}}n%# t          $ r |                                  Y d S w xY w|dk    rS| j        rL	 t          |          }n%# t          $ r |                                  Y d S w xY wt          ||          | _        n9|dk    r| j        rt          ||          | _        n|                                  d S d	| _        d S | j        d	k    sJ |r9|                    d          s|                    d
          r*| j        \  }}|||                                z   f| _        d S | j        r | j        j        | j          d | _        	 |                    dd          \  }}n%# t          $ r |                                  Y d S w xY w||                                f| _        |                                dk    rN	 t          |                                          | _        d S # t          $ r |                                  Y d S w xY wd S d| _        | j        r | j        j        | j          d | _        | j        dk    r|                                  d S |                                  d S )Nr  r   
rH   rh   rN   r   r   	ri   r   r   r   )r   bytesdecoder  r   rB   r   r  acceptResponsesr   r   r  acceptRequestsr   r   lstripr   r   r   r  r
  )r_   r  abr   r   r   rp   s           r>   lineReceivedzMessagesParser.lineReceived  sr   dE"" 	(;;w''D:$$//$''  4??4+@+@  ABBx //$''  4??4+@+@   **S!,,1aa   ##%%% I~~$"6~q66DD!   '')))FF  (a00iD$7&q!}}##%%%"DJF:**** "	s## tt'<'< "ke"UT[[]]%:; ; '*DL*DK88"&DK"&**S!"4"4KD%%!   '')))FF #ELLNN2::<<#333&)%,,..&9&9%   ++--- 43  DJ{ #&&44"{a  """OOsH   B5 5CC(C8 8DD<H H87H8/&J J98J9c                     | j         dk    sJ | j                                         |                     | j                   |                     |           d S )Nr   )r  r  r   r   r   r  s     r>   r  zMessagesParser.messageDone  sW    zV####%%'''T\***

=!!!!!r@   c                 B   | j         dv sJ t          |t                    r|                    d          }| j         dk    rd S | j        d k    r| j                            |           d S t          |          }| j        | j        z
  }||k    rA| j                            |d |                    | 	                    ||d                     d S | xj        |z  c_        | j                            |           | j        | j        k    r| 	                                 d S d S )N)r   r	  r  r	  )
r  r   r!  r"  r   r  r   r   r  r  )r_   r   dataLenexpectedLens       r>   rawDataReceivedzMessagesParser.rawDataReceived  s4   z00000dE"" 	(;;w''D:""F;$L))$/////$iiG+(99K$$--d<K<.@AAA  kll!3444!!W,!!--d333$33$$&&&&& 43r@   N)r~   )rt   ru   rv   rw   r   r#  r$  r  debugrb   r   r  r  r  r  r  r(  r  r-  r:   r@   r>   r   r   F  s          GONEE  ( ( ( (  ; ; ;(" " "" " "  A A AF" " " "' ' ' ' 'r@   r   c                   P    e Zd ZdZeZdZd Zd Zd Zd Z	d Z
d Zd	 Zd
 Zd ZdS )Basez1
    Base class for SIP clients and servers.
    Fc                 F    g | _         t          | j                  | _        d S r   )messagesr   
addMessageparserrd   s    r>   rb   zBase.__init__  s    $T_55r@   c                 :    | j                             |           d S r   )r2  r   )r_   msgs     r>   r3  zBase.addMessage  s    S!!!!!r@   c                    | j                             |           | j                                          | j        D ]}|                     ||           | j        r,t          j        d|                                d|           t          |t                    r|                     ||           w|                     ||           g | j        d d <   d S )Nz	Received z from )r4  r  r  r2  	_fixupNATr.  r   r6  rs   r   r   handle_requesthandle_response)r_   r   addrr   s       r>   datagramReceivedzBase.datagramReceived  s      &&& 	. 	.ANN1d###z DBAJJLLBB$BBCCC!W%% .##At,,,,$$Q----aaar@   c                 Z   |\  }}t          |j        d         d                   }|j        |k    r=||_        |j        |k    r||_        |                                |j        d         d<   d S |j        dk    r2||_        ||_        |                                |j        d         d<   d S d S )Nr   r   T)r   r   rQ   rU   rR   r`   rs   )r_   r  
sourcePeersrcHostsrcPort	senderVias         r>   r8  zBase._fixupNAT  s    ''"7?5#9!#<==	>W$$!(I~((")	(1(:(:(<(<GOE"1%%%_$$!(I%IO(1(:(:(<(<GOE"1%%% %$r@   c                     t          |j        d         d                   }|j        p|j        }|j        p|j        p| j        }t          ||          }|                     ||           dS zX
        Deliver response.

        Destination is based on topmost Via header.
        r   r   r   N	r   r   rU   rQ   r`   rR   rx   r   sendMessager_   responseMessagedestViarQ   rR   destAddrs         r>   deliverResponsezBase.deliverResponse  sp     !!8!?!BCC/7<}99	Dt,,,?33333r@   c                     t          |          }dD ]-}|j                            |g           dd         |j        |<   .|S z9
        Create a response to a request message.
        )r   r   r   r   r5   Nr   r   r   r_   r   requestresponser   s        r>   responseFromRequestzBase.responseFromRequest!  sP     D>>< 	F 	FD%,_%8%8r%B%B111%EHT""r@   c                 t   |j         dvrt          d          | j        r,t          j        d|                                d|           |                                }t          |t                    r|                    d          }| j         	                    ||j
        |j        p| j        f           dS )z
        Send a message.

        @param destURL: C{URL}. This should be a *physical* URL, not a logical one.
        @param message: The message to send.
        )udpNzonly UDP currently supportedzSending z to r  N)rP   r  r.  r   r6  rs   r   r   r  writerQ   rR   rx   )r_   destURLr  r   s       r>   rE  zBase.sendMessage+  s     M11=>>>: 	FGDw//11DDDDEEE!!dC   	(;;w''DTGL',2K$)#LMMMMMr@   c                     t           )z
        Override to define behavior for requests received

        @type message: C{Message}
        @type addr: C{tuple}
        r   r_   r  r;  s      r>   r9  zBase.handle_request;  
     "!r@   c                     t           )z
        Override to define behavior for responses received.

        @type message: C{Message}
        @type addr: C{tuple}
        r   rW  s      r>   r:  zBase.handle_responseD  rX  r@   N)rt   ru   rv   rw   rx   r.  rb   r3  r<  r8  rJ  rQ  rE  r9  r:  r:   r@   r>   r0  r0    s          DE6 6 6" " "  = = =4 4 4  N N N " " "" " " " "r@   r0  c                       e Zd ZdZdS )IContactz(
    A user of a registrar or proxy
    Nr   r:   r@   r>   r[  r[  N  r   r@   r[  c                       e Zd Zd ZdS )Registrationc                 "    || _         || _        d S r   )secondsToExpiry
contactURL)r_   r_  r`  s      r>   rb   zRegistration.__init__U  s    .$r@   Nr   r:   r@   r>   r]  r]  T  s#        % % % % %r@   r]  c                   $    e Zd ZdZd Zd Zd ZdS )	IRegistryz?
    Allows registration of logical->physical URL mapping.
    c                     dS )z
        Register the physical address of a logical URL.

        @return: Deferred of C{Registration} or failure with RegistrationError.
        Nr:   	domainURL
logicalURLphysicalURLs      r>   registerAddresszIRegistry.registerAddress_        r@   c                     dS )z
        Unregister the physical address of a logical URL.

        @return: Deferred of C{Registration} or failure with RegistrationError.
        Nr:   rd  s      r>   unregisterAddresszIRegistry.unregisterAddressf  ri  r@   c                     dS )z
        Get registration info for logical URL.

        @return: Deferred of C{Registration} object or failure of LookupError.
        Nr:   rf  s    r>   getRegistrationInfozIRegistry.getRegistrationInfom  ri  r@   N)rt   ru   rv   rw   rh  rk  rn  r:   r@   r>   rb  rb  Z  sK                 r@   rb  c                       e Zd ZdZd ZdS )ILocatorz<
    Allow looking up physical address for logical URL.
    c                     dS )z
        Return physical URL of server for logical URL of user.

        @param logicalURL: a logical C{URL}.
        @return: Deferred which becomes URL or fails with LookupError.
        Nr:   rm  s    r>   
getAddresszILocator.getAddressz  ri  r@   N)rt   ru   rv   rw   rr  r:   r@   r>   rp  rp  u  s-             r@   rp  c                   V    e Zd ZdZeZdZdefdZd Zd Zd Z	d Z
d Zd	 Zd
 Zd ZdS )Proxyz
    SIP proxy.
    Nc                 |    |pt          j                    | _        || _        t                              |            dS )z
        Create new instance.

        @param host: our hostname/IP as set in Via headers.
        @param port: our port as set in Via headers.
        N)socketgetfqdnrQ   rR   r0  rb   )r_   rQ   rR   s      r>   rb   zProxy.__init__  s7     ,FN,,		dr@   c                 8    t          | j        | j                  S )z<
        Return value of Via header for this proxy.
        r   )rK   rQ   rR   rd   s    r>   getViazProxy.getVia  s     		2222r@   c                     t           dj        z  d           }| j        }	  ||          }||                     fd           d S d S # t          $ r9}                                          |j                             Y d }~d S d }~wt          $ r@ t          j
                                                               d                     Y d S w xY w)Nzhandle_%s_requestc                 `                                             | j                            S r   )rJ  rQ  r   )r   r  r_   s    r>   <lambda>z&Proxy.handle_request.<locals>.<lambda>  s,    d2200AA  r@   r1   )rl   r   handle_request_default
addErrbackr   rJ  rQ  r   BaseExceptionr   r  )r_   r  r;  r   r   r   s   ``    r>   r9  zProxy.handle_request  s3    D->EE9+A	'4  A }         }  	L 	L 	L  !9!9!&'!J!JKKKKKKKKK 	I 	I 	IGIII  !9!9#w!G!GHHHHHH	Is   A 
C.BA	CCc                     |\  }} fd}                                  }|                                |j        d         v rt          j        d           dS |j        d                             d|                                           t          |j        d         d         d          \  }}}	 j                            |          }
|
	                     j
        |           |
                     j        |           dS )	z
        Default request handler.

        Default behaviour for OPTIONS and unknown methods for proxies
        is to forward message on to the client.

        Since at the moment we are stateless proxy, that's basically
        everything.
        c                 t    |                                  |j        d         d<                       | |          S )Nr   r   )rs   r   rE  )r   r  r_   s     r>   _mungContactHeaderz8Proxy.handle_request_default.<locals>._mungContactHeader  s2    ,/LLNNGOI&q)##C111r@   r   zDropping looped message.Nr   r   rH   r   )ry  rs   r   r   r6  insertr   locatorrr  addCallbackrE  r~  _cantForwardRequest)r_   r  r>  r?  r@  r  	viaHeaderr   r   tagsr   s   `          r>   r}  zProxy.handle_request_default  s    ('	2 	2 	2 	2 	2 KKMM	7?5#999G.///F%%a););)=)=>>>&wt'<Q'?qIIIc4 L##C((	d&000	T-w77777r@   c                     |                     t                     |j        d         d= |                     |                     d|                     d S )Nr   r   r,   )trapLookupErrorr   rJ  rQ  r_   errorr  s      r>   r  zProxy._cantForwardRequest  sM    

;OE"1%T55c7CCDDDDDr@   c                     t          |j        d         d                   }|j        p|j        }|j        p|j        p| j        }t          ||          }|                     ||           dS rC  rD  rF  s         r>   rJ  zProxy.deliverResponse  sp     !!8!?!BCC/7<}99	Dt,,,?33333r@   c                     t          |          }dD ]-}|j                            |g           dd         |j        |<   .|S rL  rM  rN  s        r>   rQ  zProxy.responseFromRequest  sP     D>>< 	F 	FD%,_%8%8r%B%B111%EHT""r@   c                 >   t          |j        d         d                   }|j        |j        f| j        | j        fk    rt	          j        d           dS |j        d         d= |j        d         s|                     ||           dS |                     |           dS )z+
        Default response handler.
        r   r   z&Dropping incorrectly addressed messageN)r   r   rQ   rR   r   r6  gotResponserJ  )r_   r  r;  r   s       r>   r:  zProxy.handle_response  s     7?51!455FAF	49555 G<===FOE"1%u% 	Wd+++FW%%%%%r@   c                     dS )zJ
        Called with responses that are addressed at this server.
        Nr:   rW  s      r>   r  zProxy.gotResponse  s	     	r@   )rt   ru   rv   rw   rx   r  rb   ry  r9  r}  r  rJ  rQ  r:  r  r:   r@   r>   rt  rt    s          DG t 	 	 	 	3 3 3  *8 8 8<E E E
4 4 4  & & &$    r@   rt  c                       e Zd Zd Zd ZdS )IAuthorizerc                     dS )z
        Generate a challenge the client may respond to.

        @type peer: C{tuple}
        @param peer: The client's address

        @rtype: C{str}
        @return: The challenge string
        Nr:   )peers    r>   getChallengezIAuthorizer.getChallenge  ri  r@   c                     dS )zf
        Create a credentials object from the given response.

        @type response: C{str}
        Nr:   )rP  s    r>   r"  zIAuthorizer.decode  ri  r@   N)rt   ru   rv   r  r"  r:   r@   r>   r  r    s2        	 	 	    r@   r  c                       e Zd ZU dZdZdZi Zeee	f         e
d<   d Zd Zd Zd Zd Zd	 Zd
 Zd Zd Zd Zd Zd Zd ZdS )RegisterProxyzk
    A proxy that allows registration for a specific domain.

    Unregistered users won't be handled.
    Nauthorizersc                 >    t          j        | g|R i | i | _        d S r   )rt  rb   liveChallenges)r_   argsra   s      r>   rb   zRegisterProxy.__init__&  s0    t)d)))b))) r@   c                     |\  }}d S r   r:   r_   r  	host_portrQ   rR   s        r>   handle_ACK_requestz RegisterProxy.handle_ACK_request*  s     !tr@   c                     |\  }}| j         |                     |||           dS d|j        vr|                     |||          S |                     |||          S )z`
        Handle a registration request.

        Currently registration is not proxied.
        Nauthorization)portalregisterr   unauthorizedloginr  s        r>   handle_REGISTER_requestz%RegisterProxy.handle_REGISTER_request3  sn     !t;MM'4..... go55(($===zz'4666r@   c                    |                      d|          }| j                                        D ]\  }}|                    ||f          }| |                                 d| j         d}n"|                                 d| d| j         d}|j                            dg                               |           | 	                    |           d S )Nr)   z realm="rG   rh   z,realm="r6   )
rQ  r  rn   r  titlerQ   r   r   r   rJ  )	r_   r  rQ   rR   r   schemeauthchalrp   s	            r>   r  zRegisterProxy.unauthorizedD  s    $$S'22 ,2244 	G 	GLFD$$dD\22D|!<<>>??49???!<<>>FFDFF$)FFFI  !3R88??FFFFQr@   c                    |j         d         d                             d d          }| j                            |d                                                   }|r	 |                    |d                   }|xj        d| j        z   z  c_        | j        	                    |d t                                        | j        |||                              | j        |||                              t          j                   d S # t"          $ r  t$          $ r@ t          j                     |                     |                     d|                     Y d S w xY w|                     |                     d|                     d S )Nr  r   rH   r   r1   r2   )r   rB   r  r   r   r"  r   rQ   r  r  r[  r  _cbLoginr~  _ebLoginr   r  r   r  rJ  rQ  )r_   r  rQ   rR   r   r&  r   s          r>   r  zRegisterProxy.loginO  s{   0399$BB  q!1!122 	IUHHU1X&& 

cDIo-

!!!T844@@M7D$ *T]GT4@@CGATATATATAT      M M M			$$T%=%=c7%K%KLLLLLLM   !9!9#w!G!GHHHHHs   D AEEc                 @    |\  }}}|                      |||           d S r   )r  )r_   i_a_lr  rQ   rR   r   r&  r   s           r>   r  zRegisterProxy._cbLoginb  s)    	AqgtT*****r@   c                 |    |                     t          j        j                   |                     |||           d S r   )r  r   r  UnauthorizedLoginr  )r_   failurer  rQ   rR   s        r>   r  zRegisterProxy._ebLoging  s7    TZ1222'4.....r@   c                    t          |j        d         d         d          \  }}}d}d|j        v r|j        d         d         }|j                            ddg          d         dk    r|                     |||           dS |8t          |||	          \  }}}| j                            |j        ||          }	n| j                            |          }	|	                    | j	        | j
        |f|f
           dS )z-
        Allow all users to register
        r   r   rH   r  Nr   expires0r   )callbackArgserrbackArgs)r   r   r   
unregisterregistryrh  r   rn  addCallbacks_cbRegister_ebRegister)
r_   r  rQ   rR   r   toURLr   r   r`  r   s
             r>   r  zRegisterProxy.registerk  s    +7?4+@+C1MMMeV''oi03G?y4&11!4;;OOGUG44444 "+7dQU+V+V+V(j&M11'+ujQQM55e<<NN  %Z$J	      r@   c                 4   |                      d|          }|j        d k    rK|                    d|j                                                   |                    dd|j        z             |                    dd           |                     |           d S )Nr&   r   r  z%dr   r  )rQ  r`  r   rs   r_  rJ  )r_   registrationr  rP  s       r>   r  zRegisterProxy._cbRegister  s    ++C99"d**y,*A*J*J*L*LMMMy$1M*MNNN+S111X&&&&&r@   c                 F    |                     t          t                     d S r   )r  r   r  r  s      r>   r  zRegisterProxy._ebRegister  s    

$k22222r@   c                    	 t          |j        d         d                   }|dk    rs|dk    rd}nt          |          \  }}}| j                            |j        ||          }|                    | j        |                              | j	        |           d S d S # t          $ r- |                     |                     d|                     Y d S w xY w)Nr  r   *r(   )r   r   r   r  rk  r   r  _cbUnregisterr~  _ebUnregisterr   rJ  rQ  )	r_   r  r  r   r  r`  r   r   r   s	            r>   r  zRegisterProxy.unregister  s    	'/)4Q788G !||c>>!$JJ/;G/D/D,D*fM33GK
SSd0'::EE&     |  	I 	I 	I  !9!9#w!G!GHHHHHH	Is    B 3CCc                    |                      d|          }|j                            dg                               |j                                                   |                    dd           |                     |           d S )Nr&   r   r  r  )rQ  r   r   r   r`  rs   r   rJ  )r_   r  r  r6  s       r>   r  zRegisterProxy._cbUnregister  sz    &&sG44y"--44\5L5U5U5W5WXXXi%%%S!!!!!r@   c                     d S r   r:   )r_   r  r  s      r>   r  zRegisterProxy._ebUnregister  s    r@   )rt   ru   rv   rw   r  r  r  r   r   r  __annotations__rb   r  r  r  r  r  r  r  r  r  r  r  r  r:   r@   r>   r  r    s          FH*,Kc;&',,,! ! !  7 7 7"	  	  	 I I I&+ + +
/ / /  4' ' '3 3 3
   " " "    r@   r  c                   6    e Zd ZdZd Zd Zd Zd Zd Zd Z	dS )	InMemoryRegistryz6
    A simplistic registry for a specific domain.
    c                 "    || _         i | _        d S r   )domainusers)r_   r  s     r>   rb   zInMemoryRegistry.__init__  s    


r@   c                    |j         | j        k    r!t          j        t	          d                    S |j        | j        v r)| j        |j                 \  }}t          j        |          S t          j        t	          d                    S Nzunknown domainno such user)rQ   r  r	   failr  r   r  succeedr_   userURIdcr   s       r>   rr  zInMemoryRegistry.getAddress  su    <4;&&:k*:;;<<<tz))j!12GB=%%%:k.99:::r@   c           	         |j         | j        k    r!t          j        t	          d                    S |j        | j        v rj| j        |j                 \  }}t          j        t          t          |
                                t          j                    z
            |                    S t          j        t	          d                    S r  )rQ   r  r	   r  r  r   r  r  r]  r   getTimetimer  s       r>   rn  z$InMemoryRegistry.getRegistrationInfo  s    <4;&&:k*:;;<<<tz))j!12GB=c"**,,2L.M.Ms!S!STTT:k.99:::r@   c                    	 | j         |         \  }}|                                 | j         |= n1# t          $ r$ t          j        t          d                    cY S w xY wt          j        t          d|                    S )Nr  r   )r  cancelKeyErrorr	   r  r  r  r]  )r_   r   r  r   s       r>   _expireRegistrationz$InMemoryRegistry._expireRegistration  s    	%j*GB IIKKK
8$$	  	; 	; 	;:k.99:::::	;
 }\!S11222s   / +AAc           	         |j         | j        k    r5t          j        d           t	          j        t          d                    S |j         | j        k    r5t          j        d           t	          j        t          d                    S |j        | j        v r+| j        |j                 \  }}|	                    d           n t          j        d| j        |j                  }t          j        d|                                 d|                                            ||f| j        |j        <   t	          j        t          t!          |                                t%          j                    z
            |                    S )Nz(Registration for domain we don't handle.r,   i  zRegistered z at )rQ   r  r   r6  r	   r  r   r   r  r   r   	callLaterr  rs   r  r]  r   r  r  )r_   re  rf  rg  r  olds         r>   rh  z InMemoryRegistry.registerAddress  sD   >T[((G>???:/44555?dk))G>???:/44555$*,,j!45GBHHTNNNN"4)A:CVWWBQj1133QQ9M9M9O9OQQRRR+-{*;
:&'}\#bjjllTY[[.H*I*I;WWXXXr@   c                 6    |                      |j                  S r   )r  r   )r_   re  rf  rg  s       r>   rk  z"InMemoryRegistry.unregisterAddress  s    ''
(;<<<r@   N)
rt   ru   rv   rw   rb   rr  rn  r  rh  rk  r:   r@   r>   r  r    s{           ; ; ;; ; ;3 3 3Y Y Y = = = = =r@   r  )NN)NNr   ):rw   rv  r  rV   collectionsr   typingr   r   zope.interfacer   r   twistedr   twisted.internetr	   r
   r   twisted.protocolsr   twisted.pythonr   rx   shortHeadersr   rn   rr   r   r   r   rD   rI   objectr[   rK   r   r   r   r   r   r   r   r   r   r   r   r  r   DatagramProtocolr0  r[  r]  rb  rp  rt  r  r  r  r:   r@   r>   <module>r     s  
     # # # # # #         1 1 1 1 1 1 1 1       5 5 5 5 5 5 5 5 5 5 # # # # # #       

 
     DAqKNNq666 	"6 	6
 	6 6 	6 	6 	6 6 6 	6 6 6 	6  !6" #6 6$ 	%6& 	'6( 	()6* 	+6, -6. /60 	162 	#364 	 566 	!768 	!96: ;6< 	=6> 	?6@ 	"A6B 	*C6D E6 6 6F G6H 	I6J K6L M6N 	O6P 	Q6R 	S6T 	U6V 	 W6X 	Y6Z [6\ 	]6^ 	_6` 	$a6b 	c6d 	e6f g6 6h 
#	k6 6 6r * < < <   &((E E E E E E E EP( ( (VQ
 Q
 Q
 Q
 Q
 Q
 Q
 Q
h4 4 4 4n         F    y          %" %" %" %" %" %" %" %"P> > > > >g > > >*4 4 4 4 4w 4 4 4&a' a' a' a' a'U' a' a' a'Ha" a" a" a" a"8$ a" a" a"H    y   % % % % % % % %    	   6    y       D   D    )   (P P P P PE P P Pf Y!!6= 6= 6= 6= 6= 6= 6= "!6= 6= 6=r@   