- New since 3.7.0
- is exposed by some public apis:
    - the `__doc__` attribute of `typing` mentions `ForwardRef`
    - `get_type_hints` can expose an instance of it: https://bugs.python.org/issue35834

Should this be documented? including in __all__?

Guido, I remember you were against exposing `ForwardRef` as public at some point, but recently you approved https://github.com/python/cpython/pull/13456 that added it to `typing.__all__`. I don't have any particular opinion on this, but if you don't object, I think it would make sense to add a short section about this to the docs, since it may be exposed at runtime, e.g. in `List['Cls']`.

Huh. I think I have mellowed with age. IOW SGTM.

On Sat, Jun 1, 2019 at 17:07 Ivan Levkivskyi <report@bugs.python.org> wrote:

>
> Ivan Levkivskyi <levkivskyi@gmail.com> added the comment:
>
> Guido, I remember you were against exposing `ForwardRef` as public at some
> point, but recently you approved
> https://github.com/python/cpython/pull/13456 that added it to
> `typing.__all__`. I don't have any particular opinion on this, but if you
> don't object, I think it would make sense to add a short section about this
> to the docs, since it may be exposed at runtime, e.g. in `List['Cls']`.
>
> ----------
> nosy: +gvanrossum
>
> _______________________________________
> Python tracker <report@bugs.python.org>
> <https://bugs.python.org/issue36985>
> _______________________________________
>
-- 
--Guido (mobile)

New changeset d0587353fe2dece91d2a9b8ddf2696fb5adc233a by Miss Islington (bot) (Ivan Levkivskyi) in branch '3.7':
[3.7] bpo-36985: Document typing.ForwardRef (GH-14216) (GH-14220)
https://github.com/python/cpython/commit/d0587353fe2dece91d2a9b8ddf2696fb5adc233a