Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Exclude some files completely? #469

Open
AronDurkinSSS opened this issue Dec 6, 2022 · 2 comments
Open

Exclude some files completely? #469

AronDurkinSSS opened this issue Dec 6, 2022 · 2 comments

Comments

@AronDurkinSSS
Copy link

Problem Description

I've got some Python 2.7 stuff in my project and while they function fine in the intended environment (Maya), pdoc can't execute them under 3.9 and I can't generate docs for any of the package despite just one file being problematic and hundreds being fine.

Proposal

A way to flag files as ignore completely, so we don't run into errors in "pdoc\extract.py", line 211, in load_module"

Alternatives

I've no idea sadly :(

@mhils
Copy link
Member

mhils commented Dec 6, 2022

https://pdoc.dev/docs/pdoc.html#exclude-submodules-from-being-documented - if this doesn't work, the only way forward might be to run pdoc as a library where you first import manually (https://github.com/mitmproxy/pdoc/blob/main/examples/library-usage/make.py).

@AronDurkinSSS
Copy link
Author

thanks, yeah i tried that, seems it still gets loaded and i get an error about builtins coz of py2.7, I've had a go at using it as a library, struggling with accessing modules / packages outside of the pdoc project but that's not on you, I'm a bit of a n00b. I added my desired module dir to the interpreter paths but PyCharm still tells me No Module named before it even gets to the pdoc stuff.

If i do get it working, is there more docs to using it as a library? Not sure how I would omit a file this way.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants