Added initial work to generate sphinx documentation

This commit is contained in:
2022-02-18 16:58:19 -06:00
parent 42b60d19a1
commit e912925c52
7 changed files with 195 additions and 0 deletions

View File

@@ -0,0 +1,12 @@
Generating updates
===================
The updater package will work with any module used to generate distributable files, such as `Nuitka, <https://www.nuitka.net>`_ `CX-Freeze <https://pypi.org/project/cx-Freeze/>`_ and others, as long as a valid update file is provided. A valid update file is basically a zip file containing a binary distributable version of an application, plus the bootstrap binary for the operating system. The botstrap binary, as well as any other application file, must be in the root of the zipfile.
Here is what you need to do, in order to generate an update for any operating system.
1. Create the distributable version of the application. You can use any package to do so. You should end with a folder where an executable file, as well as all of its dependencies (including package data and other application files) are included.
2. Copy the bootstrapper binary file. (more instructions here).
3. Zip the whole folder of distributable files. Take into account that you need to create a zip file where your application files must be the root folder of the zip. The updater package includes a small utility command in order to create a zip file from any created folder.
4. Upload the zip file to any known site that could give you a direct URL to the file.
5. When asked, users should be able to download and install the update.

7
source/modules.rst Normal file
View File

@@ -0,0 +1,7 @@
updater
=======
.. toctree::
:maxdepth: 4
updater

37
source/updater.rst Normal file
View File

@@ -0,0 +1,37 @@
updater package
===============
Submodules
----------
updater.core module
-------------------
.. automodule:: updater.core
:members:
:undoc-members:
:show-inheritance:
updater.utils module
--------------------
.. automodule:: updater.utils
:members:
:undoc-members:
:show-inheritance:
updater.wxupdater module
------------------------
.. automodule:: updater.wxupdater
:members:
:undoc-members:
:show-inheritance:
Module contents
---------------
.. automodule:: updater
:members:
:undoc-members:
:show-inheritance: