nsarchive 3.0.0a6__py3-none-any.whl → 3.0.0a8__py3-none-any.whl

nsarchive/instances/_entities.py

@@ -1,269 +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]:
-        print(entity._url)
-        res = requests.get(f"{entity._url}/groups", headers = self.default_headers)
-
-        if res.status_code == 200:
-            return res.json()
-        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

nsarchive/instances/_republic.py

@@ -1,339 +0,0 @@
-import time
-
-from ..cls.base import *
-from ..cls.archives import *
-from ..cls.republic import *
-
-
-class RepublicInstance(Instance):
-    """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-    Gère les interactions avec les votes, les archives de la république, et les fonctionnaires.
-
-    ## Informations
-    - Résultats des votes et procès: `.Vote | .Referendum | .Lawsuit`
-    - Différentes institutions: `.State | .Administration | .Government | .Assembly | .Court | .PoliceForces`
-    - Occupants des différents rôles et historique de leurs actions: `.Official`
-    """
-
-    def __init__(self, url: str, token: str) -> None:
-        super().__init__(url, token)
-    
-    """
-    ---- VOTES & REFERENDUMS ----
-    """
-
-    def get_vote(self, id: NSID) -> Vote | Referendum | Lawsuit:
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Récupère un vote spécifique.
-
-        ## Paramètres
-        id: `NSID`\n
-            ID du vote.
-
-        ## Renvoie
-        - `.Vote | .Referendum | .Lawsuit`
-        """
-
-        return Vote(NSID(id), "Vote Inconnu") # Provisoire
-
-        id = NSID(id)
-        _data = self._get_by_ID('votes', id)
-
-        if not _data: # Pas dans les votes -> peut-être dans les procès
-            _data = self._get_by_ID('lawsuits', id)
-
-        if not _data: # Le vote n'existe juste pas
-            return None
-        elif '_type' not in _data.keys(): # Le vote est un procès
-            _data['_type'] = "lawsuit"
-
-        if _data['_type'] == 'vote':
-            vote = Vote(id, _data['title'])
-        elif _data['_type'] == 'referendum':
-            vote = Referendum(id, _data['title'])
-            vote.choices = []
-        elif _data['_type'] == 'lawsuit':
-            vote = Lawsuit(id, _data['title'])
-            vote.choices = []
-        else:
-            vote = Vote('0', 'Unknown Vote')
-
-        vote.author = _data['author_id']
-        vote.startDate = _data['start_date']
-        vote.endDate = _data['end_date']
-
-        for opt in _data['choices']:
-            option = VoteOption(opt["id"], opt["title"])
-            option.count = opt["count"]
-
-            vote.choices.append(option)
-
-        return vote
-
-    def save_vote(self, vote: Vote | Referendum | Lawsuit):
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Sauvegarde un vote dans la base de données.
-
-        ## Paramètres
-        - vote: `.Vote`\n
-            Vote à sauvegarder
-        """
-
-        return # Provisoire
-
-        vote.id = NSID(vote.id)
-
-        _data = {
-            '_type':'vote' if type(vote) == Vote else\
-                    'referendum' if type(vote) == Referendum else\
-                    'lawsuit' if type(vote) == Lawsuit else\
-                    'unknown',
-            'id': NSID(vote.id),
-            'title': vote.title,
-            'author_id': NSID(vote.author),
-            'start_date': vote.startDate,
-            'end_date': vote.endDate,
-            'choices': [ opt.__dict__ for opt in vote.choices ]
-        }
-
-        if type(vote) == Lawsuit:
-            del _data['_type']
-            self._put_in_db('lawsuits', _data)
-        else:
-            self._put_in_db('votes', _data)
-
-    # Aucune possibilité de supprimer un vote
-
-    """
-    ---- INSTITUTION & MANDAT ----
-    """
-
-    def get_official(self, id: NSID, current_mandate: bool = True) -> Official:
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Récupère les informations d'un fonctionnaire (mandats, contributions).
-
-        ## Paramètres
-        id: `NSID`\n
-            ID du fonctionnaire.
-        current_mandate: `bool`\n
-            Indique si l'on doit récupérer le mandat actuel ou les anciens mandats.
-
-        ## Renvoie
-        - `.Official`
-        """
-
-        return Official(NSID(id)) # Provisoire
-
-        id = NSID(id)
-
-        base = 'mandate' if current_mandate else 'archives'
-
-        _contributions = self.fetch(base, author = id, _type = 'contrib')
-        _mandates = self.fetch(base, target = id, _type = 'election') +\
-                    self.fetch(base, target = id, _type = 'promotion')
-
-        user = Official(id)
-        for mandate in _mandates:
-            if mandate['details']['position'].startswith('MIN'):
-                mandate['details']['position'] = 'MIN'
-
-            try:
-                user.mandates[mandate['details']['position']] += 1
-            except KeyError:
-                user.mandates[mandate['details']['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) -> State:
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Récupère l'état actuel des institutions de la république.
-        """
-
-        return State()
-
-        admin = Administration()
-        gov = Government(Official('0'))
-        assembly = Assembly()
-        court = Court()
-        police_forces = PoliceForces()
-
-        _get_position: list[dict] = lambda pos : self._select_from_db('functions', 'id', pos)[0]['users']
-
-        admin.members = [ self.get_official(user) for user in _get_position('ADMIN') ]
-        admin.president = self.get_official(0xF7DB60DD1C4300A) # happex (remplace Kheops pour l'instant)
-
-        gov.president = self.get_official(0x0)
-
-        minister = lambda code : self.get_official(_get_position(f'MIN_{code}')[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(_get_position('PRE_AS')[0])
-        assembly.members = [ self.get_official(user) for user in _get_position('REPR') ]
-
-        court.president = gov.justice_minister
-        court.members = [ self.get_official(user) for user in _get_position('JUDGE') ]
-
-        police_forces.president = gov.inner_minister
-        police_forces.members = [ self.get_official(user) for user in _get_position('POLICE') ]
-
-        instits = State()
-        instits.administration = admin
-        instits.government = gov
-        instits.court = court
-        instits.assembly = assembly
-        instits.police = police_forces
-
-        return instits
-
-    def update_institutions(self, institutions: State):
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        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: `.State`\n
-            Le nouvel état des institutions, à sauvegarder.
-        """
-
-        return # Provisoire
-
-        get_ids = lambda institution : [ member.id for member in institutions.__getattribute__(institution).members ]
-
-        self._put_in_db('functions', { 'id': 'ADMIN', 'users': get_ids('administration') })
-        self._put_in_db('functions', { 'id': 'REPR', 'users': get_ids('assembly') })
-        self._put_in_db('functions', { 'id': 'JUDGE', 'users': get_ids('court') })
-        self._put_in_db('functions', { 'id': 'POLICE', 'users': get_ids('police') })
-
-        self._put_in_db('functions', { 'id': 'PRE_AS', 'users': [ institutions.assembly.president.id ] })
-        self._put_in_db('functions', { 'id': 'PRE_REP', 'users': [ institutions.government.president.id ] })
-
-        self._put_in_db('functions', { 'id': 'MIN_PRIM', 'users': [ institutions.government.prime_minister.id ] })
-        self._put_in_db('functions', { 'id': 'MIN_INN', 'users': [ institutions.government.inner_minister.id ] })
-        self._put_in_db('functions', { 'id': 'MIN_JUS', 'users': [ institutions.government.justice_minister.id ] })
-        self._put_in_db('functions', { 'id': 'MIN_ECO', 'users': [ institutions.government.economy_minister.id ] })
-        self._put_in_db('functions', { 'id': 'MIN_AUD', 'users': [ institutions.government.press_minister.id ] })
-        self._put_in_db('functions', { 'id': 'MIN_OUT', 'users': [ institutions.government.outer_minister.id ] })
-
-    def new_mandate(self, institutions: State, weeks: int = 4):
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Fonction qui amène à supprimer toutes les archives du mandat précédent
-
-        ## Paramètres
-        - institutions: `.State`\n
-            Nouvel État à sauvegarder
-        - weeks: `int`\n
-            Nombre de semaines du mandat
-        """
-
-        return # Provisoire
-
-        for item in self.fetch('mandate'):
-            if item['date'] >= round(time.time()) - weeks * 604800: # On évite de supprimer les informations écrites lors de la période définie
-                self._delete_by_ID('mandate', item['id'])
-
-        self.update_institutions(institutions)
-
-    """
-    ---- ARCHIVES ----
-    """
-
-    def _add_archive(self, archive: Archive):
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Ajoute une archive d'une action (élection, promotion, ou rétrogradation) dans la base de données.
-
-        ## Paramètres
-        - archive: `.Archive`\n
-            Archive à ajouter
-        """
-
-        return # Provisoire
-
-        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._put_in_db('archives', _data)
-        self._put_in_db('mandate', _data) # Ajouter les archives à celle du mandat actuel
-
-    def _get_archive(self, id: NSID) -> Archive | Election | Promotion | Demotion:
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Récupère une archive spécifique.
-
-        ## Paramètres
-        id: `NSID`\n
-            ID de l'archive.
-
-        ## Renvoie
-        - `.Archive | .Election | .Promotion | .Demotion`
-        """
-
-        return Archive(NSID(id)) # Provisoire
-
-        id = NSID(id)
-        _data = self._get_by_ID('archives', id)
-
-        if _data is None:
-            return None
-
-        if _data['_type'] == "election":
-            archive = Election(_data['author'], _data['target'], _data['details']['position'])
-        elif _data['_type'] == "promotion":
-            archive = Promotion(_data['author'], _data['target'], _data['details']['position'])
-        elif _data['_type'] == "demotion":
-            archive = Demotion(_data['author'], _data['target'])
-        else:
-            archive = Archive(_data['author'], _data['target'])
-
-        archive.id = id
-        archive.action = _data['action']
-        archive.date = _data['date']
-        archive.details = _data['details']
-
-        return archive
-
-    def _fetch_archives(self, **query) -> list[ Archive | Election | Promotion | Demotion ]:
-        """
-        *INDISPONIBLE DANS CETTE VERSION.*\n
-        Récupère une liste d'archives correspondant à la requête.
-
-        ## Paramètres
-        query: `dict`\n
-            Requête pour filtrer les archives.
-
-        ## Renvoie
-        - `list[.Archive | .Election | .Promotion | .Demotion]`
-        """
-
-        return [] # Provisoire
-
-        _res = self.fetch('archives', **query)
-        
-        return [ self._get_archive(archive['id']) for archive in _res ]

nsarchive-3.0.0a6.dist-info/RECORD

@@ -1,15 +0,0 @@
-nsarchive/__init__.py,sha256=mGEv74tD1yb0EB42ZYXfiJWX_FxE6raf8LH0lJLDkNk,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=HcfKydEMqmLkBvoIY2DRGK0PO_6ic5WK826VHaUwyjI,14428
-nsarchive/cls/republic.py,sha256=16NFNCkJxOeVRd6BoJ68AlrTESQgRfZ5FSFlNWTEdK0,4103
-nsarchive/instances/_economy.py,sha256=vMK8nRBHjLWmAmTu1f3XkWimFUk8tuV3P9KIuKRdNpw,9596
-nsarchive/instances/_entities.py,sha256=pYNoGyYg-I6QDtY3swFb2_rNm2FemG2S5ouYkZLidLE,9327
-nsarchive/instances/_republic.py,sha256=M8k2rZJvQGzOyZlmqRDiB-d615hZOqD3kuRrgYP4JqA,12004
-nsarchive/utils.py,sha256=L37Dm8aO0Sm3FDLPf2tP6fo-1lodDq7JIz-WXttNuJg,684
-nsarchive-3.0.0a6.dist-info/LICENSE,sha256=aFLFZg6LEJFpTlNQ8su3__jw4GfV-xWBmC1cePkKZVw,35802
-nsarchive-3.0.0a6.dist-info/METADATA,sha256=XiRacmzL8zP5XMgUMTzWRG8nZoAF5mma6LGzmW6rrlI,695
-nsarchive-3.0.0a6.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-nsarchive-3.0.0a6.dist-info/RECORD,,