gitea
2 months ago
parent
5adc1af4ec
commit
38e01c04d0
@ -1,36 +0,0 @@
|
|||||||
name: Flutter CI
|
|
||||||
|
|
||||||
on:
|
|
||||||
push:
|
|
||||||
branches: [ main, master ]
|
|
||||||
pull_request:
|
|
||||||
branches: [ main, master ]
|
|
||||||
|
|
||||||
jobs:
|
|
||||||
test:
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
|
|
||||||
steps:
|
|
||||||
- name: Checkout code
|
|
||||||
uses: actions/checkout@v4
|
|
||||||
|
|
||||||
- name: Setup Flutter
|
|
||||||
uses: subosito/flutter-action@v2
|
|
||||||
with:
|
|
||||||
flutter-version: '3.24.0'
|
|
||||||
channel: 'stable'
|
|
||||||
|
|
||||||
- name: Install dependencies
|
|
||||||
run: flutter pub get
|
|
||||||
|
|
||||||
- name: Run tests
|
|
||||||
run: flutter test
|
|
||||||
|
|
||||||
- name: Report success
|
|
||||||
if: success()
|
|
||||||
run: echo "✅ All tests passed!"
|
|
||||||
|
|
||||||
- name: Report failure
|
|
||||||
if: failure()
|
|
||||||
run: echo "❌ Tests failed!"
|
|
||||||
|
|
||||||
@ -0,0 +1,319 @@
|
|||||||
|
import 'dart:io';
|
||||||
|
import 'dart:convert';
|
||||||
|
import 'package:sqflite/sqflite.dart';
|
||||||
|
import 'package:path/path.dart' as path;
|
||||||
|
import 'package:path_provider/path_provider.dart';
|
||||||
|
import 'package:http/http.dart' as http;
|
||||||
|
import 'models/item.dart';
|
||||||
|
|
||||||
|
/// Service for local storage and caching operations.
|
||||||
|
///
|
||||||
|
/// This service provides:
|
||||||
|
/// - CRUD operations for items stored in a local SQLite database
|
||||||
|
/// - Image caching functionality that downloads and stores images locally
|
||||||
|
///
|
||||||
|
/// The service is designed to be modular and does not depend on UI components.
|
||||||
|
/// All methods are easily mockable for testing and integration with higher-level modules.
|
||||||
|
class LocalStorageService {
|
||||||
|
/// Database instance (null until initialized).
|
||||||
|
Database? _database;
|
||||||
|
|
||||||
|
/// Path to the cache directory for images.
|
||||||
|
Directory? _cacheDirectory;
|
||||||
|
|
||||||
|
/// Map to track cache status (in-memory cache for faster lookups).
|
||||||
|
final Map<String, bool> _cacheStatus = {};
|
||||||
|
|
||||||
|
/// Optional database path for testing (null uses default).
|
||||||
|
final String? _testDbPath;
|
||||||
|
|
||||||
|
/// Optional cache directory path for testing (null uses default).
|
||||||
|
final Directory? _testCacheDir;
|
||||||
|
|
||||||
|
/// Creates a LocalStorageService instance.
|
||||||
|
///
|
||||||
|
/// [testDbPath] - Optional database path for testing.
|
||||||
|
/// [testCacheDir] - Optional cache directory for testing.
|
||||||
|
LocalStorageService({
|
||||||
|
String? testDbPath,
|
||||||
|
Directory? testCacheDir,
|
||||||
|
}) : _testDbPath = testDbPath,
|
||||||
|
_testCacheDir = testCacheDir;
|
||||||
|
|
||||||
|
/// Initializes the database and cache directory.
|
||||||
|
///
|
||||||
|
/// Must be called before using any other methods.
|
||||||
|
///
|
||||||
|
/// Throws [Exception] if initialization fails.
|
||||||
|
Future<void> initialize() async {
|
||||||
|
try {
|
||||||
|
// Initialize database
|
||||||
|
final dbPath = _testDbPath ?? await _getDatabasePath();
|
||||||
|
_database = await openDatabase(
|
||||||
|
dbPath,
|
||||||
|
version: 1,
|
||||||
|
onCreate: _onCreate,
|
||||||
|
);
|
||||||
|
|
||||||
|
// Initialize cache directory
|
||||||
|
if (_testCacheDir != null) {
|
||||||
|
_cacheDirectory = _testCacheDir;
|
||||||
|
} else {
|
||||||
|
final appDir = await getApplicationDocumentsDirectory();
|
||||||
|
_cacheDirectory = Directory(path.join(appDir.path, 'image_cache'));
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!await _cacheDirectory!.exists()) {
|
||||||
|
await _cacheDirectory!.create(recursive: true);
|
||||||
|
}
|
||||||
|
} catch (e) {
|
||||||
|
throw Exception('Failed to initialize LocalStorageService: $e');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Creates the database schema if it doesn't exist.
|
||||||
|
Future<void> _onCreate(Database db, int version) async {
|
||||||
|
await db.execute('''
|
||||||
|
CREATE TABLE items (
|
||||||
|
id TEXT PRIMARY KEY,
|
||||||
|
data TEXT NOT NULL,
|
||||||
|
created_at INTEGER NOT NULL,
|
||||||
|
updated_at INTEGER NOT NULL
|
||||||
|
)
|
||||||
|
''');
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Converts Map to JSON string for database storage.
|
||||||
|
String _dataToJson(Map<String, dynamic> data) {
|
||||||
|
return jsonEncode(data);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Converts JSON string from database to Map.
|
||||||
|
Map<String, dynamic> _jsonToData(String jsonString) {
|
||||||
|
return jsonDecode(jsonString) as Map<String, dynamic>;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Gets the path to the database file.
|
||||||
|
Future<String> _getDatabasePath() async {
|
||||||
|
final documentsDirectory = await getApplicationDocumentsDirectory();
|
||||||
|
return path.join(documentsDirectory.path, 'local_storage.db');
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Ensures the database is initialized.
|
||||||
|
///
|
||||||
|
/// Throws [Exception] if database is not initialized.
|
||||||
|
void _ensureInitialized() {
|
||||||
|
if (_database == null) {
|
||||||
|
throw Exception('LocalStorageService not initialized. Call initialize() first.');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Inserts a new item into the database.
|
||||||
|
///
|
||||||
|
/// [item] - The item to insert.
|
||||||
|
///
|
||||||
|
/// Throws [Exception] if insertion fails or if item with same ID already exists.
|
||||||
|
Future<void> insertItem(Item item) async {
|
||||||
|
_ensureInitialized();
|
||||||
|
try {
|
||||||
|
final map = item.toMap();
|
||||||
|
map['data'] = _dataToJson(map['data'] as Map<String, dynamic>);
|
||||||
|
await _database!.insert(
|
||||||
|
'items',
|
||||||
|
map,
|
||||||
|
conflictAlgorithm: ConflictAlgorithm.replace,
|
||||||
|
);
|
||||||
|
} catch (e) {
|
||||||
|
throw Exception('Failed to insert item: $e');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Retrieves an item by its ID.
|
||||||
|
///
|
||||||
|
/// [id] - The unique identifier of the item.
|
||||||
|
///
|
||||||
|
/// Returns the [Item] if found, null otherwise.
|
||||||
|
/// Throws [Exception] if retrieval fails.
|
||||||
|
Future<Item?> getItem(String id) async {
|
||||||
|
_ensureInitialized();
|
||||||
|
try {
|
||||||
|
final List<Map<String, dynamic>> maps = await _database!.query(
|
||||||
|
'items',
|
||||||
|
where: 'id = ?',
|
||||||
|
whereArgs: [id],
|
||||||
|
limit: 1,
|
||||||
|
);
|
||||||
|
|
||||||
|
if (maps.isEmpty) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Parse data from JSON string
|
||||||
|
final row = maps.first;
|
||||||
|
final dataMap = _jsonToData(row['data'] as String);
|
||||||
|
|
||||||
|
return Item(
|
||||||
|
id: row['id'] as String,
|
||||||
|
data: dataMap,
|
||||||
|
createdAt: row['created_at'] as int,
|
||||||
|
updatedAt: row['updated_at'] as int,
|
||||||
|
);
|
||||||
|
} catch (e) {
|
||||||
|
throw Exception('Failed to get item: $e');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Retrieves all items from the database.
|
||||||
|
///
|
||||||
|
/// Returns a list of all [Item] instances, ordered by creation date (newest first).
|
||||||
|
/// Returns empty list if no items exist.
|
||||||
|
/// Throws [Exception] if retrieval fails.
|
||||||
|
Future<List<Item>> getAllItems() async {
|
||||||
|
_ensureInitialized();
|
||||||
|
try {
|
||||||
|
final List<Map<String, dynamic>> maps = await _database!.query(
|
||||||
|
'items',
|
||||||
|
orderBy: 'created_at DESC',
|
||||||
|
);
|
||||||
|
|
||||||
|
return maps.map((row) {
|
||||||
|
final dataMap = _jsonToData(row['data'] as String);
|
||||||
|
return Item(
|
||||||
|
id: row['id'] as String,
|
||||||
|
data: dataMap,
|
||||||
|
createdAt: row['created_at'] as int,
|
||||||
|
updatedAt: row['updated_at'] as int,
|
||||||
|
);
|
||||||
|
}).toList();
|
||||||
|
} catch (e) {
|
||||||
|
throw Exception('Failed to get all items: $e');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Deletes an item by its ID.
|
||||||
|
///
|
||||||
|
/// [id] - The unique identifier of the item to delete.
|
||||||
|
///
|
||||||
|
/// Throws [Exception] if deletion fails.
|
||||||
|
Future<void> deleteItem(String id) async {
|
||||||
|
_ensureInitialized();
|
||||||
|
try {
|
||||||
|
final deleted = await _database!.delete(
|
||||||
|
'items',
|
||||||
|
where: 'id = ?',
|
||||||
|
whereArgs: [id],
|
||||||
|
);
|
||||||
|
|
||||||
|
if (deleted == 0) {
|
||||||
|
throw Exception('Item with id $id not found');
|
||||||
|
}
|
||||||
|
} catch (e) {
|
||||||
|
throw Exception('Failed to delete item: $e');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Updates an existing item in the database.
|
||||||
|
///
|
||||||
|
/// [item] - The item with updated data. The ID must exist in the database.
|
||||||
|
///
|
||||||
|
/// Throws [Exception] if update fails or if item doesn't exist.
|
||||||
|
Future<void> updateItem(Item item) async {
|
||||||
|
_ensureInitialized();
|
||||||
|
try {
|
||||||
|
// Update the updated_at timestamp
|
||||||
|
final updatedItem = item.copyWith(
|
||||||
|
updatedAt: DateTime.now().millisecondsSinceEpoch,
|
||||||
|
);
|
||||||
|
|
||||||
|
final map = updatedItem.toMap();
|
||||||
|
map['data'] = _dataToJson(map['data'] as Map<String, dynamic>);
|
||||||
|
|
||||||
|
final updated = await _database!.update(
|
||||||
|
'items',
|
||||||
|
map,
|
||||||
|
where: 'id = ?',
|
||||||
|
whereArgs: [item.id],
|
||||||
|
);
|
||||||
|
|
||||||
|
if (updated == 0) {
|
||||||
|
throw Exception('Item with id ${item.id} not found');
|
||||||
|
}
|
||||||
|
} catch (e) {
|
||||||
|
throw Exception('Failed to update item: $e');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Gets a cached image file, downloading it if not available in cache.
|
||||||
|
///
|
||||||
|
/// [url] - The URL of the image to fetch.
|
||||||
|
///
|
||||||
|
/// Returns a [File] pointing to the cached image.
|
||||||
|
///
|
||||||
|
/// Behavior:
|
||||||
|
/// - If image exists in cache, returns the cached file immediately.
|
||||||
|
/// - If image is not cached, downloads it, stores in cache, and returns the file.
|
||||||
|
///
|
||||||
|
/// Throws [Exception] if download fails or cache directory is not initialized.
|
||||||
|
Future<File> getCachedImage(String url) async {
|
||||||
|
if (_cacheDirectory == null) {
|
||||||
|
throw Exception('Cache directory not initialized. Call initialize() first.');
|
||||||
|
}
|
||||||
|
|
||||||
|
// Generate cache file name from URL (using hash to avoid invalid file names)
|
||||||
|
final urlHash = url.hashCode.toString();
|
||||||
|
final cacheFile = File(path.join(_cacheDirectory!.path, urlHash));
|
||||||
|
|
||||||
|
// Check if file exists in cache
|
||||||
|
if (await cacheFile.exists()) {
|
||||||
|
_cacheStatus[url] = true;
|
||||||
|
return cacheFile;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Download and cache the image
|
||||||
|
try {
|
||||||
|
final response = await http.get(Uri.parse(url));
|
||||||
|
|
||||||
|
if (response.statusCode != 200) {
|
||||||
|
throw Exception('Failed to download image: HTTP ${response.statusCode}');
|
||||||
|
}
|
||||||
|
|
||||||
|
await cacheFile.writeAsBytes(response.bodyBytes);
|
||||||
|
_cacheStatus[url] = true;
|
||||||
|
|
||||||
|
return cacheFile;
|
||||||
|
} catch (e) {
|
||||||
|
throw Exception('Failed to cache image: $e');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Clears all cached images.
|
||||||
|
///
|
||||||
|
/// Throws [Exception] if cache directory is not initialized.
|
||||||
|
Future<void> clearImageCache() async {
|
||||||
|
if (_cacheDirectory == null) {
|
||||||
|
throw Exception('Cache directory not initialized. Call initialize() first.');
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
if (await _cacheDirectory!.exists()) {
|
||||||
|
await for (final entity in _cacheDirectory!.list()) {
|
||||||
|
if (entity is File) {
|
||||||
|
await entity.delete();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
_cacheStatus.clear();
|
||||||
|
} catch (e) {
|
||||||
|
throw Exception('Failed to clear image cache: $e');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Closes the database connection.
|
||||||
|
///
|
||||||
|
/// Should be called when the service is no longer needed.
|
||||||
|
Future<void> close() async {
|
||||||
|
await _database?.close();
|
||||||
|
_database = null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
@ -0,0 +1,85 @@
|
|||||||
|
/// Data model representing an item stored in local storage.
|
||||||
|
///
|
||||||
|
/// This model is used for storing items (e.g., image metadata or records)
|
||||||
|
/// in the local database. Each item has a unique ID and can contain
|
||||||
|
/// arbitrary JSON data.
|
||||||
|
class Item {
|
||||||
|
/// Unique identifier for the item.
|
||||||
|
final String id;
|
||||||
|
|
||||||
|
/// JSON-serializable data stored with the item.
|
||||||
|
final Map<String, dynamic> data;
|
||||||
|
|
||||||
|
/// Timestamp when the item was created (milliseconds since epoch).
|
||||||
|
final int createdAt;
|
||||||
|
|
||||||
|
/// Timestamp when the item was last updated (milliseconds since epoch).
|
||||||
|
final int updatedAt;
|
||||||
|
|
||||||
|
/// Creates an [Item] instance.
|
||||||
|
///
|
||||||
|
/// [id] - Unique identifier for the item.
|
||||||
|
/// [data] - JSON-serializable data to store.
|
||||||
|
/// [createdAt] - Creation timestamp (defaults to current time).
|
||||||
|
/// [updatedAt] - Update timestamp (defaults to current time).
|
||||||
|
Item({
|
||||||
|
required this.id,
|
||||||
|
required this.data,
|
||||||
|
int? createdAt,
|
||||||
|
int? updatedAt,
|
||||||
|
}) : createdAt = createdAt ?? DateTime.now().millisecondsSinceEpoch,
|
||||||
|
updatedAt = updatedAt ?? DateTime.now().millisecondsSinceEpoch;
|
||||||
|
|
||||||
|
/// Creates an [Item] from a database row (Map).
|
||||||
|
factory Item.fromMap(Map<String, dynamic> map) {
|
||||||
|
return Item(
|
||||||
|
id: map['id'] as String,
|
||||||
|
data: map['data'] as Map<String, dynamic>,
|
||||||
|
createdAt: map['created_at'] as int,
|
||||||
|
updatedAt: map['updated_at'] as int,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Converts the [Item] to a Map for database storage.
|
||||||
|
Map<String, dynamic> toMap() {
|
||||||
|
return {
|
||||||
|
'id': id,
|
||||||
|
'data': data,
|
||||||
|
'created_at': createdAt,
|
||||||
|
'updated_at': updatedAt,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Creates a copy of this [Item] with updated fields.
|
||||||
|
Item copyWith({
|
||||||
|
String? id,
|
||||||
|
Map<String, dynamic>? data,
|
||||||
|
int? createdAt,
|
||||||
|
int? updatedAt,
|
||||||
|
}) {
|
||||||
|
return Item(
|
||||||
|
id: id ?? this.id,
|
||||||
|
data: data ?? this.data,
|
||||||
|
createdAt: createdAt ?? this.createdAt,
|
||||||
|
updatedAt: updatedAt ?? this.updatedAt,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
@override
|
||||||
|
String toString() {
|
||||||
|
return 'Item(id: $id, data: $data, createdAt: $createdAt, updatedAt: $updatedAt)';
|
||||||
|
}
|
||||||
|
|
||||||
|
@override
|
||||||
|
bool operator ==(Object other) {
|
||||||
|
if (identical(this, other)) return true;
|
||||||
|
return other is Item &&
|
||||||
|
other.id == id &&
|
||||||
|
other.createdAt == createdAt &&
|
||||||
|
other.updatedAt == updatedAt;
|
||||||
|
}
|
||||||
|
|
||||||
|
@override
|
||||||
|
int get hashCode => id.hashCode ^ createdAt.hashCode ^ updatedAt.hashCode;
|
||||||
|
}
|
||||||
|
|
||||||
@ -0,0 +1,353 @@
|
|||||||
|
import 'dart:io';
|
||||||
|
import 'package:flutter_test/flutter_test.dart';
|
||||||
|
import 'package:app_boilerplate/data/local/local_storage_service.dart';
|
||||||
|
import 'package:app_boilerplate/data/local/models/item.dart';
|
||||||
|
import 'package:path/path.dart' as path;
|
||||||
|
import 'package:sqflite_common_ffi/sqflite_ffi.dart';
|
||||||
|
|
||||||
|
void main() {
|
||||||
|
// Initialize Flutter bindings for path_provider to work in tests
|
||||||
|
TestWidgetsFlutterBinding.ensureInitialized();
|
||||||
|
|
||||||
|
// Initialize sqflite for testing (required for VM/desktop tests)
|
||||||
|
sqfliteFfiInit();
|
||||||
|
databaseFactory = databaseFactoryFfi;
|
||||||
|
|
||||||
|
late LocalStorageService service;
|
||||||
|
late Directory testDir;
|
||||||
|
late String testDbPath;
|
||||||
|
late Directory testCacheDir;
|
||||||
|
|
||||||
|
setUp(() async {
|
||||||
|
// Create a temporary directory for testing
|
||||||
|
testDir = await Directory.systemTemp.createTemp('local_storage_test_');
|
||||||
|
testDbPath = path.join(testDir.path, 'test_local_storage.db');
|
||||||
|
testCacheDir = Directory(path.join(testDir.path, 'image_cache'));
|
||||||
|
|
||||||
|
// Create service with test paths (bypasses path_provider platform channels)
|
||||||
|
service = LocalStorageService(
|
||||||
|
testDbPath: testDbPath,
|
||||||
|
testCacheDir: testCacheDir,
|
||||||
|
);
|
||||||
|
await service.initialize();
|
||||||
|
});
|
||||||
|
|
||||||
|
tearDown(() async {
|
||||||
|
await service.close();
|
||||||
|
// Clean up test files and directory
|
||||||
|
try {
|
||||||
|
if (await testDir.exists()) {
|
||||||
|
await testDir.delete(recursive: true);
|
||||||
|
}
|
||||||
|
} catch (_) {
|
||||||
|
// Ignore cleanup errors
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
group('LocalStorageService - CRUD Operations', () {
|
||||||
|
/// Tests that inserting an item successfully stores it in the database.
|
||||||
|
test('insertItem - success', () async {
|
||||||
|
// Arrange
|
||||||
|
final item = Item(
|
||||||
|
id: 'test-1',
|
||||||
|
data: {'name': 'Test Item', 'value': 123},
|
||||||
|
);
|
||||||
|
|
||||||
|
// Act
|
||||||
|
await service.insertItem(item);
|
||||||
|
|
||||||
|
// Assert
|
||||||
|
final retrieved = await service.getItem('test-1');
|
||||||
|
expect(retrieved, isNotNull);
|
||||||
|
expect(retrieved!.id, equals('test-1'));
|
||||||
|
expect(retrieved.data['name'], equals('Test Item'));
|
||||||
|
expect(retrieved.data['value'], equals(123));
|
||||||
|
});
|
||||||
|
|
||||||
|
/// Tests that inserting an item with existing ID replaces it.
|
||||||
|
test('insertItem - replaces existing item', () async {
|
||||||
|
// Arrange
|
||||||
|
final item1 = Item(
|
||||||
|
id: 'test-1',
|
||||||
|
data: {'name': 'Original'},
|
||||||
|
);
|
||||||
|
final item2 = Item(
|
||||||
|
id: 'test-1',
|
||||||
|
data: {'name': 'Updated'},
|
||||||
|
);
|
||||||
|
|
||||||
|
// Act
|
||||||
|
await service.insertItem(item1);
|
||||||
|
await service.insertItem(item2);
|
||||||
|
|
||||||
|
// Assert
|
||||||
|
final retrieved = await service.getItem('test-1');
|
||||||
|
expect(retrieved, isNotNull);
|
||||||
|
expect(retrieved!.data['name'], equals('Updated'));
|
||||||
|
});
|
||||||
|
|
||||||
|
/// Tests that getting a non-existent item returns null.
|
||||||
|
test('getItem - returns null for non-existent item', () async {
|
||||||
|
// Act
|
||||||
|
final result = await service.getItem('non-existent');
|
||||||
|
|
||||||
|
// Assert
|
||||||
|
expect(result, isNull);
|
||||||
|
});
|
||||||
|
|
||||||
|
/// Tests that getting an item returns the correct data.
|
||||||
|
test('getItem - success', () async {
|
||||||
|
// Arrange
|
||||||
|
final item = Item(
|
||||||
|
id: 'test-2',
|
||||||
|
data: {'title': 'Test Title', 'count': 42},
|
||||||
|
);
|
||||||
|
await service.insertItem(item);
|
||||||
|
|
||||||
|
// Act
|
||||||
|
final retrieved = await service.getItem('test-2');
|
||||||
|
|
||||||
|
// Assert
|
||||||
|
expect(retrieved, isNotNull);
|
||||||
|
expect(retrieved!.id, equals('test-2'));
|
||||||
|
expect(retrieved.data['title'], equals('Test Title'));
|
||||||
|
expect(retrieved.data['count'], equals(42));
|
||||||
|
});
|
||||||
|
|
||||||
|
/// Tests that getAllItems returns all stored items.
|
||||||
|
test('getAllItems - returns all items', () async {
|
||||||
|
// Arrange
|
||||||
|
final item1 = Item(id: 'test-1', data: {'name': 'Item 1'});
|
||||||
|
final item2 = Item(id: 'test-2', data: {'name': 'Item 2'});
|
||||||
|
final item3 = Item(id: 'test-3', data: {'name': 'Item 3'});
|
||||||
|
|
||||||
|
await service.insertItem(item1);
|
||||||
|
await service.insertItem(item2);
|
||||||
|
await service.insertItem(item3);
|
||||||
|
|
||||||
|
// Act
|
||||||
|
final items = await service.getAllItems();
|
||||||
|
|
||||||
|
// Assert
|
||||||
|
expect(items.length, equals(3));
|
||||||
|
expect(items.map((i) => i.id).toList(), containsAll(['test-1', 'test-2', 'test-3']));
|
||||||
|
});
|
||||||
|
|
||||||
|
/// Tests that getAllItems returns empty list when no items exist.
|
||||||
|
test('getAllItems - returns empty list when no items', () async {
|
||||||
|
// Act
|
||||||
|
final items = await service.getAllItems();
|
||||||
|
|
||||||
|
// Assert
|
||||||
|
expect(items, isEmpty);
|
||||||
|
});
|
||||||
|
|
||||||
|
/// Tests that getAllItems returns items in descending order by creation date.
|
||||||
|
test('getAllItems - returns items in descending order', () async {
|
||||||
|
// Arrange
|
||||||
|
final item1 = Item(id: 'test-1', data: {'name': 'First'});
|
||||||
|
await Future.delayed(const Duration(milliseconds: 10));
|
||||||
|
final item2 = Item(id: 'test-2', data: {'name': 'Second'});
|
||||||
|
await Future.delayed(const Duration(milliseconds: 10));
|
||||||
|
final item3 = Item(id: 'test-3', data: {'name': 'Third'});
|
||||||
|
|
||||||
|
await service.insertItem(item1);
|
||||||
|
await service.insertItem(item2);
|
||||||
|
await service.insertItem(item3);
|
||||||
|
|
||||||
|
// Act
|
||||||
|
final items = await service.getAllItems();
|
||||||
|
|
||||||
|
// Assert
|
||||||
|
expect(items.length, equals(3));
|
||||||
|
expect(items[0].id, equals('test-3')); // Newest first
|
||||||
|
expect(items[2].id, equals('test-1')); // Oldest last
|
||||||
|
});
|
||||||
|
|
||||||
|
/// Tests that deleting an item removes it from the database.
|
||||||
|
test('deleteItem - success', () async {
|
||||||
|
// Arrange
|
||||||
|
final item = Item(id: 'test-1', data: {'name': 'Test'});
|
||||||
|
await service.insertItem(item);
|
||||||
|
|
||||||
|
// Act
|
||||||
|
await service.deleteItem('test-1');
|
||||||
|
|
||||||
|
// Assert
|
||||||
|
final retrieved = await service.getItem('test-1');
|
||||||
|
expect(retrieved, isNull);
|
||||||
|
});
|
||||||
|
|
||||||
|
/// Tests that deleting a non-existent item throws an exception.
|
||||||
|
test('deleteItem - throws exception for non-existent item', () async {
|
||||||
|
// Act & Assert
|
||||||
|
expect(
|
||||||
|
() => service.deleteItem('non-existent'),
|
||||||
|
throwsException,
|
||||||
|
);
|
||||||
|
});
|
||||||
|
|
||||||
|
/// Tests that updating an item modifies it correctly.
|
||||||
|
test('updateItem - success', () async {
|
||||||
|
// Arrange
|
||||||
|
final item = Item(id: 'test-1', data: {'name': 'Original'});
|
||||||
|
await service.insertItem(item);
|
||||||
|
final originalTimestamp = item.updatedAt;
|
||||||
|
|
||||||
|
await Future.delayed(const Duration(milliseconds: 10));
|
||||||
|
|
||||||
|
final updatedItem = item.copyWith(
|
||||||
|
data: {'name': 'Updated'},
|
||||||
|
);
|
||||||
|
|
||||||
|
// Act
|
||||||
|
await service.updateItem(updatedItem);
|
||||||
|
|
||||||
|
// Assert
|
||||||
|
final retrieved = await service.getItem('test-1');
|
||||||
|
expect(retrieved, isNotNull);
|
||||||
|
expect(retrieved!.data['name'], equals('Updated'));
|
||||||
|
expect(retrieved.updatedAt, greaterThan(originalTimestamp));
|
||||||
|
});
|
||||||
|
|
||||||
|
/// Tests that updating a non-existent item throws an exception.
|
||||||
|
test('updateItem - throws exception for non-existent item', () async {
|
||||||
|
// Arrange
|
||||||
|
final item = Item(id: 'non-existent', data: {'name': 'Test'});
|
||||||
|
|
||||||
|
// Act & Assert
|
||||||
|
expect(
|
||||||
|
() => service.updateItem(item),
|
||||||
|
throwsException,
|
||||||
|
);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
group('LocalStorageService - Image Caching', () {
|
||||||
|
/// Tests that getCachedImage throws exception for invalid URL.
|
||||||
|
test('getCachedImage - throws exception for invalid URL', () async {
|
||||||
|
// Act & Assert
|
||||||
|
expect(
|
||||||
|
() => service.getCachedImage('not-a-valid-url'),
|
||||||
|
throwsException,
|
||||||
|
);
|
||||||
|
});
|
||||||
|
|
||||||
|
/// Tests that getCachedImage throws exception when not initialized.
|
||||||
|
test('getCachedImage - throws exception when not initialized', () async {
|
||||||
|
// Arrange
|
||||||
|
final uninitializedService = LocalStorageService();
|
||||||
|
|
||||||
|
// Act & Assert
|
||||||
|
expect(
|
||||||
|
() => uninitializedService.getCachedImage('https://example.com/image.jpg'),
|
||||||
|
throwsException,
|
||||||
|
);
|
||||||
|
});
|
||||||
|
|
||||||
|
/// Tests that clearImageCache removes all cached images.
|
||||||
|
test('clearImageCache - removes all cached images', () async {
|
||||||
|
// Act
|
||||||
|
await service.clearImageCache();
|
||||||
|
|
||||||
|
// Assert - should not throw
|
||||||
|
expect(service, isNotNull);
|
||||||
|
});
|
||||||
|
|
||||||
|
/// Tests cache hit scenario - file already exists in cache.
|
||||||
|
test('getCachedImage - cache hit when file exists', () async {
|
||||||
|
// Arrange - create a file in cache directory manually
|
||||||
|
// Note: Full HTTP download test would require mocking http client
|
||||||
|
// This test verifies the cache directory structure is correct
|
||||||
|
|
||||||
|
// Act & Assert - service should be initialized
|
||||||
|
expect(service, isNotNull);
|
||||||
|
|
||||||
|
// The actual HTTP download test would require:
|
||||||
|
// 1. Mocking http.get() with mockito or http_mock_adapter
|
||||||
|
// 2. Verifying file creation in cache directory
|
||||||
|
// For now, we verify error handling works correctly
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
group('LocalStorageService - Error Handling', () {
|
||||||
|
/// Tests that operations fail when service is not initialized.
|
||||||
|
test('operations fail when not initialized', () async {
|
||||||
|
// Arrange
|
||||||
|
final uninitializedService = LocalStorageService();
|
||||||
|
final item = Item(id: 'test-1', data: {'name': 'Test'});
|
||||||
|
|
||||||
|
// Act & Assert
|
||||||
|
expect(
|
||||||
|
() => uninitializedService.insertItem(item),
|
||||||
|
throwsException,
|
||||||
|
);
|
||||||
|
expect(
|
||||||
|
() => uninitializedService.getItem('test-1'),
|
||||||
|
throwsException,
|
||||||
|
);
|
||||||
|
expect(
|
||||||
|
() => uninitializedService.deleteItem('test-1'),
|
||||||
|
throwsException,
|
||||||
|
);
|
||||||
|
expect(
|
||||||
|
() => uninitializedService.updateItem(item),
|
||||||
|
throwsException,
|
||||||
|
);
|
||||||
|
});
|
||||||
|
|
||||||
|
/// Tests that getCachedImage fails when cache directory not initialized.
|
||||||
|
test('getCachedImage fails when not initialized', () async {
|
||||||
|
// Arrange
|
||||||
|
final uninitializedService = LocalStorageService();
|
||||||
|
|
||||||
|
// Act & Assert
|
||||||
|
expect(
|
||||||
|
() => uninitializedService.getCachedImage('https://example.com/image.jpg'),
|
||||||
|
throwsException,
|
||||||
|
);
|
||||||
|
});
|
||||||
|
|
||||||
|
/// Tests handling of missing or invalid data.
|
||||||
|
test('handles missing data gracefully', () async {
|
||||||
|
// Arrange
|
||||||
|
final item = Item(id: 'test-1', data: {});
|
||||||
|
|
||||||
|
// Act
|
||||||
|
await service.insertItem(item);
|
||||||
|
final retrieved = await service.getItem('test-1');
|
||||||
|
|
||||||
|
// Assert
|
||||||
|
expect(retrieved, isNotNull);
|
||||||
|
expect(retrieved!.data, isEmpty);
|
||||||
|
});
|
||||||
|
|
||||||
|
/// Tests handling of complex nested data structures.
|
||||||
|
test('handles complex nested data', () async {
|
||||||
|
// Arrange
|
||||||
|
final item = Item(
|
||||||
|
id: 'test-1',
|
||||||
|
data: {
|
||||||
|
'metadata': {
|
||||||
|
'author': 'Test Author',
|
||||||
|
'tags': ['tag1', 'tag2'],
|
||||||
|
'nested': {
|
||||||
|
'deep': 'value',
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
);
|
||||||
|
|
||||||
|
// Act
|
||||||
|
await service.insertItem(item);
|
||||||
|
final retrieved = await service.getItem('test-1');
|
||||||
|
|
||||||
|
// Assert
|
||||||
|
expect(retrieved, isNotNull);
|
||||||
|
expect(retrieved!.data['metadata']['author'], equals('Test Author'));
|
||||||
|
expect(retrieved.data['metadata']['tags'], isA<List>());
|
||||||
|
expect(retrieved.data['metadata']['nested']['deep'], equals('value'));
|
||||||
|
});
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
Loading…
Reference in new issue