🔧 Move linting from flake8 to ruff (#268)

Author: chrisjsewell

.pre-commit-config.yaml

@@ -33,14 +33,13 @@ repos:
     hooks:
     - id: black
 
-  - repo: https://github.com/PyCQA/flake8
-    rev: 6.0.0
+  - repo: https://github.com/charliermarsh/ruff-pre-commit
+    rev: v0.0.270
     hooks:
-    - id: flake8
-      additional_dependencies: [flake8-bugbear~=22.7]
+    - id: ruff
 
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.2.0
+    rev: v1.3.0
     hooks:
     - id: mypy
       additional_dependencies: [mdurl]

docs/conf.py

@@ -121,7 +121,7 @@ def run_apidoc(app):
         shutil.rmtree(api_folder)
     os.mkdir(api_folder)
 
-    argv = ["-M", "--separate", "-o", api_folder, module_path] + ignore_paths
+    argv = ["-M", "--separate", "-o", api_folder, module_path, *ignore_paths]
 
     apidoc.OPTIONS.append("ignore-module-all")
     apidoc.main(argv)

markdown_it/common/normalize_url.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from collections.abc import Callable
+from contextlib import suppress
 import re
 from urllib.parse import quote, unquote, urlparse, urlunparse  # noqa: F401
 
@@ -21,18 +22,17 @@ def normalizeLink(url: str) -> str:
     """
     parsed = mdurl.parse(url, slashes_denote_host=True)
 
-    if parsed.hostname:
-        # Encode hostnames in urls like:
-        # `http://host/`, `https://host/`, `mailto:user@host`, `//host/`
-        #
-        # We don't encode unknown schemas, because it's likely that we encode
-        # something we shouldn't (e.g. `skype:name` treated as `skype:host`)
-        #
-        if not parsed.protocol or parsed.protocol in RECODE_HOSTNAME_FOR:
-            try:
-                parsed = parsed._replace(hostname=_punycode.to_ascii(parsed.hostname))
-            except Exception:
-                pass
+    # Encode hostnames in urls like:
+    # `http://host/`, `https://host/`, `mailto:user@host`, `//host/`
+    #
+    # We don't encode unknown schemas, because it's likely that we encode
+    # something we shouldn't (e.g. `skype:name` treated as `skype:host`)
+    #
+    if parsed.hostname and (
+        not parsed.protocol or parsed.protocol in RECODE_HOSTNAME_FOR
+    ):
+        with suppress(Exception):
+            parsed = parsed._replace(hostname=_punycode.to_ascii(parsed.hostname))
 
     return mdurl.encode(mdurl.format(parsed))
 
@@ -47,18 +47,17 @@ def normalizeLinkText(url: str) -> str:
     """
     parsed = mdurl.parse(url, slashes_denote_host=True)
 
-    if parsed.hostname:
-        # Encode hostnames in urls like:
-        # `http://host/`, `https://host/`, `mailto:user@host`, `//host/`
-        #
-        # We don't encode unknown schemas, because it's likely that we encode
-        # something we shouldn't (e.g. `skype:name` treated as `skype:host`)
-        #
-        if not parsed.protocol or parsed.protocol in RECODE_HOSTNAME_FOR:
-            try:
-                parsed = parsed._replace(hostname=_punycode.to_unicode(parsed.hostname))
-            except Exception:
-                pass
+    # Encode hostnames in urls like:
+    # `http://host/`, `https://host/`, `mailto:user@host`, `//host/`
+    #
+    # We don't encode unknown schemas, because it's likely that we encode
+    # something we shouldn't (e.g. `skype:name` treated as `skype:host`)
+    #
+    if parsed.hostname and (
+        not parsed.protocol or parsed.protocol in RECODE_HOSTNAME_FOR
+    ):
+        with suppress(Exception):
+            parsed = parsed._replace(hostname=_punycode.to_unicode(parsed.hostname))
 
     # add '%' to exclude list because of https://github.com/markdown-it/markdown-it/issues/720
     return mdurl.decode(mdurl.format(parsed), mdurl.DECODE_DEFAULT_CHARS + "%")

markdown_it/main.py

@@ -4,11 +4,11 @@
 from contextlib import contextmanager
 from typing import Any, Literal, overload
 
-from . import helpers, presets  # noqa F401
-from .common import normalize_url, utils  # noqa F401
-from .parser_block import ParserBlock  # noqa F401
-from .parser_core import ParserCore  # noqa F401
-from .parser_inline import ParserInline  # noqa F401
+from . import helpers, presets
+from .common import normalize_url, utils
+from .parser_block import ParserBlock
+from .parser_core import ParserCore
+from .parser_inline import ParserInline
 from .renderer import RendererHTML, RendererProtocol
 from .rules_core.state_core import StateCore
 from .token import Token

markdown_it/presets/__init__.py

@@ -6,7 +6,7 @@
 js_default = default
 
 
-class gfm_like:
+class gfm_like:  # noqa: N801
     """GitHub Flavoured Markdown (GFM) like.
 
     This adds the linkify, table and strikethrough components to CommmonMark.

markdown_it/renderer.py

@@ -152,19 +152,18 @@ def renderToken(
         if token.block:
             needLf = True
 
-            if token.nesting == 1:
-                if idx + 1 < len(tokens):
-                    nextToken = tokens[idx + 1]
-
-                    if nextToken.type == "inline" or nextToken.hidden:
-                        # Block-level tag containing an inline tag.
-                        #
-                        needLf = False
-
-                    elif nextToken.nesting == -1 and nextToken.tag == token.tag:
-                        # Opening tag + closing tag of the same type. E.g. `<li></li>`.
-                        #
-                        needLf = False
+            if token.nesting == 1 and (idx + 1 < len(tokens)):
+                nextToken = tokens[idx + 1]
+
+                if nextToken.type == "inline" or nextToken.hidden:  # noqa: SIM114
+                    # Block-level tag containing an inline tag.
+                    #
+                    needLf = False
+
+                elif nextToken.nesting == -1 and nextToken.tag == token.tag:
+                    # Opening tag + closing tag of the same type. E.g. `<li></li>`.
+                    #
+                    needLf = False
 
         result += ">\n" if needLf else ">"
 

markdown_it/ruler.py

@@ -30,7 +30,7 @@ class Ruler
 
 
 class StateBase:
-    srcCharCode: tuple[int, ...]
+    srcCharCode: tuple[int, ...]  # noqa: N815
 
     def __init__(self, src: str, md: MarkdownIt, env: EnvType):
         self.src = src

markdown_it/rules_block/fence.py

@@ -38,9 +38,8 @@ def fence(state: StateBlock, startLine: int, endLine: int, silent: bool) -> bool
     params = state.src[pos:maximum]
 
     # /* ` */
-    if marker == 0x60:
-        if chr(marker) in params:
-            return False
+    if marker == 0x60 and chr(marker) in params:
+        return False
 
     # Since start is found, we can report success here in validation mode
     if silent:

markdown_it/rules_block/list.py

@@ -120,14 +120,17 @@ def list_block(state: StateBlock, startLine: int, endLine: int, silent: bool) ->
 
     # limit conditions when list can interrupt
     # a paragraph (validation mode only)
-    if silent and state.parentType == "paragraph":
-        # Next list item should still terminate previous list item
-        #
-        # This code can fail if plugins use blkIndent as well as lists,
-        # but I hope the spec gets fixed long before that happens.
-        #
-        if state.tShift[startLine] >= state.blkIndent:
-            isTerminatingParagraph = True
+    # Next list item should still terminate previous list item
+    #
+    # This code can fail if plugins use blkIndent as well as lists,
+    # but I hope the spec gets fixed long before that happens.
+    #
+    if (
+        silent
+        and state.parentType == "paragraph"
+        and state.tShift[startLine] >= state.blkIndent
+    ):
+        isTerminatingParagraph = True
 
     # Detect list type and position after marker
     posAfterMarker = skipOrderedListMarker(state, startLine)
@@ -149,9 +152,11 @@ def list_block(state: StateBlock, startLine: int, endLine: int, silent: bool) ->
 
     # If we're starting a new unordered list right after
     # a paragraph, first line should not be empty.
-    if isTerminatingParagraph:
-        if state.skipSpaces(posAfterMarker) >= state.eMarks[startLine]:
-            return False
+    if (
+        isTerminatingParagraph
+        and state.skipSpaces(posAfterMarker) >= state.eMarks[startLine]
+    ):
+        return False
 
     # We should terminate list on style change. Remember first one to compare.
     markerCharCode = state.srcCharCode[posAfterMarker - 1]
@@ -209,11 +214,8 @@ def list_block(state: StateBlock, startLine: int, endLine: int, silent: bool) ->
 
         contentStart = pos
 
-        if contentStart >= maximum:
-            # trimming space in "-    \n  3" case, indent is 1 here
-            indentAfterMarker = 1
-        else:
-            indentAfterMarker = offset - initial
+        # trimming space in "-    \n  3" case, indent is 1 here
+        indentAfterMarker = 1 if contentStart >= maximum else offset - initial
 
         # If we have more than 4 spaces, the indent is 1
         # (the rest is just indented code block)

markdown_it/rules_block/reference.py

@@ -153,18 +153,17 @@ def reference(state: StateBlock, startLine: int, _endLine: int, silent: bool) ->
             break
         pos += 1
 
-    if pos < maximum and charCodeAt(string, pos) != 0x0A:
-        if title:
-            # garbage at the end of the line after title,
-            # but it could still be a valid reference if we roll back
-            title = ""
-            pos = destEndPos
-            lines = destEndLineNo
-            while pos < maximum:
-                ch = charCodeAt(string, pos)
-                if not isSpace(ch):
-                    break
-                pos += 1
+    if pos < maximum and charCodeAt(string, pos) != 0x0A and title:
+        # garbage at the end of the line after title,
+        # but it could still be a valid reference if we roll back
+        title = ""
+        pos = destEndPos
+        lines = destEndLineNo
+        while pos < maximum:
+            ch = charCodeAt(string, pos)
+            if not isSpace(ch):
+                break
+            pos += 1
 
     if pos < maximum and charCodeAt(string, pos) != 0x0A:
         # garbage at the end of the line