nsarchive 0.2a0__py3-none-any.whl → 1.0.1__py3-none-any.whl

nsarchive/__init__.py

@@ -2,137 +2,699 @@ import time
 
 import deta
 
+from .cls.base import *
 from .cls.entities import *
-from .cls.votes import *
+from .cls.archives import *
+from .cls.republic import *
+from .cls.economy import *
 
 from .cls.exceptions import *
 
 class EntityInstance:
+    """
+    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, token: str) -> None:
         self.db = deta.Deta(token)
         self.base = self.db.Base('entities')
         self.electors = self.db.Base('electors')
+        self.archives = self.db.Base('archives')
+        self.avatars = self.db.Drive('avatars')
+        self.positions = self.db.Base('positions') # Liste des métiers
+
+    def get_entity(self, id: str | NSID) -> User | Organization | Entity:
+        """
+        Fonction permettant de récupérer le profil public d'une entité.\n
+
+        ## Paramètres
+        id: `NSID`\n
+            ID héxadécimal de l'entité à récupérer
+
+        ## 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é
+        """
 
-    def get_entity(self, id: str) -> User | Organization | Entity:
-        id = id.upper()
+        id = NSID(id)
         _data = self.base.get(id)
+        _votes = self.electors.get(id)
 
         if _data is None:
             return Entity("0")
 
         if _data['_type'] == 'user':
             entity = User(id)
+
+            entity.xp = _data['xp']
+            entity.boosts = _data['boosts']
+            entity.votes = [ NSID(vote) for vote in _votes['votes'] ]
         elif _data['_type'] == 'organization':
             entity = Organization(id)
+
+            entity.owner = self.get_entity(NSID(_data['owner_id']))
+            
+            for _member in _data['members']:
+                member = GroupMember(_member['id'])
+                member.permissions.__dict__ = _member['permissions']
+
+            try:
+                entity.avatar = self.avatars.get(id).read()
+            except: 
+                entity.avatar = None
+
+            entity.certifications = _data['certifications']
         else:
             entity = Entity(id)
 
         entity.name = _data['name']
         entity.legalPosition = _data['legalPosition'] # Métier si c'est un utilisateur, domaine professionnel si c'est un collectif
         entity.registerDate = _data['registerDate']
-        entity.xp = _data['xp']
 
-        if type(entity) == Organization:
-            entity.owner = self.get_entity(_data['owner_id'].upper())
-            entity.members = [
-                self.get_entity(_id) for _id in _data['members']
-            ]
-
-            entity.certifications = _data['certifications']
-        elif type(entity) == User:
-            entity.boosts = _data['boosts']
-        
         return entity
 
     def save_entity(self, entity: Entity) -> None:
+        """
+        Fonction permettant de créer ou modifier une entité.
+
+        ## Paramètres
+        entity: `.Entity` ( `.User | .Organization` )
+            L'entité à sauvegarder
+        """
+
+        entity.id = NSID(entity.id)
+
         _base = self.base
         _data = {
             '_type': 'user' if type(entity) == User else 'organization' if type(entity) == Organization else 'unknown',
             'name': entity.name,
             'legalPosition': entity.legalPosition,
-            'registerDate': entity.registerDate,
-            'xp': entity.xp
+            'registerDate': entity.registerDate
         }
 
         if type(entity) == Organization:
-            _data['owner_id'] = entity.owner.id.upper() if entity.owner else Entity("0")
-            _data['members'] = [ member.id.upper() for member in entity.members ] if entity.members else []
+            _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),
+                    'permissions': member.permissions.__dict__.copy()
+                }
+
+                _data['members'] += _member                
+
+            self.avatars.put(name = entity.id, data = entity.avatar)
         elif type(entity) == User:
+            _data['xp'] = entity.xp
             _data['boosts'] = entity.boosts
 
-        _base.put(_data, entity.id.upper(), expire_in = 3 * 31536000) # Données supprimées tous les trois ans
+        _base.put(_data, entity.id, expire_in = 3 * 31536000) # Données supprimées tous les trois ans
 
-    def get_elector(self, id: str) -> Elector:
-        id = id.upper()
-        _data = self.electors.get(id)
-
-        if _data is None:
-            return Elector('0')
-        
-        elector = Elector(id)
-        elector.votes = _data['votes']
+    def delete_entity(self, entity: Entity) -> None:
+        """
+        Fonction permettant de supprimer le profil d'une entité
         
-        return elector
+        ## Paramètres
+        entity: `.Entity` ( `.User | .Organization` )
+            L'entité à supprimer
+        """
 
-    def save_elector(self, elector: Elector):
-        _data = {
-            "votes": elector.votes
-        }
+        self.base.delete(NSID(entity.id))
+
+        if type(entity) == Organization:
+            self.avatars.delete(NSID(entity.id))
+
+    def fetch_entities(self, query: dict = None, listquery: dict | None = None) -> list[ Entity | User | Organization ]:
+        """
+        Récupère une liste d'entités en fonction d'une requête.
 
