Software Versions
=================

King Phisher development needs to track the support of critical libraries it
uses for compatibility purposes. This information is used to make decisions
regarding dropping support for legacy systems.

Python Packages Reference Table
-------------------------------

**Last Updated:** December 3\ :sup:`rd`, 2019 by Spencer McIntyre

+------------------------+------------------------------------+----------------+
| Package                | Reason                             | Pinned Version |
+------------------------+------------------------------------+----------------+
| graphene               |                                    | 2.1.8          |
+------------------------+------------------------------------+----------------+
| graphene-sqlalchemy    | Holds graphql-relay                | 2.2.0          |
|                        | graphql-core <3                    |                |
+------------------------+------------------------------------+----------------+
| graphql-relay          | Highest version for                | 2.1.1          |
|                        | graphene-sqlalchemy                |                |
+------------------------+------------------------------------+----------------+
| numpy                  | Required by Basemap in the         | 1.16.4         |
|                        | setup.py file before installation  |                |
+------------------------+------------------------------------+----------------+
| matplotlib             | Windows build limitation           | 2.2.4          |
+------------------------+------------------------------------+----------------+
| cryptography           | Required by Paramiko 2.60          | 2.2.4          |
+------------------------+------------------------------------+----------------+
| pyproj                 | Required by Basemap                |                |
+------------------------+------------------------------------+----------------+
| pygobject              | Required for gi/gtk                |                |
+------------------------+------------------------------------+----------------+
| psycopg2               | Required by SQLAlchmey             |                |
+------------------------+------------------------------------+----------------+
| markdown               | Required by py-gfm (must be <3.0)  | 2.6.11         |
+------------------------+------------------------------------+----------------+
| jsonschema             | Minor unit tests failures          | 2.6.0          |
+------------------------+------------------------------------+----------------+

Operating System Reference Table
--------------------------------

**Last Updated:** December 3\ :sup:`rd`, 2019 by Spencer McIntyre

+-----------------------------+-------------------------+----------------+
| Flavor                      | Software                | Version        |
+-----------------------------+-------------------------+----------------+
| Backbox 5.1                 | GTK3                    | 3.18.9         |
|                             +-------------------------+----------------+
|                             | Python3                 | 3.5.2          |
+-----------------------------+-------------------------+----------------+
| Debian 7 (Wheezy)           | GTK3                    | 3.4.2          |
|                             +-------------------------+----------------+
| May 4\ :sup:`th` 2013       | Python3                 | 3.2.3          |
+-----------------------------+-------------------------+----------------+
| Debian 8 (Jessie)           | GTK3                    | 3.14.5         |
|                             +-------------------------+----------------+
| April 25\ :sup:`th` 2015    | Python3                 | 3.4.2          |
+-----------------------------+-------------------------+----------------+
| Debian 9 (Stretch)          | GTK3                    | 3.22.11        |
|                             +-------------------------+----------------+
| June 17\ :sup:`th` 2017     | Python3                 | 3.5.3          |
+-----------------------------+-------------------------+----------------+
| Debian 10 (Buster)          | GTK3                    | 3.22.29        |
|                             +-------------------------+----------------+
|                             | Python3                 | 3.6.4          |
+-----------------------------+-------------------------+----------------+
| Fedora 24                   | GTK3                    | 3.20.6         |
|                             +-------------------------+----------------+
| June 21\ :sup:`st` 2016     | Python3                 | 3.5.1          |
+-----------------------------+-------------------------+----------------+
| Fedora 25                   | GTK3                    | 3.22.2         |
|                             +-------------------------+----------------+
| November 15\ :sup:`th` 2016 | Python3                 | 3.5.4          |
+-----------------------------+-------------------------+----------------+
| Fedora 26                   | GTK3                    | 3.22.16        |
|                             +-------------------------+----------------+
| July 11\ :sup:`th` 2017     | Python3                 | 3.6.4          |
+-----------------------------+-------------------------+----------------+
| Fedora 27                   | GTK3                    | 3.22.24        |
|                             +-------------------------+----------------+
| November 14\ :sup:`th` 2017 | Python3                 | 3.6.4          |
+-----------------------------+-------------------------+----------------+
| Fedora 28                   | GTK3                    | 3.22.30        |
|                             +-------------------------+----------------+
| May 1\ :sup:`st` 2018       | Python3                 | 3.6.5          |
+-----------------------------+-------------------------+----------------+
| Fedora 29                   | GTK3                    | 3.24.1         |
|                             +-------------------------+----------------+
| October 30\ :sup:`th` 2018  | Python3                 | 3.7.0          |
+-----------------------------+-------------------------+----------------+
| Fedora 30                   | GTK3                    | 3.24.8         |
|                             +-------------------------+----------------+
| April 30\ :sup:`th` 2019    | Python3                 | 3.7.3          |
+-----------------------------+-------------------------+----------------+
| Fedora 31                   | GTK3                    | 3.24.12        |
|                             +-------------------------+----------------+
| October 22\ :sup:`nd` 2019  | Python3                 | 3.7.4          |
+-----------------------------+-------------------------+----------------+
| Kali Rolling                | GTK3                    | 3.22.29        |
|                             +-------------------------+----------------+
|                             | Python3                 | 3.7.2 :sup:`1` |
+-----------------------------+-------------------------+----------------+
| Ubuntu 14.04 (Trusty)       | GTK3                    | 3.10.8         |
|                             +-------------------------+----------------+
| April 17\ :sup:`th` 2014    | Python3                 | 3.4.3          |
+-----------------------------+-------------------------+----------------+
| Ubuntu 16.04 (Xenial)       | GTK3                    | 3.18.9         |
|                             +-------------------------+----------------+
| April 21\ :sup:`st` 2016    | Python3                 | 3.5.2          |
+-----------------------------+-------------------------+----------------+
| Windows                     | GTK3                    | 3.18.9         |
|                             +-------------------------+----------------+
|                             | Python3                 | 3.4.4          |
+-----------------------------+-------------------------+----------------+

:sup:`1` Kali Rolling is continuously updated. The version number noted was
accurate as of the last time this document was updated.

Information Sources
-------------------

Debian
~~~~~~

Search using `packages.debian.com`_.

Fedora
~~~~~~

.. code-block:: shell

   # use koji
   sudo dnf install koji
   # check the version of GTK3 for Fedora 24
   koji latest-pkg --all f24 | grep -i gtk3

Windows
~~~~~~~

.. code-block:: shell

   # run KingPhisher in debug mode
   cd king-phisher
   python KingPhisher -L DEBUG
   # The first 7 lines of out put will contain gi.repository version information.
   # Get python version
   python --version

.. _packages.debian.com: https://packages.debian.org/search
