Microsoft.VisualStudio.LiveShare.Common

Base class that makes it easier to implement IAsyncDisposable.

Determines whether an argument sequence contains a specified element, similar to the "IN" operator in SQL.

The type of the elements of source The value to locate in the sequence A sequence in which to locate a value

Enumerate over and dispose all items that support either or . If both and are supported, prefer . If there is any exception during disposal, trace it as an error event in .

Type of the objects in enumeration. Objects enumeration to dispose. Not null. Trace source to trace exceptions to. Task that completes when all dispose. If or is null.

Helper to ensure that an exception is thrown when certain operations are attempted concurrently.

Throws an exception if a concurrent operation is attempted, rather than waiting for the previous operation to finish. (If a wait is desired, use an ordinary lock / mutex.)

Begins a new guarded operation.

Name of the operation. Defaults to the calling method name. Object that must be disposed when the guarded operation is complete. If another guarded operation currently running. class Example { private readonly ConcurrencyGuard concurrencyGuard = new ConcurrencyGuard(); public void SomeGuardedMethod() { using (concurrencyGuard.StartOperation()) { // Perform the operation without concern for concurrent calls. } } }

Exception that indicates that an operaiton cannot start because a concurrent operation is already running.

Create an instance of .

Exception message.

This function will evaluate given string and it will try to convert it to Uri object. The string could contain URI fragment, IP address and port tuple or just IP address or name. It will return null if parsing fails.

This function returns true if given Host match bypass list. Note, that the list is common for http and https.

Converts string containing user:password to NetworkCredential object

Generates an URL-friendly unique ID

Options for performing IO operation

A delegate that is called when the operation succeeds. The first argument is the total elapsed time for all attempts. The second argument is the number of attempts, including the last successful one. If succeeded on the first attempt, it is 1.

A delegate that is called when the operation fails for the first time. The argument is the elapsed time for the first attempt.

A delegate that determines whether should retry IO operation on exception.

Helper class for performing IO operations with retries

A generic pipe stream that support the producer/consumer pattern

The pipe is thread safe up to one producer and one consumer thread.

Initializes a new instance of .

Cancellation token for the whole stream.

Allows to control if we want to accept Read request without the need to signal the cancellation token

Implements IProtocolConverter by converting to a Uri with a scheme

Create a new instance of vsls: for host

Create a new instance of vsls: .

When provided with a path that is not rooted (e.g. that is relative), it will find the root it's relative to, and return the fully qualified path for the file. If the file is _already_ rooted, it'll make sure that it resolves the actual path through ..\..\.. etc.

Get local file path from protocol (vsls) URI with , and no host. Returns null if it cannot convert the uri or if is null.

Protocol (vsls) URI path, unescaped. Local file full path with Path.DirectorySeparator separators or null.

Try to convert to remote path.

Local file path to convert to remove path. Not null. Unchanged if it is not rooted. Local file path from file: URI from if it cannot be converted to protocol (vsls) URI. Otherwise, unescaped path of the protcol (vsls) URI that was converted from file: URI with .

Well-known restricted operation instances.

Defines the default endpoints for the different Live Share services. The purpose of this class is to ensure consistency between the different Live Share default endpoints based on the Azure environment. This class can be initialized with the core Live Share service endpoint which is used to resolve other endpoints based on the endpoint Azure environment, by default the PROD environment is used.

Standard Live Share endpoint URIs.

Ctr to initialize endpoints from the core Live Share service endpoint.

The core Live Share endoint. If specified, it is used to resolve the Azure environment and other service endpoints. when true, the specified endpoint can be different from the well-known Live Share service endpoints.

Ctr that allows for custom service endpoints.

The core Live Share endpoint The authentication token service endpoint The authentication token audience This constructor should be used with care, only when endpoints cannot be resolved from the core Live Share endpoint.

test ctr.

The Azure environment the endpoint is deployed to.

The default set of endpoints.

Determines whether an endpoint with schema and/or host different from the predefined Live Share endpoints is allowed.

Initializes service endpoints.

The core Live Share endpoint The authentication token service endpoint The authentication token audience When true, service endpoints can have non-standard Live Share values. When true, the class can be reinitialized. An exception is thrown when false and reinitialization is attempted. Endpoints are resolved from the core Live Share service Azure environment, when not specified, Prod is assumed. Custom endpoints can be specified when the property has been set to true, otherwise an exception is thrown when any of the endpoints resolve to a different value; this is to ensure service compatibility. This method is not thread-safe.

Determines whether the specified endpoint is a default Live Share endoint.

Determines whether the specified endpoint is deployed in the specified Azure environment.

Determines whether the specified Uri represents a valid Live Share endpoint.

The core Live Share service endpoint.

The token exchange service endpoint.

The token exchange service audience.

A collection of file system path analysis and manipulation functions.

Generates an absolute path from a base path and another path.

An absolute path to use as the root if is relative. IMPORTANT: if basePath is a directory, it must end with a directory separator character or else it will be treated like a filename and discarded. A relative or absolute path, that needs to be absolute. Thrown when the argument is not an absolute path. A normalized, absolute path. A path with relative parents (i.e. c:\temp\tmp\..\a.txt) will never be returned. Not necessarily canonical, in that the file casing of the path is not guaranteed to be consistent.

given the absolute location of a file, and a disc location, returns relative file path to that disk location.

The base path we want to relativize to. Must be absolute. Should not include a filename as the last segment will be interpreted as a directory. The path we need to make relative to basePath. The path can be either absolute path or a relative path in which case it is relative to the base path The relative path (can be the full path when no relationship exists). If and are equivalent, the empty string is returned.

Make sure there is no [unnecessary] trailing directory separator.

directory path directory path without trailing slash

Make sure there is a trailing directory separator.

directory path Directory separator char directory path with trailing slash

Detects whether a given file falls within a given directory.

The absolute, normalized path to the directory. The absolute, normalized path to the file. true if the given file falls within the given directory. The current implementation of this method does NOT normalize the paths before the check.

Tests a path to see if it is absolute or not. More reliable that Path.IsPathRooted.

The path to check. true if the path is rooted; false otherwise.

Check if path is a directory

The path to check true if the path is a directory

Gets the correctly cased path for a given directory.

Directory to find the correct casing for. New directory with correctly cased path.

Verify a valid path

The path to verify True if a valid path

A few fast checks that determine whether normalization of a path is warranted.

A non-empty path. true if normalization is likely needed; false if normalization doesn't appear to be needed. In the interest of executing very fast (since this method is used in fast-or-slow-path checks) this method by no means is comprehensive, but it should catch the common causes for needing normalization.

Helper function to create Uri object form path.

path string uri object

Fixes common problems with local paths like double-backslash.

The path to fix up. The cleaned up path.

Creates a new trace source with pre-configured console and log-file trace listeners, suitable for use with a console app.

Name of the trace source, and log file suffix. Verbosity level of console trace filtering, if overriding the default. Optional enumeration of event ids that go to console unfiltered, ignoring console verbosity.