go.chromium.org/luci@v0.0.0-20240309015107-7cdc2e660f33/milo/ui/src/common/api/app_version/app_version.ts (about)

     1  // Copyright 2023 The LUCI Authors.
     2  //
     3  // Licensed under the Apache License, Version 2.0 (the "License");
     4  // you may not use this file except in compliance with the License.
     5  // You may obtain a copy of the License at
     6  //
     7  //      http://www.apache.org/licenses/LICENSE-2.0
     8  //
     9  // Unless required by applicable law or agreed to in writing, software
    10  // distributed under the License is distributed on an "AS IS" BASIS,
    11  // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    12  // See the License for the specific language governing permissions and
    13  // limitations under the License.
    14  
    15  const APP_VERSION_RE = /^(\d+)-([0-9a-f]+)(-.+)?$/;
    16  
    17  export interface ParsedAppVersion {
    18    readonly num: number;
    19    readonly hash: string;
    20  }
    21  
    22  /**
    23   * Parse the version string with the format of `APP_VERSION_RE`.
    24   *
    25   * If the version string is invalid, return null.
    26   */
    27  export function parseAppVersion(version: string): ParsedAppVersion | null {
    28    const match = version.match(APP_VERSION_RE);
    29    if (!match) {
    30      return null;
    31    }
    32  
    33    const [, num, hash] = match;
    34    return {
    35      num: Number(num),
    36      hash,
    37    };
    38  }