odysseeapi 0.2.0__tar.gz → 1.0.0__tar.gz

{odysseeapi-0.2.0 → odysseeapi-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: odysseeapi
-Version: 0.2.0
+Version: 1.0.0
 Summary: Unofficial Python API for Odyssee
 Author-email: Géry Casiez <gery.casiez@univ-lille.fr>
 Project-URL: Repository, https://github.com/casiez/OdysseeAPI
@@ -17,7 +17,7 @@ Provides an unofficial API for the [Odyssee platform](https://odyssee.enseigneme
 
 ## Features
 
-- download applications of candidates
+- download applications of candidates as zip files
 - get information about candidates
 - get information about committee members
 - get information about institutions
@@ -32,34 +32,21 @@ Provides an unofficial API for the [Odyssee platform](https://odyssee.enseigneme
 pip install odysseeapi
 ```
 
-## Getting the authentication token
-1. Go to the [Odyssee platform](https://odyssee.enseignementsup-recherche.gouv.fr/) using Chrome
-1. Open the developer tools (F12 or right-click and select "Inspect")
-1. Go to the "Network" tab
-1. Refresh the page
-1. Look for a request 
-    - Click on the request and go to the "Headers" tab
-    - Look for the "Authorization" header and copy its value (it should start with "Bearer")
-1. Copy the token and use it in your code to authenticate with the API
-
-Note that the authentication uses both cookies and a bearer token, so you need to provide both to access the API.
-The API automatically handles the cookie (using [browsercookie](https://pypi.org/project/browsercookie/)), so you only need to provide the bearer token.
-
-Note that the token is valid for a limited time, so you may need to repeat this process periodically to obtain a new token.
-
-![image](bearer.png)
-
 ## Minimal example
 
 ```python
-from odysseeapi.Odyssee import Odyssee
+from odysseeapi.OdysseeCOS import OdysseeCOS
 
 numposte = "123456"
-token = """eyJhbGciOiJSUzI1N... (token value) ..."""
+username = "xyz"
+password = "abc"
 
-# Initialize the API client with the numposte, token and use_cache set to True
+# Initialize the API client with the numposte and use_cache set to True
 # setting use_cache to False forces the API client to fetch fresh data from the server for each request, while setting it to True allows the client to use cached data if available
-odyssee = Odyssee(numposte, token, True)
+odyssee = OdysseeCOS(numposte, True)
+
+# The following line is used to authenticate the user and obtain the necessary cookies and bearer token for subsequent API calls. It is optional when using the cached data
+odyssee.authenticate(username, password)
 
 # Download the applications of the candidates in the specified directory
 odyssee.download_applications('dossiers_candidats')
@@ -79,11 +66,11 @@ print(keywords)
 candidates_with_details = odyssee.get_candidates_with_details()
 print(candidates_with_details)
 
-# odyssee.assign_jury_members_to_candidate("f1e2d3c4-b5a6-4789-9876-543210fedcba", "98765432-10fe-dcba-9876-543210fedcba", "abcd1234-5678-90ef-ghij-klmnopqrstuv")
+# odyssee.assign_jury_members_to_candidate("f1e2d3c4-b5a6-4789-9876-543210fedcba", "123456", "78910")
 
 # Download the reports of the committee members for the candidates in the specified directory
-odyssee.downloadReports("rapports_odyssee")
+# odyssee.downloadReports("rapportsOdyssee")
 
-# A l'issue de la première réunion du jury, enregistrer l'avis pour chaque candidat et les résultats du vote
+# At the end of the first jury meeting, record the opinion for each candidate and the results of the vote
 # odyssee.opinion_for_interview("f1e2d3c4-b5a6-4789-9876-543210fedcba", "A", "Motif audition", 16, 16, 0, 0, 16, 0)
 ```

{odysseeapi-0.2.0 → odysseeapi-1.0.0}/Readme.md

@@ -7,7 +7,7 @@ Provides an unofficial API for the [Odyssee platform](https://odyssee.enseigneme
 
 ## Features
 
-- download applications of candidates
+- download applications of candidates as zip files
 - get information about candidates
 - get information about committee members
 - get information about institutions
@@ -22,34 +22,21 @@ Provides an unofficial API for the [Odyssee platform](https://odyssee.enseigneme
 pip install odysseeapi
 ```
 
-## Getting the authentication token
-1. Go to the [Odyssee platform](https://odyssee.enseignementsup-recherche.gouv.fr/) using Chrome
-1. Open the developer tools (F12 or right-click and select "Inspect")
-1. Go to the "Network" tab
-1. Refresh the page
-1. Look for a request 
-    - Click on the request and go to the "Headers" tab
-    - Look for the "Authorization" header and copy its value (it should start with "Bearer")
-1. Copy the token and use it in your code to authenticate with the API
-
-Note that the authentication uses both cookies and a bearer token, so you need to provide both to access the API.
-The API automatically handles the cookie (using [browsercookie](https://pypi.org/project/browsercookie/)), so you only need to provide the bearer token.
-
-Note that the token is valid for a limited time, so you may need to repeat this process periodically to obtain a new token.
-
-![image](bearer.png)
-
 ## Minimal example
 
 ```python
-from odysseeapi.Odyssee import Odyssee
+from odysseeapi.OdysseeCOS import OdysseeCOS
 
 numposte = "123456"
-token = """eyJhbGciOiJSUzI1N... (token value) ..."""
+username = "xyz"
+password = "abc"
 
-# Initialize the API client with the numposte, token and use_cache set to True
+# Initialize the API client with the numposte and use_cache set to True
 # setting use_cache to False forces the API client to fetch fresh data from the server for each request, while setting it to True allows the client to use cached data if available
-odyssee = Odyssee(numposte, token, True)
+odyssee = OdysseeCOS(numposte, True)
+
+# The following line is used to authenticate the user and obtain the necessary cookies and bearer token for subsequent API calls. It is optional when using the cached data
+odyssee.authenticate(username, password)
 
 # Download the applications of the candidates in the specified directory
 odyssee.download_applications('dossiers_candidats')
@@ -69,11 +56,11 @@ print(keywords)
 candidates_with_details = odyssee.get_candidates_with_details()
 print(candidates_with_details)
 
-# odyssee.assign_jury_members_to_candidate("f1e2d3c4-b5a6-4789-9876-543210fedcba", "98765432-10fe-dcba-9876-543210fedcba", "abcd1234-5678-90ef-ghij-klmnopqrstuv")
+# odyssee.assign_jury_members_to_candidate("f1e2d3c4-b5a6-4789-9876-543210fedcba", "123456", "78910")
 
 # Download the reports of the committee members for the candidates in the specified directory
-odyssee.downloadReports("rapports_odyssee")
+# odyssee.downloadReports("rapportsOdyssee")
 
-# A l'issue de la première réunion du jury, enregistrer l'avis pour chaque candidat et les résultats du vote
+# At the end of the first jury meeting, record the opinion for each candidate and the results of the vote
 # odyssee.opinion_for_interview("f1e2d3c4-b5a6-4789-9876-543210fedcba", "A", "Motif audition", 16, 16, 0, 0, 16, 0)
 ```

odysseeapi-1.0.0/odysseeapi/Odyssee.py

@@ -0,0 +1,79 @@
+# -*- coding: utf-8 -*-
+#
+# Odyssee.py -
+#
+# Authors: 
+# Géry Casiez https://gery.casiez.net
+#
+# 2026
+# 
+# BSD License https://opensource.org/licenses/BSD-3-Clause
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+#  1. Redistributions of source code must retain the above copyright notice, this list of conditions
+# and the following disclaimer.
+#
+# 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions
+# and the following disclaimer in the documentation and/or other materials provided with the distribution.
+# 
+# 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or
+# promote products derived from this software without specific prior written permission.
+
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, 
+# INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+
+from playwright.sync_api import expect, sync_playwright
+import requests
+import re
+
+# This class provides the basic functionality for authentication and API calls, but does not implement any specific API calls. 
+
+
+class Odyssee(object):
+    def __init__(self):
+        """
+        Initialize the Odyssee class.
+        """
+
+        self.base_url = "https://odyssee.enseignementsup-recherche.gouv.fr/gateway/"
+        self.s = requests.session()
+        self.headers = None
+        self.cookies = None
+
+    def authenticate(self, username, password):
+        playwright = sync_playwright().start()
+
+        browser = playwright.chromium.launch()
+        page = browser.new_page()
+
+        def log_response(response):
+            if response.status == 200:
+                if re.search(r"account/?$", response.url):
+                    self.headers = {"Authorization": f"{response.request.headers['authorization']}"}
+
+        page.on("response", log_response)
+
+        page.goto("https://odyssee.enseignementsup-recherche.gouv.fr/accueil/")
+        expect(page).to_have_title(re.compile("Me connecter"))
+
+        # fill is username and password
+        page.fill('input[name="username"]', username)
+        page.fill('input[name="password"]', password)
+
+        # click the submit button
+        page.click('button[type="submit"]')
+        expect(page).to_have_title(re.compile("Bienvenue"))
+
+        # get the cookies
+        self.cookies = {cookie["name"]: cookie["value"] for cookie in page.context.cookies()}
+
+        browser.close()
+        playwright.stop()

odysseeapi-0.2.0/odysseeapi/Odyssee.py → odysseeapi-1.0.0/odysseeapi/OdysseeCOS.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 #
-# Odyssee.py -
+# OdysseeCOS.py -
 #
 # Authors: 
 # Géry Casiez https://gery.casiez.net
@@ -30,24 +30,19 @@
 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 #
 
-import requests
-import browsercookie
+from .Odyssee import Odyssee
 import json
 import tqdm
 import os
 
-class Odyssee(object):
-    def __init__(self, numposte, bearer_token, use_cache=True):
+class OdysseeCOS(Odyssee):
+    def __init__(self, numposte, use_cache=True):
         """Initialize the Odyssee class.
         numposte: the numposte to use for the API calls
-        bearer_token: the bearer token to use for the API calls
         use_cache: whether to use caching for API responses (default: True)"""
 
+        super().__init__()
         self.numposte = numposte
-        self.base_url = "https://odyssee.enseignementsup-recherche.gouv.fr/gateway/"
-        self.s = requests.session()
-        self.headers = {"Authorization": f"Bearer {bearer_token}"}
-        self.cookies = browsercookie.chrome()
         self.candidatures = None
         self.rapporteurs = None
         self.etablissements = None

{odysseeapi-0.2.0 → odysseeapi-1.0.0}/odysseeapi.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: odysseeapi
-Version: 0.2.0
+Version: 1.0.0
 Summary: Unofficial Python API for Odyssee
 Author-email: Géry Casiez <gery.casiez@univ-lille.fr>
 Project-URL: Repository, https://github.com/casiez/OdysseeAPI
@@ -17,7 +17,7 @@ Provides an unofficial API for the [Odyssee platform](https://odyssee.enseigneme
 
 ## Features
 
-- download applications of candidates
+- download applications of candidates as zip files
 - get information about candidates
 - get information about committee members
 - get information about institutions
@@ -32,34 +32,21 @@ Provides an unofficial API for the [Odyssee platform](https://odyssee.enseigneme
 pip install odysseeapi
 ```
 
-## Getting the authentication token
-1. Go to the [Odyssee platform](https://odyssee.enseignementsup-recherche.gouv.fr/) using Chrome
-1. Open the developer tools (F12 or right-click and select "Inspect")
-1. Go to the "Network" tab
-1. Refresh the page
-1. Look for a request 
-    - Click on the request and go to the "Headers" tab
-    - Look for the "Authorization" header and copy its value (it should start with "Bearer")
-1. Copy the token and use it in your code to authenticate with the API
-
-Note that the authentication uses both cookies and a bearer token, so you need to provide both to access the API.
-The API automatically handles the cookie (using [browsercookie](https://pypi.org/project/browsercookie/)), so you only need to provide the bearer token.
-
-Note that the token is valid for a limited time, so you may need to repeat this process periodically to obtain a new token.
-
-![image](bearer.png)
-
 ## Minimal example
 
 ```python
-from odysseeapi.Odyssee import Odyssee
+from odysseeapi.OdysseeCOS import OdysseeCOS
 
 numposte = "123456"
-token = """eyJhbGciOiJSUzI1N... (token value) ..."""
+username = "xyz"
+password = "abc"
 
-# Initialize the API client with the numposte, token and use_cache set to True
+# Initialize the API client with the numposte and use_cache set to True
 # setting use_cache to False forces the API client to fetch fresh data from the server for each request, while setting it to True allows the client to use cached data if available
-odyssee = Odyssee(numposte, token, True)
+odyssee = OdysseeCOS(numposte, True)
+
+# The following line is used to authenticate the user and obtain the necessary cookies and bearer token for subsequent API calls. It is optional when using the cached data
+odyssee.authenticate(username, password)
 
 # Download the applications of the candidates in the specified directory
 odyssee.download_applications('dossiers_candidats')
@@ -79,11 +66,11 @@ print(keywords)
 candidates_with_details = odyssee.get_candidates_with_details()
 print(candidates_with_details)
 
-# odyssee.assign_jury_members_to_candidate("f1e2d3c4-b5a6-4789-9876-543210fedcba", "98765432-10fe-dcba-9876-543210fedcba", "abcd1234-5678-90ef-ghij-klmnopqrstuv")
+# odyssee.assign_jury_members_to_candidate("f1e2d3c4-b5a6-4789-9876-543210fedcba", "123456", "78910")
 
 # Download the reports of the committee members for the candidates in the specified directory
-odyssee.downloadReports("rapports_odyssee")
+# odyssee.downloadReports("rapportsOdyssee")
 
-# A l'issue de la première réunion du jury, enregistrer l'avis pour chaque candidat et les résultats du vote
+# At the end of the first jury meeting, record the opinion for each candidate and the results of the vote
 # odyssee.opinion_for_interview("f1e2d3c4-b5a6-4789-9876-543210fedcba", "A", "Motif audition", 16, 16, 0, 0, 16, 0)
 ```

{odysseeapi-0.2.0 → odysseeapi-1.0.0}/odysseeapi.egg-info/SOURCES.txt

@@ -1,6 +1,7 @@
 Readme.md
 pyproject.toml
 odysseeapi/Odyssee.py
+odysseeapi/OdysseeCOS.py
 odysseeapi/__init__.py
 odysseeapi.egg-info/PKG-INFO
 odysseeapi.egg-info/SOURCES.txt

{odysseeapi-0.2.0 → odysseeapi-1.0.0}/pyproject.toml

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["setuptools >= 61.0", "requests", "browsercookie", "tqdm"]
+requires = ["setuptools >= 61.0", "requests", "playwright", "tqdm"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "odysseeapi"
-version = "0.2.0"
+version = "1.0.0"
 authors = [
   {name = "Géry Casiez", email = "gery.casiez@univ-lille.fr"},
 ]