Skip to content

younesaassila/kwyk-solver

Repository files navigation

Kwyk Solver

Kwyk Solver est un solveur d'exercices pour le site web 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

Exemple de résolution d'un exercice

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 et 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 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 :
py -m pip install --upgrade pip
py -m pip install numpy
py -m pip install requests
py -m pip install scipy
  • macOS :
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.