summaryrefslogtreecommitdiff
path: root/chromium/tools/md_browser/gitiles_autolink.py
blob: eb77ebb51d58be7d0a2889ae22f8e0b6ca3604f9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# Copyright 2017 The Chromium Authors. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.

"""Implements Gitiles' simpler auto linking.

This extention auto links basic URLs that aren't bracketed by <...>.

https://gerrit.googlesource.com/gitiles/+/master/java/com/google/gitiles/Linkifier.java
"""

from markdown.inlinepatterns import (AutolinkPattern, Pattern)
from markdown.extensions import Extension


# Best effort attempt to match URLs without matching past the end of the URL.
# The first "[]" is copied from Linkifier.java (safe, reserved, and unsafe
# characters). The second "[]" is similar to the first, but with English
# punctuation removed, since the gitiles parser treats these as punction in the
# sentence, rather than the final character of the URL.
AUTOLINK_RE = (r'(https?://[a-zA-Z0-9$_.+!*\',%;:@=?#/~<>-]+'
               r'[a-zA-Z0-9$_+*\'%@=#/~<-])')


class _GitilesSmartQuotesExtension(Extension):
  """Add Gitiles' simpler linkifier to Markdown."""
  def extendMarkdown(self, md, md_globals):
    md.inlinePatterns.add('gitilesautolink',
                          AutolinkPattern(AUTOLINK_RE, md),
                          '<autolink')


def makeExtension(*args, **kwargs):
  return _GitilesSmartQuotesExtension(*args, **kwargs)