-        self.electors.put(_data, elector.id.upper())
+        ## Paramètres
+        query: `dict`
+            La requête pour filtrer les entités.
+        listquery: `dict | None`
+            Requête secondaire pour n'afficher que les listes contenant un certain élément.
 
-    def fetch(self, query = None, listquery: dict | None = None) -> list:
+        ## Renvoie
+        - `list[Entity | User | Organization]`
+        """
         _res = self.base.fetch(query).items
 
         if listquery is not None:
             for item in _res:
-                for target, value in listquery:
+                for target, value in listquery.items():
                     if value not in item[target]:
                         _res.remove(item)
+
+        return [ self.get_entity(NSID(entity['key'])) for entity in _res ]
+
+    def get_entity_groups(self, id: str | NSID) -> list[Organization]:
+        """
+        Récupère les groupes auxquels appartient une entité.
+
+        ## Paramètres
+        id: `str | NSID`
+            ID de l'entité.
+
+        ## Renvoie
+        - `list[Organization]`
+        """
+
+        id = NSID(id)
+        groups = self.fetch_entities({'_type': 'organization'}, {'members': id})
+        
+        return groups
+
+    def get_position(self, id: str) -> Position:
+        """
+        Récupère une position légale (métier, domaine professionnel).
+
+        ## Paramètres
+        id: `str`
+            ID de la position (SENSIBLE À LA CASSE !)
+
+        ## Renvoie
+        - `.Position`
+        """
+
+        _data = self.positions.get(id)
+
+        if _data is None:
+            raise RessourceNotFoundError(f"No position with ID {id}")
+
+        position = Position(id)
+        position.name = _data['name']
+
+        for _permission in _data['permissions']:
+            position.permissions.__setattr__(_permission, True)
+
+        return position
+
+    def _add_archive(self, archive: Action) -> None:
+        """
+        Ajoute une archive d'une action (modification au sein d'un groupe ou sanction) dans la base de données.
+        """
+
+        archive.id = NSID(archive.id)
+        archive.author = NSID(archive.author)
+        archive.target = NSID(archive.target)
+
+        _data = archive.__dict__.copy()
+
+        if type(archive) == Sanction:
+            _data['type'] = "sanction"
+        elif type(archive) == AdminAction:
+            _data['type'] = "adminaction"
+        else:
+            _data['type'] = "unknown"
         
-        return _res
+        self.archives.put(key = archive.id, data = _data)
+
+    def _get_archive(self, id: str | NSID) -> Action | Sanction | AdminAction:
+        """
+        Récupère une archive spécifique.
+
+        ## Paramètres
+        id: `str | NSID`
+            ID de l'archive.
+
+        ## Renvoie
+        - `.Action | .Sanction | .AdminAction`
+        """
 
-    def get_entity_groups(self, id: int) -> list[Organization]:
-        groups = self.fetch({'_type': 'organization'}, {'members': str(id)})
+        id = NSID(id)
+        _data = self.archives.get(id)
+
+        if _data is None:
+            return None
         
-        return [ self.get_entity(int(group['id'], 16)) for group in groups ]
+        if _data['type'] == "sanction": # Mute, ban, GAV, kick, détention, prune (xp seulement)
+            archive = Sanction(_data['author'], _data['target'])
+
+            archive.details = _data['details']
+            archive.major = _data['major']
+            archive.duration = _data['duration']
+        elif _data['type'] == "adminaction": # Renommage, promotion, démotion (au niveau de l'état)
+            archive = AdminAction(_data['author'], _data['target'])
+
+            archive.details = _data['details']
+            archive.new_state = _data['new_state']
+        else:
+            archive = Action(_data['author'], _data['target'])
+        
+        archive.id = id
+        archive.action = _data['action']
+        archive.date = _data['date']
+
+        return archive
+
+    def _fetch_archives(self, **query) -> list[ Action | Sanction | AdminAction ]:
+        """
+        Récupère une liste d'archives correspondant à la requête.
+
+        ## Paramètres
+        query: `dict`
+            Requête pour filtrer les archives.
+
+        ## Renvoie
+        - `list[Action | Sanction | AdminAction]`
+        """
+
+        _res = self.archives.fetch(query).items
+        
+        return [ self._get_archive(archive['key']) for archive in _res ]
 
 class RepublicInstance:
+    """
+    Gère les interactions avec les votes, les archives de la république, et les fonctionnaires.
+
+    ## Informations
+    - Résultats des votes: `.Vote | .ClosedVote`
+    - Différentes institutions: `.Institutions | .Administration | .Government | .Assembly | .Court | .PoliceForces`
+    - Occupants des différents rôles et historique de leurs actions: `.Official`
+    """
+
     def __init__(self, token: str) -> None:
+        """Initialise une nouvelle RepublicInstance avec un token Deta."""
+
         self.db = deta.Deta(token)
         self.votes = self.db.Base('votes')
+        self.archives = self.db.Base('archives')
+        self.mandate = self.db.Base('mandate')
+        self.functions = self.db.Base('functions') # Liste des fonctionnaires
+
+    def get_vote(self, id: str | NSID) -> Vote | ClosedVote:
+        """
+        Récupère un vote spécifique.
+
+        ## Paramètres
+        id: `str | NSID`
+            ID du vote.
 
