Metadata-Version: 2.4
Name: oresme
Version: 0.1.0
Summary: Oresme numbers refer to the sums related to the harmonic series
Home-page: https://github.com/WhiteSymmetry/Oresme
Author: Mehmet Keçeci
Author-email: Mehmet Keçeci <mkececi@yaani.com>
License: MIT License
        
        Copyright (c) 2025 Mehmet Keçeci
        
        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.
        
Project-URL: Homepage, https://github.com/WhiteSymmetry/Oresme/
Project-URL: Documentation, https://WhiteSymmetry.github.io/Oresme/
Project-URL: Repository, https://github.com/WhiteSymmetry/Oresme/
Project-URL: Issues, https://github.com/WhiteSymmetry/Oresme/issues
Keywords: Oresme
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development
Classifier: Topic :: Scientific/Engineering
Classifier: Typing :: Typed
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Operating System :: MacOS
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Oresme

[![DOI](https://zenodo.org/badge/DOI/10.5281/.svg)](https://doi.org/)

[![WorkflowHub DOI](https://img.shields.io/badge/DOI--blue)](https://doi.org/)

[![Anaconda-Server Badge](https://anaconda.org/bilgi/Oresme/badges/version.svg)](https://anaconda.org/bilgi/Oresme)
[![Anaconda-Server Badge](https://anaconda.org/bilgi/Oresme/badges/latest_release_date.svg)](https://anaconda.org/bilgi/Oresme)
[![Anaconda-Server Badge](https://anaconda.org/bilgi/Oresme/badges/platforms.svg)](https://anaconda.org/bilgi/Oresme)
[![Anaconda-Server Badge](https://anaconda.org/bilgi/Oresme/badges/license.svg)](https://anaconda.org/bilgi/Oresme)
[![Open Source](https://img.shields.io/badge/Open%20Source-Open%20Source-brightgreen.svg)](https://opensource.org/)
[![MIT License](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)


Oresme numbers refer to the sums related to the harmonic series.

---

## Tanım (Türkçe)
Oresme sayıları harmonik seriye ait toplamları ifade eder.

## Description (English)
Oresme numbers refer to the sums related to the harmonic series.

---

## Kurulum (Türkçe) / Installation (English)

### Python ile Kurulum / Install with pip, conda, mamba
```bash
pip install Oresme -U
python -m pip install -U Oresme
conda install bilgi::Oresme -y
mamba install bilgi::Oresme -y
```

```diff
- pip uninstall Oresme -y
+ pip install -U Oresme
+ python -m pip install -U Oresme
```

[PyPI](https://pypi.org/project/Oresme/)

### Test Kurulumu / Test Installation

```bash
pip install -i https://test.pypi.org/simple/ Oresme -U
```

### Github Master Kurulumu / GitHub Master Installation

**Terminal:**

```bash
pip install git+https://github.com/WhiteSymmetry/Oresme.git
```

**Jupyter Lab, Notebook, Visual Studio Code:**

```python
!pip install git+https://github.com/WhiteSymmetry/Oresme.git
# or
%pip install git+https://github.com/WhiteSymmetry/Oresme.git
```

---

## Kullanım (Türkçe) / Usage (English)

```python
import oresme as ore 

# Example 1: Generate Oresme sequence
print(ore.oresme_sequence(5))  # [0.5, 0.5, 0.375, 0.25, 0.15625]

# Example 2: Get exact harmonic numbers as fractions
print(ore.harmonic_numbers(3))  # [Fraction(1, 1), Fraction(3, 2), Fraction(11, 6)]

# Example 3: Calculate single harmonic number
print(ore.harmonic_number(5))  # 2.283333333333333

# Example 4: Approximate large harmonic number
print(ore.harmonic_number_approx(1_000_000))  # ≈14.392726722865724

# Example 5: Use generator
for i, h in enumerate(ore.harmonic_generator(3), 1):
    print(f"H_{i} = {h}")

# Example 6: NumPy vectorized version
print(ore.harmonic_numbers_numpy(5))  # [1. 1.5 1.833... 2.083... 2.283...]

[0.5, 0.5, 0.375, 0.25, 0.15625]
[Fraction(1, 1), Fraction(3, 2), Fraction(11, 6)]
2.283333333333333
14.392726722865808
H_1 = 1.0
H_2 = 1.5
H_3 = 1.8333333333333333
[1.         1.5        1.83333333 2.08333333 2.28333333]

```

```python
import oresme
oresme.__version__
```
---

### Development
```bash
# Clone the repository
git clone https://github.com/WhiteSymmetry/Oresme.git
cd Oresme

# Install in development mode
python -m pip install -ve . # Install package in development mode

# Run tests
pytest

Notebook, Jupyterlab, Colab, Visual Studio Code
!python -m pip install git+https://github.com/WhiteSymmetry/Oresme.git
```
---

## Citation

If this library was useful to you in your research, please cite us. Following the [GitHub citation standards](https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-citation-files), here is the recommended citation.

### BibTeX


### APA

```


Keçeci, M. (2025). Oresme. GZenodo. https://doi.org/
```

### Chicago

```

Keçeci, Mehmet. "Oresme". Zenodo, 2025. https://doi.org/

```


### Lisans (Türkçe) / License (English)

```
This project is licensed under the MIT License.
```
