Add intro assignment - Simple Calculator

Author: jgrynczewski

0_intro/01_hello/README.md

@@ -0,0 +1,39 @@
+# 👋 Intro - Simple Calculator
+
+**Difficulty**: very easy  
+**Time**: 5 minutes  
+**Focus**: Setup verification
+
+## 🎯 Zadanie
+Zaimplementuj dwie proste funkcje, żeby sprawdzić, że środowisko działa poprawnie.
+
+## 📋 Wymagania
+- [ ] `add(2, 3)` zwraca `5`
+- [ ] `add(10, 5)` zwraca `15`
+- [ ] `multiply(2, 3)` zwraca `6`
+- [ ] `multiply(10, 5)` zwraca `50`
+- [ ] Funkcje działają z liczbami ujemnymi i zerem
+
+## 🚀 Jak zacząć
+1. Otwórz `starter.py`
+2. Uruchom doctests: `python -m doctest starter.py -v`
+3. Zaimplementuj funkcje `add()` i `multiply()`
+4. Uruchom testy: `python -m pytest test_hello.py -v`
+5. Commit gdy wszystkie testy przechodzą ✅
+
+## 💡 Podpowiedź
+- Sprawdź doctests w `starter.py` - pokazują expected behavior
+- `add(a, b)` powinno zwrócić sumę: `a + b`
+- `multiply(a, b)` powinno zwrócić iloczyn: `a * b`
+
+## ✅ Success criteria
+Gdy uruchomisz:
+```bash
+    python -m doctest starter.py -v
+    python -m pytest test_hello.py -v
+```
+
+Wszystkie testy powinny być zielone ✅
+
+Jeśli wszystkie testy przeszły, Twoje środowisko działa poprawnie.
+🎉 Gratulacje!

0_intro/01_hello/starter.py

@@ -0,0 +1,68 @@
+"""
+>>> add(2, 3)
+5
+
+>>> add(10, 5)
+15
+
+>>> multiply(2, 3)
+6
+
+>>> multiply(10, 5)
+50
+
+>>> add(0, 0)
+0
+
+>>> multiply(1, 1)
+1
+"""
+
+# %% About
+# - Name: Intro - Simple Calculator
+# - Difficulty: easy
+# - Lines: 4
+# - Focus: Setup verification
+
+# %% Description
+"""
+Intro Exercise: Simple Calculator
+
+Zaimplementuj dwie proste funkcje, żeby sprawdzić, że środowisko działa.
+"""
+
+# %% Hints
+# - Funkcja add() powinna zwrócić sumę dwóch liczb
+# - Funkcja multiply() powinna zwrócić iloczyn dwóch liczb
+
+# %% Run
+# - Terminal: `python -m doctest -f -v starter.py`
+# - Tests: `python -m pytest test_hello.py -v`
+
+
+def add(a, b):
+    """
+    Add two numbers.
+
+    Args:
+        a: First number
+        b: Second number
+
+    Returns:
+        Sum of a and b
+    """
+    pass
+
+
+def multiply(a, b):
+    """
+    Multiply two numbers.
+
+    Args:
+        a: First number
+        b: Second number
+
+    Returns:
+        Product of a and b
+    """
+    pass

0_intro/01_hello/test_hello.py

@@ -0,0 +1,54 @@
+"""
+Testy dla Intro - Simple Calculator
+"""
+
+import pytest
+from starter import add, multiply
+
+
+class TestCalculator:
+    """Testy prostego kalkulatora"""
+
+    def test_add_positive_numbers(self):
+        """Test dodawania liczb dodatnich"""
+        assert add(2, 3) == 5
+        assert add(10, 5) == 15
+
+    def test_add_zero(self):
+        """Test dodawania zera"""
+        assert add(0, 0) == 0
+        assert add(5, 0) == 5
+        assert add(0, 5) == 5
+
+    def test_add_negative_numbers(self):
+        """Test dodawania liczb ujemnych"""
+        assert add(-1, -1) == -2
+        assert add(-5, 3) == -2
+        assert add(5, -3) == 2
+
+    def test_multiply_positive_numbers(self):
+        """Test mnożenia liczb dodatnich"""
+        assert multiply(2, 3) == 6
+        assert multiply(10, 5) == 50
+
+    def test_multiply_by_zero(self):
+        """Test mnożenia przez zero"""
+        assert multiply(0, 0) == 0
+        assert multiply(5, 0) == 0
+        assert multiply(0, 5) == 0
+
+    def test_multiply_by_one(self):
+        """Test mnożenia przez jeden"""
+        assert multiply(1, 1) == 1
+        assert multiply(5, 1) == 5
+        assert multiply(1, 5) == 5
+
+    def test_multiply_negative_numbers(self):
+        """Test mnożenia liczb ujemnych"""
+        assert multiply(-2, 3) == -6
+        assert multiply(-2, -3) == 6
+        assert multiply(2, -3) == -6
+
+
+if __name__ == "__main__":
+    pytest.main([__file__, "-v"])