tests/test_main.py tests fails with Python 3.14 and click 8.3.1

[mtelka]

I run tests for httpx 0.28.1 with Python 3.14.2 and click 8.3.1 installed and all tests in tests/test_main.py fails similarly to this one:

=================================== FAILURES ===================================
__________________________________ test_help ___________________________________

self = <click.testing.CliRunner object at 0x7fffac545fd0>
cli = <function main at 0x7fffad03aa30>, args = ['--help'], input = None
env = None, catch_exceptions = True, color = False, extra = {}, exc_info = None
outstreams = (<click.testing.BytesIOCopy object at 0x7fffaaca6840>, <click.testing.BytesIOCopy object at 0x7fffaaca6890>, <_io.BytesIO object at 0x7fffaaca6250>)
return_value = None, exception = None, exit_code = 0 
        
    def invoke(  
        self,
        cli: Command,
        args: str | cabc.Sequence[str] | None = None,
        input: str | bytes | t.IO[t.Any] | None = None,
        env: cabc.Mapping[str, str | None] | None = None,
        catch_exceptions: bool | None = None,
        color: bool = False,
        **extra: t.Any,
    ) -> Result:
        """Invokes a command in an isolated environment.  The arguments are
        forwarded directly to the command line script, the `extra` keyword
        arguments are passed to the :meth:`~clickpkg.Command.main` function of
        the command.
    
        This returns a :class:`Result` object.

        :param cli: the command to invoke
        :param args: the arguments to invoke. It may be given as an iterable
                     or a string. When given as string it will be interpreted
                     as a Unix shell command. More details at
                     :func:`shlex.split`.
        :param input: the input data for `sys.stdin`.
        :param env: the environment overrides.
        :param catch_exceptions: Whether to catch any other exceptions than
                                 ``SystemExit``. If :data:`None`, the value
                                 from :class:`CliRunner` is used.
        :param extra: the keyword arguments to pass to :meth:`main`.
        :param color: whether the output should contain color codes. The
                      application can still override this explicitly.
        
        .. versionadded:: 8.2
            The result object has the ``output_bytes`` attribute with
            the mix of ``stdout_bytes`` and ``stderr_bytes``, as the user would
            see it in its terminal.
        
        .. versionchanged:: 8.2
            The result object always returns the ``stderr_bytes`` stream.
                     
        .. versionchanged:: 8.0 
            The result object has the ``return_value`` attribute with
            the value returned from the invoked command.
                                 
        .. versionchanged:: 4.0  
            Added the ``color`` parameter.
        
        .. versionchanged:: 3.0
            Added the ``catch_exceptions`` parameter.
        
        .. versionchanged:: 3.0
            The result object has the ``exc_info`` attribute with the
            traceback if available.
        """
        exc_info = None
        if catch_exceptions is None: 
            catch_exceptions = self.catch_exceptions
        
        with self.isolation(input=input, env=env, color=color) as outstreams:
            return_value = None
            exception: BaseException | None = None
            exit_code = 0
            
            if isinstance(args, str):
                args = shlex.split(args)
            
            try:
>               prog_name = extra.pop("prog_name")
                            ^^^^^^^^^^^^^^^^^^^^^^ 
E               KeyError: 'prog_name'
        
/usr/lib/python3.14/vendor-packages/click/testing.py:499: KeyError
        
During handling of the above exception, another exception occurred:

    def test_help():
        runner = CliRunner()
>       result = runner.invoke(httpx.main, ["--help"])
                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

tests/test_main.py:19:
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
/usr/lib/python3.14/vendor-packages/click/testing.py:501: in invoke
    prog_name = self.get_default_prog_name(cli)
                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _

self = <click.testing.CliRunner object at 0x7fffac545fd0>
cli = <function main at 0x7fffad03aa30>

    def get_default_prog_name(self, cli: Command) -> str:
        """Given a command object it will return the default program name
        for it.  The default is the `name` attribute or ``"root"`` if not
        set.
        """
>       return cli.name or "root"
               ^^^^^^^^
E       AttributeError: 'function' object has no attribute 'name'

/usr/lib/python3.14/vendor-packages/click/testing.py:268: AttributeError

When I test with Python 3.9.25 and click 8.1.8 then all tests pass.

[canakyuz]

The Click version is probably a red herring. The traceback shows that httpx.main is a plain function rather than a Click command.

In 0.28.1 the CLI import is wrapped in a try/except that silently falls back to a stub when any CLI dependency is missing:

https://github.com/encode/httpx/blob/0.28.1/httpx/__init__.py#L14-L24

Installing Click alone is not enough, because the ``extra also requires Pygments and Rich:

https://github.com/encode/httpx/blob/0.28.1/pyproject.toml#L34-L38

For a repository checkout:

python -m pip install -e '.[cli]'

Or for the released package:

python -m pip install 'httpx[cli]==0.28.1'

I reproduced this in a clean venv. With httpx==0.28.1 plus Click 8.5.0 but no Pygments/Rich:

click: 8.5.0
httpx.main -> <function main at 0x7f5763f07ce0>
isinstance(httpx.main, click.Command) -> False
AttributeError: 'function' object has no attribute 'name'

After installing the ``extras:

click 8.5.0 | Pygments 2.21.0 | rich 13.9.4
httpx.main -> <Command main>
isinstance(httpx.main, click.Command) -> True
--help exit code: 0

[canakyuz]

mtelka: if the explanation above helped clear up the failing tests, would you mind marking it as the answer when you have a moment? No rush either way. Thanks!