nsarchive 3.0.0a4__py3-none-any.whl → 3.0.0a5__py3-none-any.whl

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/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/cls/economy.py

@@ -1,5 +1,11 @@
+import requests
+import time
+import urllib
+
 from .base import NSID
 
+default_headers = {}
+
 class BankAccount:
     """
     Compte en banque d'une entité, individuelle ou collective.
@@ -19,14 +25,77 @@ class BankAccount:
         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)
+    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.bank: NSID = NSID("6")
+        self.flagged: bool = False
 
-        self.income: int = 0
+    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:
     """
@@ -35,44 +104,32 @@ class Item:
     ## Attributs
     - id: `NSID`\n
         Identifiant de l'objet
-    - title: `str`\n
+    - name: `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"
+    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 = {}
 
-class Inventory:
-    """
-    Inventaire d'un membre
+    def _load(self, _data: dict):
+        self.name = _data['name']
+        self.emoji = _data['emoji']
+        self.category = _data['category']
+        self.craft = _data['craft']
 
-    ## Attributs
-    - owner_id: `NSID`\n
-        ID du propriétaire de l'inventaire
-    - objects: `dict[str, NSID]`\n
-        Collection d'objets et leur quantité
-    """
+    def rename(self, new_name: str):
+        res = requests.post(f"{self._url}/rename?name={new_name}", headers = default_headers)
 
-    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
+        if res.status_code == 200:
+            self.name = new_name
         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
+            res.raise_for_status()
 
 class Sale:
     """
@@ -91,10 +148,83 @@ class Sale:
         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
+    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
-        self.seller_id: NSID = NSID('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/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/instances/_economy.py

@@ -4,19 +4,22 @@ 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:
         """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
         Récupère les informations d'un compte bancaire.
 
         ## Paramètres
@@ -27,26 +30,27 @@ class EconomyInstance(Instance):
         - `.BankAccount`
         """
 
-        return BankAccount(NSID(id)) # Provisoire
-
         id = NSID(id)
-        _data = self._get_by_ID('accounts', 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.amount = _data['amount']
-        account.frozen = _data['frozen']
-        account.owner = NSID(_data['owner_id'])
-        account.bank = _data['bank']
-        account.income = _data['income']
+        account._url = f"{self.url}/bank/accounts/{account.id}"
+
+        account._load(_data)
 
         return account
 
-    def save_account(self, account: BankAccount):
+    def save_account(self, account: BankAccount) -> str:
         """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
         Sauvegarde un compte bancaire dans la base de données.
 
         ## Paramètres
@@ -54,303 +58,321 @@ class EconomyInstance(Instance):
             Compte à sauvegarder
         """
 
-        return # Provisoire
-
         _data = {
             'id': NSID(account.id),
             'amount': account.amount,
             'frozen': account.frozen, 
-            'owner_id': account.owner, 
+            'owner_id': account.owner_id, 
             '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
+        res = requests.put(f"{self.url}/bank/register_account?owner={_data['owner_id']}", headers = self.default_headers, json = _data)
 
-        account.id = NSID(account.id)
-        account.frozen = True
+        if res.status_code == 200:
+            account._url = f"{self.url}/bank/accounts/{account.id}"
+            account.id = res.json()['id']
 
-        self.save_account(account)
-
-    """
-    ---- OBJETS & VENTES ----
-    """
+            return res.json()['digicode']
+        else:
+            res.raise_for_status()
 
-    def save_item(self, item: Item):
+    def fetch_accounts(self, **query: typing.Any) -> list[BankAccount]:
         """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Sauvegarde des infos à propos d'un item.
+        Récupère une liste de comptes en banque en fonction d'une requête.
 
         ## Paramètres
-        item: `.Item`\n
-            Article à sauvegarder
-        """
-
-        return # Provisoire
+        query: `**dict`\n
+            La requête pour filtrer les comptes.
 
-        _item = item.__dict__
-        self._put_in_db('items', _item)
-
-    def get_item(self, id: NSID) -> Item | None:
+        ## Renvoie
+        - `list[.BankAccount]`
         """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Récupère des informations à propos d'un item.
 
-        ## Paramètres
-        id: `NSID`\n
-            ID de l'item
+        query = "&".join(f"{k}={ urllib.parse.quote(v) }" for k, v in query.items())
 
-        ## Retourne
-        - `.Item` si quelque chose est trouvé, sinon
-        - `None`
-        """
+        _res = requests.get(f"{self.url}/fetch/accounts?{query}", headers = self.default_headers)
 
-        return Item(NSID(id)) # Provisoire
+        if _res.status_code == 200:
+            _data = _res.json()
+        else:
+            _res.raise_for_status()
+            return []
 
-        _item = self._get_by_ID('items', id)
+        res = []
 
-        if _item is None:
-            return
+        for _acc in _data:
+            if not _acc: continue
 
-        item = Item(id)
-        item.title = _item['title']
-        item.emoji = _item['emoji']
+            account = BankAccount(_acc["owner_id"])
 
-        return item
+            account.id = NSID(_acc['id'])
+            account._url = f"{self.url}/bank/accounts/{account.id}"
 
-    def delete_item(self, item: Item):
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Annule le référencement d'un item.
+            account._load(_acc)
 
-        ## Paramètres
-        item: `.Item`\n
-            Item à supprimer
-        """
+            res.append(account)
 
-        return # Provisoire
+        return res
 
-        self._delete_by_ID('items', item.id)
+    """
+    ---- INVENTAIRES ----
+    """
 
-    def get_sale(self, id: NSID) -> Sale | None:
+    def get_inventory(self, id: NSID) -> Inventory:
         """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Récupère une vente disponible sur le marketplace.
+        Récupère les informations d'un inventaire.
 
         ## Paramètres
         id: `NSID`\n
-            ID de la vente.
+            ID de l'inventaire.
 
         ## Renvoie
-        - `.Sale | None`: Le résultat de la vente
+        - `.Inventory`
         """
 
-        return Sale(NSID(id), Item(NSID(id))) # Provisoire
-
         id = NSID(id)
+        res = requests.get(f"{self.url}/bank/inventories/{id}", headers = self.default_headers)
 
-        _data = self._get_by_ID('market', id)
+        if res.status_code == 200:
+            _data = res.json()
+        else:
+            res.raise_for_status()
+            return
 
         if _data is None:
             return None
 
-        item = self.get_item(_data['id'])
+        inventory = Inventory(id)
+        inventory._url = f"{self.url}/bank/inventories/{inventory.id}"
 
-        sale = Sale(NSID(id), Item(_data['id']) if item is None else item)
-        sale.__dict__ = _data
+        inventory._load(_data)
 
-        return sale
+        return inventory
 
-    def sell_item(self, item: Item, quantity: int, price: int, seller: NSID):
+    def save_inventory(self, inventory: Inventory) -> str:
         """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Vend un item sur le marché.
+        Sauvegarde un inventaire dans la base de données.
 
         ## 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
+        - inventory: `.Inventory`\n
+            Inventaire à sauvegarder
         """
 
-        return # Provisoire
+        _data = inventory.__dict__
 
-        sale = Sale(NSID(round(time.time()) * 16 ** 3), item)
-        sale.quantity = quantity
-        sale.price = price
-        sale.seller_id = seller
+        res = requests.put(f"{self.url}/bank/register_inventory?owner={_data['owner_id']}", headers = self.default_headers, json = _data)
 
-        _data = sale.__dict__.copy()
+        if res.status_code == 200:
+            inventory._url = f"{self.url}/bank/inventories/{inventory.id}"
+            inventory.id = res.json()['id']
 
-        self._put_in_db('market', _data)
+            return res.json()['digicode']
+        else:
+            res.raise_for_status()
 
-    def delete_sale(self, sale: Sale) -> None:
+    def fetch_inventories(self, **query: typing.Any) -> list[Inventory]:
         """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Annule une vente sur le marketplace.
+        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]`
         """
 
-        return # Provisoire
+        query = "&".join(f"{k}={ urllib.parse.quote(v) }" for k, v in query.items())
 
-        sale.id = NSID(sale.id)
-        self._delete_by_ID('market', NSID(sale.id))
+        _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
 
     """