-    def get_vote(self, id: str) -> Vote | ClosedVote:
-        id = id.upper()
+        ## Renvoie
+        - `.Vote | .ClosedVote`
+        """
+
+        id = NSID(id)
         _data = self.votes.get(id)
 
         if _data is None:
-            return None
-        
+            raise RessourceNotFoundError(f"The vote #{id} does not exist.")
+
         if _data['_type'] == 'open':
             vote = Vote(id, _data['title'], tuple(_data['choices'].keys()))
         elif _data['_type'] == 'closed':
             vote = ClosedVote(id, _data['title'])
         else:
             vote = Vote('0', 'Unknown Vote', ())
-        
+
         vote.author = _data['author']
         vote.startDate = _data['startDate']
         vote.endDate = _data['endDate']
         vote.choices = _data['choices']
-        
+
         return vote
 
-    def save_vote(self, vote: Vote | ClosedVote):
-        _base = self.base
+    def save_vote(self, vote: Vote | ClosedVote) -> None:
+        """Sauvegarde un vote dans la base de données."""
+
+        vote.id = NSID(vote.id)
+
         _data = {
             '_type': 'open' if type(vote) == Vote else 'closed' if type(vote) == ClosedVote else 'unknown',
             'title': vote.title,
-            'author': vote.author,
+            'author': NSID(vote.author),
             'startDate': vote.startDate,
             'endDate': vote.endDate,
             'choices': vote.choices
         }
 
-        _base.put(_data, vote.id.upper())
+        self.votes.put(_data, vote.id)
+
+    def get_official(self, id: str | NSID, current_mandate: bool = True) -> Official:
+        """
+        Récupère les informations d'un fonctionnaire (mandats, contributions).
+
+        ## Paramètres
+        id: `str | NSID`
+            ID du fonctionnaire.
+        current_mandate: `bool`
+            Indique si l'on doit récupérer le mandat actuel ou les anciens mandats.
+
+        ## Renvoie
+        - `.Official`
+        """
+
+        id = NSID(id)
+
+        archives = self.mandate if current_mandate else self.archives
+
+        _contributions = archives.fetch({'author': id, 'type': 'contrib'}).items
+        _mandates = archives.fetch({'target': id, 'type': 'election'}).items\
+                    + archives.fetch({'target': id, 'type': 'promotion'}).items
+
+        user = Official(id)
+        for mandate in _mandates:
+            if mandate['position'].startswith('MIN'):
+                mandate['position'] = 'MIN'
+
+            try:
+                user.mandates[mandate['position']] += 1
+            except KeyError:
+                user.mandates[mandate['position']] = 1
+
+        for contrib in _contributions:
+            try:
+                user.contributions[contrib['action']] += 1
+            except KeyError:
+                user.contributions[contrib['action']] = 1
+
+        return user
+
+    def get_institutions(self) -> Organization:
+        """Récupère l'état actuel des institutions de la république."""
+
+        admin = Administration()
+        gov = Government(Official('0'))
+        assembly = Assembly()
+        court = Court()
+        police_forces = PoliceForces()
+
+        _admins = self.functions.get('ADMIN')
+        admin.members = [ self.get_official(user) for user in _admins['users'] ]
+        admin.president = self.get_official('F7DB60DD1C4300A') # happex (remplace Kheops pour l'instant)
+
+        gov.president = self.get_official(self.functions.get('PRE_REP')['users'][0])
+
+        minister = lambda code : self.get_official(self.functions.get(f'MIN_{code}')['users'][0])
+        gov.prime_minister = minister('PRIM')
+        gov.economy_minister = minister('ECO')
+        gov.inner_minister = minister('INN')
+        gov.press_minister = minister('AUD')
+        gov.justice_minister = minister('JUS')
+        gov.outer_minister = minister('OUT')
+
+        assembly.president = self.get_official(self.functions.get('PRE_AS')['users'][0])
+        assembly.members = [ self.get_official(id) for id in self.functions.get('REPR')['users'] ]
+
+        court.president = gov.justice_minister
+        court.members = [ self.get_official(id) for id in self.functions.get('JUDGE')['users'] ]
+
+        police_forces.president = gov.inner_minister
+        police_forces.members = [ self.get_official(id) for id in self.functions.get('POLICE')['users'] ]
+
+        instits = Institutions()
+        instits.administration = admin
+        instits.government = gov
+        instits.court = court
+        instits.assembly = assembly
+        instits.police = police_forces
+
+        return instits
+
+    def update_institutions(self, institutions: Institutions):
+        """
+        Fonction communément appelée après un vote législatif ou une nomination.\n
+        Celle-ci met à jour: Le gouvernement (président, ministres), les différents députés et leur président, les différents juges, les différents policiers.\n
+
+        ## Paramètres
+        institutions: `.Institutions`\n
+            Le nouvel état des institutions, à sauvegarder.
+        """
+
+        get_ids = lambda institution : [ member.id for member in institutions.__getattribute__(institution).members ]
+
+        self.functions.put(key = 'ADMIN', data = { 'users': get_ids('administration') })
+        self.functions.put(key = 'REPR', data = { 'users': get_ids('assembly') })
+        self.functions.put(key = 'JUDGE', data = { 'users': get_ids('court') })
+        self.functions.put(key = 'POLICE', data = { 'users': get_ids('police') })
+
+        self.functions.put(key = 'PRE_AS', data = { 'users': [ institutions.assembly.president.id ] })
+        self.functions.put(key = 'PRE_REP', data = { 'users': [ institutions.government.president.id ] })
+
+        self.functions.put(key = 'MIN_PRIM', data = { 'users': [ institutions.government.prime_minister.id ] })
+        self.functions.put(key = 'MIN_INN', data = { 'users': [ institutions.government.inner_minister.id ] })
+        self.functions.put(key = 'MIN_JUS', data = { 'users': [ institutions.government.justice_minister.id ] })
+        self.functions.put(key = 'MIN_ECO', data = { 'users': [ institutions.government.economy_minister.id ] })
+        self.functions.put(key = 'MIN_AUD', data = { 'users': [ institutions.government.press_minister.id ] })
+        self.functions.put(key = 'MIN_OUT', data = { 'users': [ institutions.government.outer_minister.id ] })
+
+    def new_mandate(self, institutions: Institutions, weeks: int = 4) -> None:
+        """
+        Fonction qui amène à supprimer toutes les archives du mandat précédent
+        """
+
+        for item in self.mandate.fetch().items:
+            if item['date'] >= round(time.time()) - weeks * 604800: # On évite de supprimer les informations écrites lors de la période définie
+                self.mandate.delete(item['id'])
+
+        self.update_institutions(institutions)
+
+    def _add_archive(self, archive: Action) -> None:
+        """Ajoute une archive d'une action (élection, promotion, ou rétrogradation) dans la base de données."""
+
+        archive.id = NSID(archive.id)
+        _data = archive.__dict__.copy()
+
+        if type(archive) == Election:
+            _data['type'] = "election"
+        elif type(archive) == Promotion:
+            _data['type'] = "promotion"
+        elif type(archive) == Demotion:
+            _data['type'] = "demotion"
+        else:
+            _data['type'] = "unknown"
+
+        self.archives.put(key = archive.id, data = _data)
+        self.mandate.put(key = archive.id, data = _data) # Ajouter les archives à celle du mandat actuel
+
+    def _get_archive(self, id: str | NSID) -> Action | Election | Promotion | Demotion:
+        """
+        Récupère une archive spécifique.
+
+        ## Paramètres
+        id: `str | NSID`
+            ID de l'archive.
+
+        ## Renvoie
+        - `.Action | .Election | .Promotion | .Demotion`
+        """
+
+        id = NSID(id)
+        _data = self.archives.get(id)
+
+        if _data is None:
+            return None
+
+        if _data['type'] == "election":
+            archive = Election(_data['author'], _data['target'], _data['position'])
+
+            archive.positive_votes = _data['positive_votes']
+            archive.total_votes = _data['total_votes']
+        elif _data['type'] == "promotion":
+            archive = Promotion(_data['author'], _data['target'], _data['position'])
+        elif _data['type'] == "demotion":
+            archive = Demotion(_data['author'], _data['target'])
+
+            archive.reason = _data['reason']
+        else:
+            archive = Action(_data['author'], _data['target'])
+
+        archive.id = id
+        archive.action = _data['action']
+        archive.date = _data['date']
+
+        return archive
+
+    def _fetch_archives(self, **query) -> list[ Action | Election | Promotion | Demotion ]:
+        """
+        Récupère une liste d'archives correspondant à la requête.
+
+        ## Paramètres
+        query: `dict`
+            Requête pour filtrer les archives.
+
+        ## Renvoie
+        - `list[Action | Election | Promotion | Demotion]`
+        """
+
+        _res = self.archives.fetch(query).items
+        
+        return [ self._get_archive(archive['key']) for archive in _res ]
+
+class BankInstance:
+    """Gère les interactions avec les comptes bancaires, les transactions, et le marché."""
+
+    def __init__(self, token: str) -> None:
+        self.db = deta.Deta(token)
+        self.archives = self.db.Base('archives')
+        self.accounts = self.db.Base('accounts')
+        self.registry = self.db.Base('banks')
+        self.marketplace = self.db.Base('shop')
+
+    def get_account(self, id: str | NSID) -> BankAccount:
+        """
+        Récupère les informations d'un compte bancaire.
+
+        ## Paramètres
+        id: `str | NSID`
+            ID du compte.
+
+        ## Renvoie
+        - `.BankAccount`
+        """
+
+        id = NSID(id)
+        _data = self.accounts.get(id)
+
+        if _data is None:
+            return None
+
+        account = BankAccount(id)
+        account.amount = _data['amount']
+        account.locked = _data['locked']
+        account.owner = _data['owner_id']
+        account.bank = _data['bank']
+
+        return account
+
+    def save_account(self, account: BankAccount):
+        """Sauvegarde un compte bancaire dans la base de données."""
+
+        _data = {
+            'amount': account.amount,
+            'locked': account.locked, 
+            'owner_id': account.owner, 
+            'bank': account.bank
+        }
+
+        self.accounts.put(_data, NSID(account.id))
+
+    def lock_account(self, account: BankAccount):
+        """Verrouille un compte bancaire pour empêcher toute transaction."""
+
+        account.id = account.id.upper()
+        account.locked = True
+
+        self.save_account(account)
+
+    def get_item(self, id: str | NSID) -> Item | None:
+        """
+        Récupère un item du marché.
+
+        ## Paramètres
+        id: `str | NSID`
+            ID de l'item.
+
+        ## Renvoie
+        - `.Item | None`
+        """
+
+        id = NSID(id)
+
+        _data = self.marketplace.get(id)
+
+        if _data is None:
+            return None
+
+        item = Item(id)
+        item.title = _data['title']
+        item.emoji = _data['emoji']
+        item.seller_id = _data['seller']
+        item.price = _data['price']
+
+        return item
+
+    def save_item(self, item: Item) -> None:
+        """Sauvegarde un item dans la base de données du marché."""
+
+        item.id = NSID(item.id)
+
+        _data = item.__dict__.copy()
+
+        self.marketplace.put(key = item.id, data = _data)
+
+    def delete_item(self, item: Item) -> None:
+        """Supprime un item du marché."""
+
+        item.id = NSID(item.id)
+        self.marketplace.delete(item.id)
+
+    def _add_archive(self, archive: Action):
+        """Ajoute une archive d'une transaction ou d'une vente dans la base de données."""
+
+        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"
+            archive.currency = archive.currency.upper()
+        elif type(archive) == Sale:
+            _data['type'] = "sale"
+        else:
+            _data['type'] = "unknown"
+
+        self.archives.put(key = archive.id, data = _data)
+
+    def _get_archive(self, id: str | NSID) -> Action | Transaction:
+        """
+        Récupère une archive spécifique.
+
+        ## Paramètres
+        id: `str | NSID`
+            ID de l'archive.
+
+        ## Renvoie
+        - `.Action | .Transaction`
+        """
+
+        id = NSID(id)
+        _data = self.archives.get(id)
+
+        if _data is None:
+            return None
+
+        if _data['type'] == "transaction":
+            archive = Transaction(_data['author'], _data['target'], _data['amount'])
+
+            archive.reason = _data['reason']
+            archive.currency = _data['currency']
+        elif _data['type'] == "sale":
+            archive = Sale(_data['author'], _data['target'])
+
+            archive.price = _data['price']
+        else:
+            archive = Action(_data['author'], _data['target'])
+
+        archive.id = id
+        archive.action = _data['action']
+        archive.date = _data['date']
+
+        return archive
+
+    def _fetch_archives(self, **query) -> list[ Action | Transaction ]:
+        """
+        Récupère une liste d'archives correspondant à la requête.
+
+        ## Paramètres
+        query: `dict`
+            Requête pour filtrer les archives.
+
+        ## Renvoie
+        - `list[Action | Transaction]`
+        """
+        
+        _res = self.archives.fetch(query).items
+
+        return [ self._get_archive(archive['key']) for archive in _res ]

