← Back
Editing: _release.cpython-38.pyc
U ��W[tH � @ sF d Z ddlZddlZddlmZmZ ddlmZmZm Z ddl m Z ddl m Z ddlmZ dd d d d gZd dddddddddg Zdd� ZG dd� de�Zee�G dd � d e��Zd d � ZG d d � d e�Zd!d"� Zd#d$� ZG d%d&� d&e�ZG d'd(� d(e�Z G d)d*� d*e�Z d+d,� Z G d-d.� d.e�Z G d/d0� d0e�Z G d1d2� d2e�Z!dS )3aL Twisted's automated release system. This module is only for use within Twisted's release system. If you are anyone else, do not use it. The interface and behaviour will change without notice. Only Linux is supported by this code. It should not be used by any tools which must run on multiple platforms (eg the setup.py script). � N)� Interface� implementer)� check_output�STDOUT�CalledProcessError)�execfile)�FilePath)� MonkeyPatcher�docZbugfixZmiscZfeatureZremovalz%https://docs.python.org/2/objects.invz%https://docs.python.org/3/objects.invz6https://pyopenssl.readthedocs.io/en/stable/objects.invz6https://hyperlink.readthedocs.io/en/stable/objects.invz5https://twisted.github.io/constantly/docs/objects.invz6https://twisted.github.io/incremental/docs/objects.invz1https://python-hyper.org/h2/en/stable/objects.invz7https://python-hyper.org/priority/en/stable/objects.invz:https://zopeinterface.readthedocs.io/en/latest/objects.invz4https://automat.readthedocs.io/en/latest/objects.invc K s t |d< t| f|�S )a� Execute a vector of arguments. This is a wrapper around L{subprocess.check_output}, so it takes the same arguments as L{subprocess.Popen} with one difference: all arguments after the vector must be keyword arguments. @param args: arguments passed to L{subprocess.check_output} @param kwargs: keyword arguments passed to L{subprocess.check_output} @return: command output @rtype: L{bytes} �stderr)r r )�args�kwargs� r �9/usr/lib/python3/dist-packages/twisted/python/_release.py� runCommand* s r c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd S ) � IVCSCommandz( An interface for VCS commands. c C s dS )z� Ensure that C{path} is a working directory of this VCS. @type path: L{twisted.python.filepath.FilePath} @param path: The path to check. Nr ��pathr r r �ensureIsWorkingDirectory? s z$IVCSCommand.ensureIsWorkingDirectoryc C s dS )�� Return the Git status of the files in the specified path. @type path: L{twisted.python.filepath.FilePath} @param path: The path to get the status from (can be a directory or a file.) Nr r r r r � isStatusCleanH s zIVCSCommand.isStatusCleanc C s dS )z� Remove the specified path from a the VCS. @type path: L{twisted.python.filepath.FilePath} @param path: The path to remove from the repository. Nr r r r r �removeR s zIVCSCommand.removec C s dS )a� Export the content of the VCSrepository to the specified directory. @type fromDir: L{twisted.python.filepath.FilePath} @param fromDir: The path to the VCS repository to export. @type exportDir: L{twisted.python.filepath.FilePath} @param exportDir: The directory to export the content of the repository to. This directory doesn't have to exist prior to exporting the repository. Nr �ZfromDirZ exportDirr r r �exportTo[ s zIVCSCommand.exportToN)�__name__� __module__� __qualname__�__doc__r r r r r r r r r ; s r c @ s@ e Zd ZdZedd� �Zedd� �Zedd� �Zedd � �Zd S ) � GitCommandzJ Subset of Git commands to release Twisted from a Git repository. c C sD zt ddg| jd� W n( ttfk r> td| jf ��Y nX dS )z� Ensure that C{path} is a Git working directory. @type path: L{twisted.python.filepath.FilePath} @param path: The path to check. �gitz rev-parse��cwdz*%s does not appear to be a Git repository.N)r r r �OSError�NotWorkingDirectoryr r r r r o s ��z#GitCommand.ensureIsWorkingDirectoryc C s t dd| jddg��� }|dkS )r r �-C�statusz--short� )r r �strip)r r% r r r r s �zGitCommand.isStatusCleanc C s t dd| �� d| jg� dS )z� Remove the specified path from a Git repository. @type path: L{twisted.python.filepath.FilePath} @param path: The path to remove from the repository. r r$ ZrmN)r �dirnamer r r r r r � s zGitCommand.removec C s$ t dd| jdddd|jd g� dS ) a� Export the content of a Git repository to the specified directory. @type fromDir: L{twisted.python.filepath.FilePath} @param fromDir: The path to the Git repository to export. @type exportDir: L{twisted.python.filepath.FilePath} @param exportDir: The directory to export the content of the repository to. This directory doesn't have to exist prior to exporting the repository. r r$ zcheckout-indexz--allz--forcez--prefix�/N)r r r r r r r � s �zGitCommand.exportToN) r r r r � staticmethodr r r r r r r r r j s r c C s> zt �| � t W S ttfk r( Y nX td| jf ��dS )a� Detect the VCS used in the specified directory and return a L{GitCommand} if the directory is a Git repository. If the directory is not git, it raises a L{NotWorkingDirectory} exception. @type directory: L{FilePath} @param directory: The directory to detect the VCS used from. @rtype: L{GitCommand} @raise NotWorkingDirectory: if no supported VCS can be found from the specified directory. z#No supported VCS can be found in %sN)r r r# r" r �� directoryr r r �getRepositoryCommand� s �r- c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) �ProjectaC A representation of a project that has a version. @ivar directory: A L{twisted.python.filepath.FilePath} pointing to the base directory of a Twisted-style Python package. The package should contain a C{_version.py} file and a C{newsfragments} directory that contains a C{README} file. c C s || _ d S �Nr+ )�selfr, r r r �__init__� s zProject.__init__c C s d| j j| jf S )Nz%s(%r))� __class__r r, )r0 r r r �__repr__� s �zProject.__repr__c C sT i }| j }|sL|jdkr"td��q |�� dks8|�� }q t|�d�j|� q |d S )z� @return: A L{incremental.Version} specifying the version number of the project based on live python modules. r) z Not inside a Twisted project.�twistedz _version.py� __version__)r, r � Exception�basename�parentr �child)r0 � namespacer, r r r � getVersion� s zProject.getVersionN)r r r r r1 r3 r; r r r r r. � s r. c C s8 g }| � � D ]&}|�� dkr |�� }|�t|�� q |S )z� Find all Twisted-style projects beneath a base directory. @param baseDirectory: A L{twisted.python.filepath.FilePath} to look inside. @return: A list of L{Project}. � newsfragments)�walkr7 r8 �appendr. )Z baseDirectoryZprojectsZfilePathZprojectDirectoryr r r �findTwistedProjects� s r? c C s� t �| | d � t| d ��}|�� }W 5 Q R X |�� D ]\}}|�||�}q8t| d d��}|�|� W 5 Q R X t �| d | � t �| d � dS )zP I replace the text `oldstr' with `newstr' in `filename' using science. z.bakz.new�wN)�os�rename�open�read�items�replace�write�unlink)�filenameZoldToNew�f�d�k�vr r r � replaceInFile� s rN c @ s e Zd ZdZdS )�NoDocumentsFoundz3 Raised when no input documents are found. N�r r r r r r r r rO s rO c @ s e Zd ZdZdd� ZdS )� APIBuilderz� Generate API documentation from source files using U{pydoctor<https://github.com/twisted/pydoctor>}. This requires pydoctor to be installed and usable. c s� g }t D ]}|�d� |�|� qddlm} |j� � fdd�} t|d| f�} | �� ddlm} d|d |d d d |� � j d |d|j d|j dddg| } dd� | D �} | | � | � � dS )ah Call pydoctor's entry point with options which will generate HTML documentation for the specified package's API. @type projectName: C{str} @param projectName: The name of the package for which to generate documentation. @type projectURL: C{str} @param projectURL: The location (probably an HTTP URL) of the project on the web. @type sourceURL: C{str} @param sourceURL: The location (probably an HTTP URL) of the root of the source browser for the project. @type packagePath: L{FilePath} @param packagePath: The path to the top-level of the package named by C{projectName}. @type outputPath: L{FilePath} @param outputPath: An existing directory to which the generated API documentation will be written. z --intersphinxr )�utilc s6 | dkr*t t��� }|�d�}|�| �jS � | �S d S )N)z summary.htmlz index.htmlz common.htmlZ_pydoctortemplates)r �__file__r8 r9 r )rI ZtwistedPythonDirZ templatesDir�ZoriginalTemplatefiler r � templatefile< s z&APIBuilder.build.<locals>.templatefilerU )�mainz--project-namez --project-urlz--system-classz&twisted.python._pydoctor.TwistedSystemz--project-base-dirz--html-viewsource-basez --add-packagez --html-outputz--html-write-function-pagesz--quietz --make-htmlc S s g | ]}|� d ��qS )�utf-8)�encode)�.0�argr r r � <listcomp>S s z$APIBuilder.build.<locals>.<listcomp>N) �intersphinxURLsr> Zpydoctor.templatewriterrR rU r ZpatchZpydoctor.driverrV r8 r Zrestore) r0 Z projectNameZ projectURL� sourceURLZ packagePathZ outputPathZ intersphinxesZ intersphinxrR rU Z monkeyPatchrV r r rT r �build s@ �� zAPIBuilder.buildN)r r r r r^ r r r r rQ s rQ c @ s" e Zd ZdZdd� Zddd�ZdS ) � SphinxBuildera� Generate HTML documentation using Sphinx. Generates and runs a shell command that looks something like:: sphinx-build -b html -d [BUILDDIR]/doctrees [DOCDIR]/source [BUILDDIR]/html where DOCDIR is a directory containing another directory called "source" which contains the Sphinx source files, and BUILDDIR is the directory in which the Sphinx output will be created. c C s< | � t|d ��d��}|r8tj�d�|�� t�d��dS )a] Build the main documentation. @type args: list of str @param args: The command line arguments to process. This must contain one string argument: the path to the root of a Twisted checkout. Additional arguments will be ignored for compatibility with legacy build infrastructure. r �docszUnclean build: {} � N)r^ r r9 �sys�stdoutrG �format�exit)r0 r �outputr r r rV i s zSphinxBuilder.mainN� c C s� |dkr|� � �d�}|�d�}tddddd|j|j|jg��d �}|�� |�� D ]V}|�� d krT|�|�}|}|r�|�|� d ��}qr|� � � � s�|� � � � |� |� qT|S ) a� Build the documentation in C{docDir} with Sphinx. @param docDir: The directory of the documentation. This is a directory which contains another directory called "source" which contains the Sphinx "conf.py" file and sphinx source documents. @type docDir: L{twisted.python.filepath.FilePath} @param buildDir: The directory to build the documentation in. By default this will be a child directory of {docDir} named "build". @type buildDir: L{twisted.python.filepath.FilePath} @param version: The version of Twisted to set in the docs. @type version: C{str} @return: the output produced by running the command @rtype: L{str} Nr Zdoctreesz sphinx-buildz-qz-bZhtmlz-drW Zmanr ) r8 r9 r r �decoder r= r7 Z segmentsFrom�pop�isdir�makedirsZcopyTo) r0 ZdocDirZbuildDir�versionZ doctreeDirrf r Zsegments�destr r r r^ y s, �� zSphinxBuilder.build)Nrg )r r r r rV r^ r r r r r_ Z s r_ c C sl d}| j �tj�}|j �tj�}t||�D ] \}}||krD|d7 }q* qJq*dgt|�| }|||d� S )a4 Return a list of strings that represent C{destination} as a path relative to C{origin}. It is assumed that both paths represent directories, not files. That is to say, the delta of L{twisted.python.filepath.FilePath} /foo/bar to L{twisted.python.filepath.FilePath} /foo/baz will be C{../baz}, not C{baz}. @type origin: L{twisted.python.filepath.FilePath} @param origin: The origin of the relative path. @type destination: L{twisted.python.filepath.FilePath} @param destination: The destination of the relative path. r ra z..N)r �splitrA �sep�zip�len)�originZ destinationZ commonItemsZpath1Zpath2Zelem1Zelem2r r r r � filePathDelta� s rs c @ s e Zd ZdZdS )r# zf Raised when a directory does not appear to be a repository directory of a supported VCS. NrP r r r r r# � s r# c @ s e Zd ZdZdd� Zdd� ZdS )�BuildAPIDocsScriptz> A thing for building API documentation. See L{main}. c C sJ t |�d���� }|�� }d|f d }t� }|�dd||�d�|� dS )a Build the API documentation of Twisted, with our project policy. @param projectRoot: A L{FilePath} representing the root of the Twisted checkout. @param output: A L{FilePath} pointing to the desired output directory. r4 z2https://github.com/twisted/twisted/tree/twisted-%sz/srcZTwistedzhttp://twistedmatrix.com/N)r. r9 r; �baserQ r^ )r0 Z projectRootrf rl Z versionStringr] Z apiBuilderr r r � buildAPIDocs� s" ����z BuildAPIDocsScript.buildAPIDocsc C s6 t |�dkrt�d� | �t|d �t|d �� dS )a Build API documentation. @type args: list of str @param args: The command line arguments to process. This must contain two strings: the path to the root of the Twisted checkout, and a path to an output directory. � zAMust specify two arguments: Twisted checkout and destination pathr ra N)rq rb re rv r )r0 r r r r rV � s zBuildAPIDocsScript.mainN)r r r r rv rV r r r r rt � s rt c @ s e Zd ZdZdd� Zdd� ZdS )�CheckNewsfragmentScriptzE A thing for checking whether a checkout has a newsfragment. c C s || _ d S r/ )�_print)r0 ry r r r r1 � s z CheckNewsfragmentScript.__init__c C s� t |�dkrt�d� tjjp d}tj�|d �}tddddg|d �� |�� � }tdd d d g|d �� |�� � }|s�| � d � t�d� |� � � tj �}| � d� |D ]}| � |� q�| � d� t |�dkr�|d tj�dddg�kr�| � d� t�d� g }|D ]F}tjd tj |k�r d|k�r |�dd�d tk�r |�|� �q |�d��r�|�rp| � d� t�d� n| � d� t�d� |D ] }| � d| � t�d� �q�| � d� t�d� dS ) z� Run the script. @type args: L{list} of L{str} @param args: The command line arguments to process. This must contain one string: the path to the root of the Twisted checkout. ra z/Must specify one argument: the Twisted checkout�asciir s gits rev-parses --abbrev-refZHEADr s diffs --name-onlys origin/trunk...z9On trunk or no diffs from trunk; no need to look at this.zLooking at these files:z----r` ZfunzTwisted.Quotesz+Quotes change only; no newsfragment needed.r< �.zrelease-z1No newsfragments should be on the release branch.z/Release branch with no newsfragments, all good.zFound z-No newsfragment found. Have you committed it?N)rq rb re rc �encodingrA r �abspathr rh r' ry rn �linesepro �join�rsplit�NEWSFRAGMENT_TYPESr> � startswith) r0 r r| �location�branch�r�filesZchanger< r r r rV � sX �� ��� z CheckNewsfragmentScript.mainN)r r r r r1 rV r r r r rx � s rx )"r rA rb Zzope.interfacer r � subprocessr r r Ztwisted.python.compatr Ztwisted.python.filepathr Ztwisted.python.monkeyr r� r\ r r �objectr r- r. r? rN r6 rO rQ r_ rs r# rt rx r r r r �<module> sD �/B%HK +
Save File
Cancel