style: add from __future__ import annotations (#2576)

Add `from __future__ import annotations` to files with type hints. Using
this simplifies type hints as they no longer require quoting.

This is in preparation for enabling Ruff rule UP037 (quoted-annotation,
Remove quotes from type annotation)
[[ref](https://beta.ruff.rs/docs/rules/#pyupgrade-up)].

devtools/diffrtpy.py

@@ -17,6 +17,7 @@
 Then attach ``/var/tmp/compact.diff`` to the PR.
 """
 
+from __future__ import annotations
 
 import argparse
 import logging

docs/conf.py

@@ -9,6 +9,7 @@
 # All configuration values have a default; values that are commented out
 # serve to show the default.
 # https://www.sphinx-doc.org/en/master/usage/configuration.html
+from __future__ import annotations
 
 import logging
 import os

examples/secure_with_audit.py

@@ -9,6 +9,7 @@
 The code in the example then verifies that the audit hook is blocking access to
 URLs and files as expected.
 """
+from __future__ import annotations
 
 import logging
 import os

examples/secure_with_urlopen.py

@@ -1,6 +1,8 @@
 """
 This example demonstrates how to use a custom global URL opener installed with `urllib.request.install_opener` to block access to URLs.
 """
+from __future__ import annotations
+
 import http.client
 import logging
 import os

pyproject.toml

@@ -88,6 +88,8 @@ select = [
     "I", # isort
     "N", # pep8-naming
     "RUF100", # Unused noqa directive
+    "UP010", # Unnecessary __future__ import for target Python version
+    "FA", # flake8-future-annotations
 ]
 
 ignore = [

rdflib/compare.py

@@ -72,7 +72,7 @@
     _:cb558f30e21ddfc05ca53108348338ade8
         <http://example.org/ns#label> "B" .
 """
-from __future__ import absolute_import, division, print_function
+from __future__ import annotations
 
 # TODO:
 # - Doesn't handle quads.

rdflib/exceptions.py

@@ -1,6 +1,7 @@
 """
 TODO:
 """
+from __future__ import annotations
 
 __all__ = [
     "Error",

rdflib/namespace/__init__.py

@@ -69,6 +69,7 @@
     >>> RDFS.seeAlso
     rdflib.term.URIRef('http://www.w3.org/2000/01/rdf-schema#seeAlso')
 """
+from __future__ import annotations
 
 import logging
 import warnings

rdflib/plugin.py

@@ -24,6 +24,7 @@
 .. __: http://peak.telecommunity.com/DevCenter/setuptools#dynamic-discovery-of-services-and-plugins
 
 """
+from __future__ import annotations
 
 from importlib.metadata import EntryPoint, entry_points
 from typing import (
@@ -102,7 +103,7 @@ def getClass(self) -> Type[PluginT]:  # noqa: N802
 
 
 class PKGPlugin(Plugin[PluginT]):
-    def __init__(self, name: str, kind: Type[PluginT], ep: "EntryPoint"):
+    def __init__(self, name: str, kind: Type[PluginT], ep: EntryPoint):
         self.name = name
         self.kind = kind
         self.ep = ep

rdflib/plugins/serializers/hext.py

@@ -2,6 +2,8 @@
 HextuplesSerializer RDF graph serializer for RDFLib.
 See <https://github.com/ontola/hextuples> for details about the format.
 """
+from __future__ import annotations
+
 import json
 import warnings
 from typing import IO, Optional, Type, Union

rdflib/plugins/serializers/jsonld.py

@@ -34,6 +34,8 @@
 # but we should consider streaming the output to deal with arbitrarily large
 # graphs.
 
+from __future__ import annotations
+
 import warnings
 from typing import IO, Optional
 

rdflib/plugins/serializers/nquads.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import warnings
 from typing import IO, Optional
 

rdflib/plugins/serializers/rdfxml.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import xml.dom.minidom
 from typing import IO, Dict, Optional, Set
 from xml.sax.saxutils import escape, quoteattr

rdflib/plugins/serializers/trig.py

@@ -2,6 +2,7 @@
 Trig RDF graph serializer for RDFLib.
 See <http://www.w3.org/TR/trig/> for syntax specification.
 """
+from __future__ import annotations
 
 from typing import IO, TYPE_CHECKING, Dict, List, Optional, Tuple, Union
 

rdflib/plugins/serializers/trix.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from typing import IO, Optional
 
 from rdflib.graph import ConjunctiveGraph, Graph

rdflib/plugins/sparql/results/rdfresults.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from typing import IO, Any, MutableMapping, Optional, Union
 
 from rdflib.graph import Graph

rdflib/plugins/sparql/results/tsvresults.py

@@ -3,8 +3,9 @@
 
 It is implemented with pyparsing, reusing the elements from the SPARQL Parser
 """
+from __future__ import annotations
 
-import codecs  # noqa: I001
+import codecs
 import typing
 from typing import IO, Union
 
@@ -30,9 +31,8 @@
 )
 from rdflib.plugins.sparql.parserutils import Comp, CompValue, Param
 from rdflib.query import Result, ResultParser
-from rdflib.term import BNode
+from rdflib.term import BNode, URIRef
 from rdflib.term import Literal as RDFLiteral
-from rdflib.term import URIRef
 
 ParserElement.setDefaultWhitespaceChars(" \n")
 

rdflib/plugins/sparql/results/txtresults.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from typing import IO, List, Optional, Union
 
 from rdflib.namespace import NamespaceManager

rdflib/plugins/sparql/results/xmlresults.py

@@ -7,6 +7,8 @@
 
 Authors: Drew Perttula, Gunnar Aastrand Grimnes
 """
+from __future__ import annotations
+
 import logging
 import xml.etree.ElementTree as xml_etree  # noqa: N813
 from io import BytesIO

rdflib/plugins/stores/auditable.py

@@ -14,6 +14,7 @@
 system fails): A and I out of ACID.
 
 """
+from __future__ import annotations
 
 import threading
 from typing import TYPE_CHECKING, Any, Generator, Iterator, List, Optional, Tuple

rdflib/plugins/stores/berkeleydb.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import logging
 from os import mkdir
 from os.path import abspath, exists

rdflib/plugins/stores/sparqlconnector.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import base64
 import copy
 import logging
@@ -40,7 +42,7 @@ def __init__(
         query_endpoint: Optional[str] = None,
         update_endpoint: Optional[str] = None,
         returnFormat: str = "xml",  # noqa: N803
-        method: "te.Literal['GET', 'POST', 'POST_FORM']" = "GET",
+        method: te.Literal["GET", "POST", "POST_FORM"] = "GET",
         auth: Optional[Tuple[str, str]] = None,
         **kwargs,
     ):

rdflib/plugins/stores/sparqlstore.py

@@ -3,6 +3,8 @@
 This was first done in layer-cake, and then ported to RDFLib
 
 """
+from __future__ import annotations
+
 import collections
 import re
 from typing import (

rdflib/term.py

@@ -20,6 +20,8 @@
 * Numerical Ranges
 
 """
+from __future__ import annotations
+
 import abc
 import re
 from fractions import Fraction

rdflib/tools/chunk_serializer.py

@@ -5,6 +5,7 @@
 There is an option to preserve any prefixes declared for the original graph in the first
 file, which will be a Turtle file.
 """
+from __future__ import annotations
 
 from contextlib import ExitStack, contextmanager
 from pathlib import Path

test/conftest.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import sys
 from contextlib import ExitStack
 

test/data/fetcher.py

@@ -1,4 +1,6 @@
 #!/usr/bin/env python
+from __future__ import annotations
+
 import argparse
 import enum
 import logging

test/data/suites/trix/test_trix.py

@@ -1,5 +1,7 @@
 """This runs the TriX tests for RDFLib's informally-assembled TriX
 test suite."""
+from __future__ import annotations
+
 from test.data import TEST_DATA_DIR
 from test.utils.manifest import RDFTest, read_manifest
 from test.utils.namespace import RDFT

test/jsonld/__init__.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from typing import List
 
 from rdflib import parser, plugin, serializer

test/jsonld/test_context.py

@@ -1,6 +1,7 @@
 """
 JSON-LD Context Spec
 """
+from __future__ import annotations
 
 import json
 from functools import wraps

test/jsonld/test_nested_arrays.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from test.utils.namespace import EGDC
 
 from rdflib import Graph, Literal

test/jsonld/test_onedotone.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import json
 import os
 from os import chdir, environ, getcwd

test/jsonld/test_testsuite.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import json
 from os import chdir, environ, getcwd
 from os import path as p

test/plugins/parser/example/rdflib/plugin/parser/__init__.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from typing import TYPE_CHECKING, Set, Tuple
 
 from rdflib.namespace import Namespace

test/test_dataset/test_dataset_default_graph.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import itertools
 import logging
 from test.data import TEST_DATA_DIR

test/test_graph/test_diff.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from dataclasses import dataclass, field
 from test.utils import (
     COLLAPSED_BNODE,

test/test_graph/test_graph.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import logging
 import os
 from pathlib import Path

test/test_graph/test_graph_http.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import logging
 import re
 from http.server import BaseHTTPRequestHandler

test/test_graph/test_graph_redirect.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from test.data import SIMPLE_TRIPLE_GRAPH, TEST_DATA_DIR
 from test.utils import GraphHelper
 from test.utils.http import MethodName, MockHTTPResponse

test/test_graph/test_graph_store.py

@@ -1,6 +1,7 @@
 """
 Tests for usage of the Store interface from Graph/NamespaceManager.
 """
+from __future__ import annotations
 
 import itertools
 import logging

test/test_graph/test_skolemization.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import logging
 import re
 from test.utils import GraphHelper

test/test_misc/test_networking_redirect.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from contextlib import ExitStack
 from copy import deepcopy
 from test.utils.http import headers_as_message as headers_as_message

test/test_misc/test_plugins.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import importlib
 import logging
 import shutil

test/test_misc/test_security.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import enum
 import http.client
 import itertools

test/test_namespace/test_definednamespace.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import inspect
 import logging
 import subprocess

test/test_namespace/test_namespace.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from test.utils.outcome import OutcomeChecker, OutcomePrimitive
 from typing import Any, Optional
 from warnings import warn

test/test_parsers/test_parser_turtlelike.py

@@ -2,6 +2,7 @@
 This module contains tests for the parsing of the turtle family of formats: N3,
 Turtle, NTriples, NQauds and TriG.
 """
+from __future__ import annotations
 
 import enum
 import itertools

test/test_path.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import logging
 from typing import Union
 

test/test_roundtrip.py

@@ -19,6 +19,8 @@
 & test_serializer_hext.py)
 
 """
+from __future__ import annotations
+
 import enum
 import logging
 import os.path

test/test_serializers/test_serializer.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import enum
 import itertools
 import logging

test/test_serializers/test_serializer_jsonld.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import json
 import logging
 import pprint