engcalc 0.1.0__tar.gz

engcalc-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,34 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Test on ${{ matrix.os }} / Python ${{ matrix.python-version }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest -v

engcalc-0.1.0/.gitignore

@@ -0,0 +1,31 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+
+# Virtual environments
+venv/
+env/
+ENV/
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+*.egg
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db

engcalc-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ankita Das
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

engcalc-0.1.0/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.5
+Name: engcalc
+Version: 0.1.0
+Summary: Mechanical Engineering calculations in Python
+Author-email: Ankita Das <ankidas687@gmail.com>
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: numpy>=1.24
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: twine>=4.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# engcalc
+
+> Mechanical Engineering calculations in Python — fast, tested, and easy to use.
+
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Tests](https://github.com/ankidas687/engcalc/actions/workflows/tests.yml/badge.svg)](https://github.com/ankidas687/engcalc/actions/workflows/tests.yml)
+[![PyPI](https://img.shields.io/badge/PyPI-coming%20soon-orange)]()
+
+`engcalc` is a pure-Python library for common Mechanical Engineering
+calculations — thermodynamics, fluid mechanics, heat transfer,
+material properties, and unit conversions. Designed for students,
+engineers, and researchers who want clean, tested formulas without
+the spreadsheet mess.
+
+## Features
+
+- **Thermodynamics** — ideal gas law, Carnot, Otto, Diesel, Brayton cycles
+- **Fluid Mechanics** — Reynolds number, Bernoulli, Darcy-Weisbach, pump power
+- **Heat Transfer** — conduction, convection, radiation, LMTD
+- **Materials Database** — 10 common engineering materials (steel, aluminum, copper, titanium, cast iron) with 8 properties each
+- **Unit Conversions** — 60+ units across 12 categories (length, mass, time, temperature, pressure, energy, power, force, area, volume, velocity, angle)
+- **SI units** throughout — no unit confusion
+- **Zero heavy dependencies** — only NumPy
+- **Fully type-hinted** and tested (91 tests passing)
+
+## Installation
+
+```bash
+pip install engcalc
+```
+
+> ⚠️ Not yet on PyPI. Install from source for now:
+
+```bash
+git clone https://github.com/ankidas687/engcalc.git
+cd engcalc
+pip install -e .
+```
+
+## Quick Start
+
+```python
+from engcalc import ideal_gas, cycles, fluids, heat, materials, units
+
+# Ideal gas law: PV = nRT
+P = ideal_gas.pressure(n=1, T=300, V=0.024)
+print(f"Pressure: {P:.2f} Pa")            # 103930.78 Pa
+
+# Carnot cycle efficiency
+eta = cycles.carnot_efficiency(T_hot=800, T_cold=300)
+print(f"Carnot efficiency: {eta * 100:.2f}%")   # 62.50%
+
+# Reynolds number
+Re = fluids.reynolds_number(rho=1000, velocity=2, diameter=0.05, mu=0.001)
+print(f"Re = {Re:.0f} → {fluids.flow_regime(Re)}")   # 100000 → turbulent
+
+# Heat conduction through a wall
+Q = heat.conduction_rate(k=50, A=2, dT=100, L=0.1)
+print(f"Heat rate: {Q:.2f} W")            # 100000.00 W
+
+# Material property lookup
+rho = materials.get("steel_AISI_1040", "density")
+print(f"Steel density: {rho} kg/m^3")     # 7850 kg/m^3
+
+# Unit conversion
+temp_K = units.convert(100, "degC", "K")
+print(f"100 °C = {temp_K:.2f} K")         # 373.15 K
+```
+
+## Modules
+
+| Module | Functions | Description |
+|---|---|---|
+| `engcalc.ideal_gas` | `pressure`, `volume`, `temperature`, `moles` | Ideal gas law (PV = nRT) |
+| `engcalc.cycles` | `carnot_efficiency`, `otto_efficiency`, `diesel_efficiency`, `brayton_efficiency` | Thermodynamic cycle efficiencies |
+| `engcalc.fluids` | `reynolds_number`, `flow_regime`, `bernoulli_pressure`, `darcy_weisbach_head_loss`, `pump_power` | Fluid mechanics |
+| `engcalc.heat` | `conduction_rate`, `convection_rate`, `radiation_rate`, `lmtd` | Heat transfer |
+| `engcalc.materials` | `get`, `get_all`, `list_materials`, `search`, `list_categories` | Material property database |
+| `engcalc.units` | `convert`, `list_categories`, `list_units`, `find_category` | Unit conversion utilities |
+
+## Examples
+
+Check the [`examples/`](examples/) folder for complete demo scripts:
+
+- `examples/demo.py` — Ideal gas law
+- `examples/cycles_demo.py` — Thermodynamic cycles
+- `examples/fluids_demo.py` — Fluid mechanics
+- `examples/heat_demo.py` — Heat transfer
+- `examples/materials_demo.py` — Materials database
+- `examples/units_demo.py` — Unit conversions
+
+Run any demo:
+
+```bash
+python examples/cycles_demo.py
+```
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/ankidas687/engcalc.git
+cd engcalc
+
+# Create virtual environment
+python -m venv venv
+venv\Scripts\Activate.ps1    # Windows
+# source venv/bin/activate   # macOS/Linux
+
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+```
+
+## Contributing
+
+Contributions are welcome! If you find a bug or want to add a new
+calculation, feel free to:
+
+1. Fork the repo
+2. Create a feature branch (`git checkout -b feature/new-formula`)
+3. Commit your changes (`git commit -m "Add new formula"`)
+4. Push to the branch (`git push origin feature/new-formula`)
+5. Open a Pull Request
+
+## Roadmap
+
+- [x] Thermodynamics (ideal gas, cycles)
+- [x] Fluid mechanics
+- [x] Heat transfer
+- [x] Materials database
+- [x] Unit conversion utilities
+- [ ] Mechanics of materials (stress, strain, beam)
+- [ ] Publish to PyPI
+
+## License
+
+This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.
+
+## Author
+
+**Ankita Das** — [@ankidas687](https://github.com/ankidas687)
+
+---
+
+⭐ If you find this useful, consider giving it a star!

engcalc-0.1.0/README.md

@@ -0,0 +1,149 @@
+# engcalc
+
+> Mechanical Engineering calculations in Python — fast, tested, and easy to use.
+
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Tests](https://github.com/ankidas687/engcalc/actions/workflows/tests.yml/badge.svg)](https://github.com/ankidas687/engcalc/actions/workflows/tests.yml)
+[![PyPI](https://img.shields.io/badge/PyPI-coming%20soon-orange)]()
+
+`engcalc` is a pure-Python library for common Mechanical Engineering
+calculations — thermodynamics, fluid mechanics, heat transfer,
+material properties, and unit conversions. Designed for students,
+engineers, and researchers who want clean, tested formulas without
+the spreadsheet mess.
+
+## Features
+
+- **Thermodynamics** — ideal gas law, Carnot, Otto, Diesel, Brayton cycles
+- **Fluid Mechanics** — Reynolds number, Bernoulli, Darcy-Weisbach, pump power
+- **Heat Transfer** — conduction, convection, radiation, LMTD
+- **Materials Database** — 10 common engineering materials (steel, aluminum, copper, titanium, cast iron) with 8 properties each
+- **Unit Conversions** — 60+ units across 12 categories (length, mass, time, temperature, pressure, energy, power, force, area, volume, velocity, angle)
+- **SI units** throughout — no unit confusion
+- **Zero heavy dependencies** — only NumPy
+- **Fully type-hinted** and tested (91 tests passing)
+
+## Installation
+
+```bash
+pip install engcalc
+```
+
+> ⚠️ Not yet on PyPI. Install from source for now:
+
+```bash
+git clone https://github.com/ankidas687/engcalc.git
+cd engcalc
+pip install -e .
+```
+
+## Quick Start
+
+```python
+from engcalc import ideal_gas, cycles, fluids, heat, materials, units
+
+# Ideal gas law: PV = nRT
+P = ideal_gas.pressure(n=1, T=300, V=0.024)
+print(f"Pressure: {P:.2f} Pa")            # 103930.78 Pa
+
+# Carnot cycle efficiency
+eta = cycles.carnot_efficiency(T_hot=800, T_cold=300)
+print(f"Carnot efficiency: {eta * 100:.2f}%")   # 62.50%
+
+# Reynolds number
+Re = fluids.reynolds_number(rho=1000, velocity=2, diameter=0.05, mu=0.001)
+print(f"Re = {Re:.0f} → {fluids.flow_regime(Re)}")   # 100000 → turbulent
+
+# Heat conduction through a wall
+Q = heat.conduction_rate(k=50, A=2, dT=100, L=0.1)
+print(f"Heat rate: {Q:.2f} W")            # 100000.00 W
+
+# Material property lookup
+rho = materials.get("steel_AISI_1040", "density")
+print(f"Steel density: {rho} kg/m^3")     # 7850 kg/m^3
+
+# Unit conversion
+temp_K = units.convert(100, "degC", "K")
+print(f"100 °C = {temp_K:.2f} K")         # 373.15 K
+```
+
+## Modules
+
+| Module | Functions | Description |
+|---|---|---|
+| `engcalc.ideal_gas` | `pressure`, `volume`, `temperature`, `moles` | Ideal gas law (PV = nRT) |
+| `engcalc.cycles` | `carnot_efficiency`, `otto_efficiency`, `diesel_efficiency`, `brayton_efficiency` | Thermodynamic cycle efficiencies |
+| `engcalc.fluids` | `reynolds_number`, `flow_regime`, `bernoulli_pressure`, `darcy_weisbach_head_loss`, `pump_power` | Fluid mechanics |
+| `engcalc.heat` | `conduction_rate`, `convection_rate`, `radiation_rate`, `lmtd` | Heat transfer |
+| `engcalc.materials` | `get`, `get_all`, `list_materials`, `search`, `list_categories` | Material property database |
+| `engcalc.units` | `convert`, `list_categories`, `list_units`, `find_category` | Unit conversion utilities |
+
+## Examples
+
+Check the [`examples/`](examples/) folder for complete demo scripts:
+
+- `examples/demo.py` — Ideal gas law
+- `examples/cycles_demo.py` — Thermodynamic cycles
+- `examples/fluids_demo.py` — Fluid mechanics
+- `examples/heat_demo.py` — Heat transfer
+- `examples/materials_demo.py` — Materials database
+- `examples/units_demo.py` — Unit conversions
+
+Run any demo:
+
+```bash
+python examples/cycles_demo.py
+```
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/ankidas687/engcalc.git
+cd engcalc
+
+# Create virtual environment
+python -m venv venv
+venv\Scripts\Activate.ps1    # Windows
+# source venv/bin/activate   # macOS/Linux
+
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+```
+
+## Contributing
+
+Contributions are welcome! If you find a bug or want to add a new
+calculation, feel free to:
+
+1. Fork the repo
+2. Create a feature branch (`git checkout -b feature/new-formula`)
+3. Commit your changes (`git commit -m "Add new formula"`)
+4. Push to the branch (`git push origin feature/new-formula`)
+5. Open a Pull Request
+
+## Roadmap
+
+- [x] Thermodynamics (ideal gas, cycles)
+- [x] Fluid mechanics
+- [x] Heat transfer
+- [x] Materials database
+- [x] Unit conversion utilities
+- [ ] Mechanics of materials (stress, strain, beam)
+- [ ] Publish to PyPI
+
+## License
+
+This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.
+
+## Author
+
+**Ankita Das** — [@ankidas687](https://github.com/ankidas687)
+
+---
+
+⭐ If you find this useful, consider giving it a star!

engcalc-0.1.0/examples/cycles_demo.py

@@ -0,0 +1,33 @@
+"""Demo script for engcalc.cycles module."""
+
+from engcalc import cycles
+
+
+def main():
+    print("=" * 55)
+    print("engcalc demo — Thermodynamic Cycles")
+    print("=" * 55)
+
+    # Carnot
+    eta_carnot = cycles.carnot_efficiency(T_hot=800, T_cold=300)
+    print(f"\nCarnot cycle (T_hot=800K, T_cold=300K):")
+    print(f"  Efficiency: {eta_carnot * 100:.2f}%")
+
+    # Otto
+    eta_otto = cycles.otto_efficiency(compression_ratio=8)
+    print(f"\nOtto cycle (r=8, petrol engine):")
+    print(f"  Efficiency: {eta_otto * 100:.2f}%")
+
+    # Diesel
+    eta_diesel = cycles.diesel_efficiency(compression_ratio=18, cutoff_ratio=2)
+    print(f"\nDiesel cycle (r=18, rc=2):")
+    print(f"  Efficiency: {eta_diesel * 100:.2f}%")
+
+    # Brayton
+    eta_brayton = cycles.brayton_efficiency(pressure_ratio=10)
+    print(f"\nBrayton cycle (rp=10, gas turbine):")
+    print(f"  Efficiency: {eta_brayton * 100:.2f}%")
+
+
+if __name__ == "__main__":
+    main()

engcalc-0.1.0/examples/demo.py

@@ -0,0 +1,24 @@
+"""Demo script for engcalc.ideal_gas module."""
+
+from engcalc import ideal_gas
+
+
+def main():
+    print("=" * 50)
+    print("engcalc demo — Ideal Gas Law")
+    print("=" * 50)
+
+    # Standard case
+    n = 1.0       # moles
+    T = 300.0     # Kelvin
+    V = 0.024     # m^3
+
+    P = ideal_gas.pressure(n=n, T=T, V=V)
+    print(f"\nInput:  n={n} mol, T={T} K, V={V} m^3")
+    print(f"Output: P = {P:.2f} Pa")
+    print(f"        P = {P / 1000:.2f} kPa")
+    print(f"        P = {P / 101325:.4f} atm")
+
+
+if __name__ == "__main__":
+    main()

engcalc-0.1.0/examples/fluids_demo.py

@@ -0,0 +1,42 @@
+"""Demo script for engcalc.fluids module."""
+
+from engcalc import fluids
+
+
+def main():
+    print("=" * 55)
+    print("engcalc demo — Fluid Mechanics")
+    print("=" * 55)
+
+    # Reynolds number
+    Re = fluids.reynolds_number(rho=1000, velocity=2, diameter=0.05, mu=0.001)
+    regime = fluids.flow_regime(Re)
+    print(f"\nReynolds number (water in pipe):")
+    print(f"  rho=1000, v=2 m/s, D=0.05 m, mu=0.001")
+    print(f"  Re = {Re:.0f} → {regime}")
+
+    # Bernoulli
+    P2 = fluids.bernoulli_pressure(
+        P1=101325, v1=0, h1=0, v2=5, h2=0, rho=1000
+    )
+    print(f"\nBernoulli equation:")
+    print(f"  P1=101325 Pa, v1=0, v2=5 m/s")
+    print(f"  P2 = {P2:.2f} Pa")
+
+    # Darcy-Weisbach
+    h_f = fluids.darcy_weisbach_head_loss(
+        f=0.02, L=100, D=0.05, velocity=2
+    )
+    print(f"\nDarcy-Weisbach head loss:")
+    print(f"  f=0.02, L=100 m, D=0.05 m, v=2 m/s")
+    print(f"  h_f = {h_f:.4f} m")
+
+    # Pump power
+    P = fluids.pump_power(rho=1000, g=9.81, Q=0.01, head=10, efficiency=0.8)
+    print(f"\nPump power:")
+    print(f"  Q=0.01 m^3/s, head=10 m, eta=0.8")
+    print(f"  P = {P:.2f} W ({P/1000:.3f} kW)")
+
+
+if __name__ == "__main__":
+    main()

engcalc-0.1.0/examples/heat_demo.py

@@ -0,0 +1,41 @@
+"""Demo script for engcalc.heat module."""
+
+from engcalc import heat
+
+
+def main():
+    print("=" * 55)
+    print("engcalc demo — Heat Transfer")
+    print("=" * 55)
+
+    # Conduction
+    Q_cond = heat.conduction_rate(k=50, A=2, dT=100, L=0.1)
+    print(f"\nConduction through wall:")
+    print(f"  k=50 W/(m·K), A=2 m², ΔT=100 K, L=0.1 m")
+    print(f"  Q = {Q_cond:.2f} W ({Q_cond/1000:.2f} kW)")
+
+    # Convection
+    Q_conv = heat.convection_rate(h=25, A=2, T_surface=350, T_fluid=300)
+    print(f"\nConvection from surface:")
+    print(f"  h=25 W/(m²·K), A=2 m², T_s=350 K, T_f=300 K")
+    print(f"  Q = {Q_conv:.2f} W")
+
+    # Radiation
+    Q_rad = heat.radiation_rate(
+        emissivity=0.9, A=1, T_surface=500, T_surroundings=300
+    )
+    print(f"\nRadiation from surface:")
+    print(f"  ε=0.9, A=1 m², T_s=500 K, T_sur=300 K")
+    print(f"  Q = {Q_rad:.2f} W")
+
+    # LMTD
+    lmtd_val = heat.lmtd(
+        T_hot_in=400, T_hot_out=350, T_cold_in=300, T_cold_out=330
+    )
+    print(f"\nLMTD for heat exchanger:")
+    print(f"  T_hot: 400 → 350, T_cold: 300 → 330")
+    print(f"  LMTD = {lmtd_val:.2f} K")
+
+
+if __name__ == "__main__":
+    main()

engcalc-0.1.0/examples/materials_demo.py

@@ -0,0 +1,46 @@
+"""Demo script for engcalc.materials module."""
+
+from engcalc import materials
+
+
+def main():
+    print("=" * 60)
+    print("engcalc demo — Materials Database")
+    print("=" * 60)
+
+    # List all categories
+    cats = materials.list_categories()
+    print(f"\nAvailable categories ({len(cats)}):")
+    for c in cats:
+        print(f"  - {c}")
+
+    # List all materials
+    all_mats = materials.list_materials()
+    print(f"\nTotal materials: {len(all_mats)}")
+
+    # Steel list
+    steels = materials.search("steel")
+    print(f"\nSteel grades ({len(steels)}):")
+    for s in steels:
+        print(f"  - {s}")
+
+    # Aluminum list
+    aluminums = materials.search("aluminum")
+    print(f"\nAluminum alloys ({len(aluminums)}):")
+    for a in aluminums:
+        print(f"  - {a}")
+
+    # Detailed properties of one material
+    print("\n" + "=" * 60)
+    print("Detailed: Aluminum 6061-T6")
+    print("=" * 60)
+    props = materials.get_all("aluminum_6061_T6")
+    for key, value in props.items():
+        if isinstance(value, float) and value > 1e6:
+            print(f"  {key:25s}: {value:.3e}")
+        else:
+            print(f"  {key:25s}: {value}")
+
+
+if __name__ == "__main__":
+    main()

engcalc-0.1.0/examples/units_demo.py

@@ -0,0 +1,65 @@
+"""Demo script for engcalc.units module."""
+
+from engcalc import units
+
+
+def main():
+    print("=" * 60)
+    print("engcalc demo — Unit Conversion Utilities")
+    print("=" * 60)
+
+    # Categories
+    cats = units.list_categories()
+    print(f"\nSupported categories ({len(cats)}):")
+    for c in cats:
+        units_in_cat = units.list_units(c)
+        print(f"  {c:12s} ({len(units_in_cat)} units): {', '.join(units_in_cat)}")
+
+    # Length
+    print("\n" + "=" * 60)
+    print("Length conversions")
+    print("=" * 60)
+    print(f"  100 cm  = {units.convert(100, 'cm', 'm'):.4f} m")
+    print(f"  1 m     = {units.convert(1, 'm', 'mm'):.1f} mm")
+    print(f"  1 in    = {units.convert(1, 'in', 'cm'):.4f} cm")
+    print(f"  1 km    = {units.convert(1, 'km', 'mile'):.6f} mile")
+
+    # Temperature
+    print("\n" + "=" * 60)
+    print("Temperature conversions")
+    print("=" * 60)
+    print(f"  100 °C  = {units.convert(100, 'degC', 'K'):.2f} K")
+    print(f"  100 °C  = {units.convert(100, 'degC', 'degF'):.2f} °F")
+    print(f"  32 °F   = {units.convert(32, 'degF', 'degC'):.2f} °C")
+    print(f"  0 K     = {units.convert(0, 'K', 'degC'):.2f} °C")
+
+    # Pressure
+    print("\n" + "=" * 60)
+    print("Pressure conversions")
+    print("=" * 60)
+    print(f"  1 atm   = {units.convert(1, 'atm', 'Pa'):.2f} Pa")
+    print(f"  1 atm   = {units.convert(1, 'atm', 'psi'):.4f} psi")
+    print(f"  1 bar   = {units.convert(1, 'bar', 'Pa'):.2f} Pa")
+    print(f"  1 MPa   = {units.convert(1, 'MPa', 'psi'):.4f} psi")
+
+    # Energy & Power
+    print("\n" + "=" * 60)
+    print("Energy & Power")
+    print("=" * 60)
+    print(f"  1 kWh   = {units.convert(1, 'kWh', 'J'):.2e} J")
+    print(f"  1 BTU   = {units.convert(1, 'BTU', 'J'):.2f} J")
+    print(f"  1 hp    = {units.convert(1, 'hp', 'W'):.2f} W")
+    print(f"  1 hp    = {units.convert(1, 'hp', 'kW'):.4f} kW")
+
+    # Fluid-related
+    print("\n" + "=" * 60)
+    print("Fluid & Mechanics")
+    print("=" * 60)
+    print(f"  1 lbf   = {units.convert(1, 'lbf', 'N'):.4f} N")
+    print(f"  1 kgf   = {units.convert(1, 'kgf', 'N'):.4f} N")
+    print(f"  36 km/h = {units.convert(36, 'km/h', 'm/s'):.4f} m/s")
+    print(f"  1 gal   = {units.convert(1, 'gal_US', 'L'):.4f} L")
+
+
+if __name__ == "__main__":
+    main()

engcalc-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "engcalc"
+version = "0.1.0"
+description = "Mechanical Engineering calculations in Python"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+    { name = "Ankita Das", email = "ankidas687@gmail.com" }
+]
+dependencies = [
+    "numpy>=1.24",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "build>=1.0",
+    "twine>=4.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/engcalc"]

engcalc-0.1.0/src/engcalc/__init__.py

@@ -0,0 +1,3 @@
+"""engcalc — Mechanical Engineering calculations in Python."""
+
+__version__ = "0.1.0"