semvec/pypi-packages huggingface dataset:
prefs 1.0.1
Store and manage preferences easily.
License: MIT
Requires Python: >=3.6,<4.0
Keywords: preferences,settings,prefs

# PREFS
> **Store and manage preferences easily.**  

[![PREFS logo](https://github.com/Patitotective/PREFS/blob/main/assets/logo.png?raw=true)](https://patitotective.github.io/PREFS)

[![Supported Python versions](https://img.shields.io/pypi/pyversions/prefs)](https://pypi.org/project/prefs/)
[![PREFS version](https://img.shields.io/pypi/v/prefs)](https://pypi.org/project/prefs/)
[![Downloads](https://pepy.tech/badge/prefs)](https://pepy.tech/project/prefs)
[![Stars](https://img.shields.io/github/stars/patitotective/prefs)](https://github.com/Patitotective/PREFS/stargazers)

[![Last commit](https://img.shields.io/github/last-commit/Patitotective/PREFS)](https://github.com/Patitotective/PREFS/commits/main)
![Size](https://img.shields.io/github/repo-size/Patitotective/PREFS)
[![License MIT](https://img.shields.io/github/license/Patitotective/PREFS)](https://github.com/Patitotective/PREFS/)  

[![Made with Python](https://img.shields.io/badge/made%20with-python-blue)](https://www.python.org/)
[![Discord server](https://img.shields.io/discord/891409914533118012?logo=discord)](https://discord.gg/as85Q4GnR6)

**PREFS** is Python library that stores preferences in a text file with a dictionary-like structure.

## Installation
On _Windows_:  
`pip install PREFS`

On _MacOS_ and _Linux_:  
`pip3 install PREFS`

### Getting started
To initialize your preferences you will need to instance the `Prefs` class with the first argument as the default preferences (the ones used the first time the program runs or whenever the file gets deleted).

```py
import prefs

default_prefs = {
  "lang": "en", 
  "theme": {
    "background": "#ffffff", 
    "font": "UbuntuMono", 
  }, 
}

my_prefs = prefs.Prefs(default_prefs)
```

The above code will create a file called `prefs.prefs` that looks like:
```py
#PREFS
lang='en'
theme=>
  background='#ffffff' 
  font='UbuntuMono'
```
Then you can change values as if it were a dictionary.
```py
my_prefs["lang"] = "es"
```
And now `prefs.prefs` will look like:
```py
#PREFS
lang='es'
theme=>
  background='#ffffff'
  font='UbuntuMono'
```

You can write your own _PREFS_ files manually as well, to manage your application's color scheme or the translations.

***

## About
- Docs: https://patitotective.github.io/PREFS/docs/start.
- GitHub: https://github.com/Patitotective/PREFS.
- Pypi: https://pypi.org/project/PREFS/.
- Discord: https://discord.gg/as85Q4GnR6.

Contact me:
- Discord: **Patitotective#0127**.
- Tiwtter: [@patitotective](https://twitter.com/patitotective).
- Email: **cristobalriaga@gmail.com**.

***v1.0.0***
invoxia 0.2.0
Non-official python package to get access to Invoxia GPS trackers data.
License: MIT
Requires Python: >=3.8

.. These are examples of badges you might want to add to your README:
   please update the URLs accordingly

    .. image:: https://pepy.tech/badge/invoxia/month
        :alt: Monthly Downloads
        :target: https://pepy.tech/project/invoxia

.. image:: https://img.shields.io/badge/-PyScaffold-005CA0?logo=pyscaffold
    :alt: Project generated with PyScaffold
    :target: https://pyscaffold.org/
.. image:: https://gitlab.com/ezlo.picori/invoxia/badges/main/pipeline.svg
    :alt: Pipeline status
    :target: https://gitlab.com/ezlo.picori/invoxia/-/commits/main
.. image:: https://gitlab.com/ezlo.picori/invoxia/badges/main/coverage.svg
    :alt: Coverage
    :target: https://gitlab.com/ezlo.picori/invoxia/-/commits/main
.. image:: https://readthedocs.org/projects/invoxia/badge/?version=latest
    :alt: ReadTheDocs
    :target: https://invoxia.readthedocs.io/en/stable/
.. image:: https://img.shields.io/pypi/v/invoxia.svg
    :alt: PyPI-Server
    :target: https://pypi.org/project/invoxia/

=======
invoxia
=======

    Non-official python package to access Invoxia GPS trackers data.

Invoxia_ is known for their GPS Trackers with long battery life which rely on the LoRa_ or SigFox_
networks. Unfortunately, trackers location can only be accessed through their Android_ and iOS_ applications.
This ``invoxia`` package connects to the same API than your smartphone app and gives you an easy access to:

- The list of devices connected to your account
- Their current state
- Their location history

Data is only in read-access, you will still need the smartphone app to change your devices configuration.

Note that even though direct access to Invoxia API is not strictly prohibited in their `terms of use`_, it is
not encouraged either: company representatives have already stated that they do not currently consider making the
API opened for all customers and this feature is limited to their `pro tracking offer`_.
Therefore, by using ``invoxia`` you:

1. Accept to use this direct API access in a reasonnable manner by limiting the query rate to the bare minimum required
for your application.

2. Understand that the Invoxia company may take any action they see fit regarding your account if they consider your
usage of their API to be in violation with their terms of use.

.. _Invoxia: https://www.invoxia.com/
.. _LoRa: https://lora-alliance.org/
.. _SigFox: https://www.sigfox.com/
.. _Android: https://play.google.com/store/apps/details?id=com.invoxia.track
.. _iOS: https://apps.apple.com/fr/app/invoxia-gps/id1261314542
.. _`terms of use`: https://www.invoxia.com/fr/legal/site/terms
.. _pro tracking offer: https://tracking.invoxia.com