-    ---- INVENTAIRES ----
+    ---- ITEMS ----
     """
 
-    def get_inventory(self, id: NSID) -> Inventory | None:
+    def get_item(self, id: NSID) -> Item:
         """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Récupérer un inventaire dans la base des inventaires.
+        Récupère les informations d'un item.
 
         ## Paramètres
         id: `NSID`\n
-            ID du propriétaire de l'inventaire
+            ID de l'item.
 
-        ## Retourne
-        - `.Inventory | None`: L'inventaire s'il a été trouvé
+        ## Renvoie
+        - `.Item`
         """
 
-        return Inventory(NSID(id)) # Provisoire
+        id = NSID(id)
+        res = requests.get(f"{self.url}/marketplace/items/{id}", headers = self.default_headers)
 
-        _data = self._get_by_ID('inventories', id)
+        if res.status_code == 200:
+            _data = res.json()
+        else:
+            res.raise_for_status()
+            return
 
         if _data is None:
             return None
 
-        inventory = Inventory(id)
-
-        for _item in _data['objects']:
-            item = self.get_item(_item)
+        item = Item()
+        item.id = id
+        item._url = f"{self.url}/marketplace/items/{item.id}"
 
-            inventory.objects.append(item)
+        item._load(_data)
 
-        return inventory
+        return item
 
-    def save_inventory(self, inventory: Inventory):
+    def save_item(self, item: Item) -> None:
         """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Sauvegarder un inventaire
