Metadata-Version: 2.4
Name: aveytense
Version: 0.3.58
Summary: Library written in Python, includes several extensions for inbuilt Python solutions
Author: John Mammoth
Author-email: aveyzan@gmail.com
License: MIT
Project-URL: Documentation, https://aveyzan.xyz/aveytense/
Project-URL: Repository, https://github.com/Aveyzan/aveytense
Project-URL: Changes, https://docs.google.com/document/d/1GC_KAOXML65jNfBZA8GhVViqPnrMoFtbLv_jHvUhBlg/edit?usp=sharing
Project-URL: Issues, https://github.com/Aveyzan/aveytense/issues/
Project-URL: Donate, https://ko-fi.com/aveyzan
Keywords: annotations,backport,extensions,math,types,typing,utility
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
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 :: 3.14
Classifier: Programming Language :: Python :: 3.15
Classifier: Topic :: Software Development
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: typing_extensions>=4.10.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: keywords
Dynamic: license
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary


# AveyTense

**AveyTense** is a library written by Aveyzan using Python, which provides especially extensions to inbuilt Python solutions.

## Features

Some feature examples:

* [`aveytense.Tense.append()`](https://aveyzan.xyz/aveytense#aveytense.Tense.append) - A pure, extended version of `list.append()` that adds an arbitrary amount of items, starting
with items in the given iterable object.

```py

from aveytense import Tense

Tense.append([651, 78, 888, 906], 75, 12, 6, 678)
# [651, 78, 888, 906, 75, 12, 6, 678]

Tense.append({762: 783, 9003: 96}, (960, 120), (762, 786))
# {762: 786, 960: 120, 762: 786}

```

* [`aveytense.Tense.extend()`](https://aveyzan.xyz/aveytense#aveytense.Tense.extend) - A pure, extended version of `list.extend()` that adds an arbitrary amount of items included in
every iterable objects, starting with items in the first given iterable object.

```py

from aveytense import Tense

Tense.extend([651, 78, 888, 906], (75, 12), {6, 678})
# [651, 78, 888, 906, 75, 12, 6, 678]

Tense.extend({762: 783, 9003: 96}, {960: 120}, {762: 786})
# {762: 786, 960: 120, 762: 786}

```

* [`aveytense.Tense.reverse()`](https://aveyzan.xyz/aveytense#aveytense.Tense.reverse) - A pure, extended version of `list.reverse()` that reverses
given iterable object.

```py

from aveytense import Tense

Tense.reverse("Hi, Python! Hi, AveyTense!")
# "!esneTyevA ,iH !nohtyP ,iH"

Tense.reverse([762, 876, 906, 903, 123])
# [123, 903, 906, 876, 762]

```

* [`aveytense.Tense.shuffle()`](https://aveyzan.xyz/aveytense#aveytense.Tense.shuffle) - A pure, extended version of `random.shuffle()` that shuffles given iterable object.

```py

from aveytense import Tense

Tense.shuffle("Hi, Python! Hi, AveyTense!")
# " ,sPh y!ti,neeTo!HvHeyA ni"

Tense.shuffle([762, 876, 906, 903, 123])
# [762, 906, 903, 123, 876]

```

More features are included in [this page](https://aveyzan.xyz/aveytense). For code changes see [this Google document](https://docs.google.com/document/d/1GC_KAOXML65jNfBZA8GhVViqPnrMoFtbLv_jHvUhBlg/edit?usp=sharing).

## Getting started

Before installing AveyTense, ensure you meet following Python version condition included in the table below:

| AveyTense Version | Python Version |
| :---------------- | :------------- |
| ≥ 0.3.46          | ≥ 3.8          |
| < 0.3.46          | ≥ 3.9          |

Then run the following command:

```
pip install aveytense
```

The command will also install [`typing_extensions`](https://pypi.org/project/typing_extensions). Minimal version of `typing_extensions` project for
AveyTense to run correctly is 4.10.0 (version of adding `TypeIs` to the project).

After installation process, you can import module `aveytense`, which imports AveyTense components into your project.

If you think you are out of date, consider checking out [releases section](https://pypi.org/project/aveytense/#history) and running following command:

```py
pip install --upgrade aveytense
```

If you have AveyTense 0.3.54 or higher, you can also use the following command to upgrade AveyTense:

```py
aveytense-upgrade
```

To view version of AveyTense, you can use [`importlib.metadata.version()`](https://docs.python.org/3/library/importlib.metadata.html#importlib.metadata.version), `aveytense.__version__`,
[`aveytense.Tense.version`](https://aveyzan.xyz/aveytense#aveytense.Tense.version), [`aveytense.Tense.versionInfo`](https://aveyzan.xyz/aveytense#aveytense.Tense.versionInfo)
or since AveyTense 0.3.54 the command below:

```py
aveytense-version
```

This project can be used anywhere, including for educational and enternainment/game purposes. 

## Support

If you found anomalies in code, need more information about the project or/and want to suggest changes,
consider sending mail to [my email](mailto:aveyzan@gmail.com) or creating an issue in [the GitHub repository](https://github.com/Aveyzan/AveyTense/issues).
Bug fixes will be issued in future versions of AveyTense. The project isn't intended to be a malware.

AveyTense project maintained on PyPi since 7th August 2024.

© 2024-Present John "Aveyzan" Mammoth // License: MIT
