Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/younesaassila/kwyk-solver

Un outil open source pour résoudre vos devoirs Kwyk.
https://github.com/younesaassila/kwyk-solver

kwyk python solver

Last synced: 3 months ago
JSON representation

Un outil open source pour résoudre vos devoirs Kwyk.

Awesome Lists containing this project

README 

        
# Kwyk Solver



Kwyk Solver est un solveur d'exercices pour le [site web Kwyk.fr](https://www.kwyk.fr/).



Cet outil vous aide à résoudre vos devoirs Kwyk. N'hésitez pas à le partager à vos camarades !



Ce solveur est écrit en Python 3.10 et supporte Windows et macOS.



Nous encourageons ses utilisateurs à ajouter le support d'exercices pour rendre le programme plus complet (voir la section ci-dessous).



## Captures d'écran



![Écran d'accueil](https://i.imgur.com/xFdwE7C.png)



![Exemple de résolution d'un exercice](https://i.imgur.com/NOYBdJq.png)



## Contribuer au projet



Ce projet accueille à bras ouverts les contributions de ses utilisateurs. Si vous souhaitez rapporter un bug, suggérer une nouvelle fonctionnalité ou ajouter le support d'un exercice, vous êtes le bienvenu !



Pour plus d'informations, veuillez lire les fichiers [CODE_OF_CONDUCT.md](https://github.com/younesaassila/kwyk-solver/blob/main/CODE_OF_CONDUCT.md) et [CONTRIBUTING.md](https://github.com/younesaassila/kwyk-solver/blob/main/CONTRIBUTING.md).



## Installation de Kwyk Solver



### Téléchargement du programme



Rendez-vous dans l'onglet "Releases" de cette page de projet et téléchargez la version la plus récente.



Celle-ci se présentera sous la forme d'un dossier compressé d'extension `.zip`.



Une fois téléchargé, pensez à décompresser le dossier ZIP.



### Installation de Python



Assurez-vous d'avoir installé au préalable Python 3.10 ou ultérieur. Si ce n'est pas encore le cas, rendez-vous sur le [site web officiel de Python](https://www.python.org/downloads/) et téléchargez la version la plus récente correspondant à votre système d'exploitation.



Lors de l'installation sur Windows, assurez-vous de cocher la case "Add Python 3.10 to PATH" sur la première page de l'installeur.



Une fois cette première terminée, ouvrez l'invite de commandes Windows (`cmd.exe`) ou le PowerShell. Sur macOS, ouvrez l'application Terminal.



Tapez la commande suivante :



- Windows : `py --version`



- macOS : `python3 --version`



Si celle-ci vous retourne un numéro de version, comme par exemple `Python 3.10`, Python s'est installé avec succès et vous pouvez continuer la procédure. Si vous obtenez une erreur ou un autre message, n'hésitez pas à demander de l'aide en vous rendant dans l'onglet "Issues" de cette page de projet.



### Installation des modules requis au fonctionnement du programme



#### Méthode 1



Si vous êtes sur macOS, passez à la deuxième méthode.



Sur Windows, rendez-vous dans le dossier contenant les fichiers du programme et exécutez le fichier nommé `Installer Kwyk Solver.cmd`.



Si celui-ci vous indique que les modules complémentaires requis se sont correctement installés ou étaient déjà installés, vous pouvez continuer la suite de la procédure. Autrement, essayez la méthode 2.



#### Méthode 2



Sur Windows, ouvrez l'invite de commandes (`cmd.exe`) ou le PowerShell.



Sur macOS, ouvrez l'application Terminal.



Tapez les commandes suivantes :



- Windows :



```text

py -m pip install --upgrade pip

py -m pip install numpy

py -m pip install requests

py -m pip install scipy

```



- macOS :



```text

python3 -m pip install --upgrade pip

python3 -m pip install numpy

python3 -m pip install requests

python3 -m pip install scipy

```



Si vous n'arrivez toujours pas à installer les modules complémentaires requis au fonctionnement du programme, demandez de l'aide dans l'onglet "Issues" de cette page de projet.



## Lancement du programme



Sur Windows, exécutez le fichier nommé `Démarrer Kwyk Solver`.



Sur macOS, ouvrez le fichier `main.py` situé dans le répertoire `solvers` avec l'application PythonLauncher.



## Utilisation du programme



Le programme vous propose une liste d'exercices pour lesquels des solveurs ont été écrits.



Tapez simplement le numéro de l'exercice que vous souhaitez résoudre et suivez les instructions à l'écran.



## Mise à jour du programme



Lorsqu'une mise à jour est disponible, le programme vous en avertira et vous proposera de la télécharger et de l'installer. Vous pouvez refuser la procédure en appuyant sur la touche `Entrée` ou l'accepter en appuyant sur la touche `o` puis `Entrée`.