Setup tp1

.gitlab-ci.yml

@@ -3,8 +3,6 @@ image: python:3.10
 stages:
   - dependencies
   - lint
-  - test
-  - deploy
 
 download_dependencies:
   stage: dependencies
@@ -21,33 +19,8 @@ pylint:
   stage: lint
   dependencies:
     - download_dependencies
-  needs:
-    - download_dependencies
   before_script:
     - source .venv/bin/activate
-    - pip install pylint
   script:
-    - pylint calculator --fail-on=error
-
-pytest:
-  stage: test
-  dependencies:
-    - download_dependencies
-  needs:
-    - download_dependencies
-  before_script:
-    - source .venv/bin/activate
-  script:
-    - pytest calculator
-
-# deploy:
-#   stage: deploy
-#   needs:
-#     - pylint
-#     - pytest
-#   before_script:
-#     - apt-get update
-#     - apt-get install -y openssh-client sshpass
-#   script:
-#     - sshpass -p viazero ssh -o StrictHostKeyChecking=no viazero@<ip-de-ma-vm>
-#       "cd /var/www/cicd && git pull && sudo systemctl restart calculator"
+    # C'est à ton tour de coder un script qui lance pylint sur ton projet
+    -

README.md

 # CICD 2022
 
-Bienvenue à cette fabuleuse formation.
+## TP1
 
-Je t'invite à forker le repo et à cloner ton fork sur ta machine.
+Pour lancer l'application python:
 
-## Le sujet du tp
+```bash
+pip install -r requirements.txt
+uvicorn calculator.server:app --reload
+```
 
-Le sujet du tp est de proprifier et tester le code d'une calculatrice en ligne. Une simple page web où on peut entrer une expression mathématique et qui nous donne le résultat.
+## Le Linting
 
-## Pour commencer les tps
+Lorsqu'on travaille en équipe, c'est souvent pratique de garder un code propre. Pour cela, on utilise des outils de linting. Ces outils vont vérifier que le code respecte certaines règles de style. Par exemple, on peut vérifier que les variables sont nommées en snake_case, que les fonctions sont nommées en camelCase, que les fonctions ne font pas plus de 10 lignes, etc.
 
