Metadata-Version: 2.4
Name: nontrinsic
Version: 1.1.9.post1
Summary: Nontrinsic API Wrapper written in Python
Author: maxie
License-Expression: MIT
Project-URL: Homepage, https://codeberg.org/nontrinsic/python
Project-URL: Issues, https://codeberg.org/nontrinsic/python/issues
Classifier: Programming Language :: Python :: 3
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: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.30
Requires-Dist: python-iso639
Dynamic: license-file

# Nontrinsic Python wrapper

docs will be here when i uneep

## Usage

### Getting nonsense

```python
from nontrinsic import Nontrinsic
non = Nontrinsic()

non.get_random_nonsense() # returns one random nonsense as Nonsense object
non.get_nonsense(uuid) # returns Nonsense object with uuid UUID
non.get_nonsense_image(uuid) # returns NonsensePartialFile with image of nonsense with uuid UUID
non.get_all_nonsense(query, format, before, after) #used to return all nonsenses in NonsenseList object with filters such as query, before and after, (all optional), format can be JSON, CSV or TXT, by default its JSON, CSV and TXT are returned as NonsenseFile objects

```

### Getting Nontrinsic status

```python
non.status # returns NontrinsicStatus object
non.get_status() # returns NontrinsicStatus object
non.update_status() # updates non.status and also returns NontrinsicStatus object
```

### Caching the database

```python
non = Nontrinsic(has_cache = True) # makes Nontrinsic have the database in memory, if something goes wrong, it will fetch nonsense from memory instead of the nontrinsic server
non.cache # you can use all the same methods as regular nontrinsic but its all in memory, also some methods are not implemented

non.cache_nontrinsic() # returns CachedNontrinsic object
non.update_cache() # update non.cache and returns CachedNontrinsic object
```

### Miscellaneous

```python
non.report_nonsense(uuid, reason, details) # reports nonsense with uuid UUID with reason and details
```

