Microsoft.VisualStudio.LiveShare.Common

Base class that makes it easier to implement IAsyncDisposable.

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. } } }

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

Combine paths and ensure that they have the same slashes (forward\backslash).

Absolute path so that we can determine the type relative path to combine

Normalize a path to always use the forward '/' directory separator when mixing path generated in Windows amd Mac/Linux clients

Normalize a path if not null or empty

Class to use the IProtocolConverter interface by converting values from/to generic protocol objects

Implements IProtocolConverter by converting to a Uri with a scheme

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.

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.