ansible-core 2.19.0b3__py3-none-any.whl → 2.19.0b5__py3-none-any.whl

{ansible_core-2.19.0b3.dist-info → ansible_core-2.19.0b5.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (72.1.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

ansible_test/_data/completion/docker.txt

@@ -1,6 +1,6 @@
-base image=quay.io/ansible/base-test-container:8.1.0 python=3.13,3.8,3.9,3.10,3.11,3.12
-default image=quay.io/ansible/default-test-container:11.5.0 python=3.13,3.8,3.9,3.10,3.11,3.12 context=collection
-default image=quay.io/ansible/ansible-core-test-container:11.5.0 python=3.13,3.8,3.9,3.10,3.11,3.12 context=ansible-core
+base image=quay.io/ansible/base-test-container:8.2.0 python=3.13,3.8,3.9,3.10,3.11,3.12
+default image=quay.io/ansible/default-test-container:11.6.0 python=3.13,3.8,3.9,3.10,3.11,3.12 context=collection
+default image=quay.io/ansible/ansible-core-test-container:11.6.0 python=3.13,3.8,3.9,3.10,3.11,3.12 context=ansible-core
 alpine321 image=quay.io/ansible/alpine321-test-container:9.1.0 python=3.12 cgroup=none audit=none
 fedora41 image=quay.io/ansible/fedora41-test-container:9.0.0 python=3.13 cgroup=v2-only
 ubuntu2204 image=quay.io/ansible/ubuntu2204-test-container:9.0.0 python=3.10

ansible_test/_data/completion/remote.txt

@@ -8,6 +8,7 @@ freebsd python_dir=/usr/local/bin become=su_sudo provider=aws arch=x86_64
 macos/15.3 python=3.13 python_dir=/usr/local/bin become=sudo provider=parallels arch=x86_64
 macos python_dir=/usr/local/bin become=sudo provider=parallels arch=x86_64
 rhel/9.5 python=3.9,3.12 become=sudo provider=aws arch=x86_64
+rhel/10.0 python=3.12 become=sudo provider=aws arch=x86_64
 rhel become=sudo provider=aws arch=x86_64
 ubuntu/22.04 python=3.10 become=sudo provider=aws arch=x86_64
 ubuntu/24.04 python=3.12 become=sudo provider=aws arch=x86_64

ansible_test/_data/requirements/sanity.ansible-doc.txt

@@ -1,5 +1,5 @@
 # edit "sanity.ansible-doc.in" and generate with: hacking/update-sanity-requirements.py --test ansible-doc
 Jinja2==3.1.6
 MarkupSafe==3.0.2
-packaging==24.2
+packaging==25.0
 PyYAML==6.0.2

ansible_test/_data/requirements/sanity.changelog.txt

@@ -1,9 +1,9 @@
 # edit "sanity.changelog.in" and generate with: hacking/update-sanity-requirements.py --test changelog
 antsibull-changelog==0.29.0
 docutils==0.18.1
-packaging==24.2
+packaging==25.0
 PyYAML==6.0.2
 rstcheck==5.0.0
 semantic-version==2.10.0
 types-docutils==0.18.3
-typing_extensions==4.12.2
+typing_extensions==4.13.2

ansible_test/_data/requirements/sanity.pep8.txt

@@ -1,2 +1,2 @@
 # edit "sanity.pep8.in" and generate with: hacking/update-sanity-requirements.py --test pep8
-pycodestyle==2.12.1
+pycodestyle==2.13.0

ansible_test/_data/requirements/sanity.pylint.txt

@@ -1,9 +1,9 @@
 # edit "sanity.pylint.in" and generate with: hacking/update-sanity-requirements.py --test pylint
-astroid==3.3.9
-dill==0.3.9
+astroid==3.3.10
+dill==0.4.0
 isort==6.0.1
 mccabe==0.7.0
-platformdirs==4.3.7
-pylint==3.3.6
+platformdirs==4.3.8
+pylint==3.3.7
 PyYAML==6.0.2
 tomlkit==0.13.2

ansible_test/_data/requirements/sanity.yamllint.txt

@@ -1,4 +1,4 @@
 # edit "sanity.yamllint.in" and generate with: hacking/update-sanity-requirements.py --test yamllint
 pathspec==0.12.1
 PyYAML==6.0.2
-yamllint==1.36.2
+yamllint==1.37.1

ansible_test/_internal/util.py

@@ -254,12 +254,29 @@ def filter_args(args: list[str], filters: dict[str, int]) -> list[str]:
     """Return a filtered version of the given command line arguments."""
     remaining = 0
     result = []
+    pass_through_args: list[str] = []
+    pass_through_explicit = False
+    pass_through_implicit = False
 
     for arg in args:
+        if pass_through_explicit:
+            pass_through_args.append(arg)
+            continue
+
+        if arg == '--':
+            pass_through_explicit = True
+            continue
+
         if not arg.startswith('-') and remaining:
             remaining -= 1
+            pass_through_implicit = not remaining
             continue
 
+        if not arg.startswith('-') and pass_through_implicit:
+            pass_through_args.append(arg)
+            continue
+
+        pass_through_implicit = False
         remaining = 0
 
         parts = arg.split('=', 1)
@@ -271,6 +288,9 @@ def filter_args(args: list[str], filters: dict[str, int]) -> list[str]:
 
         result.append(arg)
 
+    if pass_through_args:
+        result += ['--'] + pass_through_args
+
     return result
 
 

ansible_test/_util/controller/sanity/pylint/config/ansible-test-target.cfg

@@ -6,6 +6,7 @@ load-plugins=
     pylint.extensions.docstyle,
 
 disable=
+    bad-super-call,  # flakey test, can report false positives due to inference issue when using deprecate_calls plugin
     docstring-first-line-empty,
     consider-using-f-string,  # Python 2.x support still required
     cyclic-import,  # consistent results require running with --jobs 1 and testing all files

ansible_test/_util/controller/sanity/pylint/config/ansible-test.cfg

@@ -6,6 +6,7 @@ load-plugins=
     pylint.extensions.docstyle,
 
 disable=
+    bad-super-call,  # flakey test, can report false positives due to inference issue when using deprecate_calls plugin
     docstring-first-line-empty,
     consider-using-f-string,  # many occurrences
     cyclic-import,  # consistent results require running with --jobs 1 and testing all files

ansible_test/_util/controller/sanity/pylint/config/code-smell.cfg

@@ -6,6 +6,7 @@ load-plugins=
     pylint.extensions.docstyle,
 
 disable=
+    bad-super-call,  # flakey test, can report false positives due to inference issue when using deprecate_calls plugin
     docstring-first-line-empty,
     consider-using-f-string,  # many occurrences
     cyclic-import,  # consistent results require running with --jobs 1 and testing all files

ansible_test/_util/controller/sanity/pylint/config/collection.cfg

@@ -11,6 +11,7 @@ disable=
     attribute-defined-outside-init,
     bad-indentation,
     bad-mcs-classmethod-argument,
+    bad-super-call,  # flakey test, can report false positives due to inference issue when using deprecate_calls plugin
     broad-exception-caught,
     broad-exception-raised,
     c-extension-no-member,

ansible_test/_util/controller/sanity/pylint/config/default.cfg

@@ -16,6 +16,7 @@ disable=
     attribute-defined-outside-init,
     bad-indentation,
     bad-mcs-classmethod-argument,
+    bad-super-call,  # flakey test, can report false positives due to inference issue when using deprecate_calls plugin
     broad-exception-caught,
     broad-exception-raised,
     c-extension-no-member,

ansible_test/_util/controller/sanity/pylint/plugins/deprecated_calls.py

@@ -39,6 +39,10 @@ class DeprecationCallArgs:
     removed: object = None  # only on Display.deprecated
     value: object = None  # only on deprecate_value
 
+    def all_args_dynamic(self) -> bool:
+        """True if all args are dynamic or None, otherwise False."""
+        return all(arg is None or isinstance(arg, astroid.NodeNG) for arg in dataclasses.asdict(self).values())
+
 
 class AnsibleDeprecatedChecker(pylint.checkers.BaseChecker):
     """Checks for deprecated calls to ensure proper usage."""
@@ -172,7 +176,6 @@ class AnsibleDeprecatedChecker(pylint.checkers.BaseChecker):
     def __init__(self, *args, **kwargs) -> None:
         super().__init__(*args, **kwargs)
 
-        self.inference_context = astroid.context.InferenceContext()
         self.module_cache: dict[str, astroid.Module] = {}
 
     @functools.cached_property
@@ -237,7 +240,7 @@ class AnsibleDeprecatedChecker(pylint.checkers.BaseChecker):
         inferred: astroid.typing.InferenceResult | None = None
 
         while target:
-            if inferred := astroid.util.safe_infer(target, self.inference_context):
+            if inferred := astroid.util.safe_infer(target):
                 break
 
             if isinstance(target, astroid.Call):
@@ -259,6 +262,20 @@ class AnsibleDeprecatedChecker(pylint.checkers.BaseChecker):
                 break
 
         for name in reversed(names):
+            if isinstance(inferred, astroid.Instance):
+                try:
+                    attr = next(iter(inferred.getattr(name)), None)
+                except astroid.AttributeInferenceError:
+                    break
+
+                if isinstance(attr, astroid.AssignAttr):
+                    inferred = self.get_ansible_module(attr)
+                    continue
+
+                if isinstance(attr, astroid.FunctionDef):
+                    inferred = attr
+                    continue
+
             if not isinstance(inferred, (astroid.Module, astroid.ClassDef)):
                 inferred = None
                 break
@@ -278,25 +295,46 @@ class AnsibleDeprecatedChecker(pylint.checkers.BaseChecker):
     def infer_name(self, node: astroid.Name) -> astroid.NodeNG | None:
         """Infer the node referenced by the given name, or `None` if it cannot be unambiguously inferred."""
         scope = node.scope()
-        name = None
+        inferred: astroid.NodeNG | None = None
+        name = node.name
 
         while scope:
             try:
-                assignment = scope[node.name]
+                assignment = scope[name]
             except KeyError:
                 scope = scope.parent.scope() if scope.parent else None
                 continue
 
             if isinstance(assignment, astroid.AssignName) and isinstance(assignment.parent, astroid.Assign):
-                name = assignment.parent.value
+                inferred = assignment.parent.value
+            elif (
+                isinstance(scope, astroid.FunctionDef)
+                and isinstance(assignment, astroid.AssignName)
+                and isinstance(assignment.parent, astroid.Arguments)
+                and assignment.parent.annotations
+            ):
+                idx, _node = assignment.parent.find_argname(name)
+
+                if idx is not None:
+                    try:
+                        annotation = assignment.parent.annotations[idx]
+                    except IndexError:
+                        pass
+                    else:
+                        if isinstance(annotation, astroid.Name):
+                            name = annotation.name
+                            continue
+            elif isinstance(assignment, astroid.ClassDef):
+                inferred = assignment
             elif isinstance(assignment, astroid.ImportFrom):
                 if module := self.get_module(assignment):
+                    name = assignment.real_name(name)
                     scope = module.scope()
                     continue
 
             break
 
-        return name
+        return inferred
 
     def get_module(self, node: astroid.ImportFrom) -> astroid.Module | None:
         """Import the requested module if possible and cache the result."""
@@ -346,6 +384,10 @@ class AnsibleDeprecatedChecker(pylint.checkers.BaseChecker):
             self.add_message('ansible-deprecated-date-not-permitted', node=node, args=(name,))
             return
 
+        if call_args.all_args_dynamic():
+            # assume collection maintainers know what they're doing if all args are dynamic
+            return
+
         if call_args.version and call_args.date:
             self.add_message('ansible-deprecated-both-version-and-date', node=node, args=(name,))
             return
@@ -407,10 +449,13 @@ class AnsibleDeprecatedChecker(pylint.checkers.BaseChecker):
                 self.add_message('ansible-deprecated-unnecessary-collection-name', node=node, args=('deprecator', name,))
                 return
 
+        if args.all_args_dynamic():
+            # assume collection maintainers know what they're doing if all args are dynamic
+            return
+
         expected_collection_name = 'ansible.builtin' if self.is_ansible_core else self.collection_name
 
         if args.collection_name and args.collection_name != expected_collection_name:
-            # if collection_name is provided and a constant, report when it does not match the expected name
             self.add_message('wrong-collection-deprecated', node=node, args=(args.collection_name, name))
 
     def check_version(self, node: astroid.Call, name: str, args: DeprecationCallArgs) -> None:
@@ -469,7 +514,27 @@ class AnsibleDeprecatedChecker(pylint.checkers.BaseChecker):
 
         raise TypeError(type(value))
 
+    def get_ansible_module(self, node: astroid.AssignAttr) -> astroid.Instance | None:
+        """Infer an AnsibleModule instance node from the given assignment."""
+        if isinstance(node.parent, astroid.Assign) and isinstance(node.parent.type_annotation, astroid.Name):
+            inferred = self.infer_name(node.parent.type_annotation)
+        elif isinstance(node.parent, astroid.Assign) and isinstance(node.parent.parent, astroid.FunctionDef) and isinstance(node.parent.value, astroid.Name):
+            inferred = self.infer_name(node.parent.value)
+        elif isinstance(node.parent, astroid.AnnAssign) and isinstance(node.parent.annotation, astroid.Name):
+            inferred = self.infer_name(node.parent.annotation)
+        else:
+            inferred = None
+
+        if isinstance(inferred, astroid.ClassDef) and inferred.name == 'AnsibleModule':
+            return inferred.instantiate_class()
+
+        return None
+
+    def register(self) -> None:
+        """Register this plugin."""
+        self.linter.register_checker(self)
+
 
 def register(linter: pylint.lint.PyLinter) -> None:
     """Required method to auto-register this checker."""
-    linter.register_checker(AnsibleDeprecatedChecker(linter))
+    AnsibleDeprecatedChecker(linter).register()

ansible_test/_util/target/setup/bootstrap.sh

@@ -281,10 +281,41 @@ bootstrap_remote_rhel_9()
     done
 }
 
+bootstrap_remote_rhel_10()
+{
+    py_pkg_prefix="python3"
+
+    packages="
+        gcc
+        ${py_pkg_prefix}-devel
+        ${py_pkg_prefix}-pip
+        "
+
+    if [ "${controller}" ]; then
+        packages="
+            ${packages}
+            ${py_pkg_prefix}-cryptography
+            ${py_pkg_prefix}-jinja2
+            ${py_pkg_prefix}-packaging
+            ${py_pkg_prefix}-pyyaml
+            ${py_pkg_prefix}-resolvelib
+            "
+    fi
+
+    while true; do
+        # shellcheck disable=SC2086
+        dnf install -q -y ${packages} \
+        && break
+        echo "Failed to install packages. Sleeping before trying again..."
+        sleep 10
+    done
+}
+
 bootstrap_remote_rhel()
 {
     case "${platform_version}" in
         9.*) bootstrap_remote_rhel_9 ;;
+        10.*) bootstrap_remote_rhel_10 ;;
     esac
 }
 