nsarchive/cls/archives.py

@@ -0,0 +1,70 @@
+import time
+
+from .base import *
+
+class Action:
+    def __init__(self, author: str | NSID = '0', target: str | NSID = '0') -> None:
+        self.date: int = round(time.time())
+
+        self.id: NSID = NSID(self.date)
+        self.action: str = ""
+        self.author: NSID = NSID(author)
+        self.target: NSID = NSID(target)
+
+
+# Entities
+
+class Sanction(Action):
+    def __init__(self, author: str | NSID, target: str | NSID) -> None:
+        super().__init__(author, target)
+
+        self.details: str = ""
+        self.major: bool = False # Sanction majeure ou non
+        self.duration: int = 0 # Durée en secondes, 0 = définitif
+
+class AdminAction(Action):
+    def __init__(self, author: str | NSID, target: str | NSID) -> None:
+        super().__init__(author, target)
+
+        self.details: str = ""
+        self.new_state: str | int | bool = None
+
+
+# Community
+
+class Election(Action):
+    def __init__(self, author: str | NSID, target: str | NSID, position: str) -> None:
+        super().__init__(author, target)
+
+        self.position: str = position
+        self.positive_votes: int = 0
+        self.total_votes: int = 0
+
+class Promotion(Action):
+    def __init__(self, author: str | NSID, target: str | NSID, position: str) -> None:
+        super().__init__(author, target)
+
+        self.position: str = position
+
+class Demotion(Action):
+    def __init__(self, author: str | NSID, target: str | NSID) -> None:
+        super().__init__(author, target)
+
+        self.reason: str = None
+
+
+# Bank
+
+class Transaction(Action):
+    def __init__(self, author: str | NSID, target: str | NSID, amount: int) -> None:
+        super().__init__(author, target)
+
+        self.amount: int = amount
+        self.currency: str = 'HC'
+        self.reason: str = None
+
+class Sale(Action):
+    def __init__(self, author: str | NSID = '0', target: str | NSID = '0') -> None:
+        super().__init__(author, target)
+
+        self.price: int = 0

