src/vs/platform/agentHost/node/gitDiffContent.ts

75 LOC · 71 covered · 4 uncovered · 11 ranges · 983 concepts · 7 introducers · 533 tests

File neighbourhood

The centred file is linked to every concept that introduces one of its ranges, every test that runs code from the file, and the gray connector concepts standing between those tests and the file's own introducer concepts. Undirected links join concepts to every file where they introduce source and concepts to the tests they introduce; arrows show specialization between the displayed concepts and bridge only concepts omitted from this view. Concept colors match the source ranges below; connector concepts have no source color and are shown in gray.

Focused file, its introducer and connector concepts, their introduced files, and tests that run code from the file

In the embedded map, ordinary wheel input scrolls the page; use the visible controls to zoom and drag to pan. Open the full-screen map for canvas navigation: wheel pans, Ctrl/Command plus wheel zooms, and arrow keys pan when this region is focused. On touch screens, open the full-screen map to pan or pinch. If JavaScript or WebGL is unavailable, use the related-file, concept, and source links on this page.

Graph controls are ready.

Interactive rendering requires JavaScript and WebGL. Use the related-file, concept, and source links on this page while the interactive map is unavailable.

1 > /*--------------------------------------------------------------------------------------------- gitDiffContent.ts ×2
2 > * Copyright (c) Microsoft Corporation. All rights reserved.
3 > * Licensed under the MIT License. See License.txt in the project root for license information.
4 > *--------------------------------------------------------------------------------------------*/
5 >
6 > import { URI } from '../../../base/common/uri.js';
7 >
8 > const GIT_BLOB_SCHEME = 'git-blob';
9 >
10 > interface IGitBlobUriQuery {
11 > readonly sessionUri: string;
12 > readonly sha: string;
13 > readonly repoRelativePath: string;
14 > }
15 >
16 > /**
17 > * Builds a `git-blob:` URI that references a file blob at a specific git
18 > * commit, scoped to a given session. Resolved by reading the session's
19 > * working directory and shelling out to `git show <sha>:<path>`.
20 > *
21 > * The URI path is the absolute working-tree path so resource labels show a
22 > * recognizable file path and so the "before" side lines up with the
23 > * working-tree "after" side in diff editors. The session URI, SHA, and
24 > * repository-relative path needed to fetch the blob are carried in the
25 > * query.
26 > *
27 > * @param sessionUri Session the blob belongs to; used to find the working
28 > * directory.
29 > * @param sha Git commit/ref the blob is read from.
30 > * @param repoRelativePath Repository-relative path passed to `git show`.
31 > * @param absolutePath Absolute working-tree path used as the display path.
32 > */
33 > export function buildGitBlobUri(sessionUri: string, sha: string, repoRelativePath: string, absolutePath: string): string {
34 > return URI.from({ gitDiffContent.ts ×1
35 > scheme: GIT_BLOB_SCHEME,
36 > path: absolutePath,
37 > query: JSON.stringify({ sessionUri, sha, repoRelativePath } satisfies IGitBlobUriQuery),
38 > }).toString();
39 > }
41 > /** Parsed fields from a `git-blob:` content URI. */
42 > export interface IGitBlobUriFields {
43 > readonly sessionUri: string;
44 > readonly sha: string;
45 > readonly repoRelativePath: string;
46 > }
47 >
48 > /**
49 > * Parses a `git-blob:` URI produced by {@link buildGitBlobUri}.
50 > * Returns `undefined` if the URI is not a valid `git-blob:` URI.
51 > */
52 > export function parseGitBlobUri(raw: string): IGitBlobUriFields | undefined {
53 > let parsed: URI; gitDiffContent.ts ×4
54 > try {
55 > parsed = URI.parse(raw);
56 > } catch {
57 return undefined;
58 }
59 > if (parsed.scheme !== GIT_BLOB_SCHEME || !parsed.query) { gitDiffContent.ts ×4
60 > return undefined; gitDiffContent.ts ×1
61 > }
63 > const query = JSON.parse(parsed.query) as Partial<IGitBlobUriQuery>;
64 > if (typeof query.sessionUri === 'string' && typeof query.sha === 'string' && typeof query.repoRelativePath === 'string') { gitDiffContent.ts ×4
65 > return { gitDiffContent.ts ×1
66 > sessionUri: query.sessionUri,
67 > sha: query.sha,
68 > repoRelativePath: query.repoRelativePath,
69 > };
70 > }
71 > } catch { gitDiffContent.ts ×4
72 return undefined;
73 }
74 > return undefined; gitDiffContent.ts ×1
75 > }