93 support for SQLite

.github/workflows/build.yml

@@ -1,13 +1,13 @@
 name: Unit Tests
 
-on: [push, pull_request, workflow_dispatch]
+on: [push]
 
 jobs:
   unit-tests:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        smalltalk: [Pharo64-7.0]
+        smalltalk: [Pharo64-10, Pharo64-11]
         redis-version: [7]
         mongodb-version: ['4.4']
     name: ${{ matrix.smalltalk }}

README.md

@@ -1,25 +1,34 @@
-![Mapless](./header.png)
+![Mapless](./hero.jpg)
 
 # Mapless
 
 Schema-less persistence for Smalltalk with support for multiple backends.
 
+[![Release](https://img.shields.io/github/v/tag/sebastianconcept/Mapless?label=release)](https://github.com/sebastianconcept/Mapless/releases)
 [![Unit Tests](https://github.com/sebastianconcept/Mapless/actions/workflows/build.yml/badge.svg)](https://github.com/sebastianconcept/Mapless/actions/workflows/build.yml)
+
 ![Tests](https://img.shields.io/badge/tests-193-green)
 [![Coverage Status](https://codecov.io/github/sebastianconcept/Mapless/coverage.svg?branch=main)](https://codecov.io/gh/sebastianconcept/Mapless/branch/master)
 
-[![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE.txt)
-[![Release](https://img.shields.io/github/v/tag/sebastianconcept/Mapless?label=release)](https://github.com/sebastianconcept/Mapless/releases)
 
-
-[![Pharo 7](https://img.shields.io/badge/Pharo-7-%23383932.svg)](https://pharo.org/download)
 [![Pharo 10](https://img.shields.io/badge/Pharo-10-%23383932.svg)](https://pharo.org/download)
+[![Pharo 11](https://img.shields.io/badge/Pharo-11-%23383932.svg)](https://pharo.org/download)
 
 [![Social](https://img.shields.io/github/stars/sebastianconcept/Mapless?style=social)]()
 [![Forks](https://img.shields.io/github/forks/sebastianconcept/Mapless?style=sociall)]()
+[![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE.txt)
 
+### [Mapless GitHub Page](https://sebastianconcept.github.io/Mapless/)
 ---
 
+## Description
+
+Mapless is a schema-less persistence framework supporting multiple backends and offering a user-friendly API. Querying Mapless objects involves a common family of methods, and there's no need to declare accessors and mutators. See [examples below](#examples).
+
+Designed to eliminate the need for schema maintenance, Mapless avoids any Object-Relational Mapping requirements.
+
+Mapless achieves a balance between maximum data survivability and robust architectural flexibility without imposing a heavy burden in terms of adoption and maintenance. A sweet spot for development and production.
+
 ## Features
 
 - Intuitive API for frictionless persistence.
@@ -31,30 +40,36 @@ Schema-less persistence for Smalltalk with support for multiple backends.
 - Enables smooth data migration/interoperation among backends.
 - ~~Via Redis PUB/SUB, scalable observer-pattern functionality across images.~~ In the roadmap.
 
-## Description
-
-Mapless is a schema-less persistence framework supporting multiple backends and offering a user-friendly API. For instance, querying Mapless objects involves a common family of methods, and there's no need to declare accessors and mutators. See [examples below](#examples).
-
-Designed to be schema-less, Mapless eliminates the need for schema maintenance and avoids any Object-Relational Mapping requirements.
-
-Mapless achieves a balance of maximum data survivability and robust architectural flexibility without imposing a heavy burden in terms of adoption and maintenance.
-
-## Ambition
-
-To deliver a high-performance solution that preserves arbitrary application state (data) with a focus on flexibility, availability, and capacity. It aims to strategically aid in scaling without causing backend vendor lock-in, across various persistence backends, and by neutralizing the costs associated with object-mapping impedance mismatch.
-
 ## Supported backends
 
-1. MongoDB
-2. Redis
-3. Memory
-4. PostgreSQL
-5. ~~UnQLite~~ `deprecated` / retiring soon
+1. SQLite
+2. PostgreSQL
+3. Redis
+4. MongoDB
+5. Memory
+6. ~~UnQLite~~ `deprecated` / retiring soon
 
 ## Examples
+Try Mapless by [installing it in a supported Pharo image](#how-to-install) and the following snippets:
+
+```Smalltalk
+"Instantiates an SQLite Mapless repository."
+repository := MaplessSQLiteRepository
+    for: 'TryMapless'
+    on: 'path/string/to/your/sqlite.db'.
+```
 
 ```Smalltalk
-"Instanciates a mapless object."
+"Custom class to model your data"
+Mapless subclass: #Person
+	instanceVariableNames: ''
+	classVariableNames: ''
+	package: 'YourApp-Mapless'
+
+"Guarantees the database has a Person table (this is idempotent)."
+repository ensureTableFor: #Person.
+
+"Instantiates a Mapless object."
 philosopher := Person new
 	firstName: 'Aristotle';
 	yourself.
@@ -75,47 +90,54 @@ allOrEmpty := repository findAll: Person.
 
 ```Smalltalk
 "Query to load all the instances that match the condition."
-someOrEmpty := repository findAll: Person where: [ :each | each lastName = 'Peterson' ].
+someOrEmpty := repository findAll: Person where: [ :each | 
+  each firstName = 'Aristotle' ].
 ```
 
 ```Smalltalk
 "Conditionally loading the first matching instance."
-oneOrNil := repository findOne: Person where: [ :each | each lastName = 'Peterson' ].
+oneOrNil := repository findOne: Person where: [ :each | 
+  each firstName = 'Aristotle' ].
 ```
 
 ```Smalltalk
-"Create a Person mapless model"
+"Create a Person Mapless model"
 philosopher := Person new
 	firstName: 'Aristotle';
 	save.
 
-"Set it as the person for a new User mapless model"
+"Set it as the person for a new User Mapless model"
 philosopherUser := User new
 	person: philosopher;
 	save.  
 
 "Query for that user by ID and get its person instance"
 aristotle := (User findId: philosopherUser id) person.
 ```
-## Installation
+## How to Install
 
-Open a workspace in a supported Pharo image and evaluate:
+To start with Mapless, download Pharo, open a Pharo Playground and evaluate:
 
 ```smalltalk
 Metacello new
   baseline: 'Mapless';
   repository: 'github://sebastianconcept/Mapless:latest/src';
-  load
+  load.
+
+"By default, Mapless loads the Memory and SQLite backends"
 ```
 
 ## Include as dependency
 
-In BaselineOf or ConfigurationOf it can be added in this way:
+To include Mapless as a dependency from `BaselineOf` or `ConfigurationOf` add it with:
 
 ```smalltalk
 spec
   baseline: 'Mapless'
     with: [ spec
     repository: 'github://sebastianconcept/Mapless:latest/src';
-    load: #('Core' 'Postgres' 'Mongo' 'Redis' 'Memory') ]
+    load: #('Core' 'SQLite' 'Postgres' 'Mongo' 'Redis' 'Memory') ]
 ```
+## Project Ambition
+
+To deliver a high-performance solution that preserves arbitrary application state (data) with a focus on flexibility, availability, and capacity. It aims to strategically aid in scaling without causing vendor lock-in, across various persistence backends, and by neutralizing the costs associated with object-mapping impedance mismatch.

changelog.md

@@ -1,33 +1,45 @@
+Jan 29, 2024
+===================================
+* Added SQLite support.
+* Added Pharo 10 and Pharo 11 support.
+* Dropped Pharo 7 support. Last working version on Pharo 7 was v0.5.26
+* Added badges to the README.md
+
 Jan 25, 2024
 ===================================
-- Updating `master` branch to keep up with the latests useful upgrades.
-- Adding badges to the README.md for constant monitoring of CI, unit tests, regression detection capacity and supported Pharo versions.
-- Adds CI via GitHub actions.
+* Updating `master` branch to keep up with the latests useful upgrades.
+* Adding badges to the README.md for constant monitoring of CI, unit tests, regression detection capacity and supported Pharo versions.
+* Adds CI via GitHub actions.
+
+October 10, 2023
+===================================
+* Fixed most tests for the SQLite backend.
+* Adjusted Benchmarking clases and added the one for SQLite.
 
 May 22, 2023
 ===================================
-- Improved `MongoAPI` by adding `initializeMongoUrl` and a lazy accessor using it and `Array` instead of `Set` so comparing it on the fly from `getIdleReadOnlyClient` is significantly faster now.
-- `MaplessWeightedRandomPolicy>>nextAmong:` is faster now by not using `includes:` and use a `anySatisfy:` filter instead.
+* Improved `MongoAPI` by adding `initializeMongoUrl` and a lazy accessor using it and `Array` instead of `Set` so comparing it on the fly from `getIdleReadOnlyClient` is significantly faster now.
+* `MaplessWeightedRandomPolicy>>nextAmong:` is faster now by not using `includes:` and use a `anySatisfy:` filter instead.
 
 May 19, 2023
 ===================================
-- Added `defaultMinClients` for `MaplessStandaloneMongoPool`.
+* Added `defaultMinClients` for `MaplessStandaloneMongoPool`.
 
 May 19, 2022 | v0.5.4-beta | Humble Falcon
 ===================================
-- `MongoChange` is now using MongoDB `document` instead of `jsonish`.
-- Version bump.
+* `MongoChange` is now using MongoDB `document` instead of `jsonish`.
+* Version bump.
 
 May 18, 2022 | v0.5.3-beta | Proud Falcon
 ===================================
-- Declaring stable API for beta version.
+* Declaring stable API for beta version.
 
 May 18, 2022 | v0.5.2-alpha | Major Bird
 ===================================
-- `MongoChange` `type` is now uppercase for client convenience.
-- Added `maplessClass` accessor in `Mapless` and `MaplessReference`.
-- Added `unobservable` accessor to prevent recursive changes log.
-- Fixes `DELETE` missing jsonish in the `MongoChange` object.
+* `MongoChange` `type` is now uppercase for client convenience.
+* Added `maplessClass` accessor in `Mapless` and `MaplessReference`.
+* Added `unobservable` accessor to prevent recursive changes log.
+* Fixes `DELETE` missing jsonish in the `MongoChange` object.
 
 May 11, 2022 | v0.5.1-alpha | Tense Eagle
 ===================================

src/BaselineOfMapless/BaselineOfMapless.class.st

@@ -35,9 +35,10 @@ BaselineOfMapless >> baseline: spec [
 				group: 'Mongo' with: #('Mapless-Mongo-Tests');
 				group: 'Redis' with: #('Mapless-Redis-Tests');
 				group: 'Postgres' with: #('Mapless-Postgres-Tests');
+				group: 'SQLite' with: #('Mapless-SQLite-Tests');
 				group: 'UnQLite' with: #('Mapless-UnQLite-Tests');
 				group: 'Benchmark' with: #('Mapless-Benchmark-Core');
-				group: 'default' with: #('Memory' 'Mongo') ]
+				group: 'default' with: #('Memory' 'SQLite') ]
 ]
 
 { #category : #baseline }
@@ -69,9 +70,11 @@ BaselineOfMapless >> setUpBasePackages: spec [
 
 { #category : #baseline }
 BaselineOfMapless >> setUpMongoDependencies: spec [
-	spec
-		baseline: 'MongoTalk'
-		with: [ spec repository: 'github://pharo-nosql/mongotalk:1.25/mc' ]
+
+	spec baseline: 'MongoTalk' with: [ 
+		spec
+			repository: 'github://pharo-nosql/mongotalk:v2.0/mc';
+			loads: #( Client 'Mongo-DriverLegacy' ) ]
 ]
 
 { #category : #baseline }
@@ -104,6 +107,9 @@ BaselineOfMapless >> setUpPackages: spec [
 	self setUpPostgresDependencies: spec.
 	self setUpPostgresPackages: spec.
 
+	self setUpSQLiteDependencies: spec.
+	self setUpSQLitePackages: spec.
+
 	self setUpUnQLiteDependencies: spec.
 	self setUpUnQLitePackages: spec
 ]
@@ -142,6 +148,25 @@ BaselineOfMapless >> setUpRedisPackages: spec [
 		with: [ spec requires: #('Mapless-Redis-Core' 'Mapless-Tests-Base') ]
 ]
 
+{ #category : #baseline }
+BaselineOfMapless >> setUpSQLiteDependencies: spec [
+	spec
+		baseline: 'SQLite3'
+		with: [ spec
+				repository: 'github://pharo-rdbms/Pharo-SQLite3/src';
+				loads: #('Core') ]
+]
+
+{ #category : #baseline }
+BaselineOfMapless >> setUpSQLitePackages: spec [
+	spec
+		package: 'Mapless-SQLite-Core'
+		with: [ spec requires: #('Mapless-Base-Core' 'SQLite3') ].
+	spec
+		package: 'Mapless-SQLite-Tests'
+		with: [ spec requires: #('Mapless-SQLite-Core' 'Mapless-Tests-Base') ]
+]
+
 { #category : #baseline }
 BaselineOfMapless >> setUpUnQLiteDependencies: spec [
 	spec

src/Mapless-Base-Core/MaplessAbstractPool.class.st

@@ -39,7 +39,7 @@ MaplessAbstractPool class >> local [
 ]
 
 { #category : #accessing }
-MaplessAbstractPool >> currentClientDynamicVariable [
+MaplessAbstractPool >> currentClientDynamicVariableClass [
 	"Answers the class of the dynamic variable that will
 	hold the value of the current client during the evaluation of its usage."
 

src/Mapless-Base-Core/MaplessError.class.st

@@ -1,3 +1,6 @@
+"
+I'm the type of Error specific to Mapless scenarios
+"
 Class {
 	#name : #MaplessError,
 	#superclass : #Error,

src/Mapless-Benchmark-Core/MaplessRedisBenchmark.class.st

@@ -1,14 +1,14 @@
 "
-This class provides some basic performance test for Mapless on MongoDB.
+This class provides some basic performance test for Mapless on Redis.
 
 Convenience to run it logging to the Transcript:
 
-MaplessMongoBenchmark run
+MaplessRedisBenchmark run
 
 Convenience to run it logging to SomeLogFile.log:
 
 'SomeLogFile.log' asFileReference writeStreamDo: [ :stream |
-	MaplessMongoBenchmark runPrintingOn: stream ]  
+	MaplessRedisBenchmark runPrintingOn: stream ]  
 "
 Class {
 	#name : #MaplessRedisBenchmark,