Python: Unit Converter App

A Unit Converter App with a Tkinter GUI, supporting various measurements for unit conversion.

An Interactive Python unit converter with a Tkinter GUI, supporting length, mass, temperature, volume, speed, data storage, and many more conversions.

• Major Disclaimer:
  • Inconistent or Missing Data may exist during unit conversions as standards change.
  • As stated within the License, you must obtain permission by the Author of this project.

Installing / Getting Started

A quick introduction of the minimal setup you need to get a Hello World up & running in VS Code.

Install "VS Code" and "Python"
Ensure the "Environment Variable" is included in "the Path" within Python ("Click the Checkbox")
Install the needed "Extensions for VS Code" ["Python by Microsoft, Python Debugger by Microsoft, etc"]
Other Extensions may include ["GitHub, Markdown, Elint/lint, etc"] to utilize GitHub Version Control and other language syntax
Start coding Python
You can run the code by using the following: ["python filename.py"]

Congrats! You just created your first Python file and there's so much more you can do so experiment to your hearts content!

Initial Configuration

Requirements:

• Ensure that the project file/folder and other dependencies you plan to make is within the range for code execution.

• Ensure you have a GitHub account to make project repos and save changes to prevent loss of progress with your code in the future.

Developing

In order to start developing the project further:

git clone https://github.com/username/project-name.git
cd project-name/

After setting up GitHub and the GitHub repo, you should be able to clone/commit/publish your progress as you make changes to the project.

Building

To build the project after some code changes:

commit changes by using the GitHub extensions from VS Code or by using the terminal via commands
stash/push the changes into the main/master branch of the project or in another branch if needed

After commiting and pushing the changes into GitHub, you should see the project repo change to reflect the most recent code.

Deploying / Publishing

In case you want to publish your project to a server:

Ensure that the project is fully functional and give appropiate credit to all contributors/authors.
Provide a step-by-step process of how you managed to complete the project.
Check the project and live server before finalizing the project status.

If you want to use GitHub or any other 3rd party platform for your server, you can but it may prove to be difficult with the lack of updated tutorials for all sorts of software services. [You can checkout the masterPortfolio repo to see how to use GitHub pages]

Features

This project repo has the following:

• Interactive Tkinter GUI with dropdowns for category, “From” and “To” units, plus an entry field for values.
• Supports various categories: Length, Mass, Temperature, Volume, Speed, Data Storage, and etc.
• Real-time conversion: updates results instantly when you change the input value, category, or units.
• Swap button to flip “From” and “To” units in one click, and Clear button to reset the input and output.
• Identical-unit handling: entering the same unit twice simply echoes the original value.
• Blank-input handling: displays 0.0000 (or your chosen format) instead of an error when the input field is empty.
• Error handling for invalid entries or unsupported conversions, showing “Error” or a blank result as appropriate.
• Modular conversion logic: easily extend with new units, categories, SI-prefix parsing, theming, or desktop packaging via PyInstaller.

Links

Helpful links that you can use with your project:

• GitHub Commands Cheat Sheet: [https://github.com/tiimgreen/github-cheat-sheet]
• In case of sensitive bugs like security vulnerabilities, please use the issue tracker or contact me directly. We value your effort to improve the security and privacy of this project!

References

"Give Credit where its Due": Credit goes to all the original repo owners, contributors, and author into making this project. (If possible, please provide the GitHub URLs and names to all that contributed including the project owner)

Licensing

"The project is licensed under Creative Commons Attribution-NonCommercial-ShareAlike (CC BY-NC-SA) License".