Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 38 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,47 @@
# UnitConverter
Unit converter project with my husband
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

SUGGESTION: Typo in description

"The sweeetest!" appears to be a typo for "The sweetest!". Please correct the spelling.


The sweeetest!
## Description
A web-based unit converter built with Python and Streamlit. Converts between various units in temperature, length, volume, and weight categories.

## Features
- Temperature conversions: Celsius ↔ Fahrenheit, Celsius ↔ Kelvin
- Length conversions: Kilometers ↔ Miles, Kilometers → Yards, Meters → Feet
- Volume conversions: Milliliters → Ounces, Liters → Gallons
- Weight conversions: Grams → Ounces, Kilograms → Pounds
- Clean UI with custom color scheme (Tea & Romance palette)

### Temperature Conversions
- **Celsius ↔ Fahrenheit**: Convert between Celsius and Fahrenheit temperature scales
- **Celsius ↔ Kelvin**: Convert between Celsius and Kelvin temperature scales
- **Formula examples**:
- Fahrenheit = (Celsius × 9/5) + 32
- Kelvin = Celsius + 273.15

### Length Conversions
- **Kilometers ↔ Miles**: Convert between metric and imperial distance units
- **Kilometers → Yards**: Convert kilometers to yards (1 km = 1093.61 yards)
- **Meters → Feet**: Convert metric length to imperial feet (1 m = 3.28084 feet)
- **Conversion factors**:
- 1 kilometer = 0.621371 miles
- 1 kilometer = 1093.61 yards
- 1 meter = 3.28084 feet

### Volume Conversions
- **Milliliters → Ounces**: Convert liquid volume from metric to US ounces
- **Liters → Gallons**: Convert larger volumes from liters to US gallons
- **Conversion factors**:
- 1 milliliter = 0.033814 US fluid ounces
- 1 liter = 0.264172 US gallons

### Weight Conversions
- **Grams → Ounces**: Convert weight from metric grams to imperial ounces
- **Kilograms → Pounds**: Convert weight from kilograms to pounds
- **Conversion factors**:
- 1 gram = 0.035274 ounces
- 1 kilogram = 2.20462 pounds

### User Interface
- Clean, intuitive interface with dropdown selection for categories and units
- Real-time conversion calculations
- Custom color scheme with Tea & Romance palette
- Responsive design suitable for web browsers
- Clear input validation and error handling

## Setup and Run
1. Install dependencies:
Expand Down
2 changes: 1 addition & 1 deletion requirements.txt
Original file line number Diff line number Diff line change
@@ -1 +1 @@
streamlit
streamlit necessary to have
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

WARNING: Invalid requirements.txt syntax

The line "streamlit necessary to have " is not valid pip syntax. Requirements files should contain package names only, optionally with version specifiers. This will cause pip install to fail. Revert to "streamlit" or specify a version like "streamlit==1.28.1".