nsarchive/cls/base.py

@@ -0,0 +1,27 @@
+class NSID(str):
+    unknown = "0"
+    admin = "01"
+    gov = "02"
+    assembly = "03"
+    court = "04"
+    office = "05"
+    hexabank = "06"
+    archives = "07"
+
+    maintenance_committee = "101"
+    audiovisual_department = "102"
+    interior_department = "103"
+
+    def __new__(cls, value):
+        if type(value) == int:
+            value = hex(value)
+        elif type(value) in (str, NSID):
+            value = hex(int(value, 16))
+        else:
+            return TypeError(f"<{value}> is not NSID serializable")
+        
+        if value.startswith("0x"):
+            value = value[2:]
+        
+        instance = super(NSID, cls).__new__(cls, value.upper())
+        return instance

nsarchive/cls/economy.py

@@ -0,0 +1,20 @@
+from .base import *
+
+class BankAccount:
+    def __init__(self, id: str | NSID) -> None:
+        self.id: NSID = NSID(id)
+        self.owner: NSID = NSID(0)
+        self.amount: int = 0
+        self.locked: bool = False
+        self.bank: str = "HexaBank"
+
+        self.income: int = 0
+
+class Item:
+    def __init__(self, id: str | NSID) -> None:
+        self.id: NSID = NSID(id)
+        self.title: str = "Unknown Object"
+        self.emoji: str = ":light_bulb:"
+
+        self.seller_id: NSID = NSID(0)
+        self.price: int = 0