+        Sauvegarde un item dans le marketplace.
 
         ## Paramètres
-        inventory: `.Inventory`\n
-            Inventaire à sauvegarder
+        - item: `.Item`\n
+            Item à sauvegarder
         """
 
-        return # Provisoire
+        _data = item.__dict__
 
-        _data = inventory.__dict__
+        res = requests.put(f"{self.url}/marketplace/register_item", headers = self.default_headers, json = _data)
 
-        self._put_in_db('inventories', _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 delete_inventory(self, inventory: Inventory):
+    def fetch_items(self, **query: typing.Any) -> list[Item]:
         """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Supprime un inventaire
+        Récupère une liste d'items en fonction d'une requête.
 
         ## Paramètres
-        inventory: `.Inventory`
-            Inventaire à supprimer
+        query: `**dict`\n
+            La requête pour filtrer les items.
+
+        ## Renvoie
+        - `list[.Item]`
         """
 
-        return # Provisoire
+        query = "&".join(f"{k}={ urllib.parse.quote(v) }" for k, v in query.items())
 
-        self._delete_by_ID('inventories', inventory.owner_id)
+        _res = requests.get(f"{self.url}/fetch/items?{query}", headers = self.default_headers)
 
-    """
-    ---- ARCHIVES ----
-    """
+        if _res.status_code == 200:
+            _data = _res.json()
+        else:
+            _res.raise_for_status()
+            return []
 
-    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.
+        res = []
 
-        ## Paramètres
-        - archive: `.Archive`\n
-            Archive à ajouter
-        """
+        for _item in _data:
+            if not _item: continue
 
-        return # Provisoire
+            item = Item()
 
-        archive.id = NSID(archive.id)
-        archive.author = NSID(archive.author)
-        archive.target = NSID(archive.target)
+            item.id = NSID(_item['id'])
+            item._url = f"{self.url}/marketplace/items/{item.id}"
 
-        _data = archive.__dict__.copy()
+            item._load(_item)
 
-        if type(archive) == Transaction:
-            _data['_type'] = "transaction"
-        else:
-            _data['_type'] = "action"
+            res.append(item)
 
-        self._put_in_db('archives', _data)
+        return res
 
-    def _get_archive(self, id: NSID) -> Archive | Transaction:
+
+    """
+    ---- VENTES ----
+    """
+
+    def get_sale(self, id: NSID) -> Sale:
         """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Récupère une archive spécifique.
+        Récupère les informations d'une annonce.
 
         ## Paramètres
         id: `NSID`\n
-            ID de l'archive.
+            ID de la annonce.
 
         ## Renvoie
-        - `.Archive | .Transaction`
+        - `.Sale`
         """
 
-        return Archive() # Provisoire
-
         id = NSID(id)
-        _data = self._get_by_ID('archives', 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
 
-        if _data['_type'] == "transaction":
-            archive = Transaction(_data['author'], _data['target'])
-        else:
-            archive = Archive(_data['author'], _data['target'])
+        sale = Sale()
+        sale.id = id
+        sale._url = f"{self.url}/marketplace/sales/{sale.id}"
 
-        archive.id = id
-        archive.action = _data['action']
-        archive.date = _data['date']
-        archive.details = _data['details']
+        sale._load(_data)
 
-        return archive
+        return sale
 
-    def _fetch_archives(self, **query) -> list[ Archive | Transaction ]:
+    def fetch_sales(self, **query: typing.Any) -> list[Sale]:
         """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Récupère une liste d'archives correspondant à la requête.
+        Récupère une liste d'annonces en fonction d'une requête.
 
         ## Paramètres
-        query: `dict`\n
-            Requête pour filtrer les archives.
+        query: `**dict`\n
+            La requête pour filtrer les annonces.
 
         ## Renvoie
-        - `list[.Archive | .Transaction]`
+        - `list[.Sale]`
         """
 
-        return [] # Provisoire
+        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 = self.fetch('archives', **query)
+            res.append(sale)
 
-        return [ self._get_archive(archive['id']) for archive in _res ]
+        return res

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.dist-info → nsarchive-3.0.0a5.dist-info}/METADATA

@@ -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.0a5.dist-info/RECORD

