Update english texts
This commit is contained in:
Andros Fenollosa
parent
9f3ff83775
commit
5c6849cc49
67
README.md
67
README.md
@ -1032,6 +1032,8 @@ if __name__ == '__main__':
|
||||
|
||||
#### 3.1 Command
|
||||
|
||||
 We already have our interface set up to manage our searches. Next, create a *script* to check for new results. And if so, send us an *email*. The first step is to create a custom command with Flask. We made a new file called **avisador. py**.
|
||||
|
||||
 Ya tenemos montado nuestra interfaz para gestionar nuestras busquedas. Lo siguiente será crear un *script* que se encargue de verificar si hay nuevos resultados. Y si es así, enviarnos un *email*. El primer paso será crear con Flask un comando personalizado. Realizamos un nuevo archivo llamado **avisador.py**.
|
||||
|
||||
```python3
|
||||
@ -1049,6 +1051,8 @@ if __name__ == "__main__":
|
||||
manager.run()
|
||||
```
|
||||
|
||||
 To prove that it works, we run, always with the virtual environment active, the following.
|
||||
|
||||
 Para probar que funciona ejecutamos, siempre con el entorno virtual activo, lo siguiente.
|
||||
|
||||
```bash
|
||||
@ -1056,6 +1060,8 @@ chmod +x avisador.py
|
||||
./avisador.py hello
|
||||
```
|
||||
|
||||
 If everything has gone well, he will answer us.
|
||||
|
||||
 Si todo ha ido bien nos responderá.
