Server : Apache/2.4.52 (Ubuntu) System : Linux webserver 6.8.0-49-generic #49~22.04.1-Ubuntu SMP PREEMPT_DYNAMIC Wed Nov 6 17:42:15 UTC 2 x86_64 User : www-data ( 33) PHP Version : 8.1.2-1ubuntu2.21 Disable Function : NONE Directory : /lib/python3/dist-packages/twisted/python/__pycache__/ |
o
�b�' � @ s� d Z ddlZddlZddlZddlZddlmZmZmZ ddl m
Z
G dd� d�Z G dd� de �Z e
�
e � G d d
� d
e �Ze
�
e� G d d � d �ZdS )
z!
A rotating, browsable log file.
� N)�BinaryIO�Optional�cast)�
threadablec @ s~ e Zd ZdZddgZ ddededee ddfd d
�Ze d d � �Z
d
d� Z dd� Z dd� Z
dd� Zdd� Zdd� Zdd� ZdS ) � BaseLogFilez<
The base class for a log file that can be rotated.
�write�rotateN�name� directory� defaultMode�returnc C s` || _ || _tj�||�| _|du r'tj�| j�r't�t�| j�tj �| _ n|| _ | �
� dS )a
Create a log file.
@param name: name of the file
@param directory: directory holding the file
@param defaultMode: permissions used to create the file. Default to
current permissions of the file if the file exists.
N) r
r �os�path�join�exists�stat�S_IMODE�ST_MODEr � _openFile)�selfr r
r � r �8/usr/lib/python3/dist-packages/twisted/python/logfile.py�__init__ s � zBaseLogFile.__init__c O s4 t j�|�}| t j�|�t j�|�g|�R i |��S )z=
Construct a log file from a full file path.
)r
r �abspath�basename�dirname)�cls�filename�args�kwargs�logPathr r r � fromFullPath2 s (zBaseLogFile.fromFullPathc C s t �)zc
Override with a method to that returns true if the log
should be rotated.
)�NotImplementedError�r r r r � shouldRotate: s zBaseLogFile.shouldRotatec C s� d| _ tj�| j�r ttt| jdd��| _| j�dd� n.| j dur@t�
d�}zttt| jdd��| _W t�
|� nt�
|� w ttt| jdd��| _| j durfz t� | j| j � W dS t ye Y dS w dS )z[
Open the log file.
The log file is always opened in binary mode.
Fzrb+r � Ni� zwb+)
�closedr
r r r r �open�_file�seekr �umask�chmod�OSError)r �oldUmaskr r r r A s"
��zBaseLogFile._openFilec C s< | � � r | �� | �� t|t�r|�d�}| j�|� dS )z�
Write some data to the file.
@param data: The data to write. Text will be encoded as UTF-8.
@type data: L{bytes} or L{unicode}
�utf8N)r$ �flushr �
isinstance�str�encoder( r �r �datar r r r \ s
zBaseLogFile.writec C s | j �� dS )z!
Flush the file.
N)r( r/ r# r r r r/ j s zBaseLogFile.flushc C s d| _ | j�� | `dS )z[
Close the file.
The file cannot be used once it has been closed.
TN)r& r( �closer# r r r r5 p s
zBaseLogFile.closec C s | � � | �� dS )a"
Reopen the log file. This is mainly useful if you use an external log
rotation tool, which moves under your feet.
Note that on Windows you probably need a specific API to rename the
file, as it's not supported to simply use os.rename, for example.
N)r5 r r# r r r �reopenz s zBaseLogFile.reopenc C s
t | j�S )z>
Return a LogReader for the current log file.
)� LogReaderr r# r r r �
getCurrentLog� s
zBaseLogFile.getCurrentLog�N)�__name__�
__module__� __qualname__�__doc__� synchronizedr1 r �intr � classmethodr! r$ r r r/ r5 r6 r8 r r r r r s, ����
�
r c @ sX e Zd ZdZ ddd�Zdd� Zdd � Zd
d � Zd d
� Zdd� Z dd� Z
dd� Z dS )�LogFilezf
A log file that can be rotated.
A rotateLength of None disables automatic log rotation.
�@B Nc C s t �| |||� || _|| _dS )a`
Create a log file rotating on length.
@param name: file name.
@type name: C{str}
@param directory: path of the log file.
@type directory: C{str}
@param rotateLength: size of the log file where it rotates. Default to
1M.
@type rotateLength: C{int}
@param defaultMode: mode used to create the file.
@type defaultMode: C{int}
@param maxRotatedFiles: if not None, max number of log files the class
creates. Warning: it removes all log files above this number.
@type maxRotatedFiles: C{int}
N)r r � rotateLength�maxRotatedFiles)r r r
rC r rD r r r r � s
zLogFile.__init__c C s t �| � | j�� | _d S r9 )r r r( �tell�sizer# r r r r � s
zLogFile._openFilec C s | j o| j| j kS )zL
Rotate when the log file size is larger than rotateLength.
)rC rF r# r r r r$ � s zLogFile.shouldRotatec C s* d| j |f }tj �|�std��t|�S )zK
Given an integer, return a LogReader for an old log file.
�%s.%d�no such logfile exists)r r
r �
ValueErrorr7 �r �
identifierr r r r �getLog� s zLogFile.getLogc C s" t �| |� | jt|�7 _dS )z.
Write some data to the file.
N)r r rF �lenr3 r r r r � s z
LogFile.writec C s� t �| jt j�rt �| jt j�sdS | �� }|�� |D ])}| jdur3|| jkr3t �d| j|f � q t � d| j|f d| j|d f � q | j
� � t � | jd| j � | � � dS )z�
Rotate the file and create a new one.
If it's not possible to open new logfile, this will fail silently,
and continue logging to old logfile.
NrG � z%s.1)
r
�accessr
�W_OKr �listLogs�reverserD �remove�renamer( r5 r )r �logs�ir r r r � s &
zLogFile.rotatec C s\ g }t � d| j �D ] }zt|�d�d �}|r |�|� W q
ty' Y q
w |�� |S )zM
Return sorted list of integers - the old logs' identifiers.
z%s.*�.���)�globr r? �split�appendrI �sort)r �resultr �counterr r r rQ � s
� �zLogFile.listLogsc C � t �| �}|d= |S )NrF �r � __getstate__�r �stater r r ra � �
zLogFile.__getstate__)rB NN) r: r; r< r= r r r$ rL r r rQ ra r r r r rA � s
� rA c @ sP e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dS )� DailyLogFilezAA log file that is rotated daily (at or after midnight localtime)c C s& t �| � | �t�| j�d �| _d S )N� )r r �toDater
r r �lastDater# r r r r � s
zDailyLogFile._openFilec C s | � � | jkS )z1Rotate when the date has changed since last write)rg rh r# r r r r$ � s zDailyLogFile.shouldRotatec G s t j|� dd� S )a Convert a unixtime to (year, month, day) localtime tuple,
or return the current (year, month, day) localtime tuple.
This function primarily exists so you may overload it with
gmtime, or some cruft to make unit testing possible.
N� )�time� localtime)r r r r r rg s zDailyLogFile.toDatec
C s< z d� tt|��W S ty d� tt| �|��� Y S w )z>Return the suffix given a (year, month, day) tuple or unixtime�_)r �mapr1 �
BaseExceptionrg )r � tupledater r r �suffix
s
�zDailyLogFile.suffixc C sJ | � |�| jkr | �� S | j� d| �|�� �}tj�|�s!td��t|�S )z:Given a unix time, return a LogReader for an old log file.rW rH ) rg rh r8 r rp r
r rI r7 rJ r r r rL s zDailyLogFile.getLogc C s" t �| |� t| j| �� �| _dS )z Write some data to the log fileN)r r �maxrh rg r3 r r r r s zDailyLogFile.writec C sp t �| jt j�rt �| jt j�sdS | j� d| �| j�� �}t j�|�r&dS | j� � t �
| j|� | � � dS )z�Rotate the file and create a new one.
If it's not possible to open new logfile, this will fail silently,
and continue logging to old logfile.
NrW ) r
rO r
rP r rp rh r r( r5 rT r )r �newpathr r r r # s
zDailyLogFile.rotatec C r_ )Nrh r` rb r r r ra 2 rd zDailyLogFile.__getstate__N) r: r; r< r= r r$ rg rp rL r r ra r r r r re � s
re c @ s* e Zd ZdZdd� Zd
dd�Zdd� Zd S ) r7 zRead from a log file.c C s t |�| _dS )z�
Open the log file for reading.
The comments about binary-mode for L{BaseLogFile._openFile} also apply
here.
N)r' r( )r r r r r r > s zLogReader.__init__�
c C s4 g }t |�D ]}| j�� }|s |S |�|� q|S )zRead a list of lines from the log file.
This doesn't returns all of the files lines - call it multiple times.
)�ranger( �readliner[ )r �linesr] rV �liner r r � readLinesG s
�zLogReader.readLinesc C s | j �� d S r9 )r( r5 r# r r r r5 T s zLogReader.closeN)rs )r: r; r< r= r rx r5 r r r r r7 ; s
r7 )r= rY r
r rj �typingr r r �twisted.pythonr r rA � synchronizere r7 r r r r �<module> s w
f
C