nsarchive 3.0.0a7__py3-none-any.whl → 3.0.0b1__py3-none-any.whl

nsarchive/models/state.py

@@ -0,0 +1,75 @@
+from __future__ import annotations
+
+import requests
+
+from .base import NSID
+from .republic import Vote
+
+class Party:
+    def __init__(self, org_id: NSID):
+        self._url: str = ''
+        self._headers: dict = {}
+
+        self.org_id = org_id
+
+        self.color: int = 0x000000
+        self.motto: str = None
+        self.scale: dict = {}
+        self.last_election: int = None
+
+    def _load(self, _data: dict, url: str = None, headers: dict = None):
+        self._url = url
+        self._headers = headers
+
+        self.org_id = _data['org_id']
+
+        self.color = _data['color']
+        self.motto = _data['motto']
+        self.scale = _data['politiscales']
+        self.last_election = _data['last_election']
+
+    def cancel_candidacy(self, election: Election):
+        election.cancel_candidacy()
+
+class Election:
+    def __init__(self, id: NSID):
+        self._url: str = ''
+        self._headers: dict = {}
+
+        self.id = id
+        self.type: str = 'full' # Partial = législatives, full = totales
+        self.vote: Vote = None
+
+    def _load(self, _data: dict, url: str = None, headers: str = None):
+        self._url = url
+        self._headers = headers
+
+        self.id = _data['id']
+        self.type = _data['type']
+
+        self.vote = Vote(_data['vote']['id'])
+        self.vote._load(_data['vote'], url, headers)
+
+    def close(self):
+        if self.vote:
+            self.vote.close()
+        else:
+            return
+
+    def add_vote(self, id: str):
+        if self.vote:
+            self.vote.add_vote(id)
+        else:
+            return
+
+    def submit_candidacy(self):
+        res = requests.put(f"{self._url}/submit")
+
+        if res.status_code != 200:
+            res.raise_for_status()
+
+    def cancel_candidacy(self):
+        res = requests.put(f"{self._url}/cancel_candidacy")
+
+        if res.status_code != 200:
+            res.raise_for_status()