ansible/_internal/_errors/_utils.py

@@ -1,310 +0,0 @@
-from __future__ import annotations
-
-import dataclasses
-import itertools
-import pathlib
-import sys
-import textwrap
-import typing as t
-
-from ansible.module_utils.common.messages import Detail, ErrorSummary
-from ansible._internal._datatag._tags import Origin
-from ansible.module_utils._internal import _ambient_context, _traceback
-from ansible import errors
-
-if t.TYPE_CHECKING:
-    from ansible.utils.display import Display
-
-
-class RedactAnnotatedSourceContext(_ambient_context.AmbientContextBase):
-    """
-    When active, this context will redact annotated source lines, showing only the origin.
-    """
-
-
-def _dedupe_and_concat_message_chain(message_parts: list[str]) -> str:
-    message_parts = list(reversed(message_parts))
-
-    message = message_parts.pop(0)
-
-    for message_part in message_parts:
-        # avoid duplicate messages where the cause was already concatenated to the exception message
-        if message_part.endswith(message):
-            message = message_part
-        else:
-            message = concat_message(message_part, message)
-
-    return message
-
-
-def _collapse_error_details(error_details: t.Sequence[Detail]) -> list[Detail]:
-    """
-    Return a potentially modified error chain, with redundant errors collapsed into previous error(s) in the chain.
-    This reduces the verbosity of messages by eliminating repetition when multiple errors in the chain share the same contextual information.
-    """
-    previous_error = error_details[0]
-    previous_warnings: list[str] = []
-    collapsed_error_details: list[tuple[Detail, list[str]]] = [(previous_error, previous_warnings)]
-
-    for error in error_details[1:]:
-        details_present = error.formatted_source_context or error.help_text
-        details_changed = error.formatted_source_context != previous_error.formatted_source_context or error.help_text != previous_error.help_text
-
-        if details_present and details_changed:
-            previous_error = error
-            previous_warnings = []
-            collapsed_error_details.append((previous_error, previous_warnings))
-        else:
-            previous_warnings.append(error.msg)
-
-    final_error_details: list[Detail] = []
-
-    for error, messages in collapsed_error_details:
-        final_error_details.append(dataclasses.replace(error, msg=_dedupe_and_concat_message_chain([error.msg] + messages)))
-
-    return final_error_details
-
-
-def _get_cause(exception: BaseException) -> BaseException | None:
-    # deprecated: description='remove support for orig_exc (deprecated in 2.23)' core_version='2.27'
-
-    if not isinstance(exception, errors.AnsibleError):
-        return exception.__cause__
-
-    if exception.__cause__:
-        if exception.orig_exc and exception.orig_exc is not exception.__cause__:
-            _get_display().warning(
-                msg=f"The `orig_exc` argument to `{type(exception).__name__}` was given, but differed from the cause given by `raise ... from`.",
-            )
-
-        return exception.__cause__
-
-    if exception.orig_exc:
-        # encourage the use of `raise ... from` before deprecating `orig_exc`
-        _get_display().warning(msg=f"The `orig_exc` argument to `{type(exception).__name__}` was given without using `raise ... from orig_exc`.")
-
-        return exception.orig_exc
-
-    return None
-
-
-class _TemporaryDisplay:
-    # DTFIX-FUTURE: generalize this and hide it in the display module so all users of Display can benefit
-
-    @staticmethod
-    def warning(*args, **kwargs):
-        print(f'FALLBACK WARNING: {args} {kwargs}', file=sys.stderr)
-
-    @staticmethod
-    def deprecated(*args, **kwargs):
-        print(f'FALLBACK DEPRECATION: {args} {kwargs}', file=sys.stderr)
-
-
-def _get_display() -> Display | _TemporaryDisplay:
-    try:
-        from ansible.utils.display import Display
-    except ImportError:
-        return _TemporaryDisplay()
-
-    return Display()
-
-
-def _create_error_summary(exception: BaseException, event: _traceback.TracebackEvent | None = None) -> ErrorSummary:
-    from . import _captured  # avoid circular import due to AnsibleError import
-
-    current_exception: BaseException | None = exception
-    error_details: list[Detail] = []
-
-    if event:
-        formatted_traceback = _traceback.maybe_extract_traceback(exception, event)
-    else:
-        formatted_traceback = None
-
-    while current_exception:
-        if isinstance(current_exception, errors.AnsibleError):
-            include_cause_message = current_exception._include_cause_message
-            edc = Detail(
-                msg=current_exception._original_message.strip(),
-                formatted_source_context=current_exception._formatted_source_context,
-                help_text=current_exception._help_text,
-            )
-        else:
-            include_cause_message = True
-            edc = Detail(
-                msg=str(current_exception).strip(),
-            )
-
-        error_details.append(edc)
-
-        if isinstance(current_exception, _captured.AnsibleCapturedError):
-            detail = current_exception.error_summary
-            error_details.extend(detail.details)
-
-            if formatted_traceback and detail.formatted_traceback:
-                formatted_traceback = (
-                    f'{detail.formatted_traceback}\n'
-                    f'The {current_exception.context} exception above was the direct cause of the following controller exception:\n\n'
-                    f'{formatted_traceback}'
-                )
-
-        if not include_cause_message:
-            break
-
-        current_exception = _get_cause(current_exception)
-
-    return ErrorSummary(details=tuple(error_details), formatted_traceback=formatted_traceback)
-
-
-def concat_message(left: str, right: str) -> str:
-    """Normalize `left` by removing trailing punctuation and spaces before appending new punctuation and `right`."""
-    return f'{left.rstrip(". ")}: {right}'
-
-
-def get_chained_message(exception: BaseException) -> str:
-    """
-    Return the full chain of exception messages by concatenating the cause(s) until all are exhausted.
-    """
-    error_summary = _create_error_summary(exception)
-    message_parts = [edc.msg for edc in error_summary.details]
-
-    return _dedupe_and_concat_message_chain(message_parts)
-
-
-@dataclasses.dataclass(kw_only=True, frozen=True)
-class SourceContext:
-    origin: Origin
-    annotated_source_lines: list[str]
-    target_line: str | None
-
-    def __str__(self) -> str:
-        msg_lines = [f'Origin: {self.origin}']
-
-        if self.annotated_source_lines:
-            msg_lines.append('')
-            msg_lines.extend(self.annotated_source_lines)
-
-        return '\n'.join(msg_lines)
-
-    @classmethod
-    def from_value(cls, value: t.Any) -> SourceContext | None:
-        """Attempt to retrieve source and render a contextual indicator from the value's origin (if any)."""
-        if value is None:
-            return None
-
-        if isinstance(value, Origin):
-            origin = value
-            value = None
-        else:
-            origin = Origin.get_tag(value)
-
-        if RedactAnnotatedSourceContext.current(optional=True):
-            return cls.error('content redacted')
-
-        if origin and origin.path:
-            return cls.from_origin(origin)
-
-        # DTFIX-RELEASE: redaction context may not be sufficient to avoid secret disclosure without SensitiveData and other enhancements
-        if value is None:
-            truncated_value = None
-            annotated_source_lines = []
-        else:
-            # DTFIX-FUTURE: cleanup/share width
-            try:
-                value = str(value)
-            except Exception as ex:
-                value = f'<< context unavailable: {ex} >>'
-
-            truncated_value = textwrap.shorten(value, width=120)
-            annotated_source_lines = [truncated_value]
-
-        return SourceContext(
-            origin=origin or Origin.UNKNOWN,
-            annotated_source_lines=annotated_source_lines,
-            target_line=truncated_value,
-        )
-
-    @staticmethod
-    def error(message: str | None, origin: Origin | None = None) -> SourceContext:
-        return SourceContext(
-            origin=origin,
-            annotated_source_lines=[f'(source not shown: {message})'] if message else [],
-            target_line=None,
-        )
-
-    @classmethod
-    def from_origin(cls, origin: Origin) -> SourceContext:
-        """Attempt to retrieve source and render a contextual indicator of an error location."""
-        from ansible.parsing.vault import is_encrypted  # avoid circular import
-
-        # DTFIX-FUTURE: support referencing the column after the end of the target line, so we can indicate where a missing character (quote) needs to be added
-        #               this is also useful for cases like end-of-stream reported by the YAML parser
-
-        # DTFIX-FUTURE: Implement line wrapping and match annotated line width to the terminal display width.
-
-        context_line_count: t.Final = 2
-        max_annotated_line_width: t.Final = 120
-        truncation_marker: t.Final = '...'
-
-        target_line_num = origin.line_num
-
-        if RedactAnnotatedSourceContext.current(optional=True):
-            return cls.error('content redacted', origin)
-
-        if not target_line_num or target_line_num < 1:
-            return cls.error(None, origin)  # message omitted since lack of line number is obvious from pos
-
-        start_line_idx = max(0, (target_line_num - 1) - context_line_count)  # if near start of file
-        target_col_num = origin.col_num
-
-        try:
-            with pathlib.Path(origin.path).open() as src:
-                first_line = src.readline()
-                lines = list(itertools.islice(itertools.chain((first_line,), src), start_line_idx, target_line_num))
-        except Exception as ex:
-            return cls.error(type(ex).__name__, origin)
-
-        if is_encrypted(first_line):
-            return cls.error('content encrypted', origin)
-
-        if len(lines) != target_line_num - start_line_idx:
-            return cls.error('file truncated', origin)
-
-        annotated_source_lines = []
-
-        line_label_width = len(str(target_line_num))
-        max_src_line_len = max_annotated_line_width - line_label_width - 1
-
-        usable_line_len = max_src_line_len
-
-        for line_num, line in enumerate(lines, start_line_idx + 1):
-            line = line.rstrip('\n')  # universal newline default mode on `open` ensures we'll never see anything but \n
-            line = line.replace('\t', ' ')  # mixed tab/space handling is intentionally disabled since we're both format and display config agnostic
-
-            if len(line) > max_src_line_len:
-                line = line[: max_src_line_len - len(truncation_marker)] + truncation_marker
-                usable_line_len = max_src_line_len - len(truncation_marker)
-
-            annotated_source_lines.append(f'{str(line_num).rjust(line_label_width)}{" " if line else ""}{line}')
-
-        if target_col_num and usable_line_len >= target_col_num >= 1:
-            column_marker = f'column {target_col_num}'
-
-            target_col_idx = target_col_num - 1
-
-            if target_col_idx + 2 + len(column_marker) > max_src_line_len:
-                column_marker = f'{" " * (target_col_idx - len(column_marker) - 1)}{column_marker} ^'
-            else:
-                column_marker = f'{" " * target_col_idx}^ {column_marker}'
-
-            column_marker = f'{" " * line_label_width} {column_marker}'
-
-            annotated_source_lines.append(column_marker)
-        elif target_col_num is None:
-            underline_length = len(annotated_source_lines[-1]) - line_label_width - 1
-            annotated_source_lines.append(f'{" " * line_label_width} {"^" * underline_length}')
-
-        return SourceContext(
-            origin=origin,
-            annotated_source_lines=annotated_source_lines,
-            target_line=lines[-1].rstrip('\n'),  # universal newline default mode on `open` ensures we'll never see anything but \n
-        )