Developer Notes

Developing Qt for Python requires people to understand different processes and steps that need to be taken into account when dealing with topics related to modules, bindings, examples, and more.

Development Topics

• Add a new module
  • Add bindings
  • Distribution
  • Add documentation
• Add a new example or port one
  • Add a new example
  • Port a Qt example
• Add a new tool or a Qt tool wrapper
  • Add a new tool
  • Add a Qt tool wrapper
• Adapting to changes in supported Python versions
  • Relevant preprocessor defines
  • Removing outdated Python versions
  • Byte code checks
  • Adapting to new Python versions
• Fixing Documentation issues
  • Fixing texts
  • Fixing snippets
  • Maintaining additionaldocs.lst
  • Inheritance graphs
  • Changes to the documentation build infrastructure
• Adapt to new Qt versions
  • Adapting to source changes
  • Bumping the version
• Test a wheel
• Build on the command line
• Build with address sanitizer (Linux)
• Build with thread sanitizer
• De-Virtualize the Python Files
• QtAsyncio developer notes
  • QtAsyncio vs asyncio
  • The step function
  • Keeping QtAsyncio in sync with asyncio
  • asyncio developer guidance
• Signalmanager
• Description
  • Issues
  • Plans
• Python Libraries
  • UNIX
  • Windows
  • Tools

Implementation details

Complementary, here you can find the reasoning and motivation for the many features and implementation details that the project has:

• The Set of Enum Features
  • The Possible Enum Flags
  • The most likely flags needed
  • Flags for completeness
• The Transition To The Limited Python API (PEP384)
  • Foreword
  • Changed Modules
  • Using The New Type API
  • Future Versions Of The Limited API
  • Appendix A: The Transition To Simpler Types
  • Appendix B: Verification Of PyTypeObject
• The signature C extension
  • Short Introduction to the Topic
  • The Idea to Support Signatures
  • Impacts of The Signature Module
  • Update and Future of the Signature Module
  • Literature
• Improving the Quality of Signatures with mypy
  • Preliminary
  • Running the mypy Tests
  • Types of mypy Errors
  • Unsolvable Errors
  • Conclusion and Future
  • Literature
• Why do we have a __feature__?
  • History
  • Why are features selectable per-module?
  • Why dunder, and why not __future__?
• The snake_case feature
• The true_property feature
  • Normal Properties
  • Special Properties
  • Class properties
  • About Property Completeness
  • Name Clashes and Solution
• The __feature__ import
  • Overriding __import__
  • IDEs and Modifying Python stub files
• Qt Remote Objects Overview
  • Replicas are latent copies
  • How does this affect PySide?
  • RepFile PySide type
  • Replica type
  • Source type
  • Realizing Source/Replica types in python
• Fixing Type Hints
  • Overview
  • Tools and Setup
  • Finding Type Hints Issues
  • How to Fix
  • Rebuild and Verify
  • Special Cases and Workarounds
• Python File Embedding
  • Embed folder contents
  • Modifying the helper files
  • Debugging without rebuilding