Skip to content

Commit

Permalink
Docs improvements
Browse files Browse the repository at this point in the history
  • Loading branch information
jamesdbrock committed Sep 15, 2023
1 parent d6d7f54 commit 943bf85
Show file tree
Hide file tree
Showing 4 changed files with 28 additions and 20 deletions.
12 changes: 6 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,14 @@
<img src="https://raw.githubusercontent.com/pyedifice/pyedifice/master/docs/source/image/EdificePyramid.svg" width="200">
</h3>

<h1 align="center">Edifice: a declarative GUI library for Python</h1>
<h1 align="center">Edifice: Declarative GUI framework for Python and Qt</h1>

Edifice is a Python library for building declarative application user interfaces.

- Modern declarative UI paradigm from web development.
- 100% Python application development, no language inter-op.
- A native desktop app instead of a bundled web browser.
- Fast iteration via hot reloading.
- Modern **declarative** UI paradigm from web development.
- **100% Python** application development, no language inter-op.
- A **native** desktop app instead of a bundled web browser.
- Fast iteration via **hot reloading**.

This modern declarative UI paradigm is also known as
[Model-View-Update](https://thomasbandt.com/model-view-update),”
Expand Down Expand Up @@ -154,7 +154,7 @@ to enable use of the debugger
Contributions are welcome; please send pull requests!

## License
Edifice is MIT Licensed.
Edifice is [MIT Licensed](https://en.wikipedia.org/wiki/MIT_License).

Edifice uses Qt under the hood, and both PyQt6 and PySide6 are supported. Note that PyQt6 is distributed with the *GPL* license while PySide6 is distributed
under the more flexible *LGPL* license.
Expand Down
28 changes: 18 additions & 10 deletions docs/source/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
Edifice
=======

Declarative UI for Python
Declarative GUI framework for Python and Qt

.. image:: /image/example_calculator.png
:width: 200
Expand All @@ -24,16 +24,16 @@ Declarative UI for Python
:caption: *Hello World* in Edifice
import edifice
from edifice import Label
from edifice import App, Label
edifice.App(Label("Hello World!")).start()
App(Label("Hello World!")).start()
Edifice is a Python library for building declarative application user interfaces.

- Modern declarative UI paradigm from web development.
- 100% Python application development, no language inter-op.
- A native desktop app instead of a bundled web browser.
- Fast iteration via hot reloading.
- Modern **declarative** UI paradigm from web development.
- **100% Python** application development, no language inter-op.
- A **native** desktop app instead of a bundled web browser.
- Fast iteration via **hot reloading**.

This modern declarative UI paradigm is also known as
“`Model-View-Update <https://thomasbandt.com/model-view-update>`_,”
Expand All @@ -43,7 +43,8 @@ Edifice uses `PySide6 <https://doc.qt.io/qtforpython-6/>`_
or `PyQt6 <https://www.riverbankcomputing.com/static/Docs/PyQt6/introduction.html>`_
as a backend. So Edifice is like
`React <https://react.dev/>`_, but with
Python instead of JavaScript, and Qt instead of the HTML DOM.
Python instead of JavaScript, and `Qt Widgets <https://doc.qt.io/qt-6/qtwidgets-index.html>`_
instead of the HTML DOM.
If you have experience with React,
you will find Edifice very easy to pick up.

Expand All @@ -65,6 +66,7 @@ strings to TextInput, bools to Checkbox, etc.
The example below shows how you can collect information from the user in a Dialog.

.. code-block:: python
:caption: Form Dialog
import datetime
import edifice
Expand Down Expand Up @@ -253,13 +255,19 @@ License and Code Availability
-----------------------------

Edifice is released under the `MIT License <https://en.wikipedia.org/wiki/MIT_License>`_.

Edifice uses Qt under the hood, and both PyQt6 and PySide6 are supported.
Note that PyQt6 is distributed with the *GPL* license while PySide6 is distributed
under the more flexible *LGPL* license.
See `PyQt vs PySide Licensing <https://www.pythonguis.com/faq/pyqt-vs-pyside/>`.

The source code is avaliable `on GitHub <https://github.com/pyedifice/pyedifice>`_.

Support
-------

File all bug reports or feature requests using `Github issues <https://github.com/pyedifice/pyedifice/issues>`_.

Submit questions, bug reports or feature requests using
`Github issues <https://github.com/pyedifice/pyedifice/issues>`_.

Indices and tables
------------------
Expand Down
4 changes: 2 additions & 2 deletions nix/pyedifice/default.nix
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@

buildPythonPackage rec {
pname = "pyedifice";
version = "0.0.10";
version = "0.1.1";

# src = pkgs.fetchPypi {
# inherit pname version;
Expand Down Expand Up @@ -58,7 +58,7 @@ buildPythonPackage rec {
doCheck = false;

meta = with lib; {
description = "declarative GUI library for Python";
description = "Declarative GUI framework for Python and Qt";
homepage = "https://github.com/pyedifice/pyedifice";
license = licenses.mit;
maintainers = with maintainers; [ ];
Expand Down
4 changes: 2 additions & 2 deletions pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
[tool.poetry]
name = "pyedifice"
version = "0.1.1"
description = "Declarative UI framework for Qt"
description = "Declarative GUI framework for Python and Qt"
authors = ["David Ding", "James Dawson Brock"]
license = "MIT"
readme = "README.md"
homepage = "https://github.com/pyedifice/pyedifice"
homepage = "https://pyedifice.github.io"
repository = "https://github.com/pyedifice/pyedifice"
packages = [{include = "edifice", from = "."}]

Expand Down

0 comments on commit 943bf85

Please sign in to comment.