-Les branches `tp1`, `tp2`, `tp3` contiennent les fichiers de base pour chaque tp.
-La correction sont dans les branches `tp1-correction`, `tp2-correction`.
+Un outil qui permet de vérifier le linting de nos application python, c'est pylint. Pour l'installer, on peut utiliser pip:
+
+```bash
+pip install pylint
+```
+
+Pour lancer pylint, on peut utiliser la commande suivante:
+
+```bash
+pylint calculator
+```
+
+Une option intéressante de pylint est le `--fail-on=warning`. Cette option permet de renvoyer une erreur si pylint détecte une erreur. On peut donc l'ajouter à la commande précédente:
+
+```bash
+
+Alors on pourrait fixer les erreurs maintenant, mais on va d'abord vérifier une pipeline avec GitLab.

calculator/expression.py

 """
 Expression module defines the structure of an expression.
 """
-from typing import Union
 from calculator.operators import Operator
-
+from typing import Union
 
 Term: type = int
 Token: type = Union[Operator, Term]
@@ -13,7 +12,6 @@ class OperatorExpression:
     """
     OperatorExpression class is an expression that contains an operator and two sub-expressions.
     """
-
     def __init__(self, operator: Operator, left, right):
         self.operator = operator
         self.left = left
@@ -30,7 +28,6 @@ class TermExpression:
     """
     TermExpression class is an expression that contains a single term.
     """
-
     def __init__(self, value: Term):
         self.value = value
 

calculator/operators.py

@@ -5,7 +5,6 @@ class Operator:
     """
     Operator class is a binary operator with a symbol, a precedence and an evaluation function.
     """
-
     def __init__(self, symbol, precedence, evaluate_function):
       self.symbol = symbol
       self.precedence = precedence
@@ -18,9 +17,4 @@ class Operator:
         return self.evaluate_function(left, right)
 
 
-STANDARD_OPERATORS = {
-    '+': Operator('+', 1, lambda a, b: a + b),
-    '-': Operator('-', 1, lambda a, b: a - b),
-    '*': Operator('×', 2, lambda a, b: a * b),
-    '/': Operator('/', 2, lambda a, b: a / b),
-}
+STANDARD_OPERATORS = { '+': Operator('+', 1, lambda a, b: a + b),'-': Operator('-', 1, lambda a, b: a - b),'*': Operator('×', 2, lambda a, b: a * b),'/': Operator('/', 2, lambda a, b: a / b)}

calculator/server.py

-"""
-Server module for the web calculator.
-"""
+from calculator.calculator import Calculator
 from fastapi import FastAPI
 from fastapi.requests import Request
 from fastapi.templating import Jinja2Templates
-from calculator.calculator import Calculator
 
 app = FastAPI()
 templates = Jinja2Templates(directory="calculator/templates")

calculator/test_calculator.py

-"""
-Test module for the calculator module.
-"""
-import pytest
-from calculator.calculator import Calculator
-from calculator.operators import Operator
-
-
-@pytest.fixture(scope="module", name="setup")
-def fixture_setup():
-    """
-    Setup the test suite, by instantiating the calculator and the operators.
-    """
-    plus = Operator('+', 1, lambda a, b: a + b)
-    minus = Operator('-', 1, lambda a, b: a - b)
-    times = Operator('*', 2, lambda a, b: a * b)
-    divide = Operator('/', 2, lambda a, b: a / b)
-    calculator = Calculator(
-        operators={'+': plus, '-': minus, '*': times, '/': divide})
-    yield plus, minus, times, divide, calculator
-
-
-def test_tokenizer(setup):
-    """
-    Test the tokenizer.
-    """
-    plus, minus, times, divide, calc = setup
-    assert calc.tokenize("1 + 2") == [1, plus, 2]
-    assert calc.tokenize("1 + 2 * 3") == [1, plus, 2, times, 3]
-    assert calc.tokenize(
-        "1 + 2 * 3 / 4") == [1, plus, 2, times, 3, divide, 4]
-    assert calc.tokenize(
-        "1 + 2 * 3 / 4 - 5") == [1, plus, 2, times, 3, divide, 4, minus, 5]
-
-
-def test_parser(setup):
-    """
-    Test the parser.
-    """
-    _, _, _, _, calc = setup
-    assert repr(calc.parse(calc.tokenize("1 + 2"))) == '(1 + 2)'
-    assert repr(calc.parse(calc.tokenize("1 + 2 * 3"))
-                ) == '(1 + (2 * 3))'
-    assert repr(calc.parse(calc.tokenize(
-        "1 + 2 * 3 / 4"))) == '(1 + ((2 * 3) / 4))'
-    assert repr(calc.parse(calc.tokenize(
-        "1 + 2 * 3 / 4 - 5"))) == '((1 + ((2 * 3) / 4)) - 5)'
-
-
-def test_evaluation(setup):
-    """
-    Test the evaluation.
-    """
-    _, _, _, _, calc = setup
-    assert calc("1 + 2") == 3
-    assert calc("1 + 2 * 3") == 7
-    assert calc("1 + 2 * 3 / 4") == 2.5
-    assert calc("1 + 2 * 3 / 4 - 5") == -2.5

calculator/test_expression.py

-"""
-Test module for expression module.
-"""
-from calculator.expression import TermExpression, OperatorExpression
-from calculator.operators import Operator
-
-def test_single_term():
-    """
-    Test the TermExpression class.
-    """
-    expression = TermExpression(42)
-    assert repr(expression) == '42'
-    assert expression() == 42
-
-
-def test_single_operator():
-    """
-    Test the OperatorExpression class.
-    """
-    add = Operator('+', 1, lambda a, b: a + b)
-    expression = OperatorExpression(add, TermExpression(1), TermExpression(2))
-    assert repr(expression) == '(1 + 2)'
-    assert expression() == 3
-
-
-def test_complex_expression():
-    """
-    Test a complex expression.
-    """
-    add = Operator('+', 1, lambda a, b: a + b)
-    multiply = Operator('*', 2, lambda a, b: a * b)
-    expression = OperatorExpression(
-        multiply,
-        OperatorExpression(add, TermExpression(1), TermExpression(2)),
-        TermExpression(3)
-    )
-    assert repr(expression) == '((1 + 2) * 3)'
-    assert expression() == 9

calculator/test_operators.py

-"""
-Test module for the operator module.
-"""
-from calculator.operators import Operator
-
-
-def test_operator():
-    """
-    Test the Operator class.
-    """
-    modulo = Operator('%', 1, lambda a, b: a % b)
-    assert repr(modulo) == '%'
-    assert modulo(15, 4) == 3

deploy/calculator.service

-Description=CiCd.
-After=network.target
-StartLimitIntervalSec=0
-
-[Service]
-Type=simple
-ExecStart=python3 -m uvicorn calculator.server:app --port 80 --host 0.0.0.0
-User=root
-WorkingDirectory=/var/www/cicd
-
-[Install]
-WantedBy=multi-user.target

deploy/setup.md

-# Setup la vm pour notre calculatrice
-
-## Clone le repo
-
-```bash
-mkdir -p /var/www
-cd /var/www
-git clone https://gitlab.viarezo.fr/<login>/cicd.git
-```
-
-## Installe les dépendances
-
-```bash
-cd cicd
-pip install -r requirements.txt
-```
-
-## Ajoute le service
-
-Un service c'est une application qui tourne en tâche de fond sur la machine. On va créer un service pour notre application. Un service est un fichier qui se trouve dans `/etc/systemd/system/` et qui s'appelle `quelquechose.service`. On a déjà crée le fichier pour vous, vous n'avez plus qu'à le copier dans le bon dossier.
-
-```bash
-sudo cp deploy/calculator.service /etc/systemd/system/
-sudo systemctl daemon-reload
-sudo systemctl enable calculator
-sudo systemctl start calculator
-```
-
-## Dans ton navigateur
-
-- "http://ip-de-la-vm/"