Metadata-Version: 2.4
Name: timediffz
Version: 1.0.9
Summary: a library for advanced and accurate timestamping and time differences
Project-URL: Homepage, https://github.com/WeDu-official/timediffz
Project-URL: Issues, https://github.com/WeDu-official/timediffz/issues
Author-email: WeDu-official <fplu.the.founder@gmail.com>
License-File: LICENSE
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: Implementation
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Internet
Requires-Python: >=3.10
Requires-Dist: cython==3.2.2
Requires-Dist: requests==2.32.5
Requires-Dist: setuptools==80.9.0
Requires-Dist: td1inner==1.0.8
Requires-Dist: td2inner==1.0.8
Description-Content-Type: text/markdown

<img width="504" alt="time_diffz-high-resolution-logo-transparent" src="https://github.com/user-attachments/assets/6d0285dd-6cdd-4ea1-804b-561b98b0bac2" />


**timediffz/Time_diffz** a library for timestamps and differences between dates

**NOTE: timediffz ONLY work in almost any operating system(\*1) which can support python 3.10 and above**

**\*1: timediffz Tested on Arch Linux (Python 3.10+).
The library is platform-independent and expected to work on Windows and macOS, but those environments are not yet officially tested.**

**timediffz** is a library to make timestamps and calculating the differences between dates, uses exact rational arithmetic (fractions) instead of floating-point numbers, avoiding precision loss in date difference calculations. and nearly no for/while loops at all to provide fast performance literally you would need less than 100 microseconds in somecases to get the amount of months between the year 2025 and the end of the universe(year one googol), and it supports relativity for objects near earth like satellites,iss,etc... and it uses fractions based numbers to keep the numbers exact no floating point precision loss, and it has been made for scientists and systems as the most accurate system for its own job possible, note: in case of tropical year because of uncontrolled amount of parameters to count it to an unreliable level the J2000 is used but it's unreliable for extremely far dates but you can if you want to use new or other tropical dates via custom year parameter

THIS LIBRARY HAS TWO MODES THE TB1 MODE OR NORMAL ONE WHICH USES STANDARD LIBRARIES
AND REQUESTS ONLY, BUT EVEN THOUGH IT'S FAST BUT YOU CAN USE THE SECOND MODE THAT
IS EVEN FASTER WHICH IS THE TB2 BUT IT NEEDS ALL TB1'S REQUIREMENTS PLUS SETUPTOOLS
AND CYTHON AND INSTALLING GMP ON YOUR COMPUTER AND BUILDING THE CYTHON SETUP FILE
WITH THIS COMMAND:
```batch
cd (full path of folder where setupfractionals.py is in, found in the library files) & python setupfractionals.py build_ext --inplace
```
or the same but with python as python3:
```batch
cd (full path of folder where setupfractionals.py is in, found in the library files) & python3 setupfractionals.py build_ext --inplace
```
the first mode functions starts with prefix: p*, while second mode ones
start with prefix: c*, then after the first prefix the second prefix is the
function type if it was for timestamping it would be (p/c t*) or time diff.
mode which would be (p/c d).
## Install

to install use the following command(note installing the library in this way
would install library requirements both main and optional):

<code>pip install Timediffz</code>

## Contribute

if you have discovered a bug, or you want to change something just open a new issue
at [Issues](https://github.com/WeDu-official/Time_diffz/issues)

## Contact

you can contact us using this [email](mailto:fplu.the.founder@gmail.com)
,and you can be a part of our community by joining [our discord server](https://discord.gg/mnduzx6yUg)
