fix docstrings on functions written in C

[asukaminato0721]

fix #1076

use https://github.com/DetachHead/basedpyright/blob/main/build/py3_8/generate_docstubs.py to gen code during build and bundle into lsp.

[asukaminato0721]

The CI now takes too long...

[kinto0]

this is awesome. thank you for looking into this and finding a simple solution that I imagine works really well.

• it's unclear from the doc-comment if this script is executed on the client or on CI (bundled with the pyrefly binary). can you document it and explain the limitations? from the code, it seems like it's only run on CI.
• let's try removing that type: ignore. what made you add it (there's no pyrefly.toml)? if this crate is checked with a checker, can we vendor docify to avoid it? or does docify have a bunch of dependencies?

[asukaminato0721]

How this script works:

It only runs on CI, writes the doc to stub, then bundles with the Pyrefly binary.

The type ignore is ... because this script needs docify, but only requires it at build time, so I use uv to run it, but my type checker will warn about it.

docify is a single script that relies on libcst.

https://github.com/AThePeanut4/docify/blob/main/docify.py

[kinto0]

awesome! hit ready for review when you're ready, I'm excited to get this in.

one thing I will change is add a buck target for the build script so we can run it through buck (and maybe remove the lint suppression?)

[yangdanny97]

IMO better to run this bundling process whenever we pull in updates for the typeshed stubs, as opposed to every time we build. I believe that is what ty does as well.

That already happens using a Python script, so you could add your docstring copying logic to that directly.

pyrefly/crates/pyrefly_bundled/update.py

Line 4 in fdf8f22

# This source code is licensed under the MIT license found in the