Merge branch 'main' of https://github.com/Embarcadero/DelphiFMX4Python

Author: lmbelo

README.md

@@ -1,32 +1,47 @@
-# DelphiFMX for Python <a href="https://github.com/Embarcadero/DelphiFMX4Python/"><img align="right" alt="DelphiFMX for Python" src="images/DelphiFMX4Python(256px).png"></a> 
-Delphi's FireMonkey framework as a Python module for Windows, MacOS, Linux, and Android GUI development.
+# <a href="https://github.com/Embarcadero/DelphiFMX4Python/">DelphiFMX for Python<img align="right" alt="DelphiFMX for Python" src="https://github.com/Embarcadero/DelphiFMX4Python/raw/main/images/DelphiFMX4Python(256px).png"></a> 
 
-FireMonkey is a GUI framework originally from [Embarcadero Delphi](https://www.embarcadero.com/products/delphi) for native cross-platform application development. It uses the GPU via DirectX or OpenGL for hardware accellerated rendering. It includes a rich styling system and is user extensible. 
+Quick Links:
 
-<b>About:</b>
+[[Installation](https://github.com/Embarcadero/DelphiFMX4Python#installation)] &nbsp; [[eBook & Styles](https://embt.co/PythonGUIBundle)] &nbsp; [[Android Builder](https://github.com/Embarcadero/PythonFMXBuilder)] &nbsp; [[Docs](https://github.com/Embarcadero/DelphiFMX4Python/wiki)] &nbsp; [[Samples](https://github.com/Embarcadero/DelphiFMX4Python/tree/main/samples)]
 
-The `delphifmx` is a natively compiled Python module powered by the [Python4Delphi library](https://github.com/pyscripter/python4delphi). It gives Python developers access to the FireMonkey GUI framework from Python with no need to use Delphi in their development process, and is [freely redistributable](https://github.com/Embarcadero/DelphiFMX4Python/blob/main/LICENSE.md). 
+---
 
-<b>Installation:</b>
+`delphifmx` is a natively compiled Python module powered by the [Python4Delphi library](https://github.com/embarcadero/python4delphi). It gives Python developers access to the FireMonkey GUI framework and is [freely redistributable](https://github.com/Embarcadero/DelphiFMX4Python/blob/main/LICENSE.md). Supports Windows, MacOS, Linux, and Android GUI development.
+
+FireMonkey is a GUI framework originally from [Embarcadero Delphi](https://www.embarcadero.com/products/delphi) for native cross-platform application development. It uses the GPU via DirectX or OpenGL for hardware accelerated rendering. It includes a rich styling system and is user extensible. DelphiFMX for Python does not require Delphi or any experience with Object Pascal. 
+
+Be sure to check out the [PythonFMXBuilder](https://github.com/Embarcadero/PythonFMXBuilder) for deploying your Python scripts on Android and the [Delphi for Python Exporter](https://github.com/Embarcadero/Delphi4PythonExporter) to simplify your UI design.
+
+## eBook and Styles Bundle
+
+There is an free [eBook and styles bundle](https://embt.co/PythonGUIBundle) with 29 custom styles and 50 pages of content.
+ <a href="https://embt.co/PythonGUIBundle"><img alt="Download the free eBook and Python styles bundle." width="750" src="https://github.com/Embarcadero/PythonFMXBuilder/blob/main/images/30_Banner_Ebook_GGetting Started with Python GUI_830x256.jpg"></a>
+
+## Installation
 
     pip install delphifmx
 
-<b>Supports:</b>
+### Supports
 * Win32 x86, Win64 x86, Linux64 x86, Android64, macOS64 and macM1 architectures
 * Python cp3.6, cp3.7, cp3.8, cp3.9 and cp3.10
 
-<b>Conda support:</b>
+### Conda support
 * Win x86 and x64 from Python cp3.6 to cp3.10 
 * Linux x86_64 from Python cp3.6 to cp3.10
 * macOS x86_64 from Python cp3.6 to cp3.10
 
-<b>Venv support:</b>
+### Venv support
 * Win x86 and x64 from Python cp3.6 to cp3.10 
 * Linux x86_64 from Python cp3.6 to cp3.10
 * macOS x86_64 from Python cp3.6 to cp3.10
 
-Also check out [DelphiVCL4Python](https://github.com/Embarcadero/DelphiVCL4Python).
+## See Also
 
-Powered by [Embarcadero Delphi](https://www.embarcadero.com/products/delphi) and the [Python4Delphi library](https://github.com/pyscripter/python4delphi).
+ - Check out [DelphiVCL4Python](https://github.com/Embarcadero/DelphiVCL4Python) for native Windows GUI in Python.
+ - Powered by [Embarcadero Delphi](https://www.embarcadero.com/products/delphi) and the [Python4Delphi library](https://github.com/Embarcadero/python4delphi).
+ - While this redistributable library is covered by the [Embarcadero Freeware License](https://github.com/Embarcadero/DelphiFMX4Python/blob/main/LICENSE.md), all the [source code](https://github.com/Embarcadero/python4delphi) for it is covered by the [MIT License](https://github.com/Embarcadero/python4delphi/blob/master/LICENSE).
+ - Special thanks to [PyScripter](https://github.com/pyscripter/). 
+ - Sponsored by [Embarcadero](https://www.embarcadero.com/). 
 
-Sponsored by [Embarcadero](https://www.embarcadero.com/). 
+![Embarcadero](https://github.com/Embarcadero/DelphiFMX4Python/blob/main/images/Embarcadero-White-50px.png#gh-dark-mode-only])
+![Embarcadero](https://github.com/Embarcadero/DelphiFMX4Python/blob/main/images/Embarcadero-Black-50px.png#gh-light-mode-only)

delphifmx/__version__.py

@@ -1 +1 @@
-__version__ = "0.1.48"
+__version__ = "0.1.49"

docs/.buildinfo

@@ -0,0 +1,4 @@
+# Sphinx build info version 1
+# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
+config: dd27583958f4c7e1e762f58911af820b
+tags: 645f666f9bcd5a90fca523b33c5a78b7

docs/_sources/comps_ref.rst.txt

@@ -0,0 +1,10 @@
+Components Reference
+====================
+
+Need to add all the components as Python classes and their methods for reference. Need to understand the whole inheritance structure of complete library.
+
+``Components``
+--------------
+
+.. autoclass:: delphifmx.layer_2.Form
+.. autoclass:: delphifmx.layer_2.Button

docs/_sources/index.rst.txt

@@ -0,0 +1,19 @@
+.. Delphi FMX for Python documentation master file, created by
+   sphinx-quickstart on Mon Mar 14 14:23:54 2022.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+Welcome to Delphi FMX for Python's documentation!
+=================================================
+
+.. toctree::
+   :maxdepth: 3
+   :caption: Contents:
+
+   installer
+   quickstart
+   comps_ref
+
+
+
+

docs/_sources/installer.rst.txt

@@ -0,0 +1,17 @@
+Installation
+============
+
+DelphiFMX for Python is a cross-platform Python module. It is available via PyPi or download the source via GitHub. Python versions from 3.6 to 3.10 are supported, including Conda.
+
+The easiest way to install is via PIP:
+
+.. code-block::
+   
+   pip install delphifmx
+
+ 
+You can also install manually by downloading or cloning the repository from GitHub:  https://github.com/Embarcadero/DelphiFMX4Python. After cloning or downloading, enter the root DelphiFMX4Python folder/directory and open the command prompt or Anaconda prompt with that path. Now install the package using:  
+
+.. code-block::
+   
+   python setup.py install

docs/_sources/quickstart.rst.txt

@@ -0,0 +1,21 @@
+Quickstart
+==========
+
+The simplest example using DelphiFMX for Python library.
+
+..  code-block:: Python
+   
+    from delphifmx import *
+
+    Application.Initialize()
+    Application.Title = "Hello Delphi FMX"
+    Application.MainForm = Form(Application)
+    Application.MainForm.SetProps(Caption = "Hello World")
+    msg = Label(Application.MainForm)
+    msg.SetProps(Parent = Application.MainForm,
+        Text = "Hello Python from Delphi FMX",
+        Position = Position(PointF(20, 20)),
+        Width = 200)
+    Application.MainForm.Show()
+    Application.Run() # This is the main loop
+    Application.MainForm.Destroy()