nsarchive 3.0.0a4__tar.gz → 3.0.0a5__tar.gz

{nsarchive-3.0.0a4 → nsarchive-3.0.0a5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: nsarchive
-Version: 3.0.0a4
+Version: 3.0.0a5
 Summary: API-wrapper pour récupérer des données liées à Nation
 License: GPL-3.0
 Author: happex

{nsarchive-3.0.0a4 → nsarchive-3.0.0a5}/nsarchive/__init__.py

@@ -1,7 +1,7 @@
 """
 nsarchive - API-wrapper pour récupérer des données liées à Nation.
 
-Version: 3.0.0a4
+Version: 3.0.0a5
 License: GPL-3.0
 Auteur : happex <110610727+okayhappex@users.noreply.github.com>
 

{nsarchive-3.0.0a4 → nsarchive-3.0.0a5}/nsarchive/cls/base.py

@@ -2,7 +2,10 @@ import io
 import json
 import requests
 import typing
-import warnings
+
+from .. import utils
+
+VERSION = 300
 
 class NSID(str):
     """
@@ -54,6 +57,20 @@ class Instance:
             "Content-Type": "application/json",
         }
 
+        try:
+            test_res = requests.get(f'{self.url}/ping')
+
+            if test_res.status_code == 200:
+                ndb_ver = test_res.json()['_version']
+                _litt = lambda x: '.'.join((str(x // 100), str(x % 100)))
+
+                if ndb_ver != VERSION:
+                    utils.warn(f"NationDB (v{_litt(ndb_ver)}) and NSArchive (v{_litt(VERSION)}) versions do not match. Some bugs may appear.")
+            else:
+                utils.warn("Something went wrong with the server.")
+        except:
+            utils.warn("NationDB is not responding.")
+
     def request_token(self, username: str, password: str) -> str | None:
         res = requests.post(f"{self.url}/auth/login", json = {
             "username": username,
@@ -151,7 +168,7 @@ class Instance:
             raise Exception(f"Error {res.status_code}: {res.json()['message']}")
 
     def _delete_by_ID(self, _class: str, id: NSID):
-        warnings.showwarning("Method '_delete_by_id' is deprecated. Use '_delete' instead.")
+        utils.warn("Method '_delete_by_id' is deprecated. Use '_delete' instead.")
         self._delete(_class, id)
 
     def fetch(self, _class: str, **query: typing.Any) -> list:

nsarchive-3.0.0a5/nsarchive/cls/economy.py

@@ -0,0 +1,230 @@
+import requests
+import time
+import urllib
+
+from .base import NSID
+
+default_headers = {}
+
+class BankAccount:
+    """
+    Compte en banque d'une entité, individuelle ou collective.
+
+    ## Attributs
+    - id: `NSID`\n
+        Identifiant du compte
+    - owner: `NSID`\n
+        Identifiant du titulaire du compte
+    - amount: `int`\n
+        Somme d'argent totale sur le compte
+    - frozen: `bool`\n
+        État gelé ou non du compte
+    - bank: `NSID`\n
+        Identifiant de la banque qui détient le compte
+    - income: `int`\n
+        Somme entrante sur le compte depuis la dernière réinitialisation (tous les ~ 28 jours)
+    """
+
+    def __init__(self, owner_id: NSID) -> None:
+        self._url: str = ""
+
+        self.id: NSID = NSID(owner_id)
+        self.owner_id: NSID = NSID(owner_id)
+        self.register_date: int = round(time.time())
+        self.tag: str = "inconnu"
+        self.bank: str = "HexaBank"
+
+        self.amount: int = 0
+        self.income: int = 0
+
+        self.frozen: bool = False
+        self.flagged: bool = False
+
+    def _load(self, _data: dict):
+        self.owner_id = NSID(_data['owner_id'])
+        self.register_date = _data['register_date']
+        self.tag = _data['tag']
+        self.bank = _data['bank']
+
+        self.amount = _data['amount']
+        self.income = _data['income']
+
+        self.frozen = _data['frozen']
+        self.flagged = _data['flagged']
+
+    def freeze(self, frozen: bool = True, reason: str = None) -> None:
+        res = requests.post(f"{self._url}/freeze?frozen={str(frozen).lower()}", headers = default_headers, json = {
+            "reason": reason
+        })
+
+        if res.status_code == 200:
+            self.frozen = frozen
+        else:
+            print(res.text)
+            res.raise_for_status()
+
+    def flag(self, flagged: bool = True, reason: str = None) -> None:
+        res = requests.post(f"{self._url}/flag?flagged={str(flagged).lower()}", headers = default_headers, json = {
+            "reason": reason
+        })
+
+        if res.status_code == 200:
+            self.flagged = flagged
+        else:
+            res.raise_for_status()
+
+    def debit(self, amount: int, reason: str = None, target: NSID = None, loan: NSID = None, digicode: str = None) -> None:
+        _target_query = f"&target={target}"
+        _loan_query = f"&loan_id={loan}"
+
+        res = requests.post(f"{self._url}/debit?amount={amount}{_target_query if target else ''}{_loan_query if loan else ''}", headers = default_headers, json = {
+            "reason": reason,
+            "digicode": digicode
+        })
+
+        if res.status_code == 200:
+            self.amount -= amount
+        else:
+            res.raise_for_status()
+
+    def deposit(self, amount: int, reason: str = None) -> None:
+        res = requests.post(f"{self._url}/deposit?amount={amount}", headers = default_headers, json = {
+            "reason": reason,
+        })
+
+        if res.status_code == 200:
+            self.amount -= amount
+        else:
+            res.raise_for_status()
+
+class Item:
+    """
+    Article d'inventaire qui peut circuler sur le serveur
+
+    ## Attributs
+    - id: `NSID`\n
+        Identifiant de l'objet
+    - name: `str`\n
+        Nom de l'objet
+    - emoji: `str`\n
+        Emoji lié à l'objet
+    """
+
+    def __init__(self) -> None:
+        self.id: NSID = NSID(round(time.time()))
+        self.name: str = "Unknown Object"
+        self.emoji: str = ":light_bulb:"
+        self.category: str = "common"
+        self.craft: dict = {}
+
+    def _load(self, _data: dict):
+        self.name = _data['name']
+        self.emoji = _data['emoji']
+        self.category = _data['category']
+        self.craft = _data['craft']
+
+    def rename(self, new_name: str):
+        res = requests.post(f"{self._url}/rename?name={new_name}", headers = default_headers)
+
+        if res.status_code == 200:
+            self.name = new_name
+        else:
+            res.raise_for_status()
+
+class Sale:
+    """
+    Vente mettant en jeu un objet
+
+    ## Attributs
+    - id: `NSID`\n
+        Identifiant de la vente
+    - item: `NSID`\n
+        Identifiant de l'objet mis en vente
+    - quantity: `int`\n
+        Quantité d'objets mis en vente
+    - price: `int`\n
+        Prix total du lot
+    - seller_id: `NSID`\n
+        Identifiant du vendeur
+    """
+
+    def __init__(self, item: Item) -> None:
+        self._url: str = ""
+
+        self.id: NSID = NSID(round(time.time()))
+        self.open: bool = True
+        self.seller_id: NSID = NSID('0')
+
+        self.item_id: NSID = NSID(item.id)
+        self.quantity: int = 1
+        self.price: int = 0
+
+    def _load(self, _data: dict):
+        self.id = _data['json']
+        self.open = _data['open']
+        self.seller_id = NSID(_data['seller_id'])
+
+        self.item_id = NSID(_data['item_id'])
+        self.quantity = _data['quantity']
+        self.price = _data['price']
+
+class Inventory:
+    """
+    Inventaire d'un membre
+
+    ## Attributs
+    - id: `NSID`\n
+        ID de l'inventaire
+    - owner_id: `NSID`\n
+        ID du propriétaire de l'inventaire
+    - tag: `str`\n
+        Étiquette de l'inventaire
+    - register_date: `int`\n
+        Date (timestamp) de création de l'inventaire
+    - items: `dict[NSID, int]`\n
+        Collection d'objets et leur quantité
+    """
+
+    def __init__(self, owner_id: NSID) -> None:
+        self._url: str = ""
+
+        self.id: NSID = NSID(owner_id)
+        self.owner_id: NSID = NSID(owner_id)
+
+        self.tag: str = "inconnu"
+        self.register_date: int = 0
+
+        self.items: dict[NSID, int] = {}
+
+    def _load(self, _data: dict):
+        self.id = NSID(_data['id'])
+        self.owner_id = NSID(_data['owner_id'])
+
+        self.tag = _data['tag']
+        self.register_date = _data['register_date']
+
+        self.items = _data['items']
+
+    def deposit_item(self, item: Item, giver: NSID = None, quantity: int = 1, digicode: str = None):
+        res = requests.post(f"{self._url}/deposit?item={item.id}&amount={quantity}", headers = default_headers, json = {
+            "giver": giver,
+            "digicode": digicode
+        })
+
+        if res.status_code == 200:
+            if self.objects[item.id] > quantity:
+                self.objects[item.id] -= quantity
+            else:
+                self.objects[item.id] = 0
+        else:
+            res.raise_for_status()
+
+    def sell_item(self, item: Item, price: int, quantity: int = 1, digicode: str = None) -> NSID:
+        res = requests.post(f"{self._url}/sell_item?item={item.id}&quantity={quantity}&price={price}", headers = default_headers, json = {
+            "digicode": digicode
+        })
+
+        if res.status_code == 200:
+            return NSID(res.json()['sale_id'])
+        else:
+            res.raise_for_status()

{nsarchive-3.0.0a4 → nsarchive-3.0.0a5}/nsarchive/cls/entities.py

@@ -31,17 +31,20 @@ class PositionPermissions:
     """
 
     def __init__(self) -> None:
-        self.bank_accounts = Permission("a---") # APPEND = ouvrir un ou plusieurs comptes, MANAGE = voir les infos globales concernant les comptes en banque, EDIT = gérer des comptes en banque, READ = voir les infos d'un compte en banque individuel
-        self.bots = Permission() # APPEND = publier un message sous l'identité d'un bot, MANAGE = proposer d'héberger un bot, EDIT = changer les paramètres d'un bot, READ = /
-        self.constitution = Permission() # APPEND = laws.append, MANAGE = laws.manage, EDIT = modifier la constitution, READ = /
-        self.database = Permission() # APPEND = créer des sous-bases de données, MANAGE = gérer la abse de données, EDIT = modifier les éléments, READ = avoir accès à toutes les données sans exception
-        self.items = Permission("---r") # APPEND = vendre, MANAGE = gérer des items dont on n'est pas propriétaire (hors marketplace), EDIT = gérer des items dont on n'est pas propriétaire (dans le marketplace), READ = accéder au marketplace
+        self.bots = Permission() # APPEND = /, MANAGE = proposer d'héberger un bot, EDIT = changer les paramètres d'un bot, READ = /
+        self.constitution = Permission() # APPEND = /, MANAGE = /, EDIT = modifier la constitution, READ = /
+        self.database = Permission() # APPEND = créer des sous-bases de données, MANAGE = gérer la base de données, EDIT = modifier les éléments, READ = avoir accès à toutes les données sans exception
+        self.inventories = Permission("a---") # APPEND = ouvrir un ou plusieurs comptes/inventaires, MANAGE = voir les infos globales concernant les comptes en banque ou inventaires, EDIT = gérer des comptes en banque (ou inventaires), READ = voir les infos d'un compte en banque ou inventaire
+        self.items = Permission("---r") # APPEND = créer un item, MANAGE = gérer les items, EDIT = modifier des items, READ = voir tous les items
         self.laws = Permission() # APPEND = proposer un texte de loi, MANAGE = accepter ou refuser une proposition, EDIT = modifier un texte, READ = /
+        self.loans = Permission() # APPEND = prélever de l'argent sur un compte, MANAGE = gérer les prêts/prélèvements, EDIT = modifier les prêts, READ = voir tous les prêts
         self.members = Permission("---r") # APPEND = créer des entités, MANAGE = modérer des entités (hors Discord), EDIT = modifier des entités, READ = voir le profil des entités
-        self.money = Permission("---r") # APPEND = créer des entités, MANAGE = modérer des entités (hors Discord), EDIT = modifier des entités, READ = voir le profil des entités
+        self.mines = Permission("----") # APPEND = générer des matières premières, MANAGE = gérer les accès aux réservoirs, EDIT = créer un nouveau réservoir, READ = récupérer des matières premières
+        self.money = Permission("----") # APPEND = générer ou supprimer de la monnaie, MANAGE = /, EDIT = /, READ = /
         self.national_channel = Permission() # APPEND = prendre la parole sur la chaîne nationale, MANAGE = voir qui peut prendre la parole, EDIT = modifier le planning de la chaîne nationale, READ = /
         self.organizations = Permission("---r") # APPEND = créer une nouvelle organisation, MANAGE = exécuter des actions administratives sur les organisations, EDIT = modifier des organisations, READ = voir le profil de n'importe quelle organisation
         self.reports = Permission() # APPEND = déposer plainte, MANAGE = accépter ou refuser une plainte, EDIT = /, READ = accéder à des infos supplémentaires pour une plainte
+        self.sales = Permission("---r") # APPEND = vendre, MANAGE = gérer les ventes, EDIT = modifier des ventes, READ = accéder au marketplace
         self.state_budgets = Permission() # APPEND = débloquer un nouveau budget, MANAGE = gérer les budjets, EDIT = gérer les sommes pour chaque budjet, READ = accéder aux infos concernant les budgets
         self.votes = Permission() # APPEND = déclencher un vote, MANAGE = fermer un vote, EDIT = /, READ = lire les propriétés d'un vote avant sa fermeture
 
@@ -128,7 +131,6 @@ class Entity:
         if res.status_code == 200:
             self.name = new_name
         else:
-            print(res.status_code)
             res.raise_for_status()
 
     def set_position(self, position: Position) -> None:

nsarchive-3.0.0a5/nsarchive/instances/_economy.py

@@ -0,0 +1,378 @@
+import time
+
+from ..cls.base import *
+from ..cls.archives import *
+from ..cls.economy import *
+
+from ..cls import economy # Pour les default_headers
+
+class EconomyInstance(Instance):
+    """Indisponible dans cette version."""
+
+    def __init__(self, url: str, token: str) -> None:
+        super().__init__(url, token)
+
+        economy.default_headers = self.default_headers
+
+    """
+    ---- COMPTES EN BANQUE ----
+    """
+
+    def get_account(self, id: NSID) -> BankAccount:
+        """
+        Récupère les informations d'un compte bancaire.
+
+        ## Paramètres
+        id: `NSID`\n
+            ID du compte.
+
+        ## Renvoie
+        - `.BankAccount`
+        """
+
+        id = NSID(id)
+        res = requests.get(f"{self.url}/bank/accounts/{id}", headers = self.default_headers)
+
+        if res.status_code == 200:
+            _data = res.json()
+        else:
+            res.raise_for_status()
+            return
+
+        if _data is None:
+            return None
+
+        account = BankAccount(id)
+        account._url = f"{self.url}/bank/accounts/{account.id}"
+
+        account._load(_data)
+
+        return account
+
+    def save_account(self, account: BankAccount) -> str:
+        """
+        Sauvegarde un compte bancaire dans la base de données.
+
+        ## Paramètres
+        - account: `.BankAccount`\n
+            Compte à sauvegarder
+        """
+
+        _data = {
+            'id': NSID(account.id),
+            'amount': account.amount,
+            'frozen': account.frozen, 
+            'owner_id': account.owner_id, 
+            'bank': account.bank,
+            'income': account.income
+        }
+
+        res = requests.put(f"{self.url}/bank/register_account?owner={_data['owner_id']}", headers = self.default_headers, json = _data)
+
+        if res.status_code == 200:
+            account._url = f"{self.url}/bank/accounts/{account.id}"
+            account.id = res.json()['id']
+
+            return res.json()['digicode']
+        else:
+            res.raise_for_status()
+
+    def fetch_accounts(self, **query: typing.Any) -> list[BankAccount]:
+        """
+        Récupère une liste de comptes en banque en fonction d'une requête.
+
+        ## Paramètres
+        query: `**dict`\n
+            La requête pour filtrer les comptes.
+
+        ## Renvoie
+        - `list[.BankAccount]`
+        """
+
+        query = "&".join(f"{k}={ urllib.parse.quote(v) }" for k, v in query.items())
+
+        _res = requests.get(f"{self.url}/fetch/accounts?{query}", headers = self.default_headers)
+
+        if _res.status_code == 200:
+            _data = _res.json()
+        else:
+            _res.raise_for_status()
+            return []
+
+        res = []
+
+        for _acc in _data:
+            if not _acc: continue
+
+            account = BankAccount(_acc["owner_id"])
+
+            account.id = NSID(_acc['id'])
+            account._url = f"{self.url}/bank/accounts/{account.id}"
+
+            account._load(_acc)
+
+            res.append(account)
+
+        return res
+
+    """
+    ---- INVENTAIRES ----
+    """
+
+    def get_inventory(self, id: NSID) -> Inventory:
+        """
+        Récupère les informations d'un inventaire.
+
+        ## Paramètres
+        id: `NSID`\n
+            ID de l'inventaire.
+
+        ## Renvoie
+        - `.Inventory`
+        """
+
+        id = NSID(id)
+        res = requests.get(f"{self.url}/bank/inventories/{id}", headers = self.default_headers)
+
+        if res.status_code == 200:
+            _data = res.json()
+        else:
+            res.raise_for_status()
+            return
+
+        if _data is None:
+            return None
+
+        inventory = Inventory(id)
+        inventory._url = f"{self.url}/bank/inventories/{inventory.id}"
+
+        inventory._load(_data)
+
+        return inventory
+
+    def save_inventory(self, inventory: Inventory) -> str:
+        """
+        Sauvegarde un inventaire dans la base de données.
+
+        ## Paramètres
+        - inventory: `.Inventory`\n
+            Inventaire à sauvegarder
+        """
+
+        _data = inventory.__dict__
+
+        res = requests.put(f"{self.url}/bank/register_inventory?owner={_data['owner_id']}", headers = self.default_headers, json = _data)
+
+        if res.status_code == 200:
+            inventory._url = f"{self.url}/bank/inventories/{inventory.id}"
+            inventory.id = res.json()['id']
+
+            return res.json()['digicode']
+        else:
+            res.raise_for_status()
+
+    def fetch_inventories(self, **query: typing.Any) -> list[Inventory]:
+        """
+        Récupère une liste d'inventaires en fonction d'une requête.
+
+        ## Paramètres
+        query: `**dict`\n
+            La requête pour filtrer les inventaires.
+
+        ## Renvoie
+        - `list[.Inventory]`
+        """
+
+        query = "&".join(f"{k}={ urllib.parse.quote(v) }" for k, v in query.items())
+
+        _res = requests.get(f"{self.url}/fetch/inventories?{query}", headers = self.default_headers)
+
+        if _res.status_code == 200:
+            _data = _res.json()
+        else:
+            _res.raise_for_status()
+            return []
+
+        res = []
+
+        for _inv in _data:
+            if not _inv: continue
+
+            inventory = Inventory(_inv["owner_id"])
+
+            inventory.id = NSID(_inv['id'])
+            inventory._url = f"{self.url}/bank/inventories/{inventory.id}"
+
+            inventory._load(_inv)
+
+            res.append(inventory)
+
+        return res
+
+    """
+    ---- ITEMS ----
+    """
+
+    def get_item(self, id: NSID) -> Item:
+        """
+        Récupère les informations d'un item.
+
+        ## Paramètres
+        id: `NSID`\n
+            ID de l'item.
+
+        ## Renvoie
+        - `.Item`
+        """
+
+        id = NSID(id)
+        res = requests.get(f"{self.url}/marketplace/items/{id}", headers = self.default_headers)
+
+        if res.status_code == 200:
+            _data = res.json()
+        else:
+            res.raise_for_status()
+            return
+
+        if _data is None:
+            return None
+
+        item = Item()
+        item.id = id
+        item._url = f"{self.url}/marketplace/items/{item.id}"
+
+        item._load(_data)
+
+        return item
+
+    def save_item(self, item: Item) -> None:
+        """
+        Sauvegarde un item dans le marketplace.
+
+        ## Paramètres
+        - item: `.Item`\n
+            Item à sauvegarder
+        """
+
+        _data = item.__dict__
+
+        res = requests.put(f"{self.url}/marketplace/register_item", headers = self.default_headers, json = _data)
+
+        if res.status_code == 200:
+            item._url = f"{self.url}/bank/inventories/{item.id}"
+            item.id = res.json()['id']
+        else:
+            res.raise_for_status()
+
+    def fetch_items(self, **query: typing.Any) -> list[Item]:
+        """
+        Récupère une liste d'items en fonction d'une requête.
+
+        ## Paramètres
+        query: `**dict`\n
+            La requête pour filtrer les items.
+
+        ## Renvoie
+        - `list[.Item]`
+        """
+
+        query = "&".join(f"{k}={ urllib.parse.quote(v) }" for k, v in query.items())
+
+        _res = requests.get(f"{self.url}/fetch/items?{query}", headers = self.default_headers)
+
+        if _res.status_code == 200:
+            _data = _res.json()
+        else:
+            _res.raise_for_status()
+            return []
+
+        res = []
+
+        for _item in _data:
+            if not _item: continue
+
+            item = Item()
+
+            item.id = NSID(_item['id'])
+            item._url = f"{self.url}/marketplace/items/{item.id}"
+
+            item._load(_item)
+
+            res.append(item)
+
+        return res
+
+
+    """
+    ---- VENTES ----
+    """
+
+    def get_sale(self, id: NSID) -> Sale:
+        """
+        Récupère les informations d'une annonce.
+
+        ## Paramètres
+        id: `NSID`\n
+            ID de la annonce.
+
+        ## Renvoie
+        - `.Sale`
+        """
+
+        id = NSID(id)
+        res = requests.get(f"{self.url}/marketplace/sales/{id}", headers = self.default_headers)
+
+        if res.status_code == 200:
+            _data = res.json()
+        else:
+            res.raise_for_status()
+            return
+
+        if _data is None:
+            return None
+
+        sale = Sale()
+        sale.id = id
+        sale._url = f"{self.url}/marketplace/sales/{sale.id}"
+
+        sale._load(_data)
+
+        return sale
+
+    def fetch_sales(self, **query: typing.Any) -> list[Sale]:
+        """
+        Récupère une liste d'annonces en fonction d'une requête.
+
+        ## Paramètres
+        query: `**dict`\n
+            La requête pour filtrer les annonces.
+
+        ## Renvoie
+        - `list[.Sale]`
+        """
+
+        query = "&".join(f"{k}={ urllib.parse.quote(v) }" for k, v in query.items())
+
+        _res = requests.get(f"{self.url}/fetch/sales?{query}", headers = self.default_headers)
+
+        if _res.status_code == 200:
+            _data = _res.json()
+        else:
+            _res.raise_for_status()
+            return []
+
+        res = []
+
+        for _sale in _data:
+            if not _sale: continue
+
+            sale = Sale()
+
+            sale.id = NSID(_sale['id'])
+            sale._url = f"{self.url}/marketplace/sales/{sale.id}"
+
+            sale._load(_sale)
+
+            res.append(sale)
+
+        return res

{nsarchive-3.0.0a4 → nsarchive-3.0.0a5}/nsarchive/utils.py

@@ -23,4 +23,7 @@ def compress_image(data: bytes, _max: int = 1000 ** 2) -> bytes:
     val = io.BytesIO()
     img.save(val)
 
-    return val.getvalue()
+    return val.getvalue()
+
+def warn(prompt: str):
+    print("\033[1;33mWarning:\033[0m", prompt)

{nsarchive-3.0.0a4 → nsarchive-3.0.0a5}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "nsarchive"
-version = "3.0.0a4"
+version = "3.0.0a5"
 description = "API-wrapper pour récupérer des données liées à Nation"
 authors = ["happex <110610727+okayhappex@users.noreply.github.com>"]
 license = "GPL-3.0"

nsarchive-3.0.0a4/nsarchive/cls/economy.py

@@ -1,100 +0,0 @@
-from .base import NSID
-
-class BankAccount:
-    """
-    Compte en banque d'une entité, individuelle ou collective.
-
-    ## Attributs
-    - id: `NSID`\n
-        Identifiant du compte
-    - owner: `NSID`\n
-        Identifiant du titulaire du compte
-    - amount: `int`\n
-        Somme d'argent totale sur le compte
-    - frozen: `bool`\n
-        État gelé ou non du compte
-    - bank: `NSID`\n
-        Identifiant de la banque qui détient le compte
-    - income: `int`\n
-        Somme entrante sur le compte depuis la dernière réinitialisation (tous les ~ 28 jours)
-    """
-
-    def __init__(self, id: NSID) -> None:
-        self.id: NSID = NSID(id)
-        self.owner: NSID = NSID(0)
-        self.amount: int = 0
-        self.frozen: bool = False
-        self.bank: NSID = NSID("6")
-
-        self.income: int = 0
-
-class Item:
-    """
-    Article d'inventaire qui peut circuler sur le serveur
-
-    ## Attributs
-    - id: `NSID`\n
-        Identifiant de l'objet
-    - title: `str`\n
-        Nom de l'objet
-    - emoji: `str`\n
-        Emoji lié à l'objet
-    """
-
-    def __init__(self, id: NSID) -> None:
-        self.id: NSID = NSID(id)
-        self.title: str = "Unknown Object"
-        self.emoji: str = ":light_bulb:"
-
-class Inventory:
-    """
-    Inventaire d'un membre
-
-    ## Attributs
-    - owner_id: `NSID`\n
-        ID du propriétaire de l'inventaire
-    - objects: `dict[str, NSID]`\n
-        Collection d'objets et leur quantité
-    """
-
-    def __init__(self, owner_id: NSID) -> None:
-        self.owner_id: NSID = NSID(owner_id)
-        self.objects: dict[str, NSID] = {}
-
-    def append(self, item: Item, quantity: int = 1):
-        if item.id in self.objects.keys():
-            self.objects[item.id] += quantity
-        else:
-            self.objects[item.id] = quantity
-
-    def throw(self, item: Item, quantity: int = 1):
-        if item.id in self.objects.keys():
-            if self.objects[item.id] > quantity:
-                self.objects[item.id] -= quantity
-            else:
-                self.objects[item.id] = 0
-
-class Sale:
-    """
-    Vente mettant en jeu un objet
-
-    ## Attributs
-    - id: `NSID`\n
-        Identifiant de la vente
-    - item: `NSID`\n
-        Identifiant de l'objet mis en vente
-    - quantity: `int`\n
-        Quantité d'objets mis en vente
-    - price: `int`\n
-        Prix total du lot
-    - seller_id: `NSID`\n
-        Identifiant du vendeur
-    """
-
-    def __init__(self, id: NSID, item: Item) -> None:
-        self.id: NSID = NSID(id)
-        self.item: NSID = NSID(item.id)
-        self.quantity: int = 1
-
-        self.price: int = 0
-        self.seller_id: NSID = NSID('0')

nsarchive-3.0.0a4/nsarchive/instances/_economy.py

@@ -1,356 +0,0 @@
-import time
-
-from ..cls.base import *
-from ..cls.archives import *
-from ..cls.economy import *
-
-class EconomyInstance(Instance):
-    """Indisponible dans cette version."""
-
-    def __init__(self, url: str, token: str) -> None:
-        super().__init__(url, token)
-
-    """
-    ---- COMPTES EN BANQUE ----
-    """
-
-    def get_account(self, id: NSID) -> BankAccount:
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Récupère les informations d'un compte bancaire.
-
-        ## Paramètres
-        id: `NSID`\n
-            ID du compte.
-
-        ## Renvoie
-        - `.BankAccount`
-        """
-
-        return BankAccount(NSID(id)) # Provisoire
-
-        id = NSID(id)
-        _data = self._get_by_ID('accounts', id)
-
-        if _data is None:
-            return None
-
-        account = BankAccount(id)
-        account.amount = _data['amount']
-        account.frozen = _data['frozen']
-        account.owner = NSID(_data['owner_id'])
-        account.bank = _data['bank']
-        account.income = _data['income']
-
-        return account
-
-    def save_account(self, account: BankAccount):
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Sauvegarde un compte bancaire dans la base de données.
-
-        ## Paramètres
-        - account: `.BankAccount`\n
-            Compte à sauvegarder
-        """
-
-        return # Provisoire
-
-        _data = {
-            'id': NSID(account.id),
-            'amount': account.amount,
-            'frozen': account.frozen, 
-            'owner_id': account.owner, 
-            'bank': account.bank,
-            'income': account.income
-        }
-
-        self._put_in_db('accounts', _data)
-
-    def freeze_account(self, account: BankAccount):
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Gèle un compte bancaire pour empêcher toute transaction.
-
-        ## Paramètres
-        - account: `.BankAccount`\n
-            Compte à geler
-        """
-
-        return # Provisoire
-
-        account.id = NSID(account.id)
-        account.frozen = True
-
-        self.save_account(account)
-
-    """
-    ---- OBJETS & VENTES ----
-    """
-
-    def save_item(self, item: Item):
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Sauvegarde des infos à propos d'un item.
-
-        ## Paramètres
-        item: `.Item`\n
-            Article à sauvegarder
-        """
-
-        return # Provisoire
-
-        _item = item.__dict__
-        self._put_in_db('items', _item)
-
-    def get_item(self, id: NSID) -> Item | None:
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Récupère des informations à propos d'un item.
-
-        ## Paramètres
-        id: `NSID`\n
-            ID de l'item
-
-        ## Retourne
-        - `.Item` si quelque chose est trouvé, sinon
-        - `None`
-        """
-
-        return Item(NSID(id)) # Provisoire
-
-        _item = self._get_by_ID('items', id)
-
-        if _item is None:
-            return
-
-        item = Item(id)
-        item.title = _item['title']
-        item.emoji = _item['emoji']
-
-        return item
-
-    def delete_item(self, item: Item):
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Annule le référencement d'un item.
-
-        ## Paramètres
-        item: `.Item`\n
-            Item à supprimer
-        """
-
-        return # Provisoire
-
-        self._delete_by_ID('items', item.id)
-
-    def get_sale(self, id: NSID) -> Sale | None:
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Récupère une vente disponible sur le marketplace.
-
-        ## Paramètres
-        id: `NSID`\n
-            ID de la vente.
-
-        ## Renvoie
-        - `.Sale | None`: Le résultat de la vente
-        """
-
-        return Sale(NSID(id), Item(NSID(id))) # Provisoire
-
-        id = NSID(id)
-
-        _data = self._get_by_ID('market', id)
-
-        if _data is None:
-            return None
-
-        item = self.get_item(_data['id'])
-
-        sale = Sale(NSID(id), Item(_data['id']) if item is None else item)
-        sale.__dict__ = _data
-
-        return sale
-
-    def sell_item(self, item: Item, quantity: int, price: int, seller: NSID):
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Vend un item sur le marché.
-
-        ## Paramètres
-        item: `.Item`\n
-            Item à vendre
-        quantity: `int`\n
-            Nombre d'items à vendre
-        price: `int`\n
-            Prix à l'unité de chaque objet
-        seller: `NSID`\n
-            ID de l'auteur de la vente
-        """
-
-        return # Provisoire
-
-        sale = Sale(NSID(round(time.time()) * 16 ** 3), item)
-        sale.quantity = quantity
-        sale.price = price
-        sale.seller_id = seller
-
-        _data = sale.__dict__.copy()
-
-        self._put_in_db('market', _data)
-
-    def delete_sale(self, sale: Sale) -> None:
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Annule une vente sur le marketplace.
-        """
-
-        return # Provisoire
-
-        sale.id = NSID(sale.id)
-        self._delete_by_ID('market', NSID(sale.id))
-
-    """
-    ---- INVENTAIRES ----
-    """
-
-    def get_inventory(self, id: NSID) -> Inventory | None:
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Récupérer un inventaire dans la base des inventaires.
-
-        ## Paramètres
-        id: `NSID`\n
-            ID du propriétaire de l'inventaire
-
-        ## Retourne
-        - `.Inventory | None`: L'inventaire s'il a été trouvé
-        """
-
-        return Inventory(NSID(id)) # Provisoire
-
-        _data = self._get_by_ID('inventories', id)
-
-        if _data is None:
-            return None
-
-        inventory = Inventory(id)
-
-        for _item in _data['objects']:
-            item = self.get_item(_item)
-
-            inventory.objects.append(item)
-
-        return inventory
-
-    def save_inventory(self, inventory: Inventory):
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Sauvegarder un inventaire
-
-        ## Paramètres
-        inventory: `.Inventory`\n
-            Inventaire à sauvegarder
-        """
-
-        return # Provisoire
-
-        _data = inventory.__dict__
-
-        self._put_in_db('inventories', _data)
-
-    def delete_inventory(self, inventory: Inventory):
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Supprime un inventaire
-
-        ## Paramètres
-        inventory: `.Inventory`
-            Inventaire à supprimer
-        """
-
-        return # Provisoire
-
-        self._delete_by_ID('inventories', inventory.owner_id)
-
-    """
-    ---- ARCHIVES ----
-    """
-
-    def _add_archive(self, archive: Archive):
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Ajoute une archive d'une transaction ou d'une vente dans la base de données.
-
-        ## Paramètres
-        - archive: `.Archive`\n
-            Archive à ajouter
-        """
-
-        return # Provisoire
-
-        archive.id = NSID(archive.id)
-        archive.author = NSID(archive.author)
-        archive.target = NSID(archive.target)
-
-        _data = archive.__dict__.copy()
-
-        if type(archive) == Transaction:
-            _data['_type'] = "transaction"
-        else:
-            _data['_type'] = "action"
-
-        self._put_in_db('archives', _data)
-
-    def _get_archive(self, id: NSID) -> Archive | Transaction:
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Récupère une archive spécifique.
-
-        ## Paramètres
-        id: `NSID`\n
-            ID de l'archive.
-
-        ## Renvoie
-        - `.Archive | .Transaction`
-        """
-
-        return Archive() # Provisoire
-
-        id = NSID(id)
-        _data = self._get_by_ID('archives', id)
-
-        if _data is None:
-            return None
-
-        if _data['_type'] == "transaction":
-            archive = Transaction(_data['author'], _data['target'])
-        else:
-            archive = Archive(_data['author'], _data['target'])
-
-        archive.id = id
-        archive.action = _data['action']
-        archive.date = _data['date']
-        archive.details = _data['details']
-
-        return archive
-
-    def _fetch_archives(self, **query) -> list[ Archive | Transaction ]:
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Récupère une liste d'archives correspondant à la requête.
-
-        ## Paramètres
-        query: `dict`\n
-            Requête pour filtrer les archives.
-
-        ## Renvoie
-        - `list[.Archive | .Transaction]`
-        """
-
-        return [] # Provisoire
-
-        _res = self.fetch('archives', **query)
-
-        return [ self._get_archive(archive['id']) for archive in _res ]