Merge branch 'master' into fixing-learnpack-and-readme

Author: alesanchezr

.devcontainer/devcontainer.json

@@ -0,0 +1,40 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/python
+{
+	"name": "Python 3",
+	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+	"image": "mcr.microsoft.com/devcontainers/python:0-3.10",
+	"features": {
+		"ghcr.io/devcontainers/features/node:1": {
+			"nodeGypDependencies": true,
+			"version": "16"
+		}
+	},
+	"customizations": {
+		"vscode": {
+			"settings": {
+				"editor.defaultFormatter": "esbenp.prettier-vscode",
+				"workbench.editorAssociations": {   
+					"*.md": "vscode.markdown.preview.editor"
+				}
+			},
+			"extensions": ["learn-pack.learnpack-vscode"]
+		}
+	},
+	"onCreateCommand": "pip3 install pytest==4.4.2 mock pytest-testdox toml && npm i @learnpack/[email protected] -g && learnpack plugins:install @learnpack/[email protected]"
+
+	// Features to add to the dev container. More info: https://containers.dev/features.
+	// "features": {},
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	// "forwardPorts": [],
+
+	// Use 'postCreateCommand' to run commands after the container is created.
+	// "postCreateCommand": "pip3 install --user -r requirements.txt",
+
+	// Configure tool-specific properties.
+	// "customizations": {},
+
+	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+	// "remoteUser": "root"
+}

.learn/exercises/02-pipenv-installation/README.es.md

@@ -11,7 +11,7 @@ Cada proyecto de python debe estar envuelto en un "ambiente virtual" para asegur
 1. Ejecuta el siguiente comando para crear un nuevo entorno virtual con Python 3:
 
 ```bash
-$ pipenv --three
+$ pipenv install --python 3
 ```
 
 Deberías ver un  **PipFile** en la raíz de tu proyecto y dentro debería tener **[requires]** en la versión de Python 3+ similar a este (pero quizás con una diferente versión de Python 3).

.learn/exercises/02-pipenv-installation/README.md

@@ -11,7 +11,7 @@ Every python project should be wrapped in a "virtual environment" to ensure that
 1. Run the following command to create a new virtual environment with python 3 on it:
 
 ```bash
-$ pipenv --three
+$ pipenv install --python 3
 ```
 
 You should see a **PipFile** on the root of your project and it should have a **[requires]** inside of it for python version 3+: similar to this one (but maybe with a different python 3 version).

.learn/exercises/02-pipenv-installation/test.py

@@ -4,13 +4,6 @@
 def test_pipfile_exists():
   assert os.path.isfile("Pipfile")
 
-@pytest.mark.it("Python version on Pipfile must be 3+")
-def test_pipfile_contains_python_version():
-  with open("Pipfile", "r") as f:
-    toml_content = f.read()
-    parsed_toml = toml.loads(toml_content)
-    assert parsed_toml["requires"]["python_version"][0:2] == "3."
-
 @pytest.mark.it("Flask must exist on the pipfile dependency [packages]")
 def test_pipfile_contains_flask():
   with open("Pipfile", "r") as f:

.learn/exercises/02.1-flask-installation/test.py

@@ -14,7 +14,7 @@ def hello_world():
 
 + La primera línea también especifica el método que se usará con esa URL, en este caso es el método `GET` (para obtener info).
 
-+ La segunda línea define una función que será llamada por Flask cuando ese endpoint sea llamado por el usuario (cuando el usuario use `/hello`).
++ La segunda línea define una función que será llamada por Flask cuando ese endpoint sea llamado por el usuario (cuando el usuario use `/blabla`).
 
 + La tercera línea retorna el texto: `Hello World` al cliente o navegador que lo solicite.
 

.learn/exercises/03.3-your-first-route/README.es.md

@@ -14,7 +14,7 @@ def hello_world():
 
 + The first line also specifies the methods that will be used with that URL. In this case, the `GET` method (for reading data).
 
-+ The second line defines a function that will be called by Flask when that endpoint is called by the user (when the user requests `/hello`).
++ The second line defines a function that will be called by Flask when that endpoint is called by the user (when the user requests `/blabla`).
 
 + The third line defines our function execution and in this case, returns the text "Hello World" to the requesting client or browser.
 

.learn/exercises/03.3-your-first-route/README.md

@@ -5,14 +5,18 @@ Las REST APIs tienen que retornar datos en formato JSON, no en formato HTML.
 Puedes usar la función [flask jsonify](https://flask.palletsprojects.com/en/1.1.x/api/#flask.json.jsonify) para convertir con facilidad cualquier tipo de datos básico a JSON de esta forma:
 
 ```python
-def hello_world():
-    # supongamos que tienes some_data (cierta información) en una variable json
+# añade el método jsonify a tu importación de Flask
+    from flask import Flask, jsonify
+
+# supongamos que tienes tus datos en la variable some_data
     some_data = { "name": "Bobby", "lastname": "Rixer" }
 
-    # puedes convertir esa variable en un string json así
+@app.route('/blahblah', methods=['GET'])
+def hello_world():
+    # puedes convertir esa variable en una cadena json de la siguiente manera
     json_text = jsonify(some_data)
 
-    # y luego puedes retornarla (return) en el response body así:
+    # y luego puedes devolverlo al front-end en el cuerpo de la respuesta de la siguiente manera
     return json_text
 ```
 

.learn/exercises/05-returning-json/README.es.md

@@ -1,24 +1,33 @@
 # `07.2` Finish the POST /todos
 
-Ahora, si queremos terminar el `post` tenemos que hacer dos acciones específicas:
+Ahora... si queremos terminar el post, tenemos que realizar estas acciones específicas:
 
-+ Decodificar el request.data para convertirlo a un diccionario de python.
++ Primero asegúrate de convertir el cuerpo de la solicitud en una estructura de datos real de Python, como un diccionario. Ya usamos `request.json` para eso, ya que sabemos que la solicitud estará en formato application/json. Si eso no se conoce, es posible que desee usar `request.get_json(force=True)` para ignorar el tipo de contenido y tratarlo como json.
 
-+ Añadir el diccionario a la lista de todos.
++ Agrega el diccionario a la lista de `todos`.
 
-+ Retornar la nueva lista de todos.
++ Devuelve la nueva lista de `todos`.
 
-Para decodificar cualquier string json y convertirlo a un objeto de python podemos usar esta función:
+Tu código debería verse así ahora:
 
 ```python
-import json
-decoded_object = json.loads(original_string)
+
+@app.route('/todos', methods=['POST'])
+def add_new_todo():
+    request_body = request.json
+    print("Incoming request with the following body", request_body)
+    return 'Response for the POST todo'
+
 ```
 
+Obviamente, este punto final actualmente no agrega nada nuevo a nuestra 'base de datos' (la lista `todo`).
+
+Completemos el código para que el punto final pueda hacer tu trabajo: agregar una nueva tarea a los `todos`.
+
 ## 📝 Instrucciones:
 
-1. Usa la función json.loads para decodificar el `request.data`
+1. Agrega el contenido del cuerpo de la solicitud decodificada a la lista `todos`.
 
-2. Añade el objeto decodificado a la lista de `todos`.
+2. Devuelve la lista actualizada `todos` al front end.
 
-3. Retorna la lista jsonify de los `todos` actualizados.
+3. No olvide `jsonify` su devolución. ¿Por qué es esto necesario? Discuta con la clase.

.learn/exercises/07.2-finish-post-todo/README.es.md

@@ -7,6 +7,3 @@ name = "pypi"
 flask = "*"
 
 [dev-packages]
-
-[requires]
-python_version = "3.8"