Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PyConvertAtom

PyConvertAtom Logo

Unit conversion, mathematical operations, and cryptographic experimentation in a modular Python toolkit.
Lightweight CLI utility for conversions, math utilities, and educational cryptography experiments.

MIT License Python Status


Overview

PyConvertAtom is an open-source Python toolkit designed for unit conversions, basic mathematical operations, and cryptographic experimentation using classical ciphers such as the Hill Cipher. It provides a simple command-line interface (CLI) and a modular architecture that can be extended for educational or practical use cases.

Status: Frozen

The project is currently in a frozen state. Future improvements, refactoring, and maintenance are planned. Contributions and suggestions are welcome.


Features

Unit Conversions

  • Meters ↔ Kilometers
  • Seconds ↔ Hours
  • Meters/Second ↔ Kilometers/Hour (in progress)
  • Celsius ↔ Fahrenheit (planned)

Mathematical Operations

  • Addition, subtraction, multiplication, and division (menu implemented, logic in development)

Cryptography

  • Hill Cipher implementation using linear algebra and NumPy

Architecture

  • Fully modular design
  • Easy to extend with new tools and features

Installation

Clone the repository and install dependencies:

git clone https://github.com/luke-lynx/PyConvertAtom.git
cd PyConvertAtom/Converter_program/main
pip install numpy

Recommended: Python 3.7 or higher


Usage

Run the main application:

python main.py

You will interact with a CLI menu in the terminal.


Example Menu

===================================================
                  PyConvertAtom
===================================================
1. Unit Conversion
2. Mathematical Operations (Not implemented)
3. Operation History (Not implemented)
4. Hill Cipher Encryption
5. Exit
===================================================

Project Structure

PyConvertAtom/
├── Converter_program/
│   └── main/
│       ├── library/
│       │   ├── conversion_library.py
│       │   ├── conversion.py
│       │   ├── encryption.py
│       │   ├── operation.py
│       ├── main.py
│       └── trash_files/
├── LICENSE
├── README.md
└── ...

Contribution Guidelines

Contributions are welcome and encouraged.

  1. Fork the repository

  2. Create a feature branch:

    git checkout -b feature/my-improvement
  3. Commit your changes:

    git commit -m "feat: describe your improvement"
  4. Push to your branch:

    git push origin feature/my-improvement
  5. Open a Pull Request

Code Standards

  • Follow PEP8 guidelines
  • Use clear and descriptive naming
  • Include docstrings (English preferred)

Roadmap

  • Refactor CLI into modular command system
  • Expand unit conversion library
  • Add full mathematical engine
  • Implement operation history system
  • Add internationalization (i18n)
  • Automated testing suite
  • Improved CLI user experience

License

This project is licensed under the MIT License. See the LICENSE file for details.


Author

Developed by Lucas (luke-lynx)

GitHub: https://github.com/luke-lynx


Clean, modular, and extensible design for learning and experimentation.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages