# guizero
[guizero](https://lawsie.github.io/guizero) is a Python 3 library for creating simple GUIs.
It is designed to allow new learners to quickly and easily create GUIs for their programs.
```python
from guizero import App, Text, PushButton
app = App(title="guizero")
intro = Text(app, text="Have a go with guizero and see what you can create.")
ok = PushButton(app, text="Ok")
app.display()
```
## Install
If you can download and unzip a file, you can [install guizero](https://lawsie.github.io/guizero/#easy-install) - **no special permissions or administrator rights are required**.
If you have administrator rights and are connected to the internet, you can [use the command line to install or upgrade guizero](https://lawsie.github.io/guizero/#install-using-command-line).
## Documentation
Comprehensive documentation can be found at [lawsie.github.io/guizero](https://lawsie.github.io/guizero) including:
+ [installation instructions](https://lawsie.github.io/guizero)
+ [a getting started guide](https://lawsie.github.io/guizero/start)
+ [recipes](https://lawsie.github.io/guizero/recipes)
+ [an API reference](https://lawsie.github.io/guizero/app/)
## Aims
The aim of guizero is to make the process of creating simple GUIs quick, accessible and understandable for new learners.
* Works with standard Python Tkinter GUI library (and no need to install other libraries)
* Abstracts away details new learners find difficult to understand (such as Tkinter StringVar() objects)
* Accessible widget naming system to help new learners to build up a mental model
* Flexible enough to be used for projects up to A-Level standard, yet accessible to primary school children
* Comprehensive and accessible documentation with examples
* Generates helpful additional error messages
## Contributing
Contributions are very welcome - please see [lawsie.github.io/guizero/contributing](https://lawsie.github.io/guizero/contributing) for notes, build and deployment instructions.
## Issues
All issues should be raised on [github.com/lawsie/guizero/issues](https://github.com/lawsie/guizero/issues)
## Book
The authors of guizero have written a book for beginners which you can [buy in print](https://store.rpipress.cc/products/create-graphical-user-interfaces-with-python) or download as a [free PDF](https://magpi.raspberrypi.org/books/create-guis).
Raw data
{
"_id": null,
"home_page": null,
"name": "guizero",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3",
"maintainer_email": null,
"keywords": "GUI, guizero, interface",
"author": "Martin O'Hanlon",
"author_email": "Laura Sach <laura.sach@raspberrypi.org>",
"download_url": "https://files.pythonhosted.org/packages/aa/dc/2157b632f3e57c2c46ad690072abe498899d3bad55a2200fae0b5eac5102/guizero-1.6.0.tar.gz",
"platform": null,
"description": "\n\n# guizero\n\n[guizero](https://lawsie.github.io/guizero) is a Python 3 library for creating simple GUIs.\n\nIt is designed to allow new learners to quickly and easily create GUIs for their programs.\n\n\n\n```python\nfrom guizero import App, Text, PushButton\n\napp = App(title=\"guizero\")\n\nintro = Text(app, text=\"Have a go with guizero and see what you can create.\")\nok = PushButton(app, text=\"Ok\")\n\napp.display()\n```\n\n## Install\n\nIf you can download and unzip a file, you can [install guizero](https://lawsie.github.io/guizero/#easy-install) - **no special permissions or administrator rights are required**.\n\nIf you have administrator rights and are connected to the internet, you can [use the command line to install or upgrade guizero](https://lawsie.github.io/guizero/#install-using-command-line).\n\n## Documentation\n\nComprehensive documentation can be found at [lawsie.github.io/guizero](https://lawsie.github.io/guizero) including:\n+ [installation instructions](https://lawsie.github.io/guizero)\n+ [a getting started guide](https://lawsie.github.io/guizero/start)\n+ [recipes](https://lawsie.github.io/guizero/recipes)\n+ [an API reference](https://lawsie.github.io/guizero/app/)\n\n## Aims\nThe aim of guizero is to make the process of creating simple GUIs quick, accessible and understandable for new learners.\n\n* Works with standard Python Tkinter GUI library (and no need to install other libraries)\n* Abstracts away details new learners find difficult to understand (such as Tkinter StringVar() objects)\n* Accessible widget naming system to help new learners to build up a mental model\n* Flexible enough to be used for projects up to A-Level standard, yet accessible to primary school children\n* Comprehensive and accessible documentation with examples\n* Generates helpful additional error messages\n\n## Contributing\n\nContributions are very welcome - please see [lawsie.github.io/guizero/contributing](https://lawsie.github.io/guizero/contributing) for notes, build and deployment instructions.\n\n## Issues\n\nAll issues should be raised on [github.com/lawsie/guizero/issues](https://github.com/lawsie/guizero/issues)\n\n## Book\n\nThe authors of guizero have written a book for beginners which you can [buy in print](https://store.rpipress.cc/products/create-graphical-user-interfaces-with-python) or download as a [free PDF](https://magpi.raspberrypi.org/books/create-guis).\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "Python module to allow learners to easily create GUIs",
"version": "1.6.0",
"project_urls": {
"Documentation": "https://lawsie.github.io/guizero/",
"Repository": "https://github.com/lawsie/guizero"
},
"split_keywords": [
"gui",
" guizero",
" interface"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "35eabcdc9988604adc48d016ff6cdc0669b70bbb61525c1cbbc4f19801147d67",
"md5": "c98e8c7de388dc82bb1d596c80716fc2",
"sha256": "241e54f8a11c8faff53b1f6a2abdd486b8338b6f49674daad8c33dd58c910e09"
},
"downloads": -1,
"filename": "guizero-1.6.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c98e8c7de388dc82bb1d596c80716fc2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3",
"size": 45128,
"upload_time": "2025-01-10T09:38:56",
"upload_time_iso_8601": "2025-01-10T09:38:56.166557Z",
"url": "https://files.pythonhosted.org/packages/35/ea/bcdc9988604adc48d016ff6cdc0669b70bbb61525c1cbbc4f19801147d67/guizero-1.6.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "aadc2157b632f3e57c2c46ad690072abe498899d3bad55a2200fae0b5eac5102",
"md5": "20c228a856fe75bacf77a5ee8048071d",
"sha256": "0cf3000a30a4cabcd5bee95c5decad20616b2dba5bb958b4f2286c2819ee3a9f"
},
"downloads": -1,
"filename": "guizero-1.6.0.tar.gz",
"has_sig": false,
"md5_digest": "20c228a856fe75bacf77a5ee8048071d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3",
"size": 4327325,
"upload_time": "2025-01-10T09:39:03",
"upload_time_iso_8601": "2025-01-10T09:39:03.387592Z",
"url": "https://files.pythonhosted.org/packages/aa/dc/2157b632f3e57c2c46ad690072abe498899d3bad55a2200fae0b5eac5102/guizero-1.6.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-10 09:39:03",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "lawsie",
"github_project": "guizero",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "build",
"specs": [
[
"==",
"1.2.1"
]
]
},
{
"name": "mkdocs",
"specs": [
[
"==",
"1.6.1"
]
]
},
{
"name": "mkdocs-bootswatch",
"specs": [
[
"==",
"1.1"
]
]
},
{
"name": "pre-commit",
"specs": [
[
"==",
"4.0.1"
]
]
},
{
"name": "pytest",
"specs": [
[
"==",
"8.3.4"
]
]
},
{
"name": "pillow",
"specs": [
[
">=",
"4.3.0"
]
]
}
],
"lcname": "guizero"
}
JSON
