From a720947c82298c9d059b3b47d718bcbeabea7dee Mon Sep 17 00:00:00 2001
From: Michele Sessa <mikysett@gmail.com>
Date: Mon, 23 Jan 2023 17:00:05 +0000
Subject: [PATCH] chore(numerical_operations): add subject for new py exercise
 in scripting piscine

---
 .../devops/numerical_operations/README.md     | 72 +++++++++++++++++++
 1 file changed, 72 insertions(+)
 create mode 100644 subjects/devops/numerical_operations/README.md

diff --git a/subjects/devops/numerical_operations/README.md b/subjects/devops/numerical_operations/README.md
new file mode 100644
index 00000000..164f5bce
--- /dev/null
+++ b/subjects/devops/numerical_operations/README.md
@@ -0,0 +1,72 @@
+## Numerical operation
+
+### Instructions
+
+Create a file `numerical_operations.py` containing the following functions:
+
+- `add(a, b)`
+- `subtract(a, b)`
+- `multiply(a, b)`
+- `power(a, b)`
+- `square(a)`
+
+We assume that `a` and `b` are numbers (`int` or `float`).
+
+### [Optional] Use a virtual environnement to run python code locally
+
+Virtual environments can help you to run your code locally.
+
+[Learn all you need about virtual environments](https://openclassrooms.com/fr/courses/6951236-mettez-en-place-votre-environnement-python/7013854-decouvrez-les-environnements-virtuels).
+
+Here, we setup a virtual environment with Miniconda.
+
+First, [download and install Miniconda](https://docs.conda.io/en/latest/miniconda.html).
+
+Then, use those commands to create a new environment:
+
+```bash
+# create a new virtual environment for python 3.10
+$ conda create --name my_env python=3.10
+
+# activate your new environment
+$ conda activate my_env
+
+# From now, all python command use this python version in this terminal
+$ python --version
+Python 3.10.4
+```
+
+> We advise you to create one virtual environment per python project. Later, we could also install external packages on our environment.
+
+### Usage
+
+Here is a possible `test.py` to test your functions:
+
+```python
+import numerical_operations
+
+print(numerical_operations.add(2, 2))
+print(numerical_operations.subtract(10, 5))
+print(numerical_operations.multiply(3, 4))
+print(numerical_operations.power(3, 3))
+print(numerical_operations.square(3))
+```
+
+```bash
+$ python test.py
+4
+5
+12
+27
+9
+$
+```
+
+### Hints
+
+- You could `import math` at the start of your file to use the functions defined in that library (for example `math.sqrt()`).
+
+### References
+
+- [Square root in Python](https://www.geeksforgeeks.org/python-math-function-sqrt/)
+- [Operations in Python](https://www.geeksforgeeks.org/python-arithmetic-operators/)