isar 0.1.0 isar: ^0.1.0 copied to clipboard
Fast Cross Platform Database for Flutter & Web Apps. Supports indexes, FTS, queries etc.
Isar Database
π§ Very unstable and not ready for serious usage π§
Quickstart β’ Documentation β’ Examples β’ Support & Ideas β’ Pub.dev
Isar [ee-zahr]:
- River in Bavaria, Germany.
- Database that will make your life easier.
Features #
- β‘οΈ Launch your app instantly no matter how much data you have
- π Highly scalable from hundreds to tens of thousands of records
- π Lazy loaded. Only load data when you need it
- π Full-text search. Make searching fast and fun
- π± Multiplatform. iOS, Android, Desktop and the web (soonβ’)
- π Made for Flutter. Easily use it in your Flutter app
- π§ͺ ACID semantics. Rely on consistency
- β± Asynchronous. Parallel query operations & multi-isolate support
- β οΈ Static typing with compile-time checked and autocompleted queries
Add to pubspec.yaml #
dependencies:
isar: any
isar_flutter_libs: any # contains the binaries
dev_dependencies:
isar_generator: any
build_runnder: any
Schema definition #
@Collection()
class Post {
int? id; // auto increment id
@Index(indexType: IndexType.words, caseSensitive: false) // Search index
String title;
List<String> comments
}
CRUD operations #
All basic crud operations are available via the IsarCollection.
final newPost = Post()
..id = uuid.v4()
..title = 'Amazing new database'
..comments = ['First'];
await isar.writeTxn((isar) {
await isar.posts.put(newPost); // insert
});
final existingPost = await isar.get(newPost.id); // get
await isar.writeTxn((isar) {
await isar.posts.delete(existingPost.id); // delete
});
Queries #
Isar has a powerful query language that allows you to make use of your indexes, filter distinct objects, use complex and()
and or()
groups and sort the results.
final isar = await openIsar();
final databasePosts = isar.posts
.where()
.titleWordBeginsWith('DaTAb') // use case insensitive search index
.limit(10)
.findAll()
final postsWithFirstCommentOrTitle = isar.posts
.where()
.filter()
.commentsAnyEqualTo('first', caseSensitive: false)
.or()
.titleEqualTo('first')
.findAll();
Links #
You can easily define relationships between objects. In Isar they are called links and backlinks:
class Person {
String name;
IsarLink<Person> mother;
IsarLinks<Pet> pets;
}
Watchers #
With Isar, you can watch Collections, Objects, or Queries. A watcher is notified after a transaction commits successfully and the target actually changes. Watchers can be lazy and not reload the data or they can be non-lazy and fetch new results in the background.
Stream<void> collectionStream = isar.posts.watch(lazy: true);
Stream<List<Post>> queryStream = databasePosts.watch(lazy: false);
queryStream.listen((newResult) {
// do UI updates
})
License #
Copyright 2021 Simon Leier
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.