{nsarchive-3.0.0a7.dist-info → nsarchive-3.0.0b1.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.3
 Name: nsarchive
-Version: 3.0.0a7
+Version: 3.0.0b1
 Summary: API-wrapper pour récupérer des données liées à Nation
 License: GPL-3.0
 Author: happex
@@ -11,6 +11,7 @@ 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
 Requires-Dist: pillow (>=10.4,<11.0)
 Requires-Dist: requests (>=2.31,<3.0)
 Description-Content-Type: text/markdown

nsarchive-3.0.0b1.dist-info/RECORD

@@ -0,0 +1,19 @@
+nsarchive/__init__.py,sha256=Sh9eQ1alsA-fnFr3AHeMEQ5PZ1r4h_XtCBii3FlkUDs,853
+nsarchive/assets/default_avatar.png,sha256=n-4vG_WPke8LvbY3ZU6oA-H-OtRoIu7woKnRq9DCIlI,51764
+nsarchive/interfaces/_economy.py,sha256=54TpYKRw07HIryd3EDifA9Hs3s6O7aHcrtV4P8qY0QY,9348
+nsarchive/interfaces/_entities.py,sha256=9iSw_AAMmdh7VY8BgQkRoZ0RIMsi7ZYYLB3_PJXMbOU,6399
+nsarchive/interfaces/_justice.py,sha256=AOuPLgja1D1_MU6oll5JOdb0yjLknd7QIdxyStDNhBM,3708
+nsarchive/interfaces/_state.py,sha256=7cGYnkjUXLnkGnZiYNfhq4QraZ_lqMXdlBriV-SUQng,5515
+nsarchive/mandate.py,sha256=U0RE9Gpr3XawSWyr99X__GUoiwJAwKbOP4v_I2Z97Oc,1609
+nsarchive/models/base.py,sha256=UBpM4B1nOPJCPJmPAkbumGYxGxBtQUY7omh8uEczsCc,8763
+nsarchive/models/economy.py,sha256=GD1G2fOyIZxquC7F6Rawy0V1gmXN0keTh-r4xvcGl6Y,7681
+nsarchive/models/entities.py,sha256=UP3jFS-KDIER8-K1EVdjgCge7qeCtJ3106XBNrhDKLE,17429
+nsarchive/models/justice.py,sha256=RuFmPi6mK-8APc-_WSPz4bYfnC46WYwdEnzGsZcdXDw,3420
+nsarchive/models/republic.py,sha256=hZA9XB-jHQjscBzuk7vfB_CjtU2Yb8AFM3TxFM6RF5k,3260
+nsarchive/models/scale.py,sha256=ukh6wiE4mBcqbqtAC9GvCyTVUnwYUp3jla03Nohnsck,751
+nsarchive/models/state.py,sha256=gxxUu-E6t2tEx70vXT5XQ17JppP2JKpk4MWclWoqUSM,1963
+nsarchive/utils.py,sha256=L37Dm8aO0Sm3FDLPf2tP6fo-1lodDq7JIz-WXttNuJg,684
+nsarchive-3.0.0b1.dist-info/LICENSE,sha256=aFLFZg6LEJFpTlNQ8su3__jw4GfV-xWBmC1cePkKZVw,35802
+nsarchive-3.0.0b1.dist-info/METADATA,sha256=gQ9hFbAZ6cf_xXRJnx1h36io5qfafhGJ1s6lH4zng6c,746
+nsarchive-3.0.0b1.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+nsarchive-3.0.0b1.dist-info/RECORD,,

{nsarchive-3.0.0a7.dist-info → nsarchive-3.0.0b1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 1.9.0
+Generator: poetry-core 2.1.3
 Root-Is-Purelib: true
 Tag: py3-none-any

nsarchive/cls/archives.py

@@ -1,93 +0,0 @@
-import time
-
-from .base import *
-
-class Archive:
-    def __init__(self, author: NSID = '0', target: NSID = '0'):
-        """
-        Classe de référence pour toutes les archives.
-
-        ## Attributs de base
-        - date: `int`\n
-            Date (timestamp) de l'exécution de l'archive
-        - id: `NSID`\n
-            Clé d'identification des archives (basée sur la date)
-        - author: `NSID`\n
-            ID de l'auteur de l'action
-        - target: `NSID`:
-            ID de la cible de l'action
-        - action: `str`:\n
-            Action effectuée
-        - details: `dict`\n
-            Ensemble de détails que les différents bots peuvent utiliser
-        """
-        self.date: int = round(time.time())
-
-        self.id: NSID = NSID(self.date)
-        self.author: NSID = NSID(author)
-        self.target: NSID = NSID(target)
-
-        self.action: str = ""
-        self.details: dict = {
-            "reason": None
-        }
-
-
-# Entities
-
-class Sanction(Archive):
-    def __init__(self, author: NSID, target: NSID) -> None:
-        super().__init__(author, target)
-
-        self.details: dict = {
-            "reason": None,
-            "major": False, # Sanction majeure ou non
-            "duration": 0 # Durée en secondes , 0 = définitif
-        }
-
-class Report(Archive):
-    def __init__(self, author: NSID, target: NSID) -> None:
-        super().__init__(author, target)
-
-        self.details: dict = {
-            "reason": None,
-            "elements": [] # Liste des pièces jointes
-        }
-
-
-# Community
-
-class Election(Archive):
-    def __init__(self, author: NSID, target: NSID, position: str) -> None:
-        super().__init__(author, target)
-
-        self.details = {
-            "position": position,
-            "positive_votes": 0,
-            "total_votes": 0
-        }
-
-class Promotion(Archive):
-    def __init__(self, author: NSID, target: NSID, position: str) -> None:
-        super().__init__(author, target)
-
-        self.details = {
-            "position": position
-        }
-
-class Demotion(Archive):
-    def __init__(self, author: NSID, target: NSID) -> None:
-        super().__init__(author, target)
-
-
-# Bank
-
-class Transaction(Archive):
-    def __init__(self, author: NSID, target: NSID) -> None:
-        super().__init__(author, target)
-
-        self.details = {
-            "amount": 0,
-            "currency": "HC",
-            "reason": None
-        }

nsarchive/cls/republic.py

@@ -1,149 +0,0 @@
-from nsarchive.cls.base import NSID
-
-# Votes
-
-class VoteOption:
-    """
-    Option disponible lors d'un vote
-
-    ## Attributs
-    - id: `str`\n
-        Identifiant de l'option
-    - title: `str`\n
-        Label de l'option
-    - count: `int`\n
-        Nombre de sympathisants pour cette option
-    """
-
-    def __init__(self, id: str, title: str = None, count: int = 0):
-        self.id = id
-        self.title = title if title else id
-        self.count = count
-
-class Vote:
-    """
-    Classe de référence pour les différents votes du serveur
-
-    ## Attributs
-    - id: `NSID`\n
-        Identifiant du vote
-    - title: `str`\n
-        Titre du vote
-    - choices: list[.VoteOption]\n
-        Liste des choix disponibles
-    - author: `NSID`\n
-        Identifiant de l'auteur du vote
-    - startDate: `int`\n
-        Date de début du vote
-    - endDate: `int`\n
-        Date limite pour voter
-    """
-
-    def __init__(self, id: NSID, title: str) -> None:
-        self.id: NSID = NSID(id)
-        self.title: str = title
-        self.choices: list[VoteOption] = []
-        self.author: NSID = NSID("0")
-        self.startDate: int = 0
-        self.endDate: int = 0
-
-    def by_id(self, id: str) -> VoteOption:
-        for opt in self.choices:
-            if opt.id == id:
-                return opt
-
-    def sorted(self, titles_only: bool = False) -> list[VoteOption] | list[str]:
-        sorted_list: list[VoteOption] = sorted(self.choices, lambda opt : opt.count)
-
-        if titles_only:
-            return [ opt.id for opt in sorted_list ]
-        else:
-            return sorted_list
-
-class Referendum(Vote):
-    """
-    Vote à trois positions
-    """
-
-    def __init__(self, id: NSID, title: str) -> None:
-        super().__init__(id, title)
-
-        self.choices = [
-            VoteOption('yes', 'Oui'),
-            VoteOption('no', 'Non'),
-            VoteOption('blank', 'Pas d\'avis'),
-        ]
-
-class Lawsuit(Vote):
-    """
-    Vote à trois positions pour un procès
-    """
-
-    def __init__(self, id: NSID, title: str) -> None:
-        super().__init__(id, title)
-
-        self.choices = [
-            VoteOption('guilty', 'Coupable'),
-            VoteOption('innocent', 'Innocent'),
-            VoteOption('blank', 'Pas d\'avis'),
-        ]
-
-
-# Institutions (defs)
-
-class Official:
-    def __init__(self, id: NSID) -> None:
-        self.id: NSID = NSID(id)
-
-        self.mandates: int = {
-            'PRE_REP': 0, # Président de la République
-            'MIN': 0, # Différents ministres
-            'PRE_AS': 0, # Président de l'Assemblée Nationale
-            'REPR': 0 # Député
-        }
-
-        self.contributions: dict = {
-            'propose_project': 0,
-            'success_project': 0, 
-            'vote_law': 0
-        }
-
-class Administration:
-    def __init__(self) -> None:
-        self.president: Official
-        self.members: list[Official] = []
-
-class Government:
-    def __init__(self, president: Official) -> None:
-        self.president: Official = president
-        self.prime_minister: Official
-
-        self.inner_minister: Official
-        self.economy_minister: Official
-        self.justice_minister: Official
-        self.press_minister: Official
-        self.outer_minister: Official
-
-class Court:
-    def __init__(self) -> None:
-        self.president: Official
-        # On discutera de la mise en place d'un potentiel président. Pour l'instant c'est le Ministre de la Justice
-        self.members: list[Official] = []
-
-class Assembly:
-    def __init__(self) -> None:
-        self.president: Official
-        self.members: list[Official] = []
-
-class PoliceForces:
-    def __init__(self) -> None:
-        self.president: Official
-        self.members: list[Official] = []
-
-class State:
-    def __init__(self) -> None:
-        self.administration: Administration
-        self.government: Government
-        self.court: Court
-        self.assembly: Assembly
-        self.police: PoliceForces

nsarchive/instances/_entities.py

@@ -1,281 +0,0 @@
-from ..cls.base import *
-from ..cls.entities import *
-
-from ..cls import entities # Pour les default_headers
-
-class EntityInstance(Instance):
-    """
-    Instance qui vous permettra d'interagir avec les profils des membres ainsi que les différents métiers et secteurs d'activité.
-
-    ## Informations disponibles
-    - Profil des membres et des entreprises: `.User | .Organization | .Entity`
-    - Participation d'un membre à différent votes: `.User | .Organization | .Entity`
-    - Appartenance et permissions d'un membre dans un groupe: `.GroupMember.MemberPermissions`
-    - Position légale et permissions d'une entité: `.Position.Permissions`
-    - Sanctions et modifications d'une entité: `.Action[ .AdminAction | .Sanction ]`
-    """
-
-    def __init__(self, url: str, token: str = None) -> None:
-        super().__init__(url, token)
-
-        entities.default_headers = self.default_headers
-
-    """
-    ---- ENTITÉS ----
-    """
-
-    def get_entity(self, id: NSID, _class: str = None) -> User | Organization | Entity:
-        """
-        Fonction permettant de récupérer le profil public d'une entité.\n
-
-        ## Paramètres
-        id: `NSID`
-            ID héxadécimal de l'entité à récupérer
-        _class: `str`
-            Classe du modèle à prendre (`.User` ou `.Organization`)
-
-        ## Renvoie
-        - `.User` dans le cas où l'entité choisie est un membre
-        - `.Organization` dans le cas où c'est un groupe
-        - `.Entity` dans le cas où c'est indéterminé
-        """
-
-        id = NSID(id)
-
-        if _class == "user":
-            _data = self._get_by_ID('individuals', id)
-        elif _class == "group":
-            _data = self._get_by_ID('organizations', id)
-        else:
-            _data = self._get_by_ID('entities', id)
-
-        if _data is None: # ID inexistant chez les entités
-            return None
-
-        if _data['_class'] == 'individuals':
-            entity = User(id)
-            entity._url = f"{self.url}/model/individuals/{id}"
-
-            entity._load(_data)
-        elif _data['_class'] == 'organizations':
-            entity = Organization(id)
-            entity._url = f"{self.url}/model/organizations/{id}"
-
-            _owner = _data['owner']
-
-            if _owner['_class'] == 'individuals':
-                entity.owner = User(_owner['id'])
-                entity.owner._load(_owner)
-            elif _owner['class'] == 'organizations':
-                entity.owner = Organization(_owner['id'])
-                entity.owner._load(_owner)
-            else:
-                entity.owner = self.get_entity(0x0)
-
-            entity._load(_data)
-        else: 
-            entity = Entity(id)
-            entity._url = f"{self.url}/model/entities/{id}"
-
-        entity.name = _data['name']
-        entity.position._load(_data['position']) # Métier si c'est un utilisateur, domaine professionnel si c'est un collectif
-        entity.registerDate = _data['register_date']
-
-        for  key, value in _data.get('additional', {}).items():
-            if isinstance(value, str) and value.startswith('\n'):
-                entity.additional[key] = int(value[1:])
-            else:
-                entity.additional[key] = value
-
-        entity.position._url = f"{self.url}/positions/{id}"
-
-        return entity
-
-    def get_entity_groups(self, entity: User) -> list[Organization]:
-        res = requests.get(f"{entity._url}/groups", headers = self.default_headers)
-
-        if res.status_code == 200:
-            data = res.json()
-            groups = []
-
-            for grp in data:
-                if grp is None: continue
-
-                group = Organization(grp["id"])
-                group._url = f"{self.url}/model/organizations/{grp['id']}"
-
-                group._load(grp)
-
-                groups.append(group)
-
-            return groups
-        else:
-            res.raise_for_status()
-            return []
-
-    def save_entity(self, entity: Entity):
-        """
-        Fonction permettant de créer ou modifier une entité.
-
-        ## Paramètres
-        entity: `.Entity`\n
-            L'entité à sauvegarder
-        """
-
-        entity.id = NSID(entity.id)
-
-        _data = {
-            'id': entity.id,
-            'name': entity.name,
-            'position': entity.position.id,
-            'register_date': entity.registerDate,
-            'additional': {},
-        }
-
-        for key, value in entity.additional.items():
-            if isinstance(value, int) and len(str(int)) >= 15:
-                _data['additional'][key] = '\n' + str(value)
-            elif type(value) in (str, int):
-                _data['additional'][key] = value
-
-        if type(entity) == Organization:
-            _data['owner_id'] = NSID(entity.owner.id) if entity.owner else NSID("0")
-            _data['members'] = []
-            _data['certifications'] = entity.certifications
-
-            for member in entity.members:
-                _member = {
-                    'id': NSID(member.id),
-                    'level': member.permission_level
-                }
-
-                _data['members'] += [_member]
-
-            entity.save_avatar()
-        elif type(entity) == User:
-            _data['xp'] = entity.xp
-            _data['boosts'] = entity.boosts
-            _data['votes'] = [ NSID(vote) for vote in entity.votes]
-        else:
-            return
-
-        self._put_in_db(
-            f"/new_model/{'individuals' if isinstance(entity, User) else 'organizations'}?id={urllib.parse.quote(entity.id)}&name={urllib.parse.quote(entity.name)}",
-            _data,
-            headers = self.default_headers,
-            use_PUT = True
-        )
-
-        entity._url = f"{self.url}/model/{'individuals' if isinstance(entity, User) else 'organizations'}/{entity.id}"
-
-
-    def delete_entity(self, entity: Entity):
-        """
-        Fonction permettant de supprimer le profil d'une entité
-
-        ## Paramètres
-        entity: `.Entity`\n
-            L'entité à supprimer
-        """
-
-        res = requests.post(f"{entity._url}/delete", headers = self.default_headers,)
-
-        if res.status_code != 200:
-            res.raise_for_status()
-
-    def fetch_entities(self, **query: typing.Any) -> list[ Entity | User | Organization ]:
-        """
-        Récupère une liste d'entités en fonction d'une requête.
-
-        ## Paramètres
-        query: `**dict`\n
-            La requête pour filtrer les entités.
-
-        ## Renvoie
-        - `list[.Entity | .User | .Organization]`
-        """
-
-        if "_class" in query.keys():
-            if query["_class"] == "individuals":
-                del query["_class"]
-                _res = self.fetch('individuals', **query)
-            elif query["_class"] == "organizations":
-                del query["_class"]
-                _res = self.fetch('organizations', **query)
-            else:
-                del query["_class"]
-                _res = self.fetch('entities', **query)
-        else:
-            _res = self.fetch('entities', **query)
-
-        res = []
-
-        for _entity in _res:
-            if _entity is None: continue
-
-            if _entity['_class'] == 'individuals':
-                entity = User(_entity["id"])
-                entity._url = f"{self.url}/model/individuals/{_entity['id']}"
-
-                entity._load(_entity)
-            elif _entity['_class'] == 'organizations':
-                entity = Organization(_entity["id"])
-                entity._url = f"{self.url}/model/organizations/{_entity['id']}"
-
-                _owner = _entity['owner']
-                if _owner['_class'] == 'individuals':
-                    entity.owner = User(_owner['id'])
-                    entity.owner._load(_owner)
-                elif _owner['class'] == 'organizations':
-                    entity.owner = Organization(_owner['id'])
-                    entity.owner._load(_owner)
-                else:
-                    entity.owner = self.get_entity(0x0)
-
-                entity._load(_entity)
-            else:
-                entity = Entity(_entity["id"])
-                entity._url = f"{self.url}/model/organizations/{_entity['id']}"
-
-            entity.name = _entity['name']
-            entity.position._load(_entity['position'])
-            entity.registerDate = _entity['register_date']
-
-            for  key, value in _entity.get('additional', {}).items():
-                if isinstance(value, str) and value.startswith('\n'):
-                    entity.additional[key] = int(value[1:])
-                else:
-                    entity.additional[key] = value
-
-            entity.position._url = f"{self.url}/positions/{_entity['id']}"
-
-            res.append(entity)
-
-        return res
-
-
-
-    def get_position(self, id: str) -> Position:
-        """
-        Récupère une position légale (métier, domaine professionnel).
-
-        ## Paramètres
-        id: `str`\n
-            ID de la position (SENSIBLE À LA CASSE !)
-
-        ## Renvoie
-        - `.Position`
-        """
-
-        _data = self._get_by_ID('positions', id)
-
-        if _data is None:
-            return None
-
-        position = Position(id)
-        position._url = f"{self.url}/positions/{id}"
-        position.name = _data['name']
-        position.permissions.merge(_data['permissions'])
-        position.manager_permissions.merge(_data['manager_permissions'])
-
-        return position