chichitk


Namechichitk JSON
Version 0.0.5 PyPI version JSON
download
home_page
SummaryPython UI library built upon Tkinter
upload_time2023-11-07 19:32:01
maintainer
docs_urlNone
author
requires_python>=3.7
license
keywords python tkinter custom widgets
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # ChichiTk

A python UI library built upon Tkinter, which implements affectedly elegant extensions of existing tkinter widgets. ChichiTk facilitates easy implementation of dropdown menus, nested dropdown menus, progress bars, sliders, icon buttons, and more. CheckEntry and TextBox widgets can execute a callback function whenever their text is edited by the user. ChichiTk AspectFrame retains a specific aspect ratio as flexible frames are resized. ChichiTk ScrollableFrame can contain tkinter elements in a scrollable widget. For exhaustive list of features, visit the **[wiki tab](https://github.com/SamGibson1/ChichiTk/wiki)**.

![](documentation_images/example_app.jpg)
| _`example.py` on Windows_

https://user-images.githubusercontent.com/74847576/232877538-c069685a-3265-42d0-9961-73ccd59c9738.mp4

| _`example.py` on Windows - sample user interactions_

## Installation
Install the module with pip:
```
pip3 install chichitk
```
Update existing installation:
```
pip3 install chichitk --upgrade
```
Update as often as possible because this library is under active development.

## Documentation
The **official** documentation can be found in the Wiki Tab here:

**--> [ChichiTk Documentation](https://github.com/SamGibson1/ChichiTk/wiki)**

## Example Program - Stopwatch
The following is a simple Stopwatch program that uses chichitk.Player to manage callbacks:
```python
from tkinter import Tk, Frame, Label
from chichitk import Player

def time_text(time:int, f:int=100):
    hour = time // (3600 * f)
    minute = (time % (3600 * f)) // (60 * f)
    second = (time % (60 * f)) // f
    return f'{hour:0>2}:{minute:0>2}:{second:0>2}.{time % f:0>2}'

app = Tk()
app.title('Stopwatch')
app.config(bg='#28282e')
app.geometry("650x400")

frame = Frame(app)
frame.place(relx=0.5, rely=0.5, relwidth=0.8, relheight=0.6, anchor='center')

label = Label(frame, text='00:00:00.00', bg='#232328', fg='#ffffff',
              font=('Segoe UI bold', 30))
label.pack(fill='both', expand=True)

Play = Player(frame, lambda t: label.config(text=time_text(t)), 0.01,
              bg='#1e1e22', frame_num=12001, frame_rate=100, step_increment=500)
Play.pack(side='bottom', fill='x')

app.mainloop()
```
This results in the following window:

<img src="documentation_images/stopwatch_example.jpg" width="600"/>

## Example Application - Password Manager

https://user-images.githubusercontent.com/74847576/233730056-cffb5a0d-41db-44e4-ad24-7276406f9ba1.mp4

The Passwords App project can be found here:

**--> [Project Link](https://github.com/SamGibson1/PasswordManager)**

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "chichitk",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": "",
    "keywords": "python,tkinter,custom,widgets",
    "author": "",
    "author_email": "Samuel Gibson <samuelpgibson12@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/2c/04/9d0587acc94d5174e7134830473889d6b0dd9204f5b2eb5b82a0feb49d9f/chichitk-0.0.5.tar.gz",
    "platform": null,
    "description": "# ChichiTk\r\n\r\nA python UI library built upon Tkinter, which implements affectedly elegant extensions of existing tkinter widgets. ChichiTk facilitates easy implementation of dropdown menus, nested dropdown menus, progress bars, sliders, icon buttons, and more. CheckEntry and TextBox widgets can execute a callback function whenever their text is edited by the user. ChichiTk AspectFrame retains a specific aspect ratio as flexible frames are resized. ChichiTk ScrollableFrame can contain tkinter elements in a scrollable widget. For exhaustive list of features, visit the **[wiki tab](https://github.com/SamGibson1/ChichiTk/wiki)**.\r\n\r\n![](documentation_images/example_app.jpg)\r\n| _`example.py` on Windows_\r\n\r\nhttps://user-images.githubusercontent.com/74847576/232877538-c069685a-3265-42d0-9961-73ccd59c9738.mp4\r\n\r\n| _`example.py` on Windows - sample user interactions_\r\n\r\n## Installation\r\nInstall the module with pip:\r\n```\r\npip3 install chichitk\r\n```\r\nUpdate existing installation:\r\n```\r\npip3 install chichitk --upgrade\r\n```\r\nUpdate as often as possible because this library is under active development.\r\n\r\n## Documentation\r\nThe **official** documentation can be found in the Wiki Tab here:\r\n\r\n**--> [ChichiTk Documentation](https://github.com/SamGibson1/ChichiTk/wiki)**\r\n\r\n## Example Program - Stopwatch\r\nThe following is a simple Stopwatch program that uses chichitk.Player to manage callbacks:\r\n```python\r\nfrom tkinter import Tk, Frame, Label\r\nfrom chichitk import Player\r\n\r\ndef time_text(time:int, f:int=100):\r\n    hour = time // (3600 * f)\r\n    minute = (time % (3600 * f)) // (60 * f)\r\n    second = (time % (60 * f)) // f\r\n    return f'{hour:0>2}:{minute:0>2}:{second:0>2}.{time % f:0>2}'\r\n\r\napp = Tk()\r\napp.title('Stopwatch')\r\napp.config(bg='#28282e')\r\napp.geometry(\"650x400\")\r\n\r\nframe = Frame(app)\r\nframe.place(relx=0.5, rely=0.5, relwidth=0.8, relheight=0.6, anchor='center')\r\n\r\nlabel = Label(frame, text='00:00:00.00', bg='#232328', fg='#ffffff',\r\n              font=('Segoe UI bold', 30))\r\nlabel.pack(fill='both', expand=True)\r\n\r\nPlay = Player(frame, lambda t: label.config(text=time_text(t)), 0.01,\r\n              bg='#1e1e22', frame_num=12001, frame_rate=100, step_increment=500)\r\nPlay.pack(side='bottom', fill='x')\r\n\r\napp.mainloop()\r\n```\r\nThis results in the following window:\r\n\r\n<img src=\"documentation_images/stopwatch_example.jpg\" width=\"600\"/>\r\n\r\n## Example Application - Password Manager\r\n\r\nhttps://user-images.githubusercontent.com/74847576/233730056-cffb5a0d-41db-44e4-ad24-7276406f9ba1.mp4\r\n\r\nThe Passwords App project can be found here:\r\n\r\n**--> [Project Link](https://github.com/SamGibson1/PasswordManager)**\r\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "Python UI library built upon Tkinter",
    "version": "0.0.5",
    "project_urls": {
        "Bug Tracker": "https://github.com/SamGibson1/ChichiTk/issues",
        "Documentation": "https://github.com/SamGibson1/ChichiTk/wiki",
        "Homepage": "https://github.com/SamGibson1/ChichiTk"
    },
    "split_keywords": [
        "python",
        "tkinter",
        "custom",
        "widgets"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "5c6cf6afbf387e5369c4fb0a5bd94f7b11bca20757bf1c2ccf616950bdb3bbf2",
                "md5": "3f06491553e1ae550433fcd80e5dfc98",
                "sha256": "063dfb567911661566cf7db4d2f93d9fd84324a5466dd126ee3e21bcf88998d0"
            },
            "downloads": -1,
            "filename": "chichitk-0.0.5-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "3f06491553e1ae550433fcd80e5dfc98",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 80413,
            "upload_time": "2023-11-07T19:31:59",
            "upload_time_iso_8601": "2023-11-07T19:31:59.405243Z",
            "url": "https://files.pythonhosted.org/packages/5c/6c/f6afbf387e5369c4fb0a5bd94f7b11bca20757bf1c2ccf616950bdb3bbf2/chichitk-0.0.5-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "2c049d0587acc94d5174e7134830473889d6b0dd9204f5b2eb5b82a0feb49d9f",
                "md5": "d2007f88ad5b6212f8085e2b0f0bfe53",
                "sha256": "997ff87dcba16ea759d2cdbfb0c11397de2b5f8c6f40b1c24f79c7a6933c926d"
            },
            "downloads": -1,
            "filename": "chichitk-0.0.5.tar.gz",
            "has_sig": false,
            "md5_digest": "d2007f88ad5b6212f8085e2b0f0bfe53",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 71489,
            "upload_time": "2023-11-07T19:32:01",
            "upload_time_iso_8601": "2023-11-07T19:32:01.721434Z",
            "url": "https://files.pythonhosted.org/packages/2c/04/9d0587acc94d5174e7134830473889d6b0dd9204f5b2eb5b82a0feb49d9f/chichitk-0.0.5.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-11-07 19:32:01",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "SamGibson1",
    "github_project": "ChichiTk",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "requirements": [],
    "lcname": "chichitk"
}
        
Elapsed time: 0.13521s