nsarchive/cls/entities.py

@@ -1,14 +1,69 @@
+import io
 import time
 
 from .exceptions import *
+from .base import *
 
+from ..utils import assets
+
+class PositionPermissions:
+    """
+    Permissions d'une position à l'échelle du serveur. Certaines sont attribuées selon l'appartenance à divers groupes ayant une position précise
+    """
+
+    def __init__(self) -> None:
+        # Membres
+        self.approve_laws = False # Approuver ou désapprouver les lois proposées (vaut aussi pour la Constitution)
+        self.buy_items = False # Acheter des items depuis le marketplace
+        self.create_organizations = False # Créer une organisation
+        self.edit_constitution = False # Proposer une modification de la Constitution
+        self.edit_laws = False # Proposer une modification des différents textes de loi
+        self.manage_entities = False # Gérer les membres et les organisations
+        self.manage_national_channel = False # Prendre la parole sur la chaîne nationale et avoir une priorité de passage sur les autres chaînes
+        self.manage_state_budgets = False # Gérer les différents budgets de l'État
+        self.moderate_members = False # Envoyer des membres en garde à vue, en détention ou toute autre sanction non présente sur le client Discord
+        self.propose_new_laws = self.edit_constitution # Proposer un nouveau texte de loi pris en charge par la Constitution
+        self.publish_official_messages = False # Publier un message sous l'identité du bot Serveur
+        self.sell_items = False # Vendre des objets ou services sur le marketplace
+        self.vote_president = False # Participer aux élections présidentielles
+        self.vote_representatives = False # Participer aux élections législatives
+
+    def edit(self, **permissions: bool) -> None:
+        for perm in permissions.values():
+            self.__setattr__(*perm)
+
+class Position:
+    def __init__(self, id: str = 'inconnu') -> None:
+        self.name: str = "Inconnue"
+        self.id = id
+        self.permissions: PositionPermissions = PositionPermissions()
 class Entity:
-    def __init__(self, id: str):
-        self.id: str = id # ID hexadécimal de l'entité
-        self.name: str = 'Entité Inconnue'
+    def __init__(self, id: str | NSID) -> None:
+        self.id: NSID = NSID(id) # ID hexadécimal de l'entité (ou nom dans le cas de l'entreprise)
+        self.name: str = "Entité Inconnue"
         self.registerDate: int = 0
-        self.legalPosition: int = 'Normal'
+        self.legalPosition: Position = Position()
+
+    def set_name(self, new_name: str) -> None:
+        if len(new_name) > 32:
+            raise NameTooLongError(f"Name length mustn't exceed 32 characters.")
+
+        self.name = new_name
+
+    def set_position(self, position: str) -> None:
+        self.legalPosition = position
+
+class User(Entity):
+    def __init__(self, id: str | NSID) -> None:
+        super().__init__(NSID(id))
+
         self.xp: int = 0
+        self.boosts: dict[str, int] = {}
+        self.permissions: PositionPermissions = PositionPermissions() # Elles seront définies en récupérant les permissions de sa position
+        self.votes: list[str] = []
+
+    def add_vote(self, id: str | NSID):
+        self.votes.append(NSID(id))
 
     def get_level(self) -> None:
         i = 0
@@ -16,75 +71,78 @@ class Entity:
             i += 1
 
         return i
