devjoni-hosguibase

Name	devjoni-hosguibase JSON
Version	0.0.1 JSON
	download
home_page	None
Summary	A simplified widget toolkit supporting many backends
upload_time	2024-11-26 09:29:14
maintainer	None
docs_url	None
author	None
requires_python	>=3.8
license	None
keywords	toolkit gui tk gtk p3d
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # Hosguibase - An UI toolkit

Hosguibase is an open-source Python toolkit for making graphical
user interfaces. It uses other toolkits as its backends,
creating a uniform, tkinter-like API from the developer's perspective.
This uniformity allows
changing the look and the feel of the program with little to no effort.

Feature wise, hosguibase does not aim to expose many
features from its backends. On the contrary, we look for a
minimal feature set that can be used to create acceptable applications.
This minimalism is to ease the workload needed to
maintain multiple backends.

Hosguibase is developed by DEV Joni since 2023.

Currently, the project is in an early stage not recommended
for production.


## Installing

```
pip install devjoni-hosguibase
```

## API Overview

### Widgets

- MainWindow - The main window
- FrameWidget - Containment and partitioning
- TextWidget - Non-editable text (label)
- ButtonWidget - Clickable -> command
- SliderWidget - Slidable (scale)
- EntryWidget - Single-line editable text
- EditorWidget - Multiline editable text
- DropdownWidget - Selection (optionmenu)
- ImageWidget - Shows an image

The hosguibase API is tkinter like. When creating a new widget,
you specify its parent and then make the widget appear
on the screen by using the grid method.

### A hello world example

```python
import devjoni.guibase as gb

app = gb.MainWindow()
app.title = "My graphical program"
app.geometry = "small"

hello = gb.TextWidget(app)
hello.grid(row=0, column=0)

hello.set(text='Hello world!')

app.run()
```

## Supported Backends

- tkinter : The GUI toolkit based on tcl/tk that comes with Python
- gtk3/4 (via gi): A toolkit used for example by GNOME
- p3d : Panda3D - The open-source 3D rendering engine

The backend is currently selected with flags to the program. The default backend if no other flag is given is GTK3.

Tkinter backend

```
python myprogram.py --tk
```

GTK3 backend

```
python myprogram.py --gtk3
```

GTK4 backend

```
python myprogram.py --gtk4
```

Panda3D backend

```
python myprogram.py --p3d
```


## Current Limitations

- Only gridding supported (no free placement of widgets)
- Playing videos or 3D graphics not straighforward
- No dedicated touch or joystick support


## Contributing

### Reporting Issues

Please feel free to report any bugs or issues in our bug tracker in Github:

