PyDB , explicación

# Autor: JaAViEr | 0x5d
# Twitter: @0x5d
# Contacto: Javier.guajardo@vodale.com


¡ PyDB es un módulo programado para el lenguaje scripting Python y no necesitarás saber SQL para controlarla ! 

¿ Para que sirve ?

A diferencia de otras librerías, PyDB es sólo un módulo, el cuál te permitirá crear una Base de Datos
a partir de un archivo de texto, siempre y cuando éste tenga la estructura que PyDB es capaz de interpretar. (Explicada más adelante).

Este módulo no pretende hacer un reemplazo de librerías como SQLite, PostgreSql o MySQL. 
El módulo está orientado a programadores que deseen utilizar bases de datos sin instalaciones y en usos domésticos.

¿ Cómo lo utilizo ?

Solo necesitas bajar el archivo .py e importarlo desde el archivo donde lo utilizarás.
import db

Luego desde tu archivo principal llamas la clase de la base de datos:

pydb = database("base_datos.txt")

¿ Cuál es la estrucutra de la Base de Datos ?

Base_Datos.Txt :

Tabla(columna1, columna2){
	columna1=Contenido columna1; columna2=Contenido columna2;
}
Personas(nombre, edad, correo){
	nombre=Javier Guajardo; edad=19; correo=javier.guajardo@vodale.com;
	nombre=Juan Andres; edad=25; correo=contacto@dominio.com;
}
...

¿ Cómo manejo mi base de datos ?

Para manejar tu Base de Datos, PyDB dispone de las siguientes funciones:

- Añadir valor. (En SQL -> INSERT INTO)
- Eliminar valor. (En SQL -> DELETE FROM tabla WHERE campo=valor)
- Actualizar valor (En SQL -> UPDATE)
- Ver Tabla.
- Consultar valor (En SQL -> SELECT campo FROM tabla)
- Ver columnas de una tabla .

Nota: "Hay 2 funciones diferentes para añadir un valor. 
Una es con add_value(tabla) , la cuál le solicitará automáticamente los datos a añadir (detecta solo los campos) con raw_input()
Mientras que add_values(tabla, columna, valor) , está hecho para añadir un valor sin raw_input() , sino que pasando la columna y
su valor por parámetros, orientado a programas que deseen insertar datos de manera automatizada.
-------------------------------------------------------------------------------------------------------
Añadir valor a la tabla:

import db

pydb = db.database()
print add_value(tabla)

Una vez hecho esto, el programa detectará las columnas de la tabla y nos solicitará uno a uno los datos. Una vez finalizado
los nuevos valores ya estarán en nuestra Base de Datos
-------------------------------------------------------------------------------------------------------

Eliminar valor:

import db

pydb = db.database()
print delete_value("campo=valor;", 1)

Si le pasas el parámetro 1, el programa devolverá "Datos eliminados correctamente!", de lo contrario será eliminación silenciosa.
Nota: Así como no saldrá "Datos eliminados correctamente!", tampoco saldrá si hubo un error al eliminar los datos.
-------------------------------------------------------------------------------------------------------

Actualizar valor:

import db

pydb = db.database()
print pydb.update_value("columna", "valor antiguo", "nuevo valor");

Le puedes agregar luego del nuevo valor el parámetro 1 para devolver la salida de "Correcto" o "Incorrecto"
-------------------------------------------------------------------------------------------------------

Ver Tabla:

import db

pydb = db.database()
print pydb.view_table("Tabla")

Nos mostrará todas las columnas y los valores isnertos en la base de datos.
-------------------------------------------------------------------------------------------------------

Consultar valor:

import db

pydb = db.database()
print pydb.getdata("tabla", "columna")

Mostrará todos los valores insertados en una columna específica.
Nota: La salida es en forma de Array
-------------------------------------------------------------------------------------------------------

Ver Columnas:

import db

pydb = db.database()
print pydb.view_columns("tabla")

Mostrará la estructura que conforma la tabla pasada en el parámetro anterior.