Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/agustinsrg/tsbean-driver-postgres
PostgreSQL driver for TSBean-ORM
https://github.com/agustinsrg/tsbean-driver-postgres
orm postgres postgresql tsbean-orm
Last synced: 26 days ago
JSON representation
PostgreSQL driver for TSBean-ORM
- Host: GitHub
- URL: https://github.com/agustinsrg/tsbean-driver-postgres
- Owner: AgustinSRG
- License: mit
- Created: 2021-05-19T09:48:11.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-06-29T09:39:16.000Z (5 months ago)
- Last Synced: 2024-10-09T17:30:54.233Z (about 1 month ago)
- Topics: orm, postgres, postgresql, tsbean-orm
- Language: TypeScript
- Homepage:
- Size: 531 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TSBean-ORM PostgreSQL Driver
[](https://badge.fury.io/js/tsbean-driver-postgres)
This a PostgreSQL driver for [tsbean-orm](https://github.com/AgustinSRG/tsbean-orm).
Based on [pg](https://www.npmjs.com/package/pg) package.
## Installation
```
npm install --save tsbean-driver-postgres
```
## Usage
```ts
import { DataSourceDriver, DataSource } from "tsbean-orm";
import { PostgreSQLDriver } from "tsbean-driver-postgres"
const mySource = PostgreSQLDriver.createDataSource({
host: "localhost",
port: 5432,
user: "postgres",
password: "postgres",
database: "my_database"
});
DataSource.set(DataSource.DEFAULT, mySource);
```
## Correspondence of identifiers
This driver maps from [camel case](https://en.wikipedia.org/wiki/Camel_case) to [snake case](https://en.wikipedia.org/wiki/Snake_case). By default, we expect all the database table and column identifiers in snake case. Those identifiers will be converted to camel case before passing to tsbean, so you can work with camel case identifiers in your code.
Here is an example:
```sql
CREATE TABLE "person" (
"id" BIGINT NOT NULL PRIMARY KEY,
"name" VARCHAR(255) NOT NULL,
"surname" VARCHAR(255) NOT NULL,
"age" INT,
"has_driver_license" BOOLEAN,
"preferences" TEXT,
"birth_date" TIMESTAMPTZ
);
```
```ts
const SOURCE = DataSource.DEFAULT;
const TABLE = "person";
const PRIMARY_KEY = "id";
export class Person extends DataModel {
public static finder = new DataFinder(
SOURCE, // The data source
TABLE, // The table or collection name
PRIMARY_KEY, // The primary key. Leave blank if no primary key
(data: GenericRow) => {
return new Person(data);
},
);
public id: number;
public name: string;
public surname: string;
public age: number;
public hasDriverLicense: boolean;
public preferences: string[];
public birthDate: Date;
constructor(data: GenericRow) {
// First, we call DataModel constructor
super(
SOURCE, // The data source
TABLE, // The table or collection name
PRIMARY_KEY // The primary key. Leave blank if no primary key
);
// Second, we set the class properties
// The recommended way is to set one by one to prevent prototype pollution
// You can also enforce the types if you do not trust the data source
// In that case you can use the enforceType utility function
this.id = enforceType(data.id, "int");
this.name = enforceType(data.name, "string");
this.surname = enforceType(data.surname, "string");
this.age = enforceType(data.age, "int");
this.hasDriverLicense = enforceType(data.hasDriverLicense, "boolean");
this.preferences = enforceType(data.preferences, "array");
this.birthDate = enforceType(data.birthDate, "date");
// Finally, we must call init()
this.init();
}
}
```
If you want to disable this behaviour, and instead use identifiers as-it, you can use the `disableIdentifierConversion` option of the data source constructor:
```ts
const mySource = PostgreSQLDriver.createDataSource({
host: "localhost",
port: 5432,
user: "postgres",
password: "postgres",
database: "my_database",
disableIdentifierConversion: true
});
```
You can also set `customIdentifierConversion` to implement your own identifier conversion.