From 2e5b7711370aac9e79392363c86080870d82c587 Mon Sep 17 00:00:00 2001
From: aclist <92275929+aclist@users.noreply.github.com>
Date: Mon, 8 Dec 2025 17:32:25 +0900
Subject: [PATCH] feat: dzgui 7 alpha
---
CHANGELOG.md | 24 +
CODE_OF_CONDUCT.md | 34 +
LICENSE | 3 +
README.md | 28 +
docs/LICENSE | 674 ++++++++++++++++++
docs/Makefile | 20 +
docs/README.md | 22 +
docs/make.bat | 35 +
docs/requirements.txt | 2 +
docs/source/bugs.rst | 60 ++
docs/source/conf.py | 40 ++
docs/source/development.rst | 12 +
docs/source/images/01.png | Bin 0 -> 34154 bytes
docs/source/images/02.png | Bin 0 -> 32750 bytes
docs/source/images/03.png | Bin 0 -> 41721 bytes
docs/source/images/04.png | Bin 0 -> 623147 bytes
docs/source/images/05.png | Bin 0 -> 582334 bytes
docs/source/images/06.png | Bin 0 -> 427406 bytes
docs/source/images/07.png | Bin 0 -> 228379 bytes
docs/source/images/08.png | Bin 0 -> 12071 bytes
docs/source/images/09.png | Bin 0 -> 31823 bytes
docs/source/index.rst | 69 ++
docs/source/installation.rst | 64 ++
docs/source/kb.rst | 77 ++
docs/source/locale.rst | 12 +
docs/source/setup.rst | 53 ++
docs/source/steam.rst | 90 +++
docs/source/uninstallation.rst | 12 +
docs/source/usage.rst | 25 +
dzgui/__init__.py | 0
dzgui/api/__init__.py | 0
dzgui/api/bm.py | 40 ++
dzgui/api/mods.py | 170 +++++
dzgui/api/pefile.py | 465 ++++++++++++
dzgui/api/probe.py | 62 ++
dzgui/api/servers.py | 444 ++++++++++++
dzgui/api/steam.py | 137 ++++
dzgui/config/__init__.py | 0
dzgui/config/convert.py | 72 ++
dzgui/config/freedesktop.py | 42 ++
dzgui/config/ipdb.py | 97 +++
dzgui/config/query.py | 60 ++
dzgui/config/uninstall.py | 10 +
dzgui/config/update.py | 25 +
dzgui/config/userprefs.py | 12 +
dzgui/config/xdg.py | 90 +++
dzgui/const/constants.py | 53 ++
dzgui/const/endpoints.py | 23 +
dzgui/const/enum.py | 525 ++++++++++++++
dzgui/const/update.py | 15 +
dzgui/controllers/mc.py | 545 ++++++++++++++
dzgui/controllers/model.py | 256 +++++++
dzgui/data/images/dzgui | Bin 0 -> 509336 bytes
dzgui/data/images/example.png | Bin 0 -> 133344 bytes
dzgui/data/images/grid.png | Bin 0 -> 2061329 bytes
dzgui/data/images/hero.png | Bin 0 -> 2099301 bytes
dzgui/data/images/icon.png | Bin 0 -> 469649 bytes
dzgui/data/images/icons/128.png | Bin 0 -> 32867 bytes
dzgui/data/images/icons/16.png | Bin 0 -> 1067 bytes
dzgui/data/images/icons/24.png | Bin 0 -> 1660 bytes
dzgui/data/images/icons/256.png | Bin 0 -> 121255 bytes
dzgui/data/images/icons/32.png | Bin 0 -> 2723 bytes
dzgui/data/images/icons/48.png | Bin 0 -> 5587 bytes
dzgui/data/images/icons/64.png | Bin 0 -> 9391 bytes
dzgui/data/images/icons/96.png | Bin 0 -> 19666 bytes
dzgui/data/images/logo.png | Bin 0 -> 81 bytes
dzgui/init/coords.py | 23 +
dzgui/init/dayz.py | 22 +
dzgui/init/flock.py | 25 +
dzgui/init/migrate.py | 37 +
dzgui/init/prefix.py | 23 +
dzgui/init/prereqs.py | 28 +
dzgui/init/proc.py | 26 +
dzgui/init/scan.py | 51 ++
dzgui/init/update.py | 50 ++
dzgui/lib/__init__.py | 0
dzgui/main.py | 115 +++
dzgui/scripts/update.sh | 28 +
dzgui/util/__init__.py | 0
dzgui/util/_json.py | 27 +
dzgui/util/bash.py | 4 +
dzgui/util/cooldown.py | 17 +
dzgui/util/css.py | 50 ++
dzgui/util/deck.py | 30 +
dzgui/util/diag.py | 88 +++
dzgui/util/dist.py | 86 +++
dzgui/util/format.py | 44 ++
dzgui/util/ip.py | 137 ++++
dzgui/util/keys.py | 26 +
dzgui/util/localize.py | 16 +
dzgui/util/map_count.py | 28 +
dzgui/util/margins.py | 12 +
dzgui/util/open_links.py | 61 ++
dzgui/util/redact.py | 6 +
dzgui/util/strings.py | 479 +++++++++++++
dzgui/util/symlink.py | 50 ++
dzgui/views/__init__.py | 0
dzgui/views/base.py | 668 +++++++++++++++++
dzgui/views/components/buttonbox.py | 86 +++
dzgui/views/components/connect_panel.py | 17 +
dzgui/views/components/eventbox.py | 38 +
dzgui/views/components/filter_panel.py | 286 ++++++++
dzgui/views/components/icon.py | 10 +
dzgui/views/components/label.py | 12 +
dzgui/views/components/mod_panel.py | 88 +++
dzgui/views/components/right_panel.py | 125 ++++
dzgui/views/components/toast.py | 46 ++
dzgui/views/components/web_button.py | 15 +
dzgui/views/dialogs/early_alert.py | 35 +
dzgui/views/dialogs/entry.py | 80 +++
dzgui/views/dialogs/filepicker.py | 34 +
dzgui/views/dialogs/generic.py | 104 +++
dzgui/views/dialogs/lan.py | 152 ++++
dzgui/views/dialogs/link_dialog.py | 54 ++
dzgui/views/dialogs/server_details.py | 102 +++
dzgui/views/dialogs/server_mods.py | 94 +++
dzgui/views/dialogs/watcher.py | 18 +
dzgui/views/mixins/context_mixin.py | 75 ++
dzgui/views/mixins/cursor_mixin.py | 58 ++
dzgui/views/mixins/mods_mixin.py | 16 +
dzgui/views/mixins/scrollable_mixin.py | 21 +
dzgui/views/pages/changelog.py | 30 +
dzgui/views/pages/keys.py | 97 +++
dzgui/views/pages/options.py | 509 +++++++++++++
dzgui/views/pages/thanks.py | 34 +
dzgui/views/trees/tree_base.py | 185 +++++
dzgui/views/trees/tree_log.py | 80 +++
dzgui/views/trees/tree_menu.py | 86 +++
dzgui/views/trees/tree_mods.py | 88 +++
dzgui/views/trees/tree_server_mods.py | 104 +++
dzgui/views/trees/tree_servers.py | 305 ++++++++
pyproject.toml | 100 +++
requirements.txt | 3 +
scripts/copy_changelog.py | 11 +
tests/__init__.py | 0
tests/fixtures/__init__.py | 5 +
tests/fixtures/config.json | 16 +
tests/fixtures/dztuirc_one | 45 ++
tests/fixtures/dztuirc_two | 45 ++
tests/fixtures/in_library_but_bad_path.vdf | 11 +
tests/fixtures/in_library_on_second_drive.vdf | 19 +
tests/fixtures/malformed.vdf | 1 +
tests/fixtures/not_in_library.vdf | 11 +
tests/test_changelog.py | 8 +
tests/test_config.py | 79 ++
tests/test_cooldown.py | 19 +
tests/test_ip.py | 32 +
tests/test_locale.py | 28 +
tests/test_pefile.py | 60 ++
tests/test_remote_api.py | 26 +
150 files changed, 10359 insertions(+)
create mode 100644 CHANGELOG.md
create mode 100644 CODE_OF_CONDUCT.md
create mode 100644 README.md
create mode 100644 docs/LICENSE
create mode 100644 docs/Makefile
create mode 100644 docs/README.md
create mode 100644 docs/make.bat
create mode 100644 docs/requirements.txt
create mode 100644 docs/source/bugs.rst
create mode 100644 docs/source/conf.py
create mode 100644 docs/source/development.rst
create mode 100644 docs/source/images/01.png
create mode 100644 docs/source/images/02.png
create mode 100644 docs/source/images/03.png
create mode 100644 docs/source/images/04.png
create mode 100644 docs/source/images/05.png
create mode 100644 docs/source/images/06.png
create mode 100644 docs/source/images/07.png
create mode 100644 docs/source/images/08.png
create mode 100644 docs/source/images/09.png
create mode 100644 docs/source/index.rst
create mode 100644 docs/source/installation.rst
create mode 100644 docs/source/kb.rst
create mode 100644 docs/source/locale.rst
create mode 100644 docs/source/setup.rst
create mode 100644 docs/source/steam.rst
create mode 100644 docs/source/uninstallation.rst
create mode 100644 docs/source/usage.rst
create mode 100644 dzgui/__init__.py
create mode 100644 dzgui/api/__init__.py
create mode 100644 dzgui/api/bm.py
create mode 100644 dzgui/api/mods.py
create mode 100644 dzgui/api/pefile.py
create mode 100644 dzgui/api/probe.py
create mode 100644 dzgui/api/servers.py
create mode 100644 dzgui/api/steam.py
create mode 100644 dzgui/config/__init__.py
create mode 100644 dzgui/config/convert.py
create mode 100644 dzgui/config/freedesktop.py
create mode 100644 dzgui/config/ipdb.py
create mode 100644 dzgui/config/query.py
create mode 100644 dzgui/config/uninstall.py
create mode 100644 dzgui/config/update.py
create mode 100644 dzgui/config/userprefs.py
create mode 100644 dzgui/config/xdg.py
create mode 100644 dzgui/const/constants.py
create mode 100644 dzgui/const/endpoints.py
create mode 100644 dzgui/const/enum.py
create mode 100644 dzgui/const/update.py
create mode 100644 dzgui/controllers/mc.py
create mode 100644 dzgui/controllers/model.py
create mode 100644 dzgui/data/images/dzgui
create mode 100644 dzgui/data/images/example.png
create mode 100644 dzgui/data/images/grid.png
create mode 100644 dzgui/data/images/hero.png
create mode 100644 dzgui/data/images/icon.png
create mode 100644 dzgui/data/images/icons/128.png
create mode 100644 dzgui/data/images/icons/16.png
create mode 100644 dzgui/data/images/icons/24.png
create mode 100644 dzgui/data/images/icons/256.png
create mode 100644 dzgui/data/images/icons/32.png
create mode 100644 dzgui/data/images/icons/48.png
create mode 100644 dzgui/data/images/icons/64.png
create mode 100644 dzgui/data/images/icons/96.png
create mode 100644 dzgui/data/images/logo.png
create mode 100644 dzgui/init/coords.py
create mode 100644 dzgui/init/dayz.py
create mode 100644 dzgui/init/flock.py
create mode 100644 dzgui/init/migrate.py
create mode 100644 dzgui/init/prefix.py
create mode 100644 dzgui/init/prereqs.py
create mode 100644 dzgui/init/proc.py
create mode 100644 dzgui/init/scan.py
create mode 100644 dzgui/init/update.py
create mode 100644 dzgui/lib/__init__.py
create mode 100644 dzgui/main.py
create mode 100644 dzgui/scripts/update.sh
create mode 100644 dzgui/util/__init__.py
create mode 100644 dzgui/util/_json.py
create mode 100644 dzgui/util/bash.py
create mode 100644 dzgui/util/cooldown.py
create mode 100644 dzgui/util/css.py
create mode 100644 dzgui/util/deck.py
create mode 100644 dzgui/util/diag.py
create mode 100644 dzgui/util/dist.py
create mode 100644 dzgui/util/format.py
create mode 100644 dzgui/util/ip.py
create mode 100644 dzgui/util/keys.py
create mode 100644 dzgui/util/localize.py
create mode 100644 dzgui/util/map_count.py
create mode 100644 dzgui/util/margins.py
create mode 100644 dzgui/util/open_links.py
create mode 100644 dzgui/util/redact.py
create mode 100644 dzgui/util/strings.py
create mode 100644 dzgui/util/symlink.py
create mode 100644 dzgui/views/__init__.py
create mode 100644 dzgui/views/base.py
create mode 100644 dzgui/views/components/buttonbox.py
create mode 100644 dzgui/views/components/connect_panel.py
create mode 100644 dzgui/views/components/eventbox.py
create mode 100644 dzgui/views/components/filter_panel.py
create mode 100644 dzgui/views/components/icon.py
create mode 100644 dzgui/views/components/label.py
create mode 100644 dzgui/views/components/mod_panel.py
create mode 100644 dzgui/views/components/right_panel.py
create mode 100644 dzgui/views/components/toast.py
create mode 100644 dzgui/views/components/web_button.py
create mode 100644 dzgui/views/dialogs/early_alert.py
create mode 100644 dzgui/views/dialogs/entry.py
create mode 100644 dzgui/views/dialogs/filepicker.py
create mode 100644 dzgui/views/dialogs/generic.py
create mode 100644 dzgui/views/dialogs/lan.py
create mode 100644 dzgui/views/dialogs/link_dialog.py
create mode 100644 dzgui/views/dialogs/server_details.py
create mode 100644 dzgui/views/dialogs/server_mods.py
create mode 100644 dzgui/views/dialogs/watcher.py
create mode 100644 dzgui/views/mixins/context_mixin.py
create mode 100644 dzgui/views/mixins/cursor_mixin.py
create mode 100644 dzgui/views/mixins/mods_mixin.py
create mode 100644 dzgui/views/mixins/scrollable_mixin.py
create mode 100644 dzgui/views/pages/changelog.py
create mode 100644 dzgui/views/pages/keys.py
create mode 100644 dzgui/views/pages/options.py
create mode 100644 dzgui/views/pages/thanks.py
create mode 100644 dzgui/views/trees/tree_base.py
create mode 100644 dzgui/views/trees/tree_log.py
create mode 100644 dzgui/views/trees/tree_menu.py
create mode 100644 dzgui/views/trees/tree_mods.py
create mode 100644 dzgui/views/trees/tree_server_mods.py
create mode 100644 dzgui/views/trees/tree_servers.py
create mode 100644 pyproject.toml
create mode 100644 requirements.txt
create mode 100644 scripts/copy_changelog.py
create mode 100644 tests/__init__.py
create mode 100644 tests/fixtures/__init__.py
create mode 100644 tests/fixtures/config.json
create mode 100644 tests/fixtures/dztuirc_one
create mode 100644 tests/fixtures/dztuirc_two
create mode 100644 tests/fixtures/in_library_but_bad_path.vdf
create mode 100644 tests/fixtures/in_library_on_second_drive.vdf
create mode 100644 tests/fixtures/malformed.vdf
create mode 100644 tests/fixtures/not_in_library.vdf
create mode 100644 tests/test_changelog.py
create mode 100644 tests/test_config.py
create mode 100644 tests/test_cooldown.py
create mode 100644 tests/test_ip.py
create mode 100644 tests/test_locale.py
create mode 100644 tests/test_pefile.py
create mode 100644 tests/test_remote_api.py
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..50ed167
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,24 @@
+## Added
+- Add pyproject.toml file
+- requests, packaging.version, psutil
+- Lockfile
+- Changelog text wrapping and formatting
+- Decouple UI components into modules
+- Choose from kilometer or miles distance display
+- More granular haversine calculation
+- Parse XDG data dirs with fallbacks
+- Dedicated mods page
+- Dedicated thanks page
+- Rearrange menus/breadcrumbs
+- Documentation ships with source
+- Open filepicker when generating system log
+
+## Changed
+- Reduce padding on keys button
+- Add icon to keys button
+- Add icons to API buttons
+- Boldface breadcrumbs
+
+## Unreleased
+- Setup wizard
+- Integrate add/connect widgets into main menu
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
new file mode 100644
index 0000000..c3838f0
--- /dev/null
+++ b/CODE_OF_CONDUCT.md
@@ -0,0 +1,34 @@
+# Preamble
+This project is free and open source software (FOSS) that is improved upon through the collaborative efforts of its community.
+
+To foster a collegial and productive atmosphere, all interactions with this project and its members shall be subject to these standards.
+
+"Members" refers to all project maintainers, contributors, developers, and end-users.
+Bear in mind that members may come from different countries, age groups, and backgrounds, and have differing experience levels.
+
+# Standards
+- Do not engage in antagonistic, offensive, discriminatory, threatening, or inflammatory behavior or trolling towards other members under any circumstances.
+- Engage in professional communication and stay on topic. Keep banter and jokes to a minimum, as they are liable to be misconstrued.
+- Do not post offensive or inflammatory off-site content, or content violating the above standards or the terms of service of this site.
+- Do not post spam. The site operator implements anti-spam measures that may lead to your account being revoked.
+- While this project relates to the DayZ computer game, it is not a forum for non-technical discussion about the game, or a place to post unsolicited links.
+- Do not use images, emoji reactions, or other non-verbal gags as justification for skirting the above standards.
+
+# Off-site content
+From time to time, it may be necessary to include off-site reference material or links. Use discretion when selecting this content and provide
+the minimum necessary for a technical discussion of the matter. Do not willfully include content that violates the above standards.
+
+# Enforcement
+Violations of the above standards will be subject to moderation decisions.
+
+Project maintainers reserve the right to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned with these standards, and will communicate reasons for moderation decisions when appropriate.
+
+Depending on the nature of the violation, or if the violation is not corrected after a warning has been issued, the user may be permanently barred from further interaction with the project.
+
+# Technical support
+This project is free software, but this does not imply a guarantee of free, unlimited tech support and troubleshooting in perpetuity.
+The software is provided as-is, and no warranty is made as to its fitness for a given purpose or that it is free from defects.
+
+Project members volunteer their time. Do not disparage other members when they attempt to assist you.
+Be aware that if you cannot provide enough information when filing a ticket, this may lead to the ticket being closed as non-actionable.
diff --git a/LICENSE b/LICENSE
index f288702..89ad0bb 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,3 +1,6 @@
+For additional licenses to submodules, see docs/licenses.
+
+
GNU GENERAL PUBLIC LICENSE
Version 3, 29 June 2007
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..58c68fc
--- /dev/null
+++ b/README.md
@@ -0,0 +1,28 @@
+## What this is
+DZGUI allows you to connect to both official and modded/community DayZ servers on Linux and provides a graphical interface for doing so.
+
+This overcomes certain limitations in the Linux client and helps prepare the game to launch by providing features like:
+
+- Search for and display server metadata in a table (server name, player count, ping, queue size, current gametime, distance, IP)
+- Add/delete/manage favorite servers by IP or ID
+- Quick-connect to favorite/recent servers
+- Find and prepare mods being requested by servers (choose from manual or automatic installation)
+- Bulk delete/update local mods
+- Concatenate launch options to pass to Steam
+- Connect to mod-enabled LAN servers
+
+## Setup and usage
+
+Refer to the documentation for installation and setup instructions:
+
+- [GitHub](https://aclist.github.io/dzgui/index.html)
+- [Mirror (Codeberg)](https://aclist.codeberg.page)
+
+
+
+
+## Attribution
+
+Geolocation records from [DB-IP](https://db-ip.com) under [CC 4.0 license](https://creativecommons.org/licenses/by/4.0/)
+
+# TODO: mention a2s/dayzquery
diff --git a/docs/LICENSE b/docs/LICENSE
new file mode 100644
index 0000000..f288702
--- /dev/null
+++ b/docs/LICENSE
@@ -0,0 +1,674 @@
+ GNU GENERAL PUBLIC LICENSE
+ Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc.
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+ Preamble
+
+ The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+ The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works. By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users. We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors. You can apply it to
+your programs, too.
+
+ When we speak of free software, we are referring to freedom, not
+price. Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+ To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights. Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+ For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received. You must make sure that they, too, receive
+or can get the source code. And you must show them these terms so they
+know their rights.
+
+ Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+ For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software. For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+ Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so. This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software. The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable. Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products. If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+ Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary. To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+ The precise terms and conditions for copying, distribution and
+modification follow.
+
+ TERMS AND CONDITIONS
+
+ 0. Definitions.
+
+ "This License" refers to version 3 of the GNU General Public License.
+
+ "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+ "The Program" refers to any copyrightable work licensed under this
+License. Each licensee is addressed as "you". "Licensees" and
+"recipients" may be individuals or organizations.
+
+ To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy. The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+ A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+ To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy. Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+ To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies. Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+ An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License. If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+ 1. Source Code.
+
+ The "source code" for a work means the preferred form of the work
+for making modifications to it. "Object code" means any non-source
+form of a work.
+
+ A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+ The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form. A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+ The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities. However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work. For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+ The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+ The Corresponding Source for a work in source code form is that
+same work.
+
+ 2. Basic Permissions.
+
+ All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met. This License explicitly affirms your unlimited
+permission to run the unmodified Program. The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work. This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+ You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force. You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright. Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+ Conveying under any other circumstances is permitted solely under
+the conditions stated below. Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+ 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+ No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+ When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+ 4. Conveying Verbatim Copies.
+
+ You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+ You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+ 5. Conveying Modified Source Versions.
+
+ You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+ a) The work must carry prominent notices stating that you modified
+ it, and giving a relevant date.
+
+ b) The work must carry prominent notices stating that it is
+ released under this License and any conditions added under section
+ 7. This requirement modifies the requirement in section 4 to
+ "keep intact all notices".
+
+ c) You must license the entire work, as a whole, under this
+ License to anyone who comes into possession of a copy. This
+ License will therefore apply, along with any applicable section 7
+ additional terms, to the whole of the work, and all its parts,
+ regardless of how they are packaged. This License gives no
+ permission to license the work in any other way, but it does not
+ invalidate such permission if you have separately received it.
+
+ d) If the work has interactive user interfaces, each must display
+ Appropriate Legal Notices; however, if the Program has interactive
+ interfaces that do not display Appropriate Legal Notices, your
+ work need not make them do so.
+
+ A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit. Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+ 6. Conveying Non-Source Forms.
+
+ You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+ a) Convey the object code in, or embodied in, a physical product
+ (including a physical distribution medium), accompanied by the
+ Corresponding Source fixed on a durable physical medium
+ customarily used for software interchange.
+
+ b) Convey the object code in, or embodied in, a physical product
+ (including a physical distribution medium), accompanied by a
+ written offer, valid for at least three years and valid for as
+ long as you offer spare parts or customer support for that product
+ model, to give anyone who possesses the object code either (1) a
+ copy of the Corresponding Source for all the software in the
+ product that is covered by this License, on a durable physical
+ medium customarily used for software interchange, for a price no
+ more than your reasonable cost of physically performing this
+ conveying of source, or (2) access to copy the
+ Corresponding Source from a network server at no charge.
+
+ c) Convey individual copies of the object code with a copy of the
+ written offer to provide the Corresponding Source. This
+ alternative is allowed only occasionally and noncommercially, and
+ only if you received the object code with such an offer, in accord
+ with subsection 6b.
+
+ d) Convey the object code by offering access from a designated
+ place (gratis or for a charge), and offer equivalent access to the
+ Corresponding Source in the same way through the same place at no
+ further charge. You need not require recipients to copy the
+ Corresponding Source along with the object code. If the place to
+ copy the object code is a network server, the Corresponding Source
+ may be on a different server (operated by you or a third party)
+ that supports equivalent copying facilities, provided you maintain
+ clear directions next to the object code saying where to find the
+ Corresponding Source. Regardless of what server hosts the
+ Corresponding Source, you remain obligated to ensure that it is
+ available for as long as needed to satisfy these requirements.
+
+ e) Convey the object code using peer-to-peer transmission, provided
+ you inform other peers where the object code and Corresponding
+ Source of the work are being offered to the general public at no
+ charge under subsection 6d.
+
+ A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+ A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling. In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage. For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product. A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+ "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source. The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+ If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information. But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+ The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed. Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+ Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+ 7. Additional Terms.
+
+ "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law. If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+ When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it. (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.) You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+ Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+ a) Disclaiming warranty or limiting liability differently from the
+ terms of sections 15 and 16 of this License; or
+
+ b) Requiring preservation of specified reasonable legal notices or
+ author attributions in that material or in the Appropriate Legal
+ Notices displayed by works containing it; or
+
+ c) Prohibiting misrepresentation of the origin of that material, or
+ requiring that modified versions of such material be marked in
+ reasonable ways as different from the original version; or
+
+ d) Limiting the use for publicity purposes of names of licensors or
+ authors of the material; or
+
+ e) Declining to grant rights under trademark law for use of some
+ trade names, trademarks, or service marks; or
+
+ f) Requiring indemnification of licensors and authors of that
+ material by anyone who conveys the material (or modified versions of
+ it) with contractual assumptions of liability to the recipient, for
+ any liability that these contractual assumptions directly impose on
+ those licensors and authors.
+
+ All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10. If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term. If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+ If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+ Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+ 8. Termination.
+
+ You may not propagate or modify a covered work except as expressly
+provided under this License. Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+ However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+ Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+ Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License. If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+ 9. Acceptance Not Required for Having Copies.
+
+ You are not required to accept this License in order to receive or
+run a copy of the Program. Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance. However,
+nothing other than this License grants you permission to propagate or
+modify any covered work. These actions infringe copyright if you do
+not accept this License. Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+ 10. Automatic Licensing of Downstream Recipients.
+
+ Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License. You are not responsible
+for enforcing compliance by third parties with this License.
+
+ An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations. If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+ You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License. For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+ 11. Patents.
+
+ A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based. The
+work thus licensed is called the contributor's "contributor version".
+
+ A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version. For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+ Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+ In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement). To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+ If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients. "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+ If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+ A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License. You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+ Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+ 12. No Surrender of Others' Freedom.
+
+ If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all. For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+ 13. Use with the GNU Affero General Public License.
+
+ Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work. The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+ 14. Revised Versions of this License.
+
+ The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time. Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+ Each version is given a distinguishing version number. If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation. If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+ If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+ Later license versions may give you additional or different
+permissions. However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+ 15. Disclaimer of Warranty.
+
+ THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+ 16. Limitation of Liability.
+
+ IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+ 17. Interpretation of Sections 15 and 16.
+
+ If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+ END OF TERMS AND CONDITIONS
+
+ How to Apply These Terms to Your New Programs
+
+ If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+ To do so, attach the following notices to the program. It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+
+ Copyright (C)
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see .
+
+Also add information on how to contact you by electronic and paper mail.
+
+ If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+ Copyright (C)
+ This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+ This is free software, and you are welcome to redistribute it
+ under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License. Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+ You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+.
+
+ The GNU General Public License does not permit incorporating your program
+into proprietary programs. If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library. If this is what you want to do, use the GNU Lesser General
+Public License instead of this License. But first, please read
+.
diff --git a/docs/Makefile b/docs/Makefile
new file mode 100644
index 0000000..04dcb46
--- /dev/null
+++ b/docs/Makefile
@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS ?=
+SPHINXBUILD ?= sphinx-build
+SOURCEDIR = source
+BUILDDIR = build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+ @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+ @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) -a
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 0000000..2eeddad
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,22 @@
+## Dependencies:
+
+```
+pip install -r requirements.txt
+```
+
+## Setup:
+
+1. Modify `source/conf.py`.
+2. Add .rst pages to `source` tree.
+
+## Build
+
+```
+$ mkdir build
+$ sphinx-build -M html source build -a
+```
+
+## Publish
+Export contents of `build/html` to host.
+
+N.B. For GitHub, touch `.nojekyll` file on the root of the branch.
diff --git a/docs/make.bat b/docs/make.bat
new file mode 100644
index 0000000..747ffb7
--- /dev/null
+++ b/docs/make.bat
@@ -0,0 +1,35 @@
+@ECHO OFF
+
+pushd %~dp0
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+ set SPHINXBUILD=sphinx-build
+)
+set SOURCEDIR=source
+set BUILDDIR=build
+
+%SPHINXBUILD% >NUL 2>NUL
+if errorlevel 9009 (
+ echo.
+ echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
+ echo.installed, then set the SPHINXBUILD environment variable to point
+ echo.to the full path of the 'sphinx-build' executable. Alternatively you
+ echo.may add the Sphinx directory to PATH.
+ echo.
+ echo.If you don't have Sphinx installed, grab it from
+ echo.https://www.sphinx-doc.org/
+ exit /b 1
+)
+
+if "%1" == "" goto help
+
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+goto end
+
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+
+:end
+popd
diff --git a/docs/requirements.txt b/docs/requirements.txt
new file mode 100644
index 0000000..a95b596
--- /dev/null
+++ b/docs/requirements.txt
@@ -0,0 +1,2 @@
+sphinx-rtd-theme
+sphinx-copybutton
diff --git a/docs/source/bugs.rst b/docs/source/bugs.rst
new file mode 100644
index 0000000..dcb4a75
--- /dev/null
+++ b/docs/source/bugs.rst
@@ -0,0 +1,60 @@
+Submitting a ticket
+==========================
+
+Tickets are tracked at the `DZGUI issue tracker `_.
+
+You will need to `register for a GitHub account `_ in order to submit one.
+
+If have checked the :doc:`kb` and `closed issues `_ area and did not find a solution, three ticket types are provided for your
+convenience:
+
+- **Bug report**: for unexpected, breaking behavior in the application
+- **Feature request**: to propose new functionality
+- **Troubleshooting**: if all else fails, you can request help here
+
+Reports by example
+--------------------------
+
+Below are some examples of how to format a constructive report that will ensure your problem can be resolved in a timely fashion.
+
+A non-actionable report
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+ Subject: add button
+
+ hi, you must add a button to show how long I have to wait to join a full server, the app is useless without this...do your job, guys!!! ;-)
+
+
+This report exhibits a number of problems:
+
+- Vague title and summary: in addition to being unclear, this will slow down filing the incoming report.
+- Problem space is poorly defined: it is not clear where the issue lies, where the feature is supposed to be implemented, nor why.
+- Lack of context: the feature may already exist, but there is not enough information to go on. Alternatively, the feature may be technically impossible to implement, but there is not enough
+ information to go on.
+- Incorrect report type: this is a feature request filed as a bug report.
+- Unprofessional tone: the message is disrespectful towards project members and inserts the user's subjective opinion.
+
+An actionable report
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+ Subject: Version 5.5.0-beta.2 crashes when selecting multiple table rows via Ctrl-click
+
+ This occurs specifically on version 5.5.0-beta.2 if the setting ALLOW_MULTI is set to ON. I was able to reproduce it using the following steps:
+
+ Distribution: Fedora
+
+ - Ensure that ALLOW_MULTI is set to ON
+ - Open the application and immediately navigate to the Server Browser
+ - Uses the Ctrl-click binding to select multiple rows in the table
+ - After >1 row is selected, the application crashes to the desktop with the following traceback (see attached dump)
+
+ Thanks for looking into this.
+
+
+This report is actionable because it is objective, specific, and detailed:
+
+- The subject is clearly defined: specific details ensure it will be filed in a timely manner.
+- Scope is explicit: the specific version, settings, and conditions under which the problem occur were given.
+- Ample context: the user gave steps to reproduce the problem and clarified each one.
+- Courteous tone: the user interacted with project members in a professional manner.
+- Supporting information: the user provided a crash dump to expedite resolution of the issue.
diff --git a/docs/source/conf.py b/docs/source/conf.py
new file mode 100644
index 0000000..28a28fc
--- /dev/null
+++ b/docs/source/conf.py
@@ -0,0 +1,40 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# For the full list of built-in configuration values, see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Project information -----------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
+
+project = 'DZGUI'
+author = 'aclist'
+
+# -- General configuration ---------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
+
+extensions = []
+
+templates_path = ['_templates']
+exclude_patterns = []
+
+
+
+# -- Options for HTML output -------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
+
+#html_theme = 'alabaster'
+extensions = [
+ 'sphinx_rtd_theme',
+ 'sphinx_copybutton',
+ "sphinx.ext.autosectionlabel",
+ "sphinx.ext.githubpages"
+]
+html_theme = "sphinx_rtd_theme"
+html_static_path = ['_static']
+html_show_sphinx = False
+html_show_copyright = False
+html_show_sourcelink = False
+
+today_fmt = "%Y-%m-%d"
+release = "5.8.x"
+version = "5.8.x"
diff --git a/docs/source/development.rst b/docs/source/development.rst
new file mode 100644
index 0000000..879408b
--- /dev/null
+++ b/docs/source/development.rst
@@ -0,0 +1,12 @@
+Developers
+===========
+
+This project is open source under the GPLv3 license. You can find the source code on
+`GitHub `_. If you wish to contribute to
+development, you will find further help in the
+`CONTRIBUTING.md `_
+file.
+
+All contributors are expected to act in accordance with the project's
+`code of conduct `_,
+and follow the project's standards and guidelines.
diff --git a/docs/source/images/01.png b/docs/source/images/01.png
new file mode 100644
index 0000000000000000000000000000000000000000..a8bb742ae1548c2456e4e18c97200154f85a5c63
GIT binary patch
literal 34154
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
literal 0
HcmV?d00001
diff --git a/docs/source/images/02.png b/docs/source/images/02.png
new file mode 100644
index 0000000000000000000000000000000000000000..0aaf7954cc1d9b3a8427c9d5273ba2c7e5e2a2c1
GIT binary patch
literal 32750
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