diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..21c125c
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2024 Justin Myers for Adafruit Industries
+#
+# SPDX-License-Identifier: Unlicense
+
+.py text eol=lf
+.rst text eol=lf
+.txt text eol=lf
+.yaml text eol=lf
+.toml text eol=lf
+.license text eol=lf
+.md text eol=lf
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 70ade69..ff19dde 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -1,42 +1,21 @@
-# SPDX-FileCopyrightText: 2020 Diego Elio Pettenò
+# SPDX-FileCopyrightText: 2024 Justin Myers for Adafruit Industries
 #
 # SPDX-License-Identifier: Unlicense
 
 repos:
-  - repo: https://github.com/python/black
-    rev: 23.3.0
-    hooks:
-      - id: black
-  - repo: https://github.com/fsfe/reuse-tool
-    rev: v1.1.2
-    hooks:
-      - id: reuse
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.4.0
+    rev: v4.5.0
     hooks:
       - id: check-yaml
       - id: end-of-file-fixer
       - id: trailing-whitespace
-  - repo: https://github.com/pycqa/pylint
-    rev: v2.17.4
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.3.4
     hooks:
-      - id: pylint
-        name: pylint (library code)
-        types: [python]
-        args:
-          - --disable=consider-using-f-string
-        exclude: "^(docs/|examples/|tests/|setup.py$)"
-      - id: pylint
-        name: pylint (example code)
-        description: Run pylint rules on "examples/*.py" files
-        types: [python]
-        files: "^examples/"
-        args:
-          - --disable=missing-docstring,invalid-name,consider-using-f-string,duplicate-code
-      - id: pylint
-        name: pylint (test code)
-        description: Run pylint rules on "tests/*.py" files
-        types: [python]
-        files: "^tests/"
-        args:
-          - --disable=missing-docstring,consider-using-f-string,duplicate-code
+      - id: ruff-format
+      - id: ruff
+        args: ["--fix"]
+  - repo: https://github.com/fsfe/reuse-tool
+    rev: v3.0.1
+    hooks:
+      - id: reuse
diff --git a/.pylintrc b/.pylintrc
deleted file mode 100644
index f945e92..0000000
--- a/.pylintrc
+++ /dev/null
@@ -1,399 +0,0 @@
-# SPDX-FileCopyrightText: 2017 Scott Shawcroft, written for Adafruit Industries
-#
-# SPDX-License-Identifier: Unlicense
-
-[MASTER]
-
-# A comma-separated list of package or module names from where C extensions may
-# be loaded. Extensions are loading into the active Python interpreter and may
-# run arbitrary code
-extension-pkg-whitelist=
-
-# Add files or directories to the ignore-list. They should be base names, not
-# paths.
-ignore=CVS
-
-# Add files or directories matching the regex patterns to the ignore-list. The
-# regex matches against base names, not paths.
-ignore-patterns=
-
-# Python code to execute, usually for sys.path manipulation such as
-# pygtk.require().
-#init-hook=
-
-# Use multiple processes to speed up Pylint.
-jobs=1
-
-# List of plugins (as comma separated values of python modules names) to load,
-# usually to register additional checkers.
-load-plugins=pylint.extensions.no_self_use
-
-# Pickle collected data for later comparisons.
-persistent=yes
-
-# Specify a configuration file.
-#rcfile=
-
-# Allow loading of arbitrary C extensions. Extensions are imported into the
-# active Python interpreter and may run arbitrary code.
-unsafe-load-any-extension=no
-
-
-[MESSAGES CONTROL]
-
-# Only show warnings with the listed confidence levels. Leave empty to show
-# all. Valid levels: HIGH, INFERENCE, INFERENCE_FAILURE, UNDEFINED
-confidence=
-
-# Disable the message, report, category or checker with the given id(s). You
-# can either give multiple identifiers separated by comma (,) or put this
-# option multiple times (only on the command line, not in the configuration
-# file where it should appear only once).You can also use "--disable=all" to
-# disable everything first and then reenable specific checks. For example, if
-# you want to run only the similarities checker, you can use "--disable=all
-# --enable=similarities". If you want to run only the classes checker, but have
-# no Warning level messages displayed, use"--disable=all --enable=classes
-# --disable=W"
-# disable=import-error,raw-checker-failed,bad-inline-option,locally-disabled,file-ignored,suppressed-message,useless-suppression,deprecated-pragma,deprecated-str-translate-call
-disable=raw-checker-failed,bad-inline-option,locally-disabled,file-ignored,suppressed-message,useless-suppression,deprecated-pragma,import-error,pointless-string-statement,unspecified-encoding
-
-# Enable the message, report, category or checker with the given id(s). You can
-# either give multiple identifier separated by comma (,) or put this option
-# multiple time (only on the command line, not in the configuration file where
-# it should appear only once). See also the "--disable" option for examples.
-enable=
-
-
-[REPORTS]
-
-# Python expression which should return a note less than 10 (10 is the highest
-# note). You have access to the variables errors warning, statement which
-# respectively contain the number of errors / warnings messages and the total
-# number of statements analyzed. This is used by the global evaluation report
-# (RP0004).
-evaluation=10.0 - ((float(5 * error + warning + refactor + convention) / statement) * 10)
-
-# Template used to display messages. This is a python new-style format string
-# used to format the message information. See doc for all details
-#msg-template=
-
-# Set the output format. Available formats are text, parseable, colorized, json
-# and msvs (visual studio).You can also give a reporter class, eg
-# mypackage.mymodule.MyReporterClass.
-output-format=text
-
-# Tells whether to display a full report or only the messages
-reports=no
-
-# Activate the evaluation score.
-score=yes
-
-
-[REFACTORING]
-
-# Maximum number of nested blocks for function / method body
-max-nested-blocks=5
-
-
-[LOGGING]
-
-# Logging modules to check that the string format arguments are in logging
-# function parameter format
-logging-modules=logging
-
-
-[SPELLING]
-
-# Spelling dictionary name. Available dictionaries: none. To make it working
-# install python-enchant package.
-spelling-dict=
-
-# List of comma separated words that should not be checked.
-spelling-ignore-words=
-
-# A path to a file that contains private dictionary; one word per line.
-spelling-private-dict-file=
-
-# Tells whether to store unknown words to indicated private dictionary in
-# --spelling-private-dict-file option instead of raising a message.
-spelling-store-unknown-words=no
-
-
-[MISCELLANEOUS]
-
-# List of note tags to take in consideration, separated by a comma.
-# notes=FIXME,XXX,TODO
-notes=FIXME,XXX
-
-
-[TYPECHECK]
-
-# List of decorators that produce context managers, such as
-# contextlib.contextmanager. Add to this list to register other decorators that
-# produce valid context managers.
-contextmanager-decorators=contextlib.contextmanager
-
-# List of members which are set dynamically and missed by pylint inference
-# system, and so shouldn't trigger E1101 when accessed. Python regular
-# expressions are accepted.
-generated-members=
-
-# Tells whether missing members accessed in mixin class should be ignored. A
-# mixin class is detected if its name ends with "mixin" (case insensitive).
-ignore-mixin-members=yes
-
-# This flag controls whether pylint should warn about no-member and similar
-# checks whenever an opaque object is returned when inferring. The inference
-# can return multiple potential results while evaluating a Python object, but
-# some branches might not be evaluated, which results in partial inference. In
-# that case, it might be useful to still emit no-member and other checks for
-# the rest of the inferred objects.
-ignore-on-opaque-inference=yes
-
-# List of class names for which member attributes should not be checked (useful
-# for classes with dynamically set attributes). This supports the use of
-# qualified names.
-ignored-classes=optparse.Values,thread._local,_thread._local
-
-# List of module names for which member attributes should not be checked
-# (useful for modules/projects where namespaces are manipulated during runtime
-# and thus existing member attributes cannot be deduced by static analysis. It
-# supports qualified module names, as well as Unix pattern matching.
-ignored-modules=board
-
-# Show a hint with possible names when a member name was not found. The aspect
-# of finding the hint is based on edit distance.
-missing-member-hint=yes
-
-# The minimum edit distance a name should have in order to be considered a
-# similar match for a missing member name.
-missing-member-hint-distance=1
-
-# The total number of similar names that should be taken in consideration when
-# showing a hint for a missing member.
-missing-member-max-choices=1
-
-
-[VARIABLES]
-
-# List of additional names supposed to be defined in builtins. Remember that
-# you should avoid to define new builtins when possible.
-additional-builtins=
-
-# Tells whether unused global variables should be treated as a violation.
-allow-global-unused-variables=yes
-
-# List of strings which can identify a callback function by name. A callback
-# name must start or end with one of those strings.
-callbacks=cb_,_cb
-
-# A regular expression matching the name of dummy variables (i.e. expectedly
-# not used).
-dummy-variables-rgx=_+$|(_[a-zA-Z0-9_]*[a-zA-Z0-9]+?$)|dummy|^ignored_|^unused_
-
-# Argument names that match this expression will be ignored. Default to name
-# with leading underscore
-ignored-argument-names=_.*|^ignored_|^unused_
-
-# Tells whether we should check for unused import in __init__ files.
-init-import=no
-
-# List of qualified module names which can have objects that can redefine
-# builtins.
-redefining-builtins-modules=six.moves,future.builtins
-
-
-[FORMAT]
-
-# Expected format of line ending, e.g. empty (any line ending), LF or CRLF.
-# expected-line-ending-format=
-expected-line-ending-format=LF
-
-# Regexp for a line that is allowed to be longer than the limit.
-ignore-long-lines=^\s*(# )?<?https?://\S+>?$
-
-# Number of spaces of indent required inside a hanging  or continued line.
-indent-after-paren=4
-
-# String used as indentation unit. This is usually "    " (4 spaces) or "\t" (1
-# tab).
-indent-string='    '
-
-# Maximum number of characters on a single line.
-max-line-length=100
-
-# Maximum number of lines in a module
-max-module-lines=1000
-
-# Allow the body of a class to be on the same line as the declaration if body
-# contains single statement.
-single-line-class-stmt=no
-
-# Allow the body of an if to be on the same line as the test if there is no
-# else.
-single-line-if-stmt=no
-
-
-[SIMILARITIES]
-
-# Ignore comments when computing similarities.
-ignore-comments=yes
-
-# Ignore docstrings when computing similarities.
-ignore-docstrings=yes
-
-# Ignore imports when computing similarities.
-ignore-imports=yes
-
-# Minimum lines number of a similarity.
-min-similarity-lines=12
-
-
-[BASIC]
-
-# Regular expression matching correct argument names
-argument-rgx=(([a-z][a-z0-9_]{2,30})|(_[a-z0-9_]*))$
-
-# Regular expression matching correct attribute names
-attr-rgx=(([a-z][a-z0-9_]{2,30})|(_[a-z0-9_]*))$
-
-# Bad variable names which should always be refused, separated by a comma
-bad-names=foo,bar,baz,toto,tutu,tata
-
-# Regular expression matching correct class attribute names
-class-attribute-rgx=([A-Za-z_][A-Za-z0-9_]{2,30}|(__.*__))$
-
-# Regular expression matching correct class names
-# class-rgx=[A-Z_][a-zA-Z0-9]+$
-class-rgx=[A-Z_][a-zA-Z0-9_]+$
-
-# Regular expression matching correct constant names
-const-rgx=(([A-Z_][A-Z0-9_]*)|(__.*__))$
-
-# Minimum line length for functions/classes that require docstrings, shorter
-# ones are exempt.
-docstring-min-length=-1
-
-# Regular expression matching correct function names
-function-rgx=(([a-z][a-z0-9_]{2,30})|(_[a-z0-9_]*))$
-
-# Good variable names which should always be accepted, separated by a comma
-# good-names=i,j,k,ex,Run,_
-good-names=r,g,b,w,i,j,k,n,x,y,z,ex,ok,Run,_
-
-# Include a hint for the correct naming format with invalid-name
-include-naming-hint=no
-
-# Regular expression matching correct inline iteration names
-inlinevar-rgx=[A-Za-z_][A-Za-z0-9_]*$
-
-# Regular expression matching correct method names
-method-rgx=(([a-z][a-z0-9_]{2,30})|(_[a-z0-9_]*))$
-
-# Regular expression matching correct module names
-module-rgx=(([a-z_][a-z0-9_]*)|([A-Z][a-zA-Z0-9]+))$
-
-# Colon-delimited sets of names that determine each other's naming style when
-# the name regexes allow several styles.
-name-group=
-
-# Regular expression which should only match function or class names that do
-# not require a docstring.
-no-docstring-rgx=^_
-
-# List of decorators that produce properties, such as abc.abstractproperty. Add
-# to this list to register other decorators that produce valid properties.
-property-classes=abc.abstractproperty
-
-# Regular expression matching correct variable names
-variable-rgx=(([a-z][a-z0-9_]{2,30})|(_[a-z0-9_]*))$
-
-
-[IMPORTS]
-
-# Allow wildcard imports from modules that define __all__.
-allow-wildcard-with-all=no
-
-# Analyse import fallback blocks. This can be used to support both Python 2 and
-# 3 compatible code, which means that the block might have code that exists
-# only in one or another interpreter, leading to false positives when analysed.
-analyse-fallback-blocks=no
-
-# Deprecated modules which should not be used, separated by a comma
-deprecated-modules=optparse,tkinter.tix
-
-# Create a graph of external dependencies in the given file (report RP0402 must
-# not be disabled)
-ext-import-graph=
-
-# Create a graph of every (i.e. internal and external) dependencies in the
-# given file (report RP0402 must not be disabled)
-import-graph=
-
-# Create a graph of internal dependencies in the given file (report RP0402 must
-# not be disabled)
-int-import-graph=
-
-# Force import order to recognize a module as part of the standard
-# compatibility libraries.
-known-standard-library=
-
-# Force import order to recognize a module as part of a third party library.
-known-third-party=enchant
-
-
-[CLASSES]
-
-# List of method names used to declare (i.e. assign) instance attributes.
-defining-attr-methods=__init__,__new__,setUp
-
-# List of member names, which should be excluded from the protected access
-# warning.
-exclude-protected=_asdict,_fields,_replace,_source,_make
-
-# List of valid names for the first argument in a class method.
-valid-classmethod-first-arg=cls
-
-# List of valid names for the first argument in a metaclass class method.
-valid-metaclass-classmethod-first-arg=mcs
-
-
-[DESIGN]
-
-# Maximum number of arguments for function / method
-max-args=5
-
-# Maximum number of attributes for a class (see R0902).
-# max-attributes=7
-max-attributes=11
-
-# Maximum number of boolean expressions in a if statement
-max-bool-expr=5
-
-# Maximum number of branch for function / method body
-max-branches=12
-
-# Maximum number of locals for function / method body
-max-locals=15
-
-# Maximum number of parents for a class (see R0901).
-max-parents=7
-
-# Maximum number of public methods for a class (see R0904).
-max-public-methods=20
-
-# Maximum number of return / yield for function / method body
-max-returns=6
-
-# Maximum number of statements in function / method body
-max-statements=50
-
-# Minimum number of public methods for a class (see R0903).
-min-public-methods=1
-
-
-[EXCEPTIONS]
-
-# Exceptions that will emit a warning when being caught. Defaults to
-# "Exception"
-overgeneral-exceptions=builtins.Exception
diff --git a/README.rst b/README.rst
index b367984..606ca76 100644
--- a/README.rst
+++ b/README.rst
@@ -17,9 +17,9 @@ Introduction
     :alt: Build Status
 
 
-.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
-    :target: https://github.com/psf/black
-    :alt: Code Style: Black
+.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
+    :target: https://github.com/astral-sh/ruff
+    :alt: Code Style: Ruff
 
 Templating engine to substitute variables into a template string. Templates can also include conditional logic and loops. Often used for web pages.
 
diff --git a/adafruit_templateengine.py b/adafruit_templateengine.py
index 90a3eaf..02ad530 100644
--- a/adafruit_templateengine.py
+++ b/adafruit_templateengine.py
@@ -42,7 +42,7 @@
     del implementation
 
 
-class Token:  # pylint: disable=too-few-public-methods
+class Token:
     """Stores a token with its position in a template."""
 
     def __init__(self, template: str, start_position: int, end_position: int):
@@ -99,26 +99,16 @@ def _underline_token_in_template(
             )
 
             if 0 < top_skipped_lines:
-                top_skipped_lines_message = cls._skipped_lines_message(
-                    top_skipped_lines
-                )
-                template_before_token = (
-                    f"{top_skipped_lines_message}\n{template_before_token}"
-                )
+                top_skipped_lines_message = cls._skipped_lines_message(top_skipped_lines)
+                template_before_token = f"{top_skipped_lines_message}\n{template_before_token}"
 
         template_after_token = token.template[token.end_position :]
         if bottom_skipped_lines := template_after_token.count("\n") - lines_around:
-            template_after_token = "\n".join(
-                template_after_token.split("\n")[: (lines_around + 1)]
-            )
+            template_after_token = "\n".join(template_after_token.split("\n")[: (lines_around + 1)])
 
             if 0 < bottom_skipped_lines:
-                bottom_skipped_lines_message = cls._skipped_lines_message(
-                    bottom_skipped_lines
-                )
-                template_after_token = (
-                    f"{template_after_token}\n{bottom_skipped_lines_message}"
-                )
+                bottom_skipped_lines_message = cls._skipped_lines_message(bottom_skipped_lines)
+                template_after_token = f"{template_after_token}\n{bottom_skipped_lines_message}"
 
         lines_before_line_with_token = template_before_token.rsplit("\n", 1)[0]
 
@@ -204,9 +194,7 @@ def _replace_amp_or_semi(match: re.Match):
 _BLOCK_PATTERN = re.compile(r"{% block \w+? %}")
 _INCLUDE_PATTERN = re.compile(r"{% include '.+?' %}|{% include \".+?\" %}")
 _HASH_COMMENT_PATTERN = re.compile(r"{# .+? #}")
-_BLOCK_COMMENT_PATTERN = re.compile(
-    r"{% comment ('.*?' |\".*?\" )?%}[\s\S]*?{% endcomment %}"
-)
+_BLOCK_COMMENT_PATTERN = re.compile(r"{% comment ('.*?' |\".*?\" )?%}[\s\S]*?{% endcomment %}")
 _TOKEN_PATTERN = re.compile(r"{{ .+? }}|{% .+? %}")
 _LSTRIP_BLOCK_PATTERN = re.compile(r"\n +$")
 _YIELD_PATTERN = re.compile(r"\n +yield ")
@@ -269,7 +257,7 @@ def _resolve_includes(template: str):
             raise TemplateNotFoundError(template_path)
 
         # Replace the include with the template content
-        with open(template_path, "rt", encoding="utf-8") as template_file:
+        with open(template_path, encoding="utf-8") as template_file:
             template = (
                 template[: include_match.start()]
                 + template_file.read()
@@ -278,7 +266,7 @@ def _resolve_includes(template: str):
     return template
 
 
-def _resolve_includes_blocks_and_extends(  # pylint: disable=,too-many-locals
+def _resolve_includes_blocks_and_extends(
     template: str,
 ):
     extended_templates: "set[str]" = set()
@@ -304,9 +292,7 @@ def _resolve_includes_blocks_and_extends(  # pylint: disable=,too-many-locals
 
         # Load extended template
         extended_templates.add(extended_template_path)
-        with open(
-            extended_template_path, "rt", encoding="utf-8"
-        ) as extended_template_file:
+        with open(extended_template_path, encoding="utf-8") as extended_template_file:
             extended_template = extended_template_file.read()
 
         offset = extends_match.end()
@@ -352,9 +338,7 @@ def _resolve_includes_blocks_and_extends(  # pylint: disable=,too-many-locals
                     "No matching {% endblock %}",
                 )
 
-            block_content = template[
-                offset + block_match.end() : offset + endblock_match.start()
-            ]
+            block_content = template[offset + block_match.end() : offset + endblock_match.start()]
 
             # Check for unsupported nested blocks
             if (nested_block_match := _find_block(block_content)) is not None:
@@ -403,11 +387,7 @@ def _replace_blocks_with_replacements(template: str, replacements: "dict[str, st
         if (endblock_match := _find_endblock(template, block_name)) is None:
             replacement = replacements.get(block_name, "")
 
-            template = (
-                template[: block_match.start()]
-                + replacement
-                + template[block_match.end() :]
-            )
+            template = template[: block_match.start()] + replacement + template[block_match.end() :]
 
         # Block with default content
         else:
@@ -434,14 +414,10 @@ def _replace_blocks_with_replacements(template: str, replacements: "dict[str, st
 
             # Replace default content with replacement
             else:
-                replacement = replacements[block_name].replace(
-                    r"{{ block.super }}", block_content
-                )
+                replacement = replacements[block_name].replace(r"{{ block.super }}", block_content)
 
                 template = (
-                    template[: block_match.start()]
-                    + replacement
-                    + template[endblock_match.end() :]
+                    template[: block_match.start()] + replacement + template[endblock_match.end() :]
                 )
 
     return template
@@ -480,7 +456,7 @@ def _remove_matched_comment(template: str, comment_match: re.Match):
     return template
 
 
-def _create_template_rendering_function(  # pylint: disable=,too-many-locals,too-many-branches,too-many-statements
+def _create_template_rendering_function(
     template: str,
     *,
     trim_blocks: bool = True,
@@ -590,9 +566,7 @@ def indented(fragment: str, end: str = "\n") -> str:
                 if not nested_for_loops:
                     raise TemplateSyntaxError(token, "No matching {% for ... %}")
 
-                last_forloop_iterable = (
-                    nested_for_loops[-1].content[3:-3].split(" in ", 1)[1]
-                )
+                last_forloop_iterable = nested_for_loops[-1].content[3:-3].split(" in ", 1)[1]
 
                 indent_level -= 1
                 function_def += indented(f"if not {last_forloop_iterable}:")
@@ -624,7 +598,7 @@ def indented(fragment: str, end: str = "\n") -> str:
             # Token is a autoescape mode change
             elif token.content.startswith(r"{% autoescape "):
                 mode = token.content[14:-3]
-                if mode not in ("on", "off"):
+                if mode not in {"on", "off"}:
                     raise ValueError(f"Unknown autoescape mode: {mode}")
 
                 nested_autoescape_modes.append(token)
@@ -681,13 +655,11 @@ def indented(fragment: str, end: str = "\n") -> str:
         function_def += indented('yield ""')
 
     # Create and return the template function
-    exec(function_def)  # pylint: disable=exec-used
+    exec(function_def)
     return locals()[function_name]
 
 
-def _yield_as_sized_chunks(
-    generator: "Generator[str]", chunk_size: int
-) -> "Generator[str]":
+def _yield_as_sized_chunks(generator: "Generator[str]", chunk_size: int) -> "Generator[str]":
     """Yields resized chunks from the ``generator``."""
 
     # Yield chunks with a given size
@@ -722,9 +694,7 @@ def __init__(self, template_string: str) -> None:
         """
         self._template_function = _create_template_rendering_function(template_string)
 
-    def render_iter(
-        self, context: dict = None, *, chunk_size: int = None
-    ) -> "Generator[str]":
+    def render_iter(self, context: dict = None, *, chunk_size: int = None) -> "Generator[str]":
         """
         Renders the template using the provided context and returns a generator that yields the
         rendered output.
@@ -780,7 +750,7 @@ def __init__(self, template_path: str) -> None:
         if not _exists_and_is_file(template_path):
             raise TemplateNotFoundError(template_path)
 
-        with open(template_path, "rt", encoding="utf-8") as template_file:
+        with open(template_path, encoding="utf-8") as template_file:
             template_string = template_file.read()
         super().__init__(template_string)
 
diff --git a/docs/api.rst b/docs/api.rst
index ea4ed84..c19826c 100644
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -4,5 +4,8 @@
 .. If your library file(s) are nested in a directory (e.g. /adafruit_foo/foo.py)
 .. use this format as the module name: "adafruit_foo.foo"
 
+API Reference
+#############
+
 .. automodule:: adafruit_templateengine
     :members:
diff --git a/docs/conf.py b/docs/conf.py
index d1e2b85..36b7621 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -1,12 +1,10 @@
-# -*- coding: utf-8 -*-
-
 # SPDX-FileCopyrightText: 2017 Scott Shawcroft, written for Adafruit Industries
 #
 # SPDX-License-Identifier: MIT
 
+import datetime
 import os
 import sys
-import datetime
 
 sys.path.insert(0, os.path.abspath(".."))
 
@@ -53,9 +51,7 @@
 creation_year = "2023"
 current_year = str(datetime.datetime.now().year)
 year_duration = (
-    current_year
-    if current_year == creation_year
-    else creation_year + " - " + current_year
+    current_year if current_year == creation_year else creation_year + " - " + current_year
 )
 copyright = year_duration + " Michał Pokusa, Tim Cocks"
 author = "Michał Pokusa, Tim Cocks"
diff --git a/examples/templateengine_comments.py b/examples/templateengine_comments.py
index 74bb2dd..7602b80 100644
--- a/examples/templateengine_comments.py
+++ b/examples/templateengine_comments.py
@@ -4,5 +4,4 @@
 
 from adafruit_templateengine import render_template
 
-
 print(render_template("./examples/comments.html"))
diff --git a/examples/templateengine_exec.py b/examples/templateengine_exec.py
index 15052b7..1931de5 100644
--- a/examples/templateengine_exec.py
+++ b/examples/templateengine_exec.py
@@ -4,7 +4,6 @@
 
 from adafruit_templateengine import render_string
 
-
 template = r"""
 <!DOCTYPE html>
 <html>
diff --git a/examples/templateengine_expressions.py b/examples/templateengine_expressions.py
index 8919440..d8f3faf 100644
--- a/examples/templateengine_expressions.py
+++ b/examples/templateengine_expressions.py
@@ -4,7 +4,6 @@
 
 from adafruit_templateengine import render_string
 
-
 template = r"""
 <!DOCTYPE html>
 <html>
diff --git a/examples/templateengine_for_loops.py b/examples/templateengine_for_loops.py
index 69c9cd3..9afa775 100644
--- a/examples/templateengine_for_loops.py
+++ b/examples/templateengine_for_loops.py
@@ -4,7 +4,6 @@
 
 from adafruit_templateengine import render_string
 
-
 template = r"""
 <!DOCTYPE html>
 <html>
diff --git a/examples/templateengine_if_statements.py b/examples/templateengine_if_statements.py
index 16e6832..37f81fd 100644
--- a/examples/templateengine_if_statements.py
+++ b/examples/templateengine_if_statements.py
@@ -4,7 +4,6 @@
 
 from adafruit_templateengine import render_string
 
-
 template = r"""
 <!DOCTYPE html>
 <html>
diff --git a/examples/templateengine_includes.py b/examples/templateengine_includes.py
index b9ecf95..dfc0571 100644
--- a/examples/templateengine_includes.py
+++ b/examples/templateengine_includes.py
@@ -4,5 +4,4 @@
 
 from adafruit_templateengine import render_template
 
-
 print(render_template("./examples/base_without_footer.html"))
diff --git a/examples/templateengine_reusing.py b/examples/templateengine_reusing.py
index 5ccb7c8..a6edbad 100644
--- a/examples/templateengine_reusing.py
+++ b/examples/templateengine_reusing.py
@@ -4,7 +4,6 @@
 
 from adafruit_templateengine import Template, render_string
 
-
 template_string = r"""
 <!DOCTYPE html>
 <html>
diff --git a/examples/templateengine_simpletest.py b/examples/templateengine_simpletest.py
index 3255402..eeeb752 100644
--- a/examples/templateengine_simpletest.py
+++ b/examples/templateengine_simpletest.py
@@ -4,7 +4,6 @@
 
 from adafruit_templateengine import render_string
 
-
 template = r"""
 <!DOCTYPE html>
 <html>
diff --git a/examples/templateengine_while_loops.py b/examples/templateengine_while_loops.py
index 86eb791..a08d89b 100644
--- a/examples/templateengine_while_loops.py
+++ b/examples/templateengine_while_loops.py
@@ -6,7 +6,6 @@
 
 from adafruit_templateengine import render_string
 
-
 template = r"""
 <!DOCTYPE html>
 <html>
diff --git a/ruff.toml b/ruff.toml
new file mode 100644
index 0000000..6d45653
--- /dev/null
+++ b/ruff.toml
@@ -0,0 +1,110 @@
+# SPDX-FileCopyrightText: 2024 Tim Cocks for Adafruit Industries
+#
+# SPDX-License-Identifier: MIT
+
+target-version = "py38"
+line-length = 100
+
+[lint]
+preview = true
+select = ["I", "PL", "UP"]
+
+extend-select = [
+  "D419",  # empty-docstring
+  "E501",  # line-too-long
+  "W291",  # trailing-whitespace
+  "PLC0414",  # useless-import-alias
+  "PLC2401",  # non-ascii-name
+  "PLC2801",  # unnecessary-dunder-call
+  "PLC3002",  # unnecessary-direct-lambda-call
+  "E999",  # syntax-error
+  "PLE0101",  # return-in-init
+  "F706",  # return-outside-function
+  "F704",  # yield-outside-function
+  "PLE0116",  # continue-in-finally
+  "PLE0117",  # nonlocal-without-binding
+  "PLE0241",  # duplicate-bases
+  "PLE0302",  # unexpected-special-method-signature
+  "PLE0604",  # invalid-all-object
+  "PLE0605",  # invalid-all-format
+  "PLE0643",  # potential-index-error
+  "PLE0704",  # misplaced-bare-raise
+  "PLE1141",  # dict-iter-missing-items
+  "PLE1142",  # await-outside-async
+  "PLE1205",  # logging-too-many-args
+  "PLE1206",  # logging-too-few-args
+  "PLE1307",  # bad-string-format-type
+  "PLE1310",  # bad-str-strip-call
+  "PLE1507",  # invalid-envvar-value
+  "PLE2502",  # bidirectional-unicode
+  "PLE2510",  # invalid-character-backspace
+  "PLE2512",  # invalid-character-sub
+  "PLE2513",  # invalid-character-esc
+  "PLE2514",  # invalid-character-nul
+  "PLE2515",  # invalid-character-zero-width-space
+  "PLR0124",  # comparison-with-itself
+  "PLR0202",  # no-classmethod-decorator
+  "PLR0203",  # no-staticmethod-decorator
+  "UP004",  # useless-object-inheritance
+  "PLR0206",  # property-with-parameters
+  "PLR0904",  # too-many-public-methods
+  "PLR0911",  # too-many-return-statements
+  "PLR0912",  # too-many-branches
+  "PLR0913",  # too-many-arguments
+  "PLR0914",  # too-many-locals
+  "PLR0915",  # too-many-statements
+  "PLR0916",  # too-many-boolean-expressions
+  "PLR1702",  # too-many-nested-blocks
+  "PLR1704",  # redefined-argument-from-local
+  "PLR1711",  # useless-return
+  "C416",  # unnecessary-comprehension
+  "PLR1733",  # unnecessary-dict-index-lookup
+  "PLR1736",  # unnecessary-list-index-lookup
+
+  # ruff reports this rule is unstable
+  #"PLR6301",  # no-self-use
+
+  "PLW0108",  # unnecessary-lambda
+  "PLW0120",  # useless-else-on-loop
+  "PLW0127",  # self-assigning-variable
+  "PLW0129",  # assert-on-string-literal
+  "B033",  # duplicate-value
+  "PLW0131",  # named-expr-without-context
+  "PLW0245",  # super-without-brackets
+  "PLW0406",  # import-self
+  "PLW0602",  # global-variable-not-assigned
+  "PLW0603",  # global-statement
+  "PLW0604",  # global-at-module-level
+
+  # fails on the try: import typing used by libraries
+  #"F401",  # unused-import
+
+  "F841",  # unused-variable
+  "E722",  # bare-except
+  "PLW0711",  # binary-op-exception
+  "PLW1501",  # bad-open-mode
+  "PLW1508",  # invalid-envvar-default
+  "PLW1509",  # subprocess-popen-preexec-fn
+  "PLW2101",  # useless-with-lock
+  "PLW3301",  # nested-min-max
+]
+
+ignore = [
+    "PLR2004", # magic-value-comparison
+    "UP030", # format literals
+    "PLW1514",  # unspecified-encoding
+    "PLR0913", # too-many-arguments
+    "PLR0915", # too-many-statements
+    "PLR0917", # too-many-positional-arguments
+    "PLR0904", # too-many-public-methods
+    "PLR0912", # too-many-branches
+    "PLR0916", # too-many-boolean-expressions
+    "PLR6301", # could-be-static no-self-use
+    "PLC0415", # import outside toplevel
+    "PLC2701", # private import
+    "PLR0914", # too many local var
+    "E722", # bare except
+]
+
+[format]
+line-ending = "lf"