feat: Add link ansi wrapper

[Luckey-Elijah]

Description

Add an ANSI wrapper that enables hyperlinks/links in the terminal. More info at this Gist on how to achieve the desired effect.

I've done this in one of my projects, but I think it might server others as well.

Requirements

• API to "wrap" a string with a link for stdout.

Additional Context

An example API:

Future<void> main() async {
  Logger(level: Level.verbose).info(
    linkWrap(
      'You can find issues here',
      'https://github.com/felangel/mason/issues/',
    ),
  );
}

String linkWrap(String message, String link) {
  final uri = '\x1B]8;;$link\x1B\\';
  final text = '$message\x1B]8;;\x1B\\';
  return '$uri$text';
}

[Luckey-Elijah]

@felangel would you accept a PR for this feature? If so, feel free to assign to me

[felangel]

@felangel would you accept a PR for this feature? If so, feel free to assign to me

Yes, I'd love to add this 👍

[Luckey-Elijah]

I don't think using AnsiCode will work with it's wrap method since it doesn't take a second parameter for something like a "link".

I like to propose a top-level function link, a method on the Logger, or a new class for this (similar to AnsiCode).

The top-level function link or a link method on Logger would make the most sense. A new class just for wrapping a message with link is a bit overkill.

// "wraps" given string with a link, then returns the value
String linkWrap(String message, Uri uri) { ... }

void main() {
  final logger = Logger(level: Level.verbose);
  final issuesLink = linkWrap(
    'see issues here',
    Uri.parse('https://github.com/felangel/mason/issues/'),
  );
  logger
    ..info(issuesLink)
    ..warn(issuesLink)
    ..err(issuesLink);
}

class Logger {
  void link(
    String message,
    Uri uri, [
    void Function(String)? write,  // uses [info] by default
  ]) { ... }
}

void main() {
  final logger = Logger(level: Level.verbose);
  final issuesUri = Uri.parse('https://github.com/felangel/mason/issues/');
  logger
    ..link('see issues here', issuesUri)
    ..link('see issues here', issuesUri, logger.err)
    ..link('see issues here', issuesUri, logger.warn);
}

Woth implementations would be identical in output:

Personally I like Logger.link interface the most