-    
-    def rename(self, new_name: str) -> None:
-        if len(new_name) > 32:
-            raise NameTooLongError(f"Name length mustn't exceed 32 characters.")
-        
-        self.name = new_name
-    
-    def set_position(self, position: str) -> None:
-        self.legalPosition = position
-    
+
     def add_xp(self, amount: int) -> None:
         boost = 0 if 0 in self.boosts.values() else max(list(self.boosts.values()) + [ 1 ])
 
         self.xp += amount * boost
-    
-class User(Entity):
-    def __init__(self, id: str):
-        super().__init__(id)
 
-        self.boosts: dict[str, int] = {}
-    
     def edit_boost(self, name: str, multiplier: int = -1) -> None:
         if multiplier >= 0:
             self.boosts[name] = multiplier
         else:
             del self.boosts[name]
 
+class MemberPermissions:
+    """
+    Permissions d'un utilisateur à l'échelle d'un groupe
+    """
+
+    def __init__(self) -> None:
+        self.manage_organization = False # Renommer ou changer le logo
+        self.manage_members = False # Virer quelqu'un d'une entreprise, l'y inviter, changer ses rôles
+        self.manage_roles = False # Promouvoir ou rétrograder les membres
+
+    def edit(self, **permissions: bool) -> None:
+        for perm in permissions.values():
+            self.__setattr__(*perm)
+
+class GroupMember():
+    def __init__(self, id: str | NSID) -> None:
+        self.id: NSID = NSID(id)
+        self.permissions: MemberPermissions = MemberPermissions()
+        self.position: str = 'membre'
+
+class Official:
+    def __init__(self, id: str | 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
+            'JUDGE': 0, # Juge
+            'REPR': 0 # Député
+        }
+
+        self.contributions: dict = {
+            'project': 0,
+            'approved_project': 0, 
+            'admin_action': 0, 
+            'law_vote': 0
+        }
+
 class Organization(Entity):
-    def __init__(self, id: str):
-        super().__init__(id)
+    def __init__(self, id: str | NSID) -> None:
+        super().__init__(NSID(id))
 
         self.owner: Entity
         self.certifications: dict = {}
-        self.members: list = []
-    
+        self.members: list[GroupMember] = []
+        self.avatar: bytes = assets.open('default_avatar.png')
+
     def add_certification(self, certif: str) -> None:
         self.certifications[certif] = round(time.time())
-    
-    def add_member(self, member: User) -> None:
+
+    def add_member(self, member: GroupMember) -> None:
         self.members.append(member)
-    
-    def remove_member(self, member: User) -> None:
+
+    def remove_member(self, member: GroupMember) -> None:
         if member in self.members:
             self.members.remove(member)
-    
+
     def set_owner(self, member: User) -> None:
         self.owner = member
 
-class Elector(User):
-    def __init__(self, id: str) -> None:
-        self.id: str = id
-        self.votes: list[str] = []
-
-class FunctionalUser(User):
-    def __init__(self, id: str):
-        super().__init__(id)
-
-        self.permissions: dict = {
-            'approve_project': False,
-            'create_org': False,
-            'destroy_gov': False,
-            'destroy_org': False,
-            'propose_projects': False
-        }
-
-        self.mandates: int = 0
-        self.contribs: dict = {
-            'projects': 0,
-            'approved_projects': 0, 
-            'admin_actions': 0, 
-            'law_votes': 0
-        }
+    def get_member_id(self) -> list[str]:
+        return [ member.id for member in self.members ]

nsarchive/cls/exceptions.py

@@ -8,9 +8,18 @@ class EntityTypeError(Exception):
     def __init__(self, *args: object) -> None:
         super().__init__(*args)
 
+class AvatarTooLongError(Exception):
+    def __init__(self, *args: object) -> None:
+        super().__init__(*args)
 
 # Exceptions pour le vote
 
 class AlreadyVotedError(Exception):
+    def __init__(self, *args: object) -> None:
+        super().__init__(*args)
+
+# Ressource pas trouvée
+
+class RessourceNotFoundError(Exception):
     def __init__(self, *args: object) -> None:
         super().__init__(*args)

nsarchive/cls/republic.py

