https://github.com/tmr232/cute

Cross-Qt compatibility module for IDAPython.
https://github.com/tmr232/cute

Last synced: about 1 month ago
JSON representation

Cross-Qt compatibility module for IDAPython.

• Host: GitHub
• URL: https://github.com/tmr232/cute
• Owner: tmr232
• Created: 2016-01-15T14:59:10.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2019-10-02T17:52:22.000Z (about 5 years ago)
• Last Synced: 2024-05-12T20:48:27.973Z (6 months ago)
• Language: Python
• Size: 7.81 KB
• Stars: 13
• Watchers: 5
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst

Awesome Lists containing this project

README

        
Cute

====

Cross-Qt compatibility module for IDAPython.

What is it?

-----------

Cute is a tiny compatibility module, to allow IDAPython code to use

PySide/Qt4 and PyQt/Qt5 seamlessly.

Motivation

----------

Cute was originally a part of

`Sark `__

(``sark.qt``). Since no-one likes dependencies, especially for things

this small, no-one used it. So I decided to release it as a separate

module as well, so that people can just take the file as-is and use it

in their own code.

Usage

-----

Qt Modules

~~~~~~~~~~

Importing ``QtCore``, ``QtGui`` and ``QtWidgets`` works for all Qt

versions. For Qt4, ``QtWidgets`` is an alias for ``QtGui``, so Qt5 code

with ``QtWidgets`` / ``QtGui`` separation will work on Qt4 as well.

::

    from cute import QtCure, QtGui, QtWidgets

Connecting to Signals

~~~~~~~~~~~~~~~~~~~~~

Cute offers a ``cute.connect(...)`` method to mitigate the difference

between Qt4 and Qt5.

::

    # Qt4 Code:

    QtCore.QObject.connect(my_object, QtCore.SIGNAL('error(QProcess::ProcessError)'), my_callback)

    # Qt5 Code:

    my_object.error.connect(my_callback)

    # Cute Code:

    cute.connect(my_object, 'error(QProcess::ProcessError)', my_callback)

The API for disconnecting is the same, just use the

``cute.disconnect(...)`` function.

Form to Widget

~~~~~~~~~~~~~~

IDA has 2 APIs for getting the widget associated with a TForm. One for

PyQt and one for PySide. Cute wraps them both in one function.

::

    my_widget = cute.form_to_widget(my_tform)

Which Qt Should I Use?

~~~~~~~~~~~~~~~~~~~~~~

Sometimes, you *do* need to to know the Qt version your code uses. For

those cases, ask the ``use_qt5`` variable.

::

    if cute.use_qt5:

        print 'Use Qt5'

    else:

        print 'Use Qt4'

In a Project

~~~~~~~~~~~~

There are two recommended ways to use Cute:

#. Copy it into your own project. This way *does* create code duplication, but avoid dependencies.

#. Install it as a package - ``pip install idacute``.

Licensing

---------

Cute is released under the MIT license, so you are free to use it in any

project whatsoever.

FAQ

---

**Q:** Why did you name it "cute"?

**A:** For years I was sure "Qt" is pronounced "Q T". This is my effort

to remind myself it is not.