Tkinter-native toolset and widget library
Project description
[![Build Status](https://travis-ci.org/slightlynybbled/tk_tools.svg?branch=master)](https://travis-ci.org/slightlynybbled/tk_tools)
[![Documentation Status](https://readthedocs.org/projects/tk-tools/badge/?version=latest)](http://tk-tools.readthedocs.io/en/latest/?badge=latest)
# Purpose
This repository holds useful high-level widgets written in pure python. This library used type hints and requires Python 3.5+; it could, however, be back-ported to earlier Python versions without difficulty.
Here are some examples screenshots of the widgets you can create:
#### Button-Grid:
![Button-Grid](docs/img/button-grid.png)
#### Binary-Label:
![Byte-Label](docs/img/byte-label.png)
#### Calendar:
![Calendar](docs/img/calendar.png)
#### Dropdown:
![Dropdown](docs/img/dropdown.png)
#### Entry-Grid:
![Entry-Grid](docs/img/entry-grid.png)
#### Multi-Slot Frame
![Multi-Slot Frame](docs/img/multi-slot-frame.png)
#### Graph:
![Graph](docs/img/graph.png)
#### Key-Value:
![Key-Value](docs/img/key-value.png)
#### Label-Grid:
![Label-Grid](docs/img/label-grid.png)
#### LED: (size can be scaled)
![LED](docs/img/led.gif)
#### SevenSegment and SevenSegmentDisplay
![Seven Segment Display](docs/img/seven-segment-display.png)
#### Gauge
![Gauges](docs/img/gauges.png)
#### Rotary-Scale: (Tachymeter)
![Rotary-Scale](docs/img/rotary-scale.png)
For more details, check out the [documentation](https://tk-tools.readthedocs.io).
# Testing
Basic testing has been instantiated however it is currently limited. To execute style testing:
flake8 tk_tools
To execute automated tests:
py.test test.py
More testing will be added to new widgets as they are brought online while further testing will be added to old widgets as the project matures.
# Contributions
Contributions for new widgets, documentation, tests, and resolving issues are welcomed.
Contribution guidelines:
Fork the repository to your account.
Clone your account repository to your local development environment.
Create/checkout a new branch appropriately named by feature, bug, issue number, whatever.
Make your changes on your branch. The ideal changes would:
have working examples in the examples directory
have documentation in the docs directory
Push your changes to your github account.
Create a pull request from within github.
All code is to be passing flake8 before it is merged into master!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
File details
Details for the file tk_tools-0.9.5-py3-none-any.whl
.
File metadata
- Download URL: tk_tools-0.9.5-py3-none-any.whl
- Upload date:
- Size: 173.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | b24605322c6230e573587bad084d1a6ae24f936d10f102e4ac28f87b1cf3a247 |
|
MD5 | c55dcafc9365835fb2a57fb7b0f1fcbb |
|
BLAKE2b-256 | 0f6f0f3260330aa12b9649c0e7e0e7530e8ab8ec892e5eb015b527d16f91a8af |