.gitignore

@@ -0,0 +1,3 @@
+.env
+
+*.pyc

README.md

@@ -1,4 +1,23 @@
-# TRANSCENDENCE
-The last project of the 42 common core
+# Python lib
+A python lib to interract with the api more easier
 
-# adrien est une merde
+## Installation
+
+- Clone the project:
+``` bash
+git clone https://git.chauvet.pro/michel/ft_transcendence
+cd ft_transcendence
+git switch python-api
+```
+- Create python virtual environnement.
+``` bash
+python3 -m venv .env
+```
+- Source the environnement.
+``` bash
+source .env/bin/activate
+```
+- Install the requirements
+``` bash
+pip install -r requirements.txt
+```

requirements.txt

@@ -0,0 +1,5 @@
+certifi==2023.7.22
+charset-normalizer==3.3.2
+idna==3.4
+requests==2.31.0
+urllib3==2.0.7

setup.py

@@ -0,0 +1,3 @@
+from setuptools import setup, find_packages
+
+setup(name='transcendence_api', version='1.0', packages=find_packages())

src/accounts.py

@@ -0,0 +1,18 @@
+from src import urls
+
+from requests import Response
+
+
+class Accounts:
+    
+    def __init__(self, client):
+        self._client = client
+    
+    def create(self, username: str, password: str):
+        response: Response = self._client._post(urls.accounts_register, {'username': username, 'password': password})
+        return response.content
+    
+    def delete(self):
+        assert self._client.is_authentificate
+        response: Response = self._client._post(urls.accounts_delete, {})
+        return response.content

src/client.py

@@ -0,0 +1,38 @@
+import requests
+from requests import Response, Request, Session
+
+from src.profiles import Profiles
+from src.accounts import Accounts
+from src import urls
+
+class Client:
+    def __init__(self, url: str):
+        self.url: str = url
+        self.token: str = None
+        self.csrf_token: str = None
+        self.session: Session = Session()
+        self.accounts: Accounts = Accounts(self)
+        self.profiles: Profiles = Profiles(self)
+    
+    def is_authentificate(self):
+        return (self.token is not None)
+    
+    def login(self, username: str, password: str):
+        response: Response = self._post(urls.accounts_login, {'username': username, 'password': password})
+        return response.content
+    
+    def _post(self, uri: str, data: dict = {}):
+        url: str = self.url + uri
+        if self.csrf_token is None:
+            response: Response = self.session.get(url)
+            self.csrf_token = response.cookies.get('csrftoken')
+        data.update({'csrfmiddlewaretoken': self.csrf_token})
+        response: Response = self.session.post(url, data = data, headers = dict(Referer=url))
+        self.csrf_token = response.cookies.get('csrftoken')
+        return response
+    
+    def _get(self, uri: str):
+        url: str = self.url + uri
+        response: Response = self.session.get(url)
+        self.csrf_token = response.cookies.get('csrftoken')
+        return response

src/profile.py

@@ -0,0 +1,27 @@
+
+
+class Profile:
+    
+    def __init__(self, data: dict = None, username: str = None, title: str = None):
+        
+        if (data is None):
+            self._from_value(username, title)
+        else:
+            self._from_dict(data)
+        
+    def _from_value(self, username: str, title: str):
+        self.username = username
+        self.title = title
+        return self
+    
+    def _from_dict(self, data: dict):
+        self._from_value(data.get('username'), data.get('title'))
+        return self
+    
+    def __eq__(self, other):
+        if isinstance(other, Profile):
+            return self.username == other.username and self.title == other.title
+        return False
+    
+    def __ne__(self, other):
+        return not self.__eq__(other)

src/profiles.py

@@ -0,0 +1,18 @@
+from src import urls
+
+from src.profile import Profile
+
+
+from requests import Response
+
+class Profiles:
+    
+    def __init__(self, client):
+        self.client = client
+    
+    def get(self, user_id: int):
+        response: Response = self.client._get(urls.profiles_page + str(user_id))
+        if response.status_code == 404:
+            return None
+        content: dict = eval(response.content)
+        return Profile(data = content)

src/urls.py

@@ -0,0 +1,9 @@
+api: str = "api/"
+
+accounts: str = api + "accounts/"
+accounts_login: str = accounts + "login"
+accounts_delete: str = accounts + "delete"
+accounts_register: str = accounts + "register"
+
+profiles: str = api + "profiles/"
+profiles_page: str = profiles

tests/accounts.py

@@ -0,0 +1,35 @@
+from uuid import uuid4
+
+from tests.utils import test
+
+def test_accounts_register(client, username, password):
+    print ("REGISTER")
+
+    test(client.accounts.create, (username, password), b'ok: user added', 'normal', None)
+
+    print()
+
+def test_accounts_login(client, username, password):
+    
+    print ("LOGIN")
+    
+    test(client.login, (username, password), b'ok: account valid', "normal", None)
+    
+    print()
+
+def test_accounts_delete(client):
+    
+    print ("DELETE")
+    
+    test(client.accounts.delete, (), b'ok: account has been deleted', 'normal')
+    
+    print()
+
+def test_accounts(client):
+    
+    username = uuid4()
+    password = uuid4()
+    
+    test_accounts_register(client, username, password)
+    test_accounts_login(client, username, password)
+    test_accounts_delete(client)

tests/profiles.py

@@ -0,0 +1,19 @@
+import os
+import sys
+sys.path.append(os.path.join(os.path.dirname(__file__), '..'))  # Add parent directory to system path
+
+from tests.utils import test
+
+from src.profile import Profile
+
+def test_profiles_get(client):
+    
+    print ("GET")
+    
+    test(client.profiles.get, (1, ), Profile(username="997e13f5-474d-4fea-b55a-ad8a27b9534b", title=""), "normal")
+    
+    print()
+
+def test_profiles(client):
+    
+    test_profiles_get(client)

tests/test.py

@@ -0,0 +1,22 @@
+import os
+import sys
+sys.path.append(os.path.join(os.path.dirname(__file__), '..'))  # Add parent directory to system path
+
+from src.client import Client
+from src import urls
+
+from tests.accounts import test_accounts
+from tests.profiles import test_profiles
+
+def tests():
+        
+    client = Client("http://0.0.0.0:8000/")
+
+    print("ACCOUNTS".center(os.get_terminal_size()[0], '-'))    
+    test_accounts(client)
+       
+    print("PROFILES".center(os.get_terminal_size()[0], '-'))    
+    test_profiles(client)
+
+if __name__ == "__main__":
+    tests()

tests/utils.py

@@ -0,0 +1,10 @@
+def test(func: callable,  params, expected_value, title: str, description = None):
+    print(title, end=" ")
+    value = func(*params)
+    if (value == expected_value):
+        print("[OK]")
+        return
+    print ("[ERROR]")
+    print ("expected", expected_value, ", got", value)
+    if not description is None:
+        print (description)