관리-도구
편집 파일: base.cpython-37.opt-1.pyc
B �M!V�i � @ s� d dl Z d dlZd dlZd dlZddlmZ ddlmZ ddlmZ ddlm Z d dl m Z e� d �Z e� d �Ze� d �Ze� d �Ze� d �ZdZe� d�ZG dd� de�ZG dd� dej�ZdS )� N� )�util)�compat� )�revision)� migration)�contextmanagerz(?!__init__)(.*\.py)(c|o)?$z(?!__init__)(.*\.py)$z([a-f0-9]+)\.py$z (upgrade|downgrade)_([a-z0-9]+)z\w+z%(rev)s_%(slug)sz,|(?: +)c @ s e Zd ZdZeddddfdd�Zedd � �Zej d d � �Z d d � Z e dd� �Z ed:dd��Zd;dd�Zdd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Z ed.d/� �Z d0d1� Z d2d3� Z d4d5� Z d<d6d7�Z!d8d9� Z"dS )=�ScriptDirectoryaH Provides operations upon an Alembic script directory. This object is useful to get information as to current revisions, most notably being able to get at the "head" revision, for schemes that want to test if the current revision in the database is the most recent:: from alembic.script import ScriptDirectory from alembic.config import Config config = Config() config.set_main_option("script_location", "myapp:migrations") script = ScriptDirectory.from_config(config) head_revision = script.get_current_head() �( NFzutf-8c C sV || _ || _|| _|pd| _|| _|| _t�| j�| _ t � |t j �sRt �d| ��d S )Nr zVPath doesn't exist: %r. Please use the 'init' command to create a new scripts folder.)�dir� file_template�version_locations�truncate_slug_length� sourceless�output_encodingr Z RevisionMap�_load_revisions� revision_map�os�access�F_OKr � CommandError)�selfr r r r r r � r �D/opt/alt/python37/lib/python3.7/site-packages/alembic/script/base.py�__init__* s zScriptDirectory.__init__c C s* | j }t|�dkr t�d��n|d S d S )Nr z"Multiple version_locations presentr )�_version_locations�lenr r )r Zlocr r r �versions; s zScriptDirectory.versionsc C s4 | j rdd� | j D �S tj�tj�| jd��fS d S )Nc S s g | ]}t j�t�|���qS r )r �path�abspathr �coerce_resource_to_filename)�.0�locationr r r � <listcomp>G s z6ScriptDirectory._version_locations.<locals>.<listcomp>r )r r r r �joinr )r r r r r C s z"ScriptDirectory._version_locationsc c sd | j rdd� | jD �}n| jg}x>|D ]6}x0t�|�D ]"}t�| ||�}|d krRq6|V q6W q&W d S )Nc S s g | ]}t j�|�r|�qS r )r r �exists)r! �versr r r r# P s z3ScriptDirectory._load_revisions.<locals>.<listcomp>)r r r r �listdir�Script�_from_filename)r �pathsr& Zfile_�scriptr r r r M s z ScriptDirectory._load_revisionsc C s� |� d�}|dkr t�d��|� d�}|dk r6t|�}|� d�}|rNt�|�}tt�|�|� dt�||� d�dk|� d d �|d �S ) z�Produce a new :class:`.ScriptDirectory` given a :class:`.Config` instance. The :class:`.Config` need only have the ``script_location`` key present. �script_locationNz0No 'script_location' key found in configuration.r r r r �truer zutf-8)r r r r r ) Zget_main_optionr r �int�_split_on_space_comma�splitr r �_default_file_template)�clsZconfigr, r r r r r � from_config\ s$ zScriptDirectory.from_configc c sN y d V W �n< t jk rr } zF|d kr.|j}|d kr<|j}|sDd}|||d� }t�t�|�� W d d }~X Y n� t jk r� } z8|s�d}||p�|j t� |j �d� }t�t�|�� W d d }~X Y n� t j k �r } z&|d kr�d|j }t�t�|�� W d d }~X Y n< t j k �rH } zt�t�| jd �� W d d } ~ X Y nX d S )NzgRequested range %(start)s:%(end)s does not refer to ancestor/descendant revisions along the same branch)�start�endz�Multiple head revisions are present for given argument '%(head_arg)s'; please specify a specific target revision, '<branchname>@%(head_arg)s' to narrow to a specific head, or 'heads' for all heads)Zhead_arg�headsz(Can't locate revision identified by '%s'r )r ZRangeNotAncestorError�lower�upperr Zraise_from_causer r Z MultipleHeadsZargument�format_as_commar6 ZResolutionErrorZ RevisionError�args) r �ancestor�multiple_headsr4 r5 Z resolutionZrnaZmh�re�errr r r �_catch_revision_errors{ s2 z&ScriptDirectory._catch_revision_errors�baser6 c c sB | j ||d��* x"| jj||ddd�D ] }|V q&W W dQ R X dS )a� Iterate through all revisions. :param base: the base revision, or "base" to start from the empty revision. :param head: the head revision; defaults to "heads" to indicate all head revisions. May also be "head" to indicate a single head revision. .. versionchanged:: 0.7.0 the "head" identifier now refers to the head of a non-branched repository only; use "heads" to refer to the set of all head branches simultaneously. )r4 r5 TF)Z inclusiveZassert_relative_lengthN)r? r �iterate_revisions)r r@ �head�revr r r �walk_revisions� s z ScriptDirectory.walk_revisionsc C s | � � � | j�|�S Q R X dS )z�Return the :class:`.Script` instance with the given rev identifier, symbolic name, or sequence of identifiers. .. versionadded:: 0.7.0 N)r? r � get_revisions)r �id_r r r rE � s z ScriptDirectory.get_revisionsc C s | � � � | j�|�S Q R X dS )z�Return the :class:`.Script` instance with the given rev id. .. seealso:: :meth:`.ScriptDirectory.get_revisions` N)r? r � get_revision)r rF r r r rG � s z ScriptDirectory.get_revisionc C s8 | � � � | j�|�\}}W dQ R X |s,dS |d S dS )z[Convert a symbolic revision, i.e. 'head' or 'base', into an actual revision number.Nr )r? r Z_resolve_revision_number)r rF rC Z branch_namer r r �as_revision_number� s z"ScriptDirectory.as_revision_numberc C s | j �||�S )a� Iterate through script revisions, starting at the given upper revision identifier and ending at the lower. The traversal uses strictly the `down_revision` marker inside each migration script, so it is a requirement that upper >= lower, else you'll get nothing back. The iterator yields :class:`.Script` objects. .. seealso:: :meth:`.RevisionMap.iterate_revisions` )r rA )r r8 r7 r r r rA � s z!ScriptDirectory.iterate_revisionsc C s" | j dd�� | j�� S Q R X dS )aG Return the current head revision. If the script directory has multiple heads due to branching, an error is raised; :meth:`.ScriptDirectory.get_heads` should be preferred. :return: a string revision number. .. seealso:: :meth:`.ScriptDirectory.get_heads` z}The script directory has multiple heads (due to branching).Please use get_heads(), or merge the branches using alembic merge.)r< N)r? r �get_current_head)r r r r rI � s z ScriptDirectory.get_current_headc C s t | jj�S )aU Return all "versioned head" revisions as strings. This is normally a list of length one, unless branches are present. The :meth:`.ScriptDirectory.get_current_head()` method can be used normally when a script directory has only one head. :return: a tuple of string revision numbers. )�listr r6 )r r r r � get_heads s zScriptDirectory.get_headsc C s4 | � � }t|�dkr t�d��n|r,|d S dS dS )a# Return the "base" revision as a string. This is the revision number of the script that has a ``down_revision`` of None. If the script directory has multiple bases, an error is raised; :meth:`.ScriptDirectory.get_bases` should be preferred. r z@The script directory has multiple bases. Please use get_bases().r N)� get_basesr r r )r �basesr r r �get_base s zScriptDirectory.get_basec C s t | jj�S )z�return all "base" revisions as strings. This is the revision number of all scripts that have a ``down_revision`` of None. .. versionadded:: 0.7.0 )rJ r rM )r r r r rL % s zScriptDirectory.get_basesc sN � j d|d��6 � jj||dd�}t|�}� fdd�tt|��D �S Q R X d S )NzFDestination %(end)s is not a valid upgrade target from current head(s))r; r5 T)Z implicit_basec s g | ]}t j�� j|��qS r )r � MigrationStepZupgrade_from_scriptr )r! r+ )r r r r# 8 s z1ScriptDirectory._upgrade_revs.<locals>.<listcomp>)r? r rA rJ �reversed)r � destination� current_rev�revsr )r r � _upgrade_revs0 s z ScriptDirectory._upgrade_revsc s: � j d|d��" � j�||�}� fdd�|D �S Q R X d S )NzHDestination %(end)s is not a valid downgrade target from current head(s))r; r5 c s g | ]}t j�� j|��qS r )r rO Zdowngrade_from_scriptr )r! r+ )r r r r# D s z3ScriptDirectory._downgrade_revs.<locals>.<listcomp>)r? r rA )r rQ rR rS r )r r �_downgrade_revs= s z ScriptDirectory._downgrade_revsc C sH | j dd���0 | �|�}| jj||dd�}g }| �|�p>d g}x�|D ]�}|d krj|�dd� |D �� qFn ||krtqFt| j�|g��}t| j�|g��}|�|�r�|�|�r�t �dd� |D �} t � | |j dd�} |� | � qFqF|�|��rd d� |D �} t � | |j dd�} |� | � qFqFt � d |j dd�} |� | � qFqFW |S Q R X d S ) NzCMultiple heads are present; please specify a single target revision)r< T)Zinclude_dependenciesc S s g | ]}t �|jd dd��qS )NFT)r � StampStepr )r! rB r r r r# ] s z/ScriptDirectory._stamp_revs.<locals>.<listcomp>c S s g | ] }|j �qS r )r )r! rB r r r r# o s Fc S s g | ] }|j �qS r )r )r! rB r r r r# w s r )r? rE r Zfilter_for_lineage�extend�setZ_get_descendant_nodesZ_get_ancestor_nodes� intersection�AssertionErrorr rV r �append) r r r6 Zfiltered_headsZstepsZdests�destZ descendantsZ ancestorsZ todo_heads�stepr r r � _stamp_revsI sF zScriptDirectory._stamp_revsc C s t �| jd� dS )z�Run the script environment. This basically runs the ``env.py`` script present in the migration environment. It is called exclusively by the command functions in :mod:`alembic.command`. zenv.pyN)r �load_python_filer )r r r r �run_env� s zScriptDirectory.run_envc C s t j�t j�| jd��S )Nzenv.py)r r r r$ r )r r r r �env_py_location� s z ScriptDirectory.env_py_locationc K s* t jdtj�|� t j||| jf|� d S )Nz Generating %s)r �statusr r r Ztemplate_to_filer )r �srcr\ �kwr r r �_generate_template� s z"ScriptDirectory._generate_templatec C s" t �dtj�|� tj||� d S )Nz Generating %s)r rb r r r �shutil�copy)r rc r\ r r r � _copy_file� s zScriptDirectory._copy_filec C s0 t j�|�}t j�|�s,t�d| t j|� d S )NzCreating directory %s)r r r r% r rb �makedirs)r r r r r �_ensure_directory� s z!ScriptDirectory._ensure_directoryc s$ |dkr d}� j dd�� � j�|�} W dQ R X tt| ��t| �krNt�d��tj�� } |dkr�t� j �dkr�x6| D ] }|dk rtt j � |j �}P qtW t�d��n� j }t j �t j �|��} x.� j D ]} t j �| �| kr�P q�W t�d| ��� jr�� �|� � �|||| �}|�sBx0| D ](}|dk �r|j�st�d |j ���qW |�r~� � � �( d d � � fd d �t�|�D �D �}W dQ R X � jt j �� jd �|ft|�t�tdd� | D ���t� |�t�|�| tj |dk �r�|ndd�| �� t � � |�}|�r|j �st�d|j||j f ��� j�!|� |S )a Generate a new revision file. This runs the ``script.py.mako`` template, given template arguments, and creates a new file. :param revid: String revision id. Typically this comes from ``alembic.util.rev_id()``. :param message: the revision message, the one passed by the -m argument to the ``revision`` command. :param head: the head revision to generate against. Defaults to the current "head" if no branches are present, else raises an exception. .. versionadded:: 0.7.0 :param splice: if True, allow the "head" version to not be an actual head; otherwise, the selected head must be a head (e.g. endpoint) revision. :param refresh: deprecated. NrB z{Multiple heads are present; please specify the head revision on which the new revision should be based, or perform a merge.)r< z"Duplicate head revisions specifiedr zAMultiple version locations present, please specify --version-pathz7Path %s is not represented in current version locationszeRevision %s is not a head revision; please specify --splice to create a new branch from this revisionc S s$ g | ] \}}||j kr|n|j�qS r )� branch_labelsr )r! rC �depr r r r# � s z5ScriptDirectory.generate_revision.<locals>.<listcomp>c s g | ]}� j �|�|f�qS r )r rG )r! rl )r r r r# � s zscript.py.makoc s s | ]}|d k r|j nd V qd S )N)r )r! �hr r r � <genexpr> s z4ScriptDirectory.generate_revision.<locals>.<genexpr>z empty message)Z up_revision� down_revisionrk � depends_on� create_dateZcomma�messagez�Version %s specified branch_labels %s, however the migration file %s does not have them; have you upgraded your script.py.mako to include the 'branch_labels' section?)"r? r rE r rX r r �datetimeZnowr r r �dirnamer �normpathr r rj � _rev_path�is_headr Zto_listre r$ r �strZtuple_rev_as_scalar�tuple�to_tupler9 r( � _from_pathrk Z add_revision)r Zrevidrr rB ZrefreshZsplicerk Z version_pathrp rd r6 rq Z norm_pathZ vers_pathr r+ r )r r �generate_revision� sr z!ScriptDirectory.generate_revisionc C s~ d� t�|pd���� }t|�| jkrD|d | j� �dd�d d }d| j|||j|j |j |j |j |j d� }tj� ||�S )N�_� r r z%s.py)rC �slug�year�month�day�hour�minute�second)r$ �_slug_re�findallr7 r r �rsplitr r� r� r� r� r� r� r r )r r �rev_idrr rq r �filenamer r r rv s zScriptDirectory._rev_path)NNNNN)r@ r6 )NFFNNN)#�__name__� __module__� __qualname__�__doc__r1 r �propertyr r Zmemoized_propertyr r � classmethodr3 r r? rD rE rG rH rA rI rK rN rL rT rU r^ r` ra re rh rj r| rv r r r r r sB % ; or c s� e Zd ZdZ� fdd�ZdZdZedd� �Zedd� �Z ed d � �Z d d � Z ddd�Z ddd�Z dd� Zedd� �Zedd� �Z� ZS )r( z�Represent a single revision file in a ``versions/`` directory. The :class:`.Script` instance is returned by methods such as :meth:`.ScriptDirectory.iterate_revisions`. c sN || _ || _tt| �j||jtjt|dd �dd�tjt|dd �dd�d� d S )Nrk r )�defaultrp )rk � dependencies) �moduler �superr( r ro r rz �getattr)r r� r� r )� __class__r r r 6 s zScript.__init__Nc C s t �d| j�d S )z)Return the docstring given in the script.z r )r= r0 �longdoc)r r r r �docH s z Script.docc C s6 | j j}|r.t| j d�r&|�| j j�}|�� S dS dS )z)Return the docstring given in the script.�_alembic_source_encodingr~ N)r� r� �hasattr�decoder� �strip)r r� r r r r� N s zScript.longdocc C s� d| j | jrdnd| jr dnd| jr(dndf }| jrJ|d| �� f 7 }n|d| �� f 7 }| jrv|dt�| j� 7 }| jr�|d t�| j� 7 }| j r�|d t�| j �f 7 }|d | j f 7 }|d d � dd� | j � � D �� 7 }|S )NzRev: %s%s%s%s z (head)r~ z (branchpoint)z (mergepoint)z Merges: %s z Parent: %s zAlso depends on: %s zBranches into: %s zBranch names: %s z Path: %s z %s � c s s | ]}d | V qdS )z %sNr )r! Zparar r r rn w s z#Script.log_entry.<locals>.<genexpr>)r rw �is_branch_point�is_merge_point�_format_down_revisionr� r r9 Znextrevrk r r$ r� � splitlines)r �entryr r r � log_entryZ s. zScript.log_entryc C s: d| � � | j| jrdnd| jr"dnd| jr.dnd| jf S )Nz%s -> %s%s%s%s, %sz (head)r~ z (branchpoint)z (mergepoint))r� r rw r� r� r� )r r r r �__str__} s zScript.__str__FTc C s� | j }|r<| jr,d| �� t�| j�|f }nd| �� |f }|rZ| jrZ|dt�| j� 7 }|sb|r�|d| jrpdnd| jr�| js�dndf 7 }|r�|d| jr�dnd| j r�d ndf 7 }|r�|d | j 7 }|S ) Nz %s (%s) -> %sz%s -> %sz (%s)z%s%sz (head)r~ z (effective head)z (branchpoint)z (mergepoint)z, %s) r r� r� r r9 rk Z _is_real_headrw r� r� r� )r �include_branches� include_doc�include_parents�tree_indicatorsZhead_indicators�textr r r � _head_only� s. zScript._head_onlyc C s |r | j S | �||||�S d S )N)r� r� )r �verboser� r� r� r� r r r � cmd_format� s zScript.cmd_formatc C s | j s dS t�| j�S d S )Nz<base>)ro r r9 Z_versioned_down_revisions)r r r r r� � s z Script._format_down_revisionc C s t j�|�\}}| �|||�S )N)r r r0 r) )r2 � scriptdirr �dir_r� r r r r{ � s zScript._from_pathc C s� |j rt�|�}n t�|�}|s$d S |�d�}|j rR|�d�dk}|�d�dk}nd }}|sb|r�tj�tj�||��}tj�tj�||d ��} |s�|r�| r�d S t � ||�} t | d�s�t �|�} | s�t � d| ��q�| �d�} n| j} t| | tj�||��S )Nr r �c�oFr z�Could not determine revision id from filename %s. Be sure the 'revision' variable is declared inside the script (please see 'Upgrading from Alembic 0.1 to 0.2' in the documentation).)r �_sourceless_rev_file�match�_only_source_rev_file�groupr r r% r$ r r_ r� � _legacy_revr r r( ) r2 r� r� r� Zpy_matchZ py_filenameZis_cZis_oZ py_existsZ pyc_existsr� �mr r r r r) � s2 zScript._from_filename)FFFTT)FFFT)r� r� r� r� r r� r r� r� r� r� r� r� r� r� r� r{ r) � __classcell__r r )r� r r( - s # r( )rs r r= rf r~ r r r Zruntimer � contextlibr �compiler� r� r� Z _mod_def_rer� r1 r/ �objectr ZRevisionr( r r r r �<module> s*