Update README
This commit is contained in:
Andros Fenollosa
parent
cf66ef04cd
commit
3b0d223c97
54
README.md
54
README.md
@ -435,9 +435,9 @@ if __name__ == '__main__':
|
||||
{% endblock %}
|
||||
```
|
||||
|
||||
 And ... *Voilá*.
|
||||
 And... we already have an unofficial search engine.
|
||||
|
||||
 Y... *Voilá*.
|
||||
 Y... ya tenemos un buscador no oficial.
|
||||
|
||||
|
||||
### Break (Descanso) - 10 min
|
||||
@ -451,6 +451,8 @@ if __name__ == '__main__':
|
||||
|
||||
#### 2.1 Models
|
||||
|
||||
 With **Flask-alquemy** we will define the structure of our database. In this case we will have a single table called *Programdo* with the fields: *id*, *title* and *last_item*. To do this we will create a new file with the name **models.py**.
|
||||
|
||||
 Con **Flask-alquemy** vamos a definir la estructura de nuestra base de datos. En este caso tendremos una única tabla llamada *Programado* con los campos: *id*, *title* y *last_item*. Para ello crearemos un nuevo archivo con el nombre **models.py**.
|
||||
|
||||
```python3
|
||||
@ -468,6 +470,8 @@ class Programado(db.Model):
|
||||
last_item = db.Column(db.Integer)
|
||||
```
|
||||
|
||||
 This clean way of working lacks several basic functionalities, such as migrations or the possibility of executing orders through the terminal. To do this, we'll add **Flask-Migrate** for automatic migrations and **Flask-Script** for managing them.
|
||||
|
||||
 Esta forma de trabajar tan limpia carece de varias funcionalidades básicas, como migraciones o la posibilidad de ejecutar ordenes por medio del terminal. Para ello le sumaremos **Flask-Migrate** para las migraciones automáticas y **Flask-Script** para su gestión.
|
||||
|
||||
|
||||
@ -495,6 +499,8 @@ if __name__ == "__main__":
|
||||
manager.run()
|
||||
```
|
||||
|
||||
 We opened our terminal and started the database, created the first migration and updated the database.
|
||||
|
||||
 Abrimos nuestro terminal e iniciamos la base de datos, creamos la primera migración y actualizamos la base de datos.
|
||||
|
||||
```bash
|
||||
@ -503,6 +509,8 @@ python3 models.py db migrate
|
||||
python3 models.py db upgrade
|
||||
```
|
||||
|
||||
 We found that everything went well.
|
||||
|
||||
 Comprobamos que todo ha ido bien.
|
||||
|
||||
```bash
|
||||
@ -514,6 +522,9 @@ sqlite3 database.sqlite
|
||||
---
|
||||
#### 2.2 Save item
|
||||
|
||||
|
||||
 To save an element we need to modify our template **buscador.html**. We will send a *POST*. How simply a **<form>** with the hidden variables will be. In this case we will only display the button visible when we receive a *POST* request. Its purpose will be to make a request to the *programadas_nuevo()* page with the name we have searched.
|
||||
|
||||
 Para guarda un elemento necesitamos modificar nuestra plantilla **buscador.html**. Enviaremos un *POST*. Qué sencillamente será un **<form>** con las variables ocultas. En este caso lo que haremos será mostrar el botón solamente visible cuando recibamos una petición *POST*. Su finalidad será realizar una petición a la página *programadas_nuevo()* con el nombre que hemos buscado.
|
||||
|
||||
```jinja2
|
||||
@ -570,14 +581,20 @@ sqlite3 database.sqlite
|
||||
{% endblock %}
|
||||
```
|
||||
|
||||
 Now, it's time to create the function for *programdas_nuevo()* in **app. py**. The first thing we tell you is that you can only accept *POST* requests. We then create variables to save the form information. We then create the record in the database. Finally we redirect to the previous page to see the new element.
|
||||
|
||||
 Ahora, es el momento de crear la función para *programadas_nuevo()* en **app.py**. Lo primero que le indicamos es que solo puede aceptar peticiones *POST*. A continuación creamos variables para guardar la información del formulario. Después creamos el registro en la base de datos. Por último redireccionamos a la anterior página para ver el nuevo elemento.
|
||||
|
||||
 Let's go in parts. We import **db** that will be our *ORM*, and **Programado** that will be the table to manipulate.
|
||||
|
||||
 Vayamos por partes. Importamos **db** que será nuestro *ORM*, y **Programado** que será la tabla a manipular.
|
||||
|
||||
```python3
|
||||
from models import db, Programado
|
||||
```
|
||||
|
||||
 We created the new record.
|
||||
|
||||
 Creamos el nuevo registro.
|
||||
|
||||
```python3
|
||||
@ -586,12 +603,16 @@ my_program = Programado(
|
||||
)
|
||||
```
|
||||
|
||||
 We added it to the queue.
|
||||
|
||||
 Lo añadimos a la cola.
|
||||
|
||||
```python3
|
||||
db.session.add(my_program)
|
||||
```
|
||||
|
||||
 And we execute the modifications. In case he failed, I'd leave the data as it was.
|
||||
|
||||
 Y ejecutamos las modificaciones. En caso que fallara, dejaría los datos como estaban.
|
||||
|
||||
```python3
|
||||
@ -601,6 +622,8 @@ except:
|
||||
db.session.rollback()
|
||||
```
|
||||
|
||||
 Everything together will be like this.
|
||||
|
||||
 Todo junto quedará así.
|
||||
|
||||
```python3
|
||||
@ -642,6 +665,9 @@ def get_resultados(name='', price_max=''):
|
||||
)
|
||||
return results['items']
|
||||
|
||||
@app.route('/programadas')
|
||||
def programadas():
|
||||
return render_template('items/programadas.html')
|
||||
|
||||
@app.route('/programadas/nuevo', methods=('POST',))
|
||||
def programadas_nuevo():
|
||||
@ -666,6 +692,8 @@ if __name__ == '__main__':
|
||||
---
|
||||
#### 2.3 View items
|
||||
|
||||
 Unfortunately, we will see the empty page. For now. We will query the database to give us all the records in the **Programado** table, and pass it on to the template. To do this, we will modify the function that renders the template **programadas.html**, which in our case is called **programadas()** and is in **app. py**.