[https://github.com/devjonix/hosguibase/issues](https://github.com/devjonix/hosguibase/issues)

### Pull Requests

Despite commercial backing this is a true open-source project.
We appriciate any inputs to the projects.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "devjoni-hosguibase",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "toolkit, GUI, tk, gtk, p3d",
    "author": null,
    "author_email": "DEV Joni <solutions@devjoni.com>",
    "download_url": "https://files.pythonhosted.org/packages/83/e9/bf97e03f8009faa6035fc18b9c372f06abe4f98fa97ea92447af978b4d4c/devjoni_hosguibase-0.0.1.tar.gz",
    "platform": null,
    "description": "# Hosguibase - An UI toolkit\n\nHosguibase is an open-source Python toolkit for making graphical\nuser interfaces. It uses other toolkits as its backends,\ncreating a uniform, tkinter-like API from the developer's perspective.\nThis uniformity allows\nchanging the look and the feel of the program with little to no effort.\n\nFeature wise, hosguibase does not aim to expose many\nfeatures from its backends. On the contrary, we look for a\nminimal feature set that can be used to create acceptable applications.\nThis minimalism is to ease the workload needed to\nmaintain multiple backends.\n\nHosguibase is developed by DEV Joni since 2023.\n\nCurrently, the project is in an early stage not recommended\nfor production.\n\n\n## Installing\n\n```\npip install devjoni-hosguibase\n```\n\n## API Overview\n\n### Widgets\n\n- MainWindow - The main window\n- FrameWidget - Containment and partitioning\n- TextWidget - Non-editable text (label)\n- ButtonWidget - Clickable -> command\n- SliderWidget - Slidable (scale)\n- EntryWidget - Single-line editable text\n- EditorWidget - Multiline editable text\n- DropdownWidget - Selection (optionmenu)\n- ImageWidget - Shows an image\n\nThe hosguibase API is tkinter like. When creating a new widget,\nyou specify its parent and then make the widget appear\non the screen by using the grid method.\n\n### A hello world example\n\n```python\nimport devjoni.guibase as gb\n\napp = gb.MainWindow()\napp.title = \"My graphical program\"\napp.geometry = \"small\"\n\nhello = gb.TextWidget(app)\nhello.grid(row=0, column=0)\n\nhello.set(text='Hello world!')\n\napp.run()\n```\n\n## Supported Backends\n\n- tkinter : The GUI toolkit based on tcl/tk that comes with Python\n- gtk3/4 (via gi): A toolkit used for example by GNOME\n- p3d : Panda3D - The open-source 3D rendering engine\n\nThe backend is currently selected with flags to the program. The default backend if no other flag is given is GTK3.\n\nTkinter backend\n\n```\npython myprogram.py --tk\n```\n\nGTK3 backend\n\n```\npython myprogram.py --gtk3\n```\n\nGTK4 backend\n\n```\npython myprogram.py --gtk4\n```\n\nPanda3D backend\n\n```\npython myprogram.py --p3d\n```\n\n\n## Current Limitations\n\n- Only gridding supported (no free placement of widgets)\n- Playing videos or 3D graphics not straighforward\n- No dedicated touch or joystick support\n\n\n## Contributing\n\n### Reporting Issues\n\nPlease feel free to report any bugs or issues in our bug tracker in Github:\n\n[https://github.com/devjonix/hosguibase/issues](https://github.com/devjonix/hosguibase/issues)\n\n### Pull Requests\n\nDespite commercial backing this is a true open-source project.\nWe appriciate any inputs to the projects.\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A simplified widget toolkit supporting many backends",
    "version": "0.0.1",
    "project_urls": {
        "Bug Tracker": "https://github.com/devjonix/hosguibase/issues",
        "Homepage": "https://github.com/devjonix/hosguibase"
    },
    "split_keywords": [
        "toolkit",
        " gui",
        " tk",
        " gtk",
        " p3d"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "6cbe6dea3188125d3e3f1afbab30a3841c858a37efa77c0d13ca0611d94b50ba",
                "md5": "fb963ae1648e3c712a9ae7422db3f691",
                "sha256": "1c09c05cce9861429560d6f47b9d83712d998e7d93ade910be579ee46bde2315"
            },
            "downloads": -1,
            "filename": "devjoni_hosguibase-0.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "fb963ae1648e3c712a9ae7422db3f691",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 43441,
            "upload_time": "2024-11-26T09:29:13",
            "upload_time_iso_8601": "2024-11-26T09:29:13.349961Z",
            "url": "https://files.pythonhosted.org/packages/6c/be/6dea3188125d3e3f1afbab30a3841c858a37efa77c0d13ca0611d94b50ba/devjoni_hosguibase-0.0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "83e9bf97e03f8009faa6035fc18b9c372f06abe4f98fa97ea92447af978b4d4c",
                "md5": "c25a0bb73f953a2ddbae88f3644502e5",
                "sha256": "c18333d86cb50ccc4dfe973eabc360f0e038c5fba51f42e07a1abe18da777063"
            },
            "downloads": -1,
            "filename": "devjoni_hosguibase-0.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "c25a0bb73f953a2ddbae88f3644502e5",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 37520,
            "upload_time": "2024-11-26T09:29:14",
            "upload_time_iso_8601": "2024-11-26T09:29:14.746604Z",
            "url": "https://files.pythonhosted.org/packages/83/e9/bf97e03f8009faa6035fc18b9c372f06abe4f98fa97ea92447af978b4d4c/devjoni_hosguibase-0.0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-26 09:29:14",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "devjonix",
    "github_project": "hosguibase",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "devjoni-hosguibase"
}