Builderbot ORM

Builderbot ORM es un paquete que te facilita instanciar bases de datos, crear tablas, hacer consultas de manera dinamica y mucho mas sencilla.

📚 Table of Contents

• 🛠️ Instalacion
  • Usar NPM
  • Usar yarn
  • Usar pnpm
• 🎯 Examples
  • Ejemplo Mysql
  • Ejemplo MongoDB

🛠️ Instala la libreria con tu paquete favorito

Usando npm:

npm i builderbot-orm

Usando yarn:

yarn add builderbot-orm

Usando pnpm:

pnpm add builderbot-orm

Ejemplo basico con mysql

Este es un ejemplo basico de como usar la libreria con bases de datos Mysql

//Importancion con Commonjs
const { ORMBuilderBot } = require("builderbot-orm");

//Importancion con Typescript
import { ORMBuilderBot } from 'builderbot-orm'

//Instanciamos el metodo
const orm = new ORMBuilderBot();

//Builderbot adapter nos ayuda a conectar con nuesta base de datos favorita:
// adaters disponibles: mysql y mongo, muy pronto postgres

const db = await orm.BuilderBotDBAdapter({
adapter: "mysql", 
mysqlOptions: { dburl: "mysql://root@localhost:3306/test" } 
});

//Creando una tabla e insertando datos
const objetTables={
    tableName: "users",
        columns: {
            id:"INT AUTO_INCREMENT PRIMARY KEY",
            name:"VARCHAR(150)",
            email:"VARCHAR(150)",
            age: "INT"
       }, 
       values:{
            name: "John Doe",
            email: "[email protected]",
            age: 20
        }
}

//Si ya tenemos una tabla creada en mysql puedes omitir el parametro columns
const objetTables={
    tableName: "users",
       values:{
            name: "John Doe",
            email: "[email protected]",
            age: 20
    }
}

const table = await orm.createTables(objetTables)

//  console.log(table) => Data inserted successfully


//Encontrar un dato en la tabla de mysql
const find = await orm.find({ tableName: "users", type: { age: 20 } });

//  console.log(find) => Retorna el objeto encontrado con ese parametro en este caso busca y encuentra todos los datos cuyo age sean 20


//para actualizar un dato de la tabla
// TableName -> nombre de la tabla
// Fiels -> campos que seran actualizados
// Cond -> condicional para realizar el campo, es un similar al tipo WHERE

const updateUser = await orm.update({
        tableName: "users",
        fields: {
            email: "[email protected]",
            age: 21
        }, cond: { name: "Jhon Doe" }
});

//  console.log(updateUser) => Retorna el objeto con el cambio realizado


//Eliminar un dato en la tabla de mysql
const delete = await orm.delete({ tableName: "users", type: { name:"John Doe" } });
// console.log(delete) Elimina el dato en la tabla

Ejemplo basico con mongodb

Este es un ejemplo basico de como usar la libreria con bases de datos mongodb

//Importancion con Commonjs
const { ORMBuilderBot } = require("builderbot-orm");

//Importancion con Typescript
import { ORMBuilderBot } from 'builderbot-orm'

//Instanciamos el metodo
const orm = new ORMBuilderBot();

//Builderbot adapter nos ayuda a conectar con nuesta base de datos favorita:
// adaters disponibles: mysql y mongo, muy pronto postgres

const db = await orm.BuilderBotDBAdapter({ 
adapter:"mongo", 
mongoOptions: { dburl: "mongodb://localhost:27017/test" } 
});

//Creando una tabla e insertando datos
const objetTables={
    tableName: "users",
        columns: {
            name: String, email: String, age: Number 
       }, 
       values:{
            name: "John Doe",
            email: "[email protected]",
            age: 20
        }
}

//Si ya tenemos una coleccion creada en mongo puedes omitir el parametro columns
const objetTables={
    tableName: "users",
       values:{
            name: "John Doe",
            email: "[email protected]",
            age: 20
    }
}

const table = await orm.createTables(objetTables)

//  console.log(table) => Data inserted successfully


//Encontrar un dato en la tabla de mongo
const find = await orm.find({ tableName: "users", type: { age: 20 } });

//  console.log(find) => Retorna el objeto encontrado con ese parametro en este caso busca y encuentra todos los datos cuyo age sean 20


//para actualizar un dato de la coleccion
// TableName -> nombre de la coleccion
// Fiels -> campos que seran actualizados
// Cond -> condicional para realizar el campo, es un similar al tipo WHERE

const updateUser = await orm.update({
        tableName: "users",
        fields: {
            email: "[email protected]",
            age: 21
        }, cond: { name: "Jhon Doe" }
});

//  console.log(updateUser) => Retorna el objeto con el cambio realizado


//Eliminar un dato en la tabla de mongo
const delete = await orm.delete({ tableName: "users", type: { name:"John Doe" } });
// console.log(delete) Elimina el dato en la coleccion