# Formatter SQL Script
Paquete de ayuda, para formatear en lenguaje SQL los datos de una tabla en excel, basta solamente con copiar y pegar la informacion de la tabla en el formato requerido.
> !Importante: El nombre de las columnas de la tabla deben ser los mismos que se tienen en la base de datos, para que el script resultante sea lo mas exacto posible.
> Este paquete, aun se encuentra en desarrollo.
## Estructura de la informacion
Se debe tener en cuenta lo siguiente:
La clase ```GenerateScript``` requiere 3 parametros y 2 opcionales:
- data (str) = La informacion o values a formatear
- table (str) = Nombre de la tabla
- fields (str) = Los campos donde se insertaran los values
- _type (int) = Tipo de operacion permitida (0 = Insert / 1 = Update) por defecto es 0
- where (str) = Condicional del script -> UPDATE
### Como funciona
Para que se pueda utilizar el paquete correctamente, la informacion debe tener una estructura similar a la de una tabla, entre columnas y filas, veamos un ejemplo del formato:
```text
1 prueba testing null
2 prueba testing null
```
Esta estructura de texto se consigue al copiar los datos en un libro del programa excel.
Para el tema de fields (campos / columnas), se debe manejar el mismo orden que tienen los datos para que sea preciso el resultado.
## Ejemplo de uso
Veamos algunos ejemplos practicos:
si queremos formatear a un script insert debemos enviar la informacion de la siguiente manera:
> Los espacios de separacion son tabulaciones \t
```py
# importacion del paquete
from formatter_sql_script import GenerateScript
# asignamos la data copiada de nuestra tabla en una variable entre """ (3) comillas dobles para conservar el formato
data = """1 prueba testing 1
2 prueba2 testing2 0"""
# Copiar y pegar los titulos de las columnas de la tabla de excel de la misma forma que se hizo con los datos
fields = """id nombre descripcion estado"""
# Asigno el nombre de mi tabla en la base de datos
table = 'ejemplo'
# Tipo de procesamiento (0=Insert / 1=Update)
_type = 0
# Instanciamos la clase y hacemos uso del metodo generate_script
resp = (GenerateScript(table=table,
fields=fields,
data=data,
_type=_type)
.generate_script())
# Imprimimos en consola el resultado
print(resp)
```
para el ejemplo anterior, el resultado seria el siguiente:
```sql
insert into ejemplo
(id, nombre, descripcion, estado)
values
(1, 'prueba', 'testing', 1),
(2, 'prueba2', 'testing2', 0):
```
Ahora si realizamos una prueba para un update
```py
# asignamos la data copiada de nuestra tabla en una variable entre """ (3) comillas dobles para conservar el formato
data = """Testing Una prueba de update 0"""
# Copiar y pegar los titulos de las columnas de la tabla de excel de la misma forma que se hizo con los datos
fields = """nombre descripcion estado"""
# Asigno el nombre de mi tabla en la base de datos
table = 'ejemplo'
# Tipo de procesamiento (0=Insert / 1=Update)
_type = 1
# Instanciamos la clase y hacemos uso del metodo generate_script
resp = (GenerateScript(table=table,
fields=fields,
data=data,
_type=_type,
where='id = 1')
.generate_script())
# Imprimimos en consola el resultado
print(resp)
```
para el ejemplo anterior, el resultado seria el siguiente:
```sql
UPDATE ejemplo
SET nombre = 'Testing',
descripcion = 'Una prueba de update',
estado = 0
WHERE id = 1;
```
## Desarrollado por
* Felipe Medel
* luispipemedel@gmail.com
Raw data
{
"_id": null,
"home_page": null,
"name": "formatter-sql-script",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "helper, sql Formatter, testing, dev",
"author": "Felipe Medel",
"author_email": "luispipemedel@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/8d/ba/7919f57fabf7b11aff0ea100ab407693748c6acbca7546115006b30452c0/formatter_sql_script-1.1.1.tar.gz",
"platform": null,
"description": "# Formatter SQL Script\r\n\r\nPaquete de ayuda, para formatear en lenguaje SQL los datos de una tabla en excel, basta solamente con copiar y pegar la informacion de la tabla en el formato requerido.\r\n\r\n> !Importante: El nombre de las columnas de la tabla deben ser los mismos que se tienen en la base de datos, para que el script resultante sea lo mas exacto posible. \r\n\r\n> Este paquete, aun se encuentra en desarrollo.\r\n\r\n## Estructura de la informacion\r\n\r\nSe debe tener en cuenta lo siguiente:\r\n\r\nLa clase ```GenerateScript``` requiere 3 parametros y 2 opcionales:\r\n\r\n- data (str) = La informacion o values a formatear\r\n- table (str) = Nombre de la tabla\r\n- fields (str) = Los campos donde se insertaran los values\r\n- _type (int) = Tipo de operacion permitida (0 = Insert / 1 = Update) por defecto es 0\r\n- where (str) = Condicional del script -> UPDATE\r\n\r\n### Como funciona\r\n\r\nPara que se pueda utilizar el paquete correctamente, la informacion debe tener una estructura similar a la de una tabla, entre columnas y filas, veamos un ejemplo del formato: \r\n\r\n```text\r\n1 prueba testing null\r\n2 prueba testing null \r\n``` \r\n\r\nEsta estructura de texto se consigue al copiar los datos en un libro del programa excel.\r\n\r\nPara el tema de fields (campos / columnas), se debe manejar el mismo orden que tienen los datos para que sea preciso el resultado.\r\n\r\n## Ejemplo de uso\r\n\r\nVeamos algunos ejemplos practicos:\r\n\r\nsi queremos formatear a un script insert debemos enviar la informacion de la siguiente manera:\r\n\r\n> Los espacios de separacion son tabulaciones \\t\r\n\r\n```py\r\n# importacion del paquete\r\nfrom formatter_sql_script import GenerateScript\r\n\r\n# asignamos la data copiada de nuestra tabla en una variable entre \"\"\" (3) comillas dobles para conservar el formato \r\ndata = \"\"\"1 prueba testing 1\r\n2 prueba2 testing2 0\"\"\" \r\n\r\n# Copiar y pegar los titulos de las columnas de la tabla de excel de la misma forma que se hizo con los datos\r\nfields = \"\"\"id nombre descripcion estado\"\"\"\r\n\r\n# Asigno el nombre de mi tabla en la base de datos\r\ntable = 'ejemplo'\r\n\r\n# Tipo de procesamiento (0=Insert / 1=Update)\r\n_type = 0\r\n\r\n# Instanciamos la clase y hacemos uso del metodo generate_script\r\nresp = (GenerateScript(table=table, \r\n fields=fields,\r\n data=data, \r\n _type=_type)\r\n .generate_script())\r\n\r\n# Imprimimos en consola el resultado\r\nprint(resp)\r\n```\r\npara el ejemplo anterior, el resultado seria el siguiente:\r\n\r\n```sql\r\ninsert into ejemplo \r\n(id, nombre, descripcion, estado)\r\nvalues\r\n(1, 'prueba', 'testing', 1),\r\n(2, 'prueba2', 'testing2', 0):\r\n```\r\n\r\nAhora si realizamos una prueba para un update\r\n\r\n```py\r\n# asignamos la data copiada de nuestra tabla en una variable entre \"\"\" (3) comillas dobles para conservar el formato \r\ndata = \"\"\"Testing Una prueba de update 0\"\"\" \r\n\r\n# Copiar y pegar los titulos de las columnas de la tabla de excel de la misma forma que se hizo con los datos\r\nfields = \"\"\"nombre descripcion estado\"\"\"\r\n\r\n# Asigno el nombre de mi tabla en la base de datos\r\ntable = 'ejemplo'\r\n\r\n# Tipo de procesamiento (0=Insert / 1=Update)\r\n_type = 1\r\n\r\n# Instanciamos la clase y hacemos uso del metodo generate_script\r\nresp = (GenerateScript(table=table, \r\n fields=fields, \r\n data=data, \r\n _type=_type, \r\n where='id = 1')\r\n .generate_script())\r\n\r\n# Imprimimos en consola el resultado\r\nprint(resp)\r\n```\r\n\r\npara el ejemplo anterior, el resultado seria el siguiente:\r\n\r\n```sql\r\nUPDATE ejemplo \r\nSET nombre = 'Testing', \r\ndescripcion = 'Una prueba de update', \r\nestado = 0\r\nWHERE id = 1;\r\n```\r\n\r\n## Desarrollado por\r\n\r\n* Felipe Medel\r\n* luispipemedel@gmail.com\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Formateador de texto a sentencia de SQL (Insert y Update)",
"version": "1.1.1",
"project_urls": null,
"split_keywords": [
"helper",
" sql formatter",
" testing",
" dev"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8dba7919f57fabf7b11aff0ea100ab407693748c6acbca7546115006b30452c0",
"md5": "9795cdc06410cdeb204fdac7392b2960",
"sha256": "3dcc2bbe6630d2498beb65ad63d50a7dfc7f2085b513e8a7b9ffafc29a4d06f5"
},
"downloads": -1,
"filename": "formatter_sql_script-1.1.1.tar.gz",
"has_sig": false,
"md5_digest": "9795cdc06410cdeb204fdac7392b2960",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 3630,
"upload_time": "2024-07-22T23:11:46",
"upload_time_iso_8601": "2024-07-22T23:11:46.717487Z",
"url": "https://files.pythonhosted.org/packages/8d/ba/7919f57fabf7b11aff0ea100ab407693748c6acbca7546115006b30452c0/formatter_sql_script-1.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-22 23:11:46",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "formatter-sql-script"
}
JSON