question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Add documentation for methods or helpers that are specific to qtpy

See original GitHub issue

This includes documenting

  • from qtpy.QtCore import Signal, Slot
  • The use of the openfiledialog openfolderdialog helpers (study the option of overloading QFileDialog… which would also need documentation as it would change the default behavior)
  • Where to find the Qt version from qtpy.QtCore import __version__

Issue Analytics

  • State:closed
  • Created 7 years ago
  • Comments:5 (5 by maintainers)

github_iconTop GitHub Comments

1reaction
dalthvizcommented, Nov 5, 2021

Beyond just letting people know to import Signal and Slot from here, are there QtPy-specific syntax or semantics that need to be described, or something else we want to say?

Besides the things described at the OP probably some description for the env variables that QtPy uses (FORCE_QT_API, QT_API) as well as state variables available (PYQT5, PYQT6, PYSIDE2, PYSIDE6, etc) could be nice (also letting clear that we are trying to follow Qt5 layout for things, so for example pyqtSlot -> Slot)

I assume this is related to Get rid of getexistingdirectory and patch QFileDialog? #26 ? Basically, we’d need basic documentation for these QtPy-specific helper functions? Since I’m not familiar with them, beyond just elaborating on the API and anything else the docstrings I’d need some help here with what to say.

Yes, related in the sense that following what is decided there (keeping it as it is, adding aliases to those functions or patching QFileDialog) the documentation should reflect that

0reactions
CAM-Gerlachcommented, Nov 4, 2021

@dalthviz I can try to help with this, but given I’m not a Qt expert (both a benefit and a downside when writing user docs), I’ll need a little more detail on what you want said here:

  • Beyond just letting people know to import Signal and Slot from here, are there QtPy-specific syntax or semantics that need to be described, or something else we want to say?
  • I assume this is related to #26 ? Basically, we’d need basic documentation for these QtPy-specific helper functions? Since I’m not familiar with them, beyond just elaborating on the API and anything else the docstrings I’d need some help here with what to say.
  • This seems pretty streightforward
Read more comments on GitHub >

github_iconTop Results From Across the Web

The Qt Help Framework - Qt for Python - Qt Documentation
Contains the table of contents, indices, and references to the actual documentation files (*.html). It also defines a unique namespace for the documentation....
Read more >
Documenting Python Code: A Complete Guide
A complete guide to documenting Python code. Whether you're documenting a small script or a large project, whether you're a beginner or seasoned...
Read more >
PyQtGraph's Helper Functions - Read the Docs
Qt uses the classes QColor, QPen, and QBrush to determine how to draw lines ... these functions directly–any function or method that accepts...
Read more >
Using automatic documentation of my own function with Qt ...
What is this? Where is it documented? Can I use this to generate my own Qt Assistant qch help files or something?
Read more >
qtpy/CHANGELOG.md at master · spyder-ide/qtpy - GitHub
... 61 - Add documentation for methods or helpers that are specific to qtpy ... PR 357 - PR: Add initial Methods, helpers...
Read more >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found