unitconverter-tk

Unit Converter in Python

Badges

Now with native look-and-feel for each Windows & macOS!

Screenshots

Folder Structure

| Folder | Description | | — | — | | / | Root directory contains app.py file | | src | Contains modules for each implementation | | test | Contains tests implemented using pytest framework |

How to run

• Install Python 3 : Download
• The Windows Python3 installer already comes with Tkinter setup built in. For other platforms (Linux/macOS) please read the official installation docs for Tkinter.
• Clone this repository

• Run app.py in root directory using : python app.py (for Windows)

  python3 app.py (for Linux/macOS)

How to build platform-specific binary

• Install pyinstaller : pip install pyinstaller
• Build with pyinstaller : pyinstaller --onefile app.py

  Note : Windows Defender might show the built file as a trojan. This is a false positive. Heuristic based scanning will detect anything not digitally signed and packed, or has keyboard access as a trojan dropper. You can ignore the warning.

Testing

• Install pip iff you don’t already have it installed using the official documentation
• Install pytest framework : pip install -U pytest
• In root directory, run tests using : pytest

### Resources

• Python Tutorial
• TKinter Tutorial
• GitHub Docs
• Article - How to Configure Github Actions the Easy Way
• Official Tkinter Documentation

Extras

Setup tkinter on macOS/linux using brew package manager

• Install brew package manager : /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
• Install latest version of python3 : brew update && brew install python3
• Install latest version of python-tk: brew update && brew install python-tk

This site is open source. Improve this page.