Update README

README.md

@@ -5,45 +5,54 @@
 [![green-leaf-mongo Scala version support](https://index.scala-lang.org/greenleafoss/green-leaf-mongo/green-leaf-mongo/latest-by-scala-version.svg)](https://index.scala-lang.org/greenleafoss/green-leaf-mongo/green-leaf-mongo)
 
 ## Short description
-This extension created on top of official [MongoDB Scala Driver](http://mongodb.github.io/mongo-scala-driver), allows to fully utilize [Spray JSON](https://github.com/spray/spray-json) and represents bidirectional serialization for case classes in BSON, as well as flexible DSL for [MongoDB query operators](https://docs.mongodb.com/manual/reference/operator/query/), documents and collections.
+This extension created on top of official [MongoDB Scala Driver](https://mongodb.github.io/mongo-scala-driver) and allows to fully utilize [Spray JSON](https://github.com/spray/spray-json) or [Play JSON](https://github.com/playframework/play-json) to represent bidirectional serialization for case classes in BSON, as well as flexible DSL for [MongoDB query operators](https://www.mongodb.com/docs/manual/reference/operator/query/), documents and collections.
 
 ## Usage
 ```scala
 // build.sbt
-// https://mvnrepository.com/artifact/io.github.greenleafoss/green-leaf-mongo
-libraryDependencies += "io.github.greenleafoss" %% "green-leaf-mongo" % "0.1.16.1"
+
+// https://mvnrepository.com/artifact/io.github.greenleafoss/green-leaf-mongo-core
+// `green-leaf-mongo-core` can be used if you want to create your own extension
+
+// https://mvnrepository.com/artifact/io.github.greenleafoss/green-leaf-mongo-spray
+libraryDependencies += "io.github.greenleafoss" %% "green-leaf-mongo-spray" % "3.0"
+
+// https://mvnrepository.com/artifact/io.github.greenleafoss/green-leaf-mongo-play
+libraryDependencies += "io.github.greenleafoss" %% "green-leaf-mongo-play" % "3.0"
 ```
 
 ## JSON and BSON protocols
 
-`GreenLeafJsonProtocol` based on DefaultJsonProtocol from Spray JSON and allows to override predefined JsonFormats to make possible use custom seriallization in BSON format.
-This trait also includes a few additional JsonFormats for _ZonedDateTime_, _ObjectId_, _scala Enumeration_ and _UUID_.
+`GreenLeafMongoJsonBasicFormats` based on DefaultJsonProtocol from Spray JSON and allows to override predefined JsonFormats to make possible use custom serialization in BSON format.
+This trait also includes a few additional JsonFormats for _LocalDate_, _LocalDateTime_, _ZonedDateTime_, _ObjectId_, _scala Enumeration_ and _UUID_.
 
-`GreenLeafBsonProtocol` extends `GreenLeafJsonProtocol` and overrides _Long_, _ZonedDateTime_, _ObjectId_, _scala Enumeration_, _UUID_ and _Regex_ JSON formats to represent them in related BSON formats.
+`PlayJsonProtocol` is a related extension for Play JSON library and `PlayJsonProtocol` for Spray JSON library. 
+
+`SprayBsonProtocol`/`PlayBsonProtocol` extends related JsonProtocols and overrides _Int_, _Long_, _BigDecimal_, _LocalDate_, _LocalDateTime_, _ZonedDateTime_, _ObjectId_, _scala Enumeration_, _UUID_ and _Regex_ JSON formats to represent them in related BSON (MongoDB Extended JSON V2) formats https://www.mongodb.com/docs/manual/reference/mongodb-extended-json/#mongodb-extended-json-v2-usage.
 
 These base protocols allow to simply (de)serialize this instance to and from both JSON and BSON the same way as in Spray JSON:
-```scala
+```scala 3
 // MODEL
 case class Test(id: ObjectId, i: Int, l: Long, b: Boolean, zdt: ZonedDateTime)
 
 // JSON
-trait TestJsonProtocol extends GreenLeafJsonProtocol {
-  implicit def testJf = jsonFormat5(Test)
-}
+trait TestJsonProtocol extends SprayBsonProtocol:
+  given testJsonFormat = jsonFormat5(Test)
+
 object TestJsonProtocol extends TestJsonProtocol
 
 // BSON
-trait TestBsonProtocol extends TestJsonProtocol with GreenLeafBsonProtocol {
-  override implicit def testJf = jsonFormat(Test, "_id", "i", "l", "b", "zdt")
-}
+trait TestBsonProtocol extends SprayBsonProtocol:
+  given testBsonFormat = jsonFormat(Test, "_id", "i", "l", "b", "zdt")
+
 object TestBsonProtocol extends TestBsonProtocol
 ```
 
 Once protocols defined, we can make instance of Test case class and use TestJsonProtocol to print related JSON:
 ```scala
 val obj = Test(new ObjectId("5c72b799306e355b83ef3c86"), 1, 0x123456789L, true, "1970-01-01")
 
-import TestJsonProtocol._
+import TestJsonProtocol.given
 println(obj.toJson.prettyPrint)
 ```
 Output in this case will be:
@@ -62,7 +71,7 @@ Changing single line of import `TestJsonProtocol` to `TestBsonProtocol` allows u
 ```scala
 val obj = Test(new ObjectId("5c72b799306e355b83ef3c86"), 1, 0x123456789L, true, "1970-01-01")
 
-import TestBsonProtocol._
+import TestBsonProtocol.given
 println(obj.toJson.prettyPrint)
 ```
 
@@ -83,10 +92,10 @@ Output in this case will be:
 }
 ```
 
-Full code of the examples above available in `GreenLeafJsonAndBsonProtocolsTest`.
+More examples available in implementation of **JsonProtocolSpec**/**BsonProtocolSpec** in Spray and Play project modules.
 
 ## GreenLeafMongoDsl
-Import `GreenLeafMongoDsl._` makes it possible to write queries with a syntax that is more close to real queries in MongoDB, as was implemented in [Casbah Query DSL](http://mongodb.github.io/casbah/3.1/reference/query_dsl/).
+`GreenLeafMongoFilterOps` makes it possible to write queries with a syntax that is more close to real queries in MongoDB, as was implemented in [Casbah Query DSL](http://mongodb.github.io/casbah/3.1/reference/query_dsl/).
 
 ```scala
 "size" $all ("S", "M", "L")
@@ -100,17 +109,19 @@ Import `GreenLeafMongoDsl._` makes it possible to write queries with a syntax th
 "size" $nin ("S", "XXL")
 $or( "price" $lt 5, "price" $gt 1, "promotion" $eq true )
 $and( "price" $lt 5, "price" $gt 1, "stock" $gte 1 )
-"price" $not { _ $gte 5.1 }
+"price" $not { $gte (5.1)  }
 $nor( "price" $eq 1.99 , "qty" $lt 20, "sale" $eq true )
 "qty" $exists true
+"results" $elemMatch $and("product" $eq "xyz", "score" $gte 8)
 // ...
 ```
 
-More examples of queries available in `GreenLeafMongoDslTest`.
+More examples of queries available in **GreenLeafMongoFilterOpsSpec**.
 
 
 ## GreenLeafMongoDao
-`GreenLeafMongoDao` extends `GreenLeafMongoDsl` and provides simple DSL to transform Mongo's _Observable[Document]_ instances to _Future[Seq[T]]_, _Future[Option[T]]_ and _Future[T]_.
-In addition this trait provides many useful generic methods such as _insert_, _getById_, _findById_, _updateById_, _replaceById_ and others.
-You can find more details and examples in [EntityWithIdAsFieldDaoTest](https://github.com/GreenLeafOSS/green-leaf-mongo/blob/master/src/test/scala/io/github/greenleafoss/mongo/EntityWithIdAsFieldDaoTest.scala), [EntityWithIdAsObjectDaoTest](https://github.com/GreenLeafOSS/green-leaf-mongo/blob/master/src/test/scala/io/github/greenleafoss/mongo/EntityWithIdAsObjectDaoTest.scala), [EntityWithOptionalFieldsDaoTest](https://github.com/GreenLeafOSS/green-leaf-mongo/blob/master/src/test/scala/io/github/greenleafoss/mongo/EntityWithOptionalFieldsDaoTest.scala) and [EntityWithoutIdDaoTest](https://github.com/GreenLeafOSS/green-leaf-mongo/blob/master/src/test/scala/io/github/greenleafoss/mongo/EntityWithoutIdDaoTest.scala).
+`GreenLeafMongoDao` extends `GreenLeafMongoObservableToFutureOps` with `GreenLeafMongoFilterOps` and provides simple DSL to transform Mongo's _Observable[Document]_ instances to _Future[Seq[T]]_, _Future[Option[T]]_ and _Future[T]_.
+In addition, this trait provides many useful generic methods such as _insert_, _getById_, _findById_, _updateById_, _replaceById_ and others.
+`SprayMongoDao`/`PlayMongoDao` are related implementations for Spray and Play JSON libraries. 
+You can find more details and examples in the dao tests.