Method parseIncludeComponent

src/parser-includes.ts:254–324

(component: string, gitData: GitData)

    }

    static parseIncludeComponent (component: string, gitData: GitData): ParsedComponent {
        assert(!component.includes("://"), `This GitLab CI configuration is invalid: component: \`${component}\` should not contain protocol`);
        const pattern = /(?<domain>[^/:\s]+)(:(?<port>\d+))?\/(?<projectPath>.+)\/(?<componentName>[^@]+)@(?<ref>.+)/; // https://regexr.com/7v7hm
        const gitRemoteMatch = pattern.exec(component);
        if (gitRemoteMatch?.groups == null) throw new Error(`This is a bug, please create a github issue if this is something you're expecting to work. input: ${component}`);
        const {domain, projectPath, port, componentName, ref} = gitRemoteMatch.groups;
        const isLocalComponent = projectPath === `${gitData.remote.group}/${gitData.remote.project}` && ref === gitData.commit.SHA;
        return {
            _cache: {
                version: undefined,
                effectiveRef: undefined,
                sha: undefined,
            },
            gitData,
            domain,
            port,
            projectPath,
            componentPath: `templates/${componentName}`,
            name: componentName,
            reference: ref,
            get version () {
                if (this._cache.version === undefined) {
                    if (this.isLocal) {
                        this._cache.version = this.gitData.commit.SHA;
                    } else {
                        const semanticVersionRangesPattern = /^\d+(\.\d+)?$/;
                        if (this.reference == "~latest" || semanticVersionRangesPattern.test(this.reference)) {
                            // https://docs.gitlab.com/ci/components/#semantic-version-ranges
                            const stdout = getGitRemoteInfo(this, "--tags");
                            const tags = stdout.split("\n").map(line => line.split("\t")[1].split("/")[2]);
                            const version = resolveSemanticVersionRange(this.reference, tags);
                            assert(version, `This GitLab CI configuration is invalid: component: \`${this.name}\` - The reference (${this.reference}) is invalid`);
                            this._cache.version = version;
                        } else {
                            this._cache.version = null;
                        }
                    }
                }
                return this._cache.version;
            },
            get effectiveRef () {
                if (this._cache.effectiveRef === undefined) {
                    this._cache.effectiveRef = this.version ?? this.reference;
                }
                return this._cache.effectiveRef;
            },
            get sha () {
                if (this._cache.sha === undefined) {
                    if (this.isLocal) {
                        this._cache.sha = this.gitData.commit.SHA;
                    } else if (/^[0-9a-f]{40}$/.test(this.effectiveRef)) {
                        // effectiveRef may already be a sha, if so return it directly
                        this._cache.sha = this.effectiveRef;
                    } else {
                        const stdout = getGitRemoteInfo(this);
                        const lines = stdout.split("\n");
                        // annotated tags: prefer the deref'd commit sha (refs/tags/x^{})
                        const match = lines.find(line => line.endsWith(`refs/tags/${this.effectiveRef}^{}`)) ??