# MathSimplicity
## Description
[MathSimplicity](mathsimplicity/mathsimplicity.py) is a Python package that provides various utilities for mathematical computations, including:
- Prime factorization of numbers.
- Generation of prime numbers within a specified range.
- Conversion of fractions to decimals and vice versa.
- Calculation of Greatest Common Divisor (GCD) and Least Common Multiple (LCM).
## Why mathsimplicity?
The main motivation behind [mathsimplicity](mathsimplicity/mathsimplicity.py) is to provide an accessible tool for those who are taking their first steps in programming and mathematics. By offering intuitive and easy-to-use tools, my goal is to support students and enthusiasts on their way to understanding and applying basic mathematical concepts. This project aims to simplify learning and facilitate the process of solving everyday mathematical problems.
### Key Features
- Ease of Use: Functions designed to be simple and straightforward.
- Support for New Programmers: Clear documentation and practical examples to facilitate learning.
- Essential Mathematical Functions: Fundamental tools for solving common mathematical problems.
## Installation
You can install [`mathsimplicity`](mathsimplicity/mathsimplicity.py) via PyPI using pip. Simply run the following command:
```
pip install mathsimplicity
```
## Usage
Here's a quick overview of how to use the functionalities provided by the package.
### Prime Factorization
```
from mathsimplicity import primes
result = primes(30, 56)
print(result)
```
#### OUTPUT
```
The number 30 can be divided by the following prime numbers: 2 x 3 x 5
The number 56 can be divided by the following prime numbers: 2^3 x 7
```
### Prime Numbers in Range
```
from mathsimplicity import primes_in_range
result = primes_in_range(10, 50)
print(result)
```
#### OUTPUT
```
[11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47]
```
### Fraction to Decimal Conversion
```
from mathsimplicity import fraction_to_decimal
result = fraction_to_decimal("1/2", "3/4", "5 ÷ 10")
print(result)
```
#### OUTPUT
```
The result of '1/2' is 0.5
The result of '3/4' is 0.75
The result of '5 ÷ 10' is 0.5
```
### Decimal to Fraction Conversion
```
from mathsimplicity import decimal_to_fraction
result = decimal_to_fraction("0.25", "0.5", "0.75")
print(result)
```
#### OUTPUT
```
The decimal '0.25' is approximately '1/4' as a fraction.
The decimal '0.5' is approximately '1/2' as a fraction.
The decimal '0.75' is approximately '3/4' as a fraction.
```
### Greatest Common Divisor (GCD)
```
from mathsimplicity import greatest_common_divisor
result = greatest_common_divisor(54, 24, 18)
print(result)
```
#### OUTPUT
- ```The greatest common divisor of the provided numbers is: 6```
### Least Common Multiple (LCM)
```
from your_package import least_common_multiple
result = least_common_multiple(4, 5, 6)
print(result)
```
#### OUTPUT
- ```The least common multiple of the provided numbers is: 60```
## Contributing
Contributions are not welcome!
## LICENSE
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.
## Contact
If you have any questions or feedback, feel free to contact me:
- Email: mohamedhireche74@gmail.com
- GitHub: promoha90
Raw data
{
"_id": null,
"home_page": "https://github.com/promoha90/mathsimplicity",
"name": "MathSimplicity",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "math, mathematics, beginner, education, prime numbers, fraction, decimal, GCD, LCM, programming, math tools, math utilities, simple math, math for beginners",
"author": "Mohamed Lotfi Hireche Benkert",
"author_email": "mohamedhireche74@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/ab/f6/adc5f92b9b35209dbf58331edb4ecf9d850a64084435ac3c27908fd80981/mathsimplicity-1.0.0.tar.gz",
"platform": null,
"description": "# MathSimplicity\r\n\r\n## Description\r\n\r\n[MathSimplicity](mathsimplicity/mathsimplicity.py) is a Python package that provides various utilities for mathematical computations, including:\r\n\r\n- Prime factorization of numbers.\r\n- Generation of prime numbers within a specified range.\r\n- Conversion of fractions to decimals and vice versa.\r\n- Calculation of Greatest Common Divisor (GCD) and Least Common Multiple (LCM).\r\n\r\n## Why mathsimplicity?\r\nThe main motivation behind [mathsimplicity](mathsimplicity/mathsimplicity.py) is to provide an accessible tool for those who are taking their first steps in programming and mathematics. By offering intuitive and easy-to-use tools, my goal is to support students and enthusiasts on their way to understanding and applying basic mathematical concepts. This project aims to simplify learning and facilitate the process of solving everyday mathematical problems.\r\n\r\n### Key Features\r\n- Ease of Use: Functions designed to be simple and straightforward.\r\n- Support for New Programmers: Clear documentation and practical examples to facilitate learning.\r\n- Essential Mathematical Functions: Fundamental tools for solving common mathematical problems.\r\n\r\n## Installation\r\n\r\nYou can install [`mathsimplicity`](mathsimplicity/mathsimplicity.py) via PyPI using pip. Simply run the following command:\r\n\r\n```\r\npip install mathsimplicity\r\n```\r\n\r\n## Usage\r\nHere's a quick overview of how to use the functionalities provided by the package.\r\n### Prime Factorization\r\n```\r\nfrom mathsimplicity import primes\r\n\r\nresult = primes(30, 56)\r\nprint(result)\r\n```\r\n#### OUTPUT\r\n```\r\nThe number 30 can be divided by the following prime numbers: 2 x 3 x 5\r\nThe number 56 can be divided by the following prime numbers: 2^3 x 7\r\n```\r\n\r\n### Prime Numbers in Range\r\n```\r\nfrom mathsimplicity import primes_in_range\r\n\r\nresult = primes_in_range(10, 50)\r\nprint(result)\r\n\r\n```\r\n#### OUTPUT\r\n```\r\n[11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47]\r\n```\r\n\r\n### Fraction to Decimal Conversion\r\n```\r\nfrom mathsimplicity import fraction_to_decimal\r\n\r\nresult = fraction_to_decimal(\"1/2\", \"3/4\", \"5 \u00c3\u00b7 10\")\r\nprint(result)\r\n```\r\n#### OUTPUT\r\n```\r\nThe result of '1/2' is 0.5\r\nThe result of '3/4' is 0.75\r\nThe result of '5 \u00c3\u00b7 10' is 0.5\r\n```\r\n\r\n### Decimal to Fraction Conversion\r\n```\r\nfrom mathsimplicity import decimal_to_fraction\r\n\r\nresult = decimal_to_fraction(\"0.25\", \"0.5\", \"0.75\")\r\nprint(result)\r\n```\r\n#### OUTPUT\r\n```\r\nThe decimal '0.25' is approximately '1/4' as a fraction.\r\nThe decimal '0.5' is approximately '1/2' as a fraction.\r\nThe decimal '0.75' is approximately '3/4' as a fraction.\r\n```\r\n\r\n### Greatest Common Divisor (GCD)\r\n```\r\nfrom mathsimplicity import greatest_common_divisor\r\n\r\nresult = greatest_common_divisor(54, 24, 18)\r\nprint(result)\r\n```\r\n#### OUTPUT\r\n- ```The greatest common divisor of the provided numbers is: 6```\r\n\r\n### Least Common Multiple (LCM)\r\n```\r\nfrom your_package import least_common_multiple\r\n\r\nresult = least_common_multiple(4, 5, 6)\r\nprint(result)\r\n```\r\n#### OUTPUT\r\n- ```The least common multiple of the provided numbers is: 60```\r\n\r\n## Contributing\r\nContributions are not welcome!\r\n\r\n## LICENSE\r\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.\r\n\r\n## Contact\r\nIf you have any questions or feedback, feel free to contact me:\r\n\r\n- Email: mohamedhireche74@gmail.com\r\n- GitHub: promoha90\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "MathSimplicity is a Python package providing essential tools for basic mathematical computations, including prime factorization, range prime generation, fraction-to-decimal conversion, and GCD/LCM calculation.",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/promoha90/mathsimplicity"
},
"split_keywords": [
"math",
" mathematics",
" beginner",
" education",
" prime numbers",
" fraction",
" decimal",
" gcd",
" lcm",
" programming",
" math tools",
" math utilities",
" simple math",
" math for beginners"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6b20eabadc203bb781a79f4df7f2c7cc22e39d70fe56b1a7a6a2ce002ad25c41",
"md5": "6a541864215b91309851e75b922106c6",
"sha256": "afb4d2c66614409d32f5614f04b87ee681ebbee6aa444a5d4a8fc8e21a1051a1"
},
"downloads": -1,
"filename": "MathSimplicity-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6a541864215b91309851e75b922106c6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 6170,
"upload_time": "2024-08-24T15:39:33",
"upload_time_iso_8601": "2024-08-24T15:39:33.743277Z",
"url": "https://files.pythonhosted.org/packages/6b/20/eabadc203bb781a79f4df7f2c7cc22e39d70fe56b1a7a6a2ce002ad25c41/MathSimplicity-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "abf6adc5f92b9b35209dbf58331edb4ecf9d850a64084435ac3c27908fd80981",
"md5": "8a2e32df1ceb1e9a17da92cf8e8c3ba8",
"sha256": "f3784c7bca5176cda43fcbe298377a73db3244af34f67ac1f3853d11c1cd810a"
},
"downloads": -1,
"filename": "mathsimplicity-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "8a2e32df1ceb1e9a17da92cf8e8c3ba8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 5911,
"upload_time": "2024-08-24T15:39:35",
"upload_time_iso_8601": "2024-08-24T15:39:35.338290Z",
"url": "https://files.pythonhosted.org/packages/ab/f6/adc5f92b9b35209dbf58331edb4ecf9d850a64084435ac3c27908fd80981/mathsimplicity-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-24 15:39:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "promoha90",
"github_project": "mathsimplicity",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "mathsimplicity"
}
JSON
