Skip to main content

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.

For more details, check out the [documentation](https://tk-tools.readthedocs.io).

Here are some examples screenshots of the widgets you can create:

## Button-Grid:

![Button-Grid](https://tk-tools.readthedocs.io/en/latest/_images/button-grid.png)

## Binary-Label:

![Byte-Label](https://tk-tools.readthedocs.io/en/latest/_images/byte-label.png)

## Calendar:

![Calendar](https://tk-tools.readthedocs.io/en/latest/_images/calendar.png)

## Entry-Grid:

![Entry-Grid](https://tk-tools.readthedocs.io/en/latest/_images/entry-grid.png)

## Multi-Slot Frame

![Multi-Slot Frame](https://tk-tools.readthedocs.io/en/latest/_images/multi-slot-frame.png)

## Graph:

![Graph](https://tk-tools.readthedocs.io/en/latest/_images/graph.png)

## Key-Value:

![Key-Value](https://tk-tools.readthedocs.io/en/latest/_images/key-value.png)

## Label-Grid:

![Label-Grid](https://tk-tools.readthedocs.io/en/latest/_images/label-grid.png)

## LED: (size can be scaled)

![LED](https://tk-tools.readthedocs.io/en/latest/_images/led.gif)

## SevenSegment and SevenSegmentDisplay

![Seven Segment Display](https://tk-tools.readthedocs.io/en/latest/_images/seven-segment-display.png)

## Gauge

![Gauge](https://tk-tools.readthedocs.io/en/latest/_images/gauges.png)

![Gauge Documentation](https://tk-tools.readthedocs.io/en/latest/_images/gaugedoc.png)

## Rotary-Scale: (Tachometer)

![Rotary-Scale](https://tk-tools.readthedocs.io/en/latest/_images/rotary-scale.png)

# Dependencies

This package is dependant on [engineering_notation](https://pypi.org/project/engineering-notation/), which is one of my other packages.

# 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:

  1. Fork the repository to your account.

  2. Clone your account repository to your local development environment.

  3. Create/checkout a new branch appropriately named by feature, bug, issue number, whatever.

  4. Make your changes on your branch. The ideal changes would:

  • have working examples in the examples directory

  • have documentation in the docs directory

  1. Push your changes to your github account.

  2. Create a pull request from within github.

All code is to be passing flake8 before it is merged into master!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

tk_tools-0.11.0-py3-none-any.whl (172.8 kB view details)

Uploaded Python 3

File details

Details for the file tk_tools-0.11.0-py3-none-any.whl.

File metadata

  • Download URL: tk_tools-0.11.0-py3-none-any.whl
  • Upload date:
  • Size: 172.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.10.0 pkginfo/1.2.1 requests/2.18.4 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/3.6.5

File hashes

Hashes for tk_tools-0.11.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f8becadd4471b6bc5a98fcedb98bf0b6fe2e164fd5c608d46e782343255bfef0
MD5 ea6578582483d4b2dd9f63d3586b0ada
BLAKE2b-256 063f41c00bd868e4b9c897bfc7c3dc6825f4dd31a498830ac4bfd8ab4e4f87cc

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page