o s@sdZddlmZddlmZddlmZddlZddlmZddlmZddl m Z dd l m Z ddl Z dd lmZGd d d eZd dZdS)zKContains utilities for comparing RELEASE_NOTES between Cloud SDK versions. )absolute_import)division)unicode_literalsN)config)log)render_document) installers)StringIOc@sFeZdZdZdZdZedddZddZd d Z d d Z d dZ dS) ReleaseNotesaRepresents a parsed RELEASE_NOTES file. The file should have the general structure of: # Google Cloud SDK - Release Notes Copyright 2014-2015 Google LLC. All rights reserved. ## 0.9.78 (2015/09/16) * Note * Note 2 ## 0.9.77 (2015/09/09) * Note 3 z6(?<=\n)\n## +(?P\S+).*\n(?:\n.*(?!\n\n## ))+.NcCsjzt||}|durWdS|j}|tjjkrWdS||jWSty4tj dj |dddYdSw)aParses release notes from the given URL using the requests library. Any error in downloading or parsing release notes is logged and swallowed and None is returned. Args: url: str, The URL to download and parse. command_path: str, The command that is calling this for instrumenting the user agent for the download. Returns: ReleaseNotes, the parsed release notes or None if an error occurred. NzFailed to download [{url}])urlT)exc_info) r MakeRequest status_coderequestscodesoktext Exceptionrdebugformat)clsr command_pathresponsecoderF/tmp/google-cloud-sdk/lib/googlecloudsdk/core/updater/release_notes.pyFromURLAs    zReleaseNotes.FromURLcCsN|dd|_g}ttj|jD]}||d|fq||_ dS)zParse the release notes from the given text. Args: text: str, The text of the release notes to parse. Returns: ReleaseNotes, the parsed release notes. z  versionN) replace_textrefinditerr _VERSION_SPLIT_REGEXappendgroupstrip _versions)selfrversionsmrrr__init__`s   zReleaseNotes.__init__cCs$||}|dur dS|j|dS)zGets the release notes text for the given version. Args: version: str, The version to get the release notes for. Returns: str, The release notes or None if the version does not exist. N)_GetVersionIndexr()r)rindexrrrGetVersionTextss zReleaseNotes.GetVersionTextcCs,t|jD]\}\}}||kr|SqdS)zGets the index of the given version in the list of parsed versions. Args: version: str, The version to get the index for. Returns: int, The index of the given version or None if not found. N) enumerater()r)riv_rrrr.s  zReleaseNotes._GetVersionIndexcCsT|r||}|dur dSnd}|r||}|durdSnt|j}|j||S)a Creates a diff of the release notes between the two versions. The release notes are returned in reversed order (most recent first). Args: start_version: str, The version at which to start the diff. This should be the later of the two versions. The diff will start with this version and go backwards in time until end_version is hit. If None, the diff will start at the most recent entry. end_version: str, The version at which to stop the diff. This should be the version you are currently on. The diff is accumulated until this version it hit. This version is not included in the diff. If None, the diff will include through the end of all release notes. Returns: [(version, text)], The list of release notes in the diff from most recent to least recent. Each item is a tuple of the version string and the release notes text for that version. Returns None if either of the versions are not present in the release notes. Nr)r.lenr()r) start_version end_version start_index end_indexrrrDiffs   zReleaseNotes.Diff)N) __name__ __module__ __qualname____doc__r$MAX_DIFF classmethodrr,r0r.r:rrrrr "s  r cCs|r|r|rt|}|r|||}nd}nd}|s(tjdtjj dSt |tj kr __future__rrrr"googlecloudsdk.corerr&googlecloudsdk.core.document_renderersrgooglecloudsdk.core.updaterrr six.movesr objectr rMrrrrs