Added README
This commit is contained in:
parent
35af57732e
commit
1adcaa2e22
62
README.md
Normal file
62
README.md
Normal file
@ -0,0 +1,62 @@
|
||||
# PawSQLite
|
||||
|
||||
PawSQLite is a library for interacting with SQLite databases. Through the use of multiple adapters for various environments, it provides a simple API that abstracts out implementation specific quirks.
|
||||
|
||||
## Installation
|
||||
|
||||
You can install using npm:
|
||||
|
||||
```bash
|
||||
npm install -s git+https://git.n0m.org/n0m/PawSQLite.git
|
||||
```
|
||||
In order to actually use PawSQLite, you must also install an adapter for your specific environment. Currently, adapters are available for the following environments:
|
||||
|
||||
### WebSQL:
|
||||
PawSQLite-WebSQL-Adapter: [https://git.n0m.org/n0m/PawSQLite-WebSQL-Adapter](https://git.n0m.org/n0m/PawSQLite-WebSQL-Adapter)
|
||||
|
||||
|
||||
### Apache Cordova:
|
||||
PawSQLite-Cordova-Adapter: [https://git.n0m.org/n0m/PawSQLite-Cordova-Adapter](https://git.n0m.org/n0m/PawSQLite-Cordova-Adapter)
|
||||
|
||||
|
||||
### Node.js via Sqlite3 package:
|
||||
Coming Soon!
|
||||
|
||||
## Usage
|
||||
|
||||
```javascript
|
||||
const PawSQLite = require("pawsqlite");
|
||||
const PawSQLiteWebSQLAdapter = require("pawsqlite-websql-adapter");
|
||||
|
||||
PawSQLite.registerAdapter(PawSQLiteWebSQLAdapter)
|
||||
|
||||
const db = await PawSQLite.open("test", {
|
||||
adapter: 'PawSQLiteWebSQLAdapter'
|
||||
});
|
||||
|
||||
await db.sql(`
|
||||
CREATE TABLE contacts (
|
||||
contact_id INTEGER PRIMARY KEY,
|
||||
first_name TEXT NOT NULL,
|
||||
last_name TEXT NOT NULL
|
||||
);
|
||||
`);
|
||||
|
||||
const transaction = db.transaction();
|
||||
|
||||
console.log(await db.sql("SELECT * FROM contacts"));
|
||||
|
||||
await transaction.sql(
|
||||
"INSERT INTO contacts (first_name, last_name) VALUES (?, ?)",
|
||||
"John",
|
||||
"Lennon"
|
||||
);
|
||||
|
||||
await transaction.commit();
|
||||
```
|
||||
|
||||
## Contributing
|
||||
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
|
||||
|
||||
## License
|
||||
[MIT](https://choosealicense.com/licenses/mit/)
|
Loading…
Reference in New Issue
Block a user