Pending changes exported from your codespace

josemoracard · josemoracard · commit 6b4373d1793a · 2024-03-26T07:19:35.000Z
diff --git a/.learn/resets/03-response-body/app.py b/.learn/resets/03-response-body/app.py
@@ -0,0 +1,10 @@
+import requests
+
+url = "https://assets.breatheco.de/apis/fake/sample/random-status.php"
+
+response = requests.get(url)
+
+if response.status_code == 200:
+    print(response.text)
+else:
+    print("Something went wrong")
diff --git a/exercises/00-welcome/README.es.md b/exercises/00-welcome/README.es.md
@@ -1,13 +1,13 @@
-# Python API Requests 
+# `00` Welcome to Python API Requests!
  
 Python Requests es el paquete más popular para consumir API y hacer solicitudes HTTP.
 
 Aquí aprenderás:
 
 1. Cómo hacer solicitudes GET.
-2. Cómo obtener propiedades de una data e información.
+2. Cómo obtener propiedades de datos e información.
 3. Cómo configurar request headers.
 4. Cómo configurar request content-type.
 5. Cómo hacer solicitudes POST.
 
-Haga click en el botón `next →` en la esquina superior derecha para continuar.
+Haga clic en el botón `Next →` en la esquina superior derecha para continuar.
diff --git a/exercises/00-welcome/README.md b/exercises/00-welcome/README.md
@@ -0,0 +1,13 @@
+# `00` Welcome to Python API Requests! 
+ 
+Python Requests is the most popular package for consuming APIs and doing HTTP requests.
+
+Here you will learn:
+
+1. How to do GET requests.
+2. How to fetch data properties and information.
+3. How to set request headers.
+4. How to set request content-type.
+5. How to do POST requests.
+
+Click the `Next →` button on the top right to continue.
diff --git a/exercises/01-creating-a-request/README.es.md b/exercises/01-creating-a-request/README.es.md
@@ -0,0 +1,20 @@
+# `01` Creating a Request
+
+Python tiene integrado un [paquete de solicitudes (*requests package*)](https://requests.readthedocs.io/en/master/) eso permite a los desarrolladores crear solicitudes HTTP con bastante facilidad.
+
+Así es como en Python hacemos una solicitud HTTP GET:
+
+```python
+response = requests.get('<destination url>')
+print(response.status_code)
+```
+
+## 📝 Instrucciones:
+
+Actualiza la variable `url` para que solicite a esta dirección:
+
+```bash
+https://assets.breatheco.de/apis/fake/sample/hello.php
+```
+
+> Nota: La consola debe imprimir un código de estado 200.
diff --git a/exercises/01-creating-a-request/README.md b/exercises/01-creating-a-request/README.md
@@ -1,4 +1,4 @@
-# 02 Creating a request
+# `01` Creating a Request
 
 Python has a [requests package](https://requests.readthedocs.io/en/master/) that allows developers to create HTTP request pretty easily.
 
@@ -9,12 +9,12 @@ response = requests.get('<destination url>')
 print(response.status_code)
 ```
 
-# 📝 Instructions
+## 📝 Instructions:
 
-Change the variable url to make it request to: 
+Update the `url` variable to make it request to this address: 
 
-```bash
+```text
 https://assets.breatheco.de/apis/fake/sample/hello.php
 ```
 
-Note: The console should print a 200 status code.
+> Note: The console should print a 200 status code.
diff --git a/exercises/01-creating-a-request/app.py b/exercises/01-creating-a-request/app.py
diff --git a/exercises/01-creating-a-request/solution.hide.py b/exercises/01-creating-a-request/solution.hide.py
@@ -0,0 +1,6 @@
+import requests
+
+url = "https://assets.breatheco.de/apis/fake/sample/hello.php"
+response = requests.get(url)
+
+print("The response status is: "+str(response.status_code))
diff --git a/exercises/01-creating-a-request/test.py b/exercises/01-creating-a-request/test.py
diff --git a/exercises/01-hello-world/README.md b/exercises/01-hello-world/README.md
diff --git a/exercises/01-what-is-a-request/README.es.md b/exercises/01-what-is-a-request/README.es.md
diff --git a/exercises/02-random-status/README.es.md b/exercises/02-random-status/README.es.md
@@ -1,14 +1,15 @@
-# `02` Manejar el Status de Respuesta
+# `02` Handle Response Status
 
 La siguiente solicitud GET siempre devuelve un código de status diferente, nunca se sabe qué respuesta está recibiendo del servidor.
 
-## 📝Instrucciones
+## 📝 Instrucciones:
 
 Crea una condición para imprimir en la consola los siguientes mensajes según el status de respuesta:
 
-| Status    | Message   |
+| Status    | Mensaje   |
 | -----     | -----     |
-| 404       | The URL you asked is not found |
+| 404       | The URL you asked for is not found |
 | 503       | Unavailable right now |
 | 200       | Everything went perfect |
-| 400       | Something is wrong on the request params |
+| 400       | Something is wrong with the request params |
+| Otro código de status | Unknown status code |
diff --git a/exercises/02-random-status/README.md b/exercises/02-random-status/README.md
@@ -1,15 +1,15 @@
 # `02` Handle Response Status
 
-The following GET request is always returning a different status code, you never know what reponse you are getting form the server.
+The following GET request is always returning a different status code; you never know what response you are getting from the server.
 
-## 📝Instructions
+## 📝 Instructions:
 
-Create a condition to print on the console the following messages depending on the response status:
+Create a condition to print on the console the following messages, depending on the response status:
 
 | Status    | Message   |
 | -----     | -----     |
-| 404       | The URL you asked is not found |
+| 404       | The URL you asked for is not found |
 | 503       | Unavailable right now |
 | 200       | Everything went perfect |
-| 400       | Something is wrong on the request params |
-| anything else | anything |
+| 400       | Something is wrong with the request params |
+| Any other code | Unknown status code |
diff --git a/exercises/02-random-status/solution.hide.py b/exercises/02-random-status/solution.hide.py
@@ -0,0 +1,14 @@
+import requests
+
+response = requests.get("https://assets.breatheco.de/apis/fake/sample/random-status.php")
+
+if response.status_code == 404:
+    print("The URL you asked for is not found")
+elif response.status_code == 503:
+    print("Unavailable right now")
+elif response.status_code == 200:
+    print("Everything went perfect")
+elif response.status_code == 400:
+    print("Something is wrong with the request params")
+else:
+    print("Unknown code")
diff --git a/exercises/02-random-status/test.py b/exercises/02-random-status/test.py
@@ -16,7 +16,7 @@ def test_url_200(capsys, app):
         captured = capsys.readouterr()
         assert "Everything went perfect\n" == captured.out
 
-@pytest.mark.it("When testing for 404 it should print The URL you asked is not found'")
+@pytest.mark.it("Testing for 404: The URL you asked for is not found'")
 def test_url_404(capsys, app):
     with patch('requests.get') as mock_request:
         mock_request.return_value.status_code = 404
@@ -32,10 +32,18 @@ def test_url_503(capsys, app):
         captured = capsys.readouterr()
         assert "Unavailable right now\n" == captured.out
 
-@pytest.mark.it("Testing for 400: Something is wrong on the request params")
+@pytest.mark.it("Testing for 400: Something is wrong with the request params")
 def test_url_400(capsys, app):
     with patch('requests.get') as mock_request:
         mock_request.return_value.status_code = 400
         app()
         captured = capsys.readouterr()
-        assert "Something is wrong on the request params\n" == captured.out
+        assert "Something is wrong with the request params\n" == captured.out
+
+@pytest.mark.it("Testing for any other code: Unknown status code")
+def test_url_generic_response(capsys, app):
+    with patch('requests.get') as mock_request:
+        mock_request.return_value.status_code = 500  # For example, using status code 500 for generic response
+        app()
+        captured = capsys.readouterr()
+        assert "Unknown status code\n" == captured.out
diff --git a/exercises/03-response-body/README.es.md b/exercises/03-response-body/README.es.md
@@ -1,14 +1,18 @@
-# `03` Respuesta en Body
+# `03` Response Body
 
 Haga clic en este enlace para ver la respuesta que esta solicitud GET está dando en el body:
 [https://assets.breatheco.de/apis/fake/sample/random-status.php](https://assets.breatheco.de/apis/fake/sample/random-status.php)
 
-Ahora, si deseas obtener ese body como respuesta (texto), todo lo que tiene que hacer es:
+Ahora, si deseas obtener el *body* de la respuesta (texto/contenido), todo lo que tienes que hacer es:
+
 ```py
-# plain text
 print(response.text) 
 ```
 
-# 📝 Instrucciones
+## 📝 Instrucciones:
+
+Imprime en la consola el *body* de la respuesta solo para solicitudes con status `200`, para el resto imprime:
 
-Imprime en la consola la the responde body solo para solicitudes 200, para el resto imprima "Something went wrong".
+```text
+"Something went wrong"
+```
diff --git a/exercises/03-response-body/README.md b/exercises/03-response-body/README.md
@@ -3,12 +3,16 @@
 Click on this link to see the response body that this GET request is giving:
 [https://assets.breatheco.de/apis/fake/sample/random-status.php](https://assets.breatheco.de/apis/fake/sample/random-status.php)
 
-Now, if you want to get that response body (text) all you have to do is:
+Now, if you want to get that response body (text/content) all you have to do is this:
+
 ```py
-# plain text
 print(response.text) 
 ```
 
-# 📝 Instructions
+## 📝 Instructions:
+
+Print on the console the response body for status code `200`, for all the other print:
 
-Print on the console the response body only for 200 requests, for all the other print "Something went wrong".
+```text
+"Something went wrong"
+```
diff --git a/exercises/03-response-body/app.py b/exercises/03-response-body/app.py
@@ -1,3 +1,10 @@
 import requests
 
-url = "https://assets.breatheco.de/apis/fake/sample/random-status.php"
+url = "https://assets.breatheco.de/apis/fake/sample/random-status.php"
+
+response = requests.get(url)
+
+if response.status_code == 200:
+    print(response.text)
+else:
+    print("Something went wrong")
diff --git a/exercises/03-response-body/solution.hide.py b/exercises/03-response-body/solution.hide.py
@@ -0,0 +1,10 @@
+import requests
+
+url = "https://assets.breatheco.de/apis/fake/sample/random-status.php"
+
+response = requests.get(url)
+
+if response.status_code == 200:
+    print(response.text)
+else:
+    print("Something went wrong")
diff --git a/exercises/03-response-body/test.py b/exercises/03-response-body/test.py
@@ -7,7 +7,7 @@ def test_url_call(capsys, app):
         app()
         mock_request.assert_called_once_with("https://assets.breatheco.de/apis/fake/sample/random-status.php")
 
-@pytest.mark.it("Testing for 200: Everythign went perfect")
+@pytest.mark.it("Testing for 200: Everything went perfect")
 def test_url_200(capsys, app):
     with patch('requests.get') as mock_request:
         mock_request.return_value.status_code = 200
@@ -16,7 +16,7 @@ def test_url_200(capsys, app):
         captured = capsys.readouterr()
         assert "something\n" == captured.out
 
-@pytest.mark.it("When testing for 404 it should print 'Something went wrong'")
+@pytest.mark.it("Testing for any other code: Something went wrong")
 def test_url_404(capsys, app):
     with patch('requests.get') as mock_request:
         mock_request.return_value.status_code = 404
diff --git a/exercises/04-response-body-json/README.es.md b/exercises/04-response-body-json/README.es.md
@@ -1,8 +1,8 @@
-# `04` Respuesta JSON
+# `04` Response JSON
 
 Pero tener una respuesta basada en texto no es muy útil, es por eso que las API normalmente responden en formato CSV, JSON, YAML o XML.
 
-# 📝 Instrucciones
+## 📝 Instrucciones:
 
 El siguiente endpoint devuelve la hora actual en un formato JSON cada vez que se solicita utilizando el método GET.
 
@@ -22,15 +22,15 @@ Response body:
 }
 ```
 
-Haga una solicitud GET a ese endpoint e imprima la hora en la consola con este formato:
+Haga una solicitud GET a ese endpoint e imprime la hora en la consola con este formato:
 
 ```bash
 Current time: 17 hrs 06 min and 23 sec
 ```
 
-## 💡Pista
+## 💡 Pistas:
 
-1. Usa el [metodo .json()](https://www.w3schools.com/python/ref_requests_response.asp) para obtener el response body como un diccionario y almacenarlo en una variable
-2. Obtenga las propiedades `horas`,` minutos` y `segundos` del diccionario
-3. Concatenar todo de esta manera: `Hora actual: 17 h 06 min y 23 seg`
+1. Usa el [metodo .json()](https://www.w3schools.com/python/ref_requests_response.asp) para obtener el response body como un diccionario y almacenarlo en una variable.
+2. Obtenga las propiedades `hours`, `minutes` y `seconds` del diccionario.
+3. Concatenar todo de esta manera: `Hora actual: 17 h 06 min y 23 seg`.
 
diff --git a/exercises/04-response-body-json/README.md b/exercises/04-response-body-json/README.md
@@ -2,7 +2,7 @@
 
 But having a text based response is not very useful, that is why API's normally respond in CSV, JSON, YAML or XML format.
 
-# 📝 Instructions
+## 📝 Instructions:
 
 The following endpoint returns the current time in a JSON format every time it is requested using the GET method.
 
@@ -24,13 +24,13 @@ Response body:
 
 Please do a GET request to that endpoint and print the time on the console with this format:
 
-```bash
+```text
 Current time: 17 hrs 06 min and 23 sec
 ```
 
-## 💡Hint
+## 💡 Hints:
 
-1. Use the [.json() method](https://www.w3schools.com/python/ref_requests_response.asp) to get the response body as a dictionary and store it in a variable
-2. Get the `hours`, `minutes` and `seconds` properties from the dictionary
-3. Concatenate everything together like this: `Current time: 17 hrs 06 min and 23 sec`
+1. Use the [.json() method](https://www.w3schools.com/python/ref_requests_response.asp) to get the response body as a dictionary and store it in a variable.
+2. Get the `hours`, `minutes` and `seconds` properties from the dictionary.
+3. Concatenate everything together like this: `Current time: 17 hrs 06 min and 23 sec`.
 
diff --git a/learn.json b/learn.json
@@ -6,7 +6,7 @@
     },
     "slug": "python-http-requests-api-tutorial-exercises",
     "description": {
-        "us": "Learn interactively to consume and create HTTP requests to API's using Python",
+        "us": "Learn interactively to consume and create HTTP requests to APIs using Python",
         "es": "Aprende interactivamente cómo consumir APIs y hacer requests HTTP con Python"
     },
     "repository": "https://github.com/4GeeksAcademy/python-http-requests-api-tutorial-exercises",