|
||||
|
||||
```bash
|
||||
@ -1065,26 +1071,38 @@ hello PyConES17
|
||||
---
|
||||
#### 3.2 SMTP Server
|
||||
|
||||
 To send an email if we need an SMTP server or if we need one. You can use GMail, Hotmail, Fastmail... or any email account. For the workshop, we'll use Mailgun. A powerful professional service for sending emails. It allows us to send 10,000 free monthly mailings. Enough for what we need. We come in here.
|
||||
|
||||
 Para enviar un email si o si necesitaremos una servidor SMTP. Podéis usar GMail, Hotmail, Fastmail... o cualquier cuenta de correo. Para el taller, usaremos Mailgun. Un poderoso servicio profesional para el envío de emails. Nos permite 10.000 envíos mensuales gratuitos. Suficientes para lo que necesitamos. Entramos aquí.
|
||||
|
||||
[Mailgun](https://signup.mailgun.com/new/signup)
|
||||
|
||||
 We created a new account.
|
||||
|
||||
 Creamos una nueva cuenta.
|
||||
|
||||
|
||||
|
||||
 We confirm our account by clicking on the link sent to our email.
|
||||
|
||||
 Confirmamos nuestra cuenta por el enlace que nos han enviado a nuestro email.
|
||||
|
||||
|
||||
|
||||
 Clicking on the link will take us to this page. We confirm our phone number and press *Domains*. Watch out! If you do not confirm your phone number, Mailgun will not work.
|
||||
|
||||
 Al pulsar sobre el enlace nos llevará a esta página. Confirmamos nuestro teléfono y pulsamos en *Domains*. ¡Ojo! Si no confirmáis vuestro teléfono, Mailgun no funcionará.
|
||||
|
||||
|
||||
|
||||
 We entered our active domain.
|
||||
|
||||
 Entramos en nuestro dominio activo.
|
||||
|
||||
|
||||
|
||||
 Here we will have the accesses we will need. We leave this page open for later.
|
||||
|
||||
 Aquí tendremos los accesos que necesitaremos. Dejamos abierta esta página para más adelante.
|
||||
|
||||
|
||||
@ -1092,12 +1110,16 @@ hello PyConES17
|
||||
---
|
||||
#### 3.3 Send email
|
||||
|
||||
 We already have our email server. Now let's send a test email. We open **avisador.py** to import **flask-mail**.
|
||||
|
||||
 Ya tenemos nuestro servidor de email. Ahora vamos a enviar un correo de prueba. Abrimos **avisador.py** para importar **flask-mail**.
|
||||
|
||||
```python3
|
||||
from flask_mail import Mail, Message
|
||||
```
|
||||
|
||||
 We configure **flask-mail**. **MAIL_USERNAME** will be **Default SMTP Login**. And **MAIL_PASSWORD** will be **Default Password** from *mailgun*.
|
||||
|
||||
 Configuramos **flask-mail**. **MAIL_USERNAME** será **Default SMTP Login** de *mailgun*. Y **MAIL_PASSWORD** será **Default Password** de *mailgun*.
|
||||
|
||||
```python3
|
||||
@ -1110,6 +1132,8 @@ app.config.update(
|
||||
mail = Mail(app)
|
||||
```
|
||||
|
||||
 We created a command for you to send us a test *email*.
|
||||
|
||||
 Creamos un comando para que nos envíe un *email* de prueba.
|
||||
|
||||
```python3
|
||||
@ -1125,6 +1149,8 @@ def send_email():
|
||||
mail.send(msg)
|
||||
```
|
||||
|
||||
 All together would be like this.
|
||||
|
||||
 Todo junto quedaría así.
|
||||
|
||||
```python3
|
||||
@ -1159,31 +1185,44 @@ if __name__ == "__main__":
|
||||
manager.run()
|
||||
```
|
||||
|
||||
 We execute.
|
||||
|
||||
 Ejecutamos.
|
||||
|
||||
```bash
|
||||
./avisador.py send_email
|
||||
```
|
||||
|
||||
 We checked our inbox. Otherwise we look in *spam*.
|
||||
|
||||
 Revisamos nuestra bandeja de entrada. En caso contrario buscamos en *spam*.
|
||||
|
||||
--
|
||||
---
|
||||
#### 3.4 Notification
|
||||
|
||||
|
||||
 We are ready to perform the notification system. The logic will be basic: we look for all the products that have the word we have guard. We get the first *id*. If the *id* is the same one we have in the database, we don't do anything. If different, we update the database and send an email.
|
||||
|
||||
 Estamos listos para realizar el sistema de notificación. La lógica será básica: buscamos todos los productos que tenga la palabra que tenemos guarda. Nos quedamos con la primera *id*. Si la *id* es la misma que tenemos en la base de datos, no hacemos nada. Si es diferente, actualizamos la base de datos y enviamos un email.
|
||||
|
||||
 We Open **avisador.py**. First, we import our functionality to get the Wallapop API elements.
|
||||
|
||||
 Abrimos **avisador.py**. Primero, importamos nuestra funcion para obtener los elementos del API de Wallapop.
|
||||
|
||||
```python3
|
||||
from app import app, get_resultados
|
||||
```
|
||||
|
||||
 In addition, we import our table with the saved words.
|
||||
|
||||
 Además, importamos nuestra tabla con las palabras guardadas.
|
||||
|
||||
```python3
|
||||
from models import db, Programado
|
||||
```
|
||||
|
||||
 We go through all the stored words.
|
||||
|
||||
 Recorremos todas las palabras almacenadas.
|
||||
|
||||
```python3
|
||||
@ -1193,6 +1232,8 @@ def send_email():
|
||||
for item in programados:
|
||||
```
|
||||
|
||||
 We get the first *id*. That we'll use it to compare if we've got it stashed away.
|
||||
|
||||
 Obtenemos el primer *id*. Que lo usaremos para comparar si la tenemos guardada.
|
||||
|
||||
```python3
|
||||
@ -1206,6 +1247,9 @@ def send_email():
|
||||
if int(itemId) != item.last_item:
|
||||
```
|
||||
|
||||
|
||||
 To update in SQLAlchemy, you must obtain the result, modify the object, and return it. To illustrate the way of working I leave an example. I change the *gana* column which is a *boolean* and the *nombre* column which is a *string* column.
|
||||
|
||||
 Para actualizar en SQLAlchemy hay que obtener el resultado, modificar el objeto, y devolverlo. Para ilustrar la forma de trabajar dejo un ejemplo. Modifico la columna *gana* que es un *boolean* y la columna *nombre* que es un *string*.
|
||||
|
||||
```python3
|
||||
@ -1216,6 +1260,8 @@ db.session.add(spartano)
|
||||
db.session.commit()
|
||||
```
|
||||
|
||||
 In our code it would be implemented as follows.
|
||||
|
||||
 En nuestro código quedaría implementado de la siguiente forma.
|
||||
|
||||
```python3
|
||||
@ -1237,6 +1283,8 @@ def send_email():
|
||||
db.session.rollback()
|
||||
```
|
||||
|
||||
 We just have to send the *email*.
|
||||
|
||||
 Ya solo nos queda enviar el *email*.
|
||||
|
||||
```python3
|
||||
@ -1267,8 +1315,9 @@ def send_email():
|
||||
mail.send(msg)
|
||||
```
|
||||
|
||||
 Todo junto quedaría.
|
||||
 All together would remain.
|
||||
|
||||
 Todo junto quedaría.
|
||||
|
||||
```python3
|
||||
#!/usr/bin/env python3
|
||||
@ -1321,8 +1370,12 @@ if __name__ == "__main__":
|
||||
---
|
||||
#### 3.5 View email
|
||||
|
||||
 I am no longer sending a simple text in the *email*. I need the magic of *flask* with its *render_template*. You can see how I use two templates where I pass two variables. The *titulo* and the *id* of the item.
|
||||
|
||||
 Ya no estoy enviando un texto sencillo en el *email*. Necesito la magia de *flask* con su *render_template*. Puedes observar como hago uso de dos plantillas donde paso dos variables. El *titulo* y la *id* del item.
|
||||
|
||||
 We created a new folder inside *templates* with the name *emails*. And within this, the *notificacion.html* and *notificacion.txt* file. The structure will stay that way.
|
||||
|
||||
 Creamos una carpeta nueva dentro de *templates* con el nombre *emails*. Y dentro de esta, el archivo *notificacion.html* y *notificacion.txt*. Quedará la estructura así.
|
||||
|
||||
```bash
|
||||
@ -1337,6 +1390,8 @@ if __name__ == "__main__":
|
||||
--> master.html
|
||||
```
|
||||
|
||||
 Open *notificacion.txt* and enter.
|
||||
|
||||
 Abrimos *notificacion.txt* e introducimos.
|
||||
|
||||
```txt
|
||||
@ -1347,6 +1402,8 @@ Aviso
|
||||
http://p.wallapop.com/i/{{ id }}?_pid=web&_me=www&campaign=mobile_item
|
||||
```
|
||||
|
||||
 And in *notificacion.html* the following.
|
||||
|
||||
 Y en *notificacion.html* lo siguiente.
|
||||
|
||||
```html
|
||||
@ -1366,17 +1423,23 @@ http://p.wallapop.com/i/{{ id }}?_pid=web&_me=www&campaign=mobile_item
|
||||
</html>
|
||||
```
|
||||
|
||||
 E voilà! We're all done now. When the new notices arrive we will be able to click on the link to see the product file. And if we're on the smartphone, the official application will open.
|
||||
|
||||
 ¡E voilà! Ya hemos terminado. Cuando nos llegue los nuevos avisos podremos pulsar en el enlace para ver la ficha del producto. Y si estamos en el smartphone, se nos abrirá la aplicación oficial.
|
||||
|
||||
---
|
||||
#### 3.6 Automation
|
||||
|
||||
 To check and receive emails, just run the custom command. Same way as before.
|
||||
|
||||
 Para revisar y recibir los emails solo tendrás que ejecutar el comando personalizado. De la misma forma que antes.
|
||||
|
||||
```bash
|
||||
./avisador.py send_email
|
||||
```
|
||||
|
||||
 My recommendation is to run it on *cron* every hour.
|
||||
|
||||
 Mi recomendación es ejecutarlo en un *cron* cada hora y listo.
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user