|
||||
|
||||
 Lamentablemente veremos la página vacía. Por ahora. Haremos una consulta a la base de datos para que nos de todos los registros de la tabla **Programado**, y se lo pasaremos a la plantilla. Para ello modificaremos la función que renderiza la plantilla **programadas.html**, que en nuestro caso se llama **programadas()** y esta en **app.py**.
|
||||
|
||||
```python3
|
||||
@ -735,6 +763,8 @@ if __name__ == '__main__':
|
||||
app.run()
|
||||
```
|
||||
|
||||
 We updated the **programadas.html** template with a *loop* to display all the results in an HTML table.
|
||||
|
||||
 Actualizamos la plantilla **programadas.html** con un *bucle* para mostrar todos los resultados en una tabla de HTML.
|
||||
|
||||
```jinja2
|
||||
@ -763,6 +793,8 @@ if __name__ == '__main__':
|
||||
---
|
||||
#### 2.4 Delete item
|
||||
|
||||
 We will repeat the previous strategy. In the *loop* that shows all the results in **programdas.html**, we add a form that sends us an *id* to a future function that we will define in **app.py**.
|
||||
|
||||
 Repetiremos la estrategia anterior. En el *bucle* que muestra todos los resultados en **programadas.html**, añadimos un formulario que nos envíe un *id* a una futura función que definiremos en **app.py**.
|
||||
|
||||
```jinja2
|
||||
@ -795,6 +827,8 @@ if __name__ == '__main__':
|
||||
{% endblock %}
|
||||
```
|
||||
|
||||
 The way to delete a record is to search for the items you want to delete, and then put it in the queue to remove them. Finally you execute the order as before.
|
||||
|
||||
 La manera de eliminar un registro consiste en realizar una busqueda de los elementos que quieres eliminar, y luego ponerlo en la cola para eliminarlos. Por último ejecutas la orden como antes.
|
||||
|
||||
```python3
|
||||
@ -805,6 +839,8 @@ except:
|
||||
db.session.rollback()
|
||||
```
|
||||
|
||||
 It would look like this.
|
||||
|
||||
 Quedaría así.
|
||||
|
||||
```python3
|
||||
@ -857,7 +893,6 @@ def get_resultados(name='', price_max=''):
|
||||
def programadas_nuevo():
|
||||
title = request.form['title']
|
||||
# We saved in the database
|
||||
|
||||
my_program = Programado(
|
||||
title=title
|
||||
)
|
||||
@ -889,6 +924,8 @@ if __name__ == '__main__':
|
||||
---
|
||||
#### 2.5 Flash messages
|
||||
|
||||
 We have a usability problem: The user is blind when adding or deleting! We need to let him know what's going on when he presses buttons. We will use the **Fash messages**. As we want them to be seen on all our pages, we modify **master.html**.
|
||||
|
||||
 Tenemos un problema de usabilidad: ¡El usuario esta a ciegas cuando añade o borra! Tenemos que informarle de que esta pasando cuando apreta botones. Para ello nos haremos uso de los **Fash messages**. Como queremos que se vean en todas nuestras páginas, modificamos **master.html**.
|
||||
|
||||
```jinja2
|
||||
@ -921,22 +958,24 @@ if __name__ == '__main__':
|
||||
</html>
|
||||
```
|
||||
|
||||
 All messages will now be visible in elegant boxes of *Bootstrap*. We import **flash**.
|
||||
|
||||
 Ahora ya será visible todos los mensajes en cajas elegantes de *Bootstrap*. Importamos **flash**.
|
||||
|
||||
```python3
|
||||
from flask import Flask, render_template, request, redirect, url_for, flash
|
||||
```
|
||||
|
||||
 And we add the messages we want to see. For example.
|
||||
|
||||
 Y añadimos los mensajes que deseamos ver. Por ejemplo.
|
||||
|
||||
```python3
|
||||
try:
|
||||
db.session.commit()
|
||||
flash('Añadida con éxito.')
|
||||
except:
|
||||
db.session.rollback()
|
||||
```
|
||||
|
||||
 Our **app.py** would stay that way.
|
||||
|
||||
 Nuestro **app.py** se nos quedaría así.
|
||||
|
||||
```python3
|
||||
@ -989,7 +1028,6 @@ def get_resultados(name='', price_max=''):
|
||||
def programadas_nuevo():
|
||||
title = request.form['title']
|
||||
# We saved in the database
|
||||
|
||||
my_program = Programado(
|
||||
title=title
|
||||
)
|
||||
|
||||
Loading…
Reference in New Issue
Block a user