@@ -0,0 +1,15 @@
+nsarchive/__init__.py,sha256=5ZPH_bKziBRrkxCn_q7j8ZD2I-wDUE2mRKuM5g5ojug,656
+nsarchive/assets/default_avatar.png,sha256=n-4vG_WPke8LvbY3ZU6oA-H-OtRoIu7woKnRq9DCIlI,51764
+nsarchive/cls/archives.py,sha256=3vyGOBZUE-B-G_QMJXRIPD0d-1O5z4wqv-2MRf5AQdA,2506
+nsarchive/cls/base.py,sha256=ley35D1i0RTfX_lmPoyC_PICG40UQtLj5zizRWjUwpM,8034
+nsarchive/cls/economy.py,sha256=Ap6nhnArieHroHi9zTHUKQgYscLhByNcI74QQ1Fno9c,6992
+nsarchive/cls/entities.py,sha256=a0U2xTQ8Uwo6RohC9JqTq1gCzwkqcZAbW8PPdhN9x-I,14397
+nsarchive/cls/republic.py,sha256=16NFNCkJxOeVRd6BoJ68AlrTESQgRfZ5FSFlNWTEdK0,4103
+nsarchive/instances/_economy.py,sha256=vMK8nRBHjLWmAmTu1f3XkWimFUk8tuV3P9KIuKRdNpw,9596
+nsarchive/instances/_entities.py,sha256=6diGZVdtCBgw3ybnx09nBMfLrA1zpNM0DZT7grxKHCo,9319
+nsarchive/instances/_republic.py,sha256=M8k2rZJvQGzOyZlmqRDiB-d615hZOqD3kuRrgYP4JqA,12004
+nsarchive/utils.py,sha256=L37Dm8aO0Sm3FDLPf2tP6fo-1lodDq7JIz-WXttNuJg,684
+nsarchive-3.0.0a5.dist-info/LICENSE,sha256=aFLFZg6LEJFpTlNQ8su3__jw4GfV-xWBmC1cePkKZVw,35802
+nsarchive-3.0.0a5.dist-info/METADATA,sha256=Zsf-oJLY3WNCPQJGOO6ZsobBiJsH4sDmeoUJ46b5EkQ,657
+nsarchive-3.0.0a5.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+nsarchive-3.0.0a5.dist-info/RECORD,,

nsarchive-3.0.0a4.dist-info/RECORD

@@ -1,15 +0,0 @@
-nsarchive/__init__.py,sha256=_IK4p7rSwTN9GahaxnL4gkgXOCCkT0vMgBXbJY_MXVA,656
-nsarchive/assets/default_avatar.png,sha256=n-4vG_WPke8LvbY3ZU6oA-H-OtRoIu7woKnRq9DCIlI,51764
-nsarchive/cls/archives.py,sha256=3vyGOBZUE-B-G_QMJXRIPD0d-1O5z4wqv-2MRf5AQdA,2506
-nsarchive/cls/base.py,sha256=R6ZD2_DVOvjTO6VZ0HteFWVmdW9fieyIpGF9P0PqYk4,7424
-nsarchive/cls/economy.py,sha256=soe3ATrtQem-u80vz8nXfsn_3TqMdhpolyTxRenH2C0,2742
-nsarchive/cls/entities.py,sha256=cc76FSkigUm_ryT_tzLNIDj-TDIAOLtleXy9xutLvnc,14072
-nsarchive/cls/republic.py,sha256=16NFNCkJxOeVRd6BoJ68AlrTESQgRfZ5FSFlNWTEdK0,4103
-nsarchive/instances/_economy.py,sha256=kVIbsCIrctV5yA3nlnSEYkJ8Cuh74YnQKtntIXTqOY0,8892
-nsarchive/instances/_entities.py,sha256=6diGZVdtCBgw3ybnx09nBMfLrA1zpNM0DZT7grxKHCo,9319
-nsarchive/instances/_republic.py,sha256=M8k2rZJvQGzOyZlmqRDiB-d615hZOqD3kuRrgYP4JqA,12004
-nsarchive/utils.py,sha256=qpQCZLlbVApOLtCI2ml54QwUld6K8fDxyBfwzofqXzw,610
-nsarchive-3.0.0a4.dist-info/LICENSE,sha256=aFLFZg6LEJFpTlNQ8su3__jw4GfV-xWBmC1cePkKZVw,35802
-nsarchive-3.0.0a4.dist-info/METADATA,sha256=nRgP7-B_I5F4wKUuh5-hWhiBh2euagI7ATpr7T3_NDY,657
-nsarchive-3.0.0a4.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-nsarchive-3.0.0a4.dist-info/RECORD,,