@@ -0,0 +1,60 @@
+from .entities import *
+
+# Votes
+
+class Vote:
+    def __init__(self, id: str | NSID, title: str, choices: tuple[str]) -> None:
+        self.id: NSID = NSID(id)
+        self.title: str = title
+        self.choices = { choice : 0 for choice in choices }
+        self.author: str = '0'
+        self.startDate: int = 0
+        self.endDate: int = 0
+
+class ClosedVote(Vote):
+    def __init__(self, id: str | NSID, title: str) -> None:
+        super().__init__(id, title, ('yes', 'no', 'blank'))
+
+
+# Institutions (defs)
+
+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 Assembly:
+    def __init__(self) -> None:
+        self.president: Official
+        self.members: list[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 PoliceForces:
+    def __init__(self) -> None:
+        self.president: Official
+        self.members: list[Official]
+
+class Institutions:
+    def __init__(self) -> None:
+        self.administration: Administration
+        self.government: Government
+        self.court: Court
+        self.assembly: Assembly
+        self.police: PoliceForces
+

nsarchive/utils/assets.py

@@ -0,0 +1,15 @@
+import io
+import os
+from PIL import Image
+
+def open(path: str) -> Image:
+    curr_dir = os.path.dirname(os.path.abspath(os.path.join(__file__)))
+    parent_dir = os.path.dirname(curr_dir)
+    asset_path = os.path.join(parent_dir, 'assets', path)
+
+    image = Image.open(asset_path)
+    val = io.BytesIO()
+
+    image.save(val, format = 'PNG')
+
+    return val.getvalue()

{nsarchive-0.2a0.dist-info → nsarchive-1.0.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: nsarchive
-Version: 0.2a0
+Version: 1.0.1
 Summary: 
 License: GPL-3.0
 Author: happex
@@ -11,6 +11,8 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: deta (>=1.2,<2.0)
+Requires-Dist: pillow (>=10.4,<11.0)
 Description-Content-Type: text/markdown
 
 # nsarchive
@@ -76,7 +78,7 @@ entity_instance.save_entity(entity)
 Vous pouvez rechercher des entités avec des critères spécifiques.
 
 ```python
-entities = entity_instance.fetch(query = {'name': 'Alice'})
+entities = entity_instance.fetch_entity(query = {'name': 'Alice'})
 for entity in entities:
     print(entity['name'])
 ```

nsarchive-1.0.1.dist-info/RECORD

@@ -0,0 +1,13 @@
+nsarchive/__init__.py,sha256=WAGTyFj-bQEgkz7tW8KTCIYqEMKq6RvjP6sp-9RaGp0,23899
+nsarchive/assets/default_avatar.png,sha256=n-4vG_WPke8LvbY3ZU6oA-H-OtRoIu7woKnRq9DCIlI,51764
+nsarchive/cls/archives.py,sha256=P3xOg7D7og-Vnf3VQWeIwmJRD9g7dVQBYChvMIMM6i8,2008
+nsarchive/cls/base.py,sha256=z7NTvrtbeaUF1T_o-J7PL2N8axkmJek9EoKcQ8fTF9I,715
+nsarchive/cls/economy.py,sha256=RjFu3VzNunazslbd4Ia5p1Jr-jJP5CvIcbVOzkDTwTU,549
+nsarchive/cls/entities.py,sha256=zz0JTphgtXpCIVH8dgb3hxc55nxwvXF3m2yIXgp_Q9k,5743
+nsarchive/cls/exceptions.py,sha256=QN6Qn7cxTkGoC4lO50hBAq4gZCgo7scQvCkb-xKl6Xs,692
+nsarchive/cls/republic.py,sha256=FphoO9TBE9hyfdjcePjQHqBw7NFT74f-avE9T5qTTuE,1750
+nsarchive/utils/assets.py,sha256=hd0STSpa0yT-OJlUyI_wCYXJqcBiUMQds2pZTXNNg9c,382
+nsarchive-1.0.1.dist-info/LICENSE,sha256=aFLFZg6LEJFpTlNQ8su3__jw4GfV-xWBmC1cePkKZVw,35802
+nsarchive-1.0.1.dist-info/METADATA,sha256=CdilT_3C-x4b20ccl_uwdyiWEEAXotfrJsrhQXlKgI4,5629
+nsarchive-1.0.1.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+nsarchive-1.0.1.dist-info/RECORD,,

nsarchive/cls/votes.py

@@ -1,16 +0,0 @@
-import time
-
-from .entities import FunctionalUser
-
-class Vote:
-    def __init__(self, id: str, title: str, choices: tuple[str]) -> None:
-        self.id: str = id
-        self.title: str = title
-        self.choices = { choice : 0 for choice in choices }
-        self.author: FunctionalUser
-        self.startDate: int = 0
-        self.endDate: int = 0
-
-class ClosedVote(Vote):
-    def __init__(self, id: str, title: str) -> None:
-        super().__init__(id, title, ('yes', 'no', 'blank'))

nsarchive-0.2a0.dist-info/RECORD

@@ -1,8 +0,0 @@
-nsarchive/__init__.py,sha256=0eu5Tf7ZuUmMQeeZ001ePNWBisoz1njUA2__Ruy6wjU,4600
-nsarchive/cls/entities.py,sha256=mhBHZBtYK1E2dfTDoFHNdw1uu5QsnOc-Utuu5EjtV7c,2556
-nsarchive/cls/exceptions.py,sha256=TrH9PvHhVZi7wap9ZfBLGRWJY3OBCYgWAMnco5uadYY,420
-nsarchive/cls/votes.py,sha256=vASgf9ies8YPPlKBoaQdB5jB_Sp4GS_Onl8hv3_7HJU,507
-nsarchive-0.2a0.dist-info/LICENSE,sha256=aFLFZg6LEJFpTlNQ8su3__jw4GfV-xWBmC1cePkKZVw,35802
-nsarchive-0.2a0.dist-info/METADATA,sha256=xlZA4CPlK_RrfnzpnPApuAKhrTZgPBef9TI-8VxplIw,5552
-nsarchive-0.2a0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-nsarchive-0.2a0.dist-info/RECORD,,