Comments (6)
Hello @miloth,
There is currently no way to include local objects.inv file. But support for this could be relatively easy to add. Maybe adding an new option —intersphinx-file.
Looking at the file sphinx.py would be a good starting point.
from pydoctor.
Better, we could simply add support for the file:// scheme.
from pydoctor.
Hi @tristanlatr, thanks for the response and the suggestions. I don't have hours available to allocate to this, but I will get back to it if I find some.
I don't know if the url file://
scheme will work, because the links in the compiled docs should point to the private URL where the dependency is hosted, not where the local objects.inv
files are fetched for the intershpinx at docs compile.
from pydoctor.
I don't know if the url file:// scheme will work, because the links in the compiled docs should point to the private URL where the dependency is hosted, not where the local objects.inv files are fetched for the intershpinx at docs compile.
I think the is a misunderstanding, I’m not proposing to generate links with the file:// scheme, but to use the file:// scheme in the intersphinx list configuration to differentiate local and remote objects.inv. But, thinking about it twice: it’s probably misguided because the file:// scheme theoretically also support providing a remote host to fetch the file from…
Any opinion about this @glyph ?
from pydoctor.
But, thinking about it twice: it’s probably misguided because the file:// scheme theoretically also support providing a remote host to fetch the file from…
Any opinion about this @glyph ?
technically speaking, file://host/.../
is valid, but the only practical way to interpret this is a UNC pathname, which is local…enough, I guess. I think using this URI scheme is a good way to disambiguate, and if you want to be careful to not open up an esoteric minor vulnerability that could cause a user's machine to reach out to a surprising UNC host, you can just enforce that the host of the file URI is ''
before passing it on.
from pydoctor.
Easier: if the string doesn’t contain ://
then it’s treated like a file. This is how Sphinx handles it.
from pydoctor.
Related Issues (20)
- Fix the standard library smoke test
- Drop support for python 3.6 HOT 3
- Is this normal? HOT 3
- Be clear that exit code 2 means partial success HOT 3
- Fix verbose mode
- Regression on in link not found warnings linenumbers
- ERROR collecting pydoctor/test/test_attrs.py with Python-3.12 HOT 3
- Including default values for Pydantic model attributes HOT 3
- Don't raise exceptions when offline HOT 1
- dev-doc: "pydoctor_primer" not documented HOT 6
- Missing test dependencies: hypothesis HOT 4
- Failing and undocumented test "test_pyval_repr.py::test_expressions_parens" HOT 3
- "tox -p all" not working HOT 3
- "tox -p all" to noise for extern contributors HOT 4
- Contribution docu: Code Style HOT 1
- Test docu: Missing docu about test_packags.py and processPackage()
- Build infrastructure: Run ReadTheDocs on every PR/commit? HOT 2
- Find an extensible manner to integrate templatewriter customizations
- How to break down (debug) " Cannot find link target for XYZ" errors? HOT 9
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from pydoctor.