Deprecate @sr_str macro by Base.@raw_str and suggest users to switch. (#318)

* Deprecate @sr_str macro by Base.@raw_str and suggest users to switch.

* Remove more @sr_str in docs.

Author: metab0t

docs/src/index.md

@@ -116,7 +116,7 @@ julia> DBInterface.execute(db, "SELECT * FROM MediaType WHERE Name REGEXP '-d'")
 
 This can be avoided in two ways.
 You can either escape each backslash yourself
-or you can use the sr"..." string literal that SQLite.jl exports.
+or you can use the raw"..." string literal.
 The previous query can then successfully be run like so:
 
 ```julia
@@ -128,18 +128,14 @@ julia> DBInterface.execute(db, "SELECT * FROM MediaType WHERE Name REGEXP '-\\d'
 |-----|---------------|-------------------------------|
 | 1   | 3             | "Protected MPEG-4 video file" |
 
-julia> # using sr"..."
 
-julia> DBInterface.execute(db, sr"SELECT * FROM MediaType WHERE Name REGEXP '-\d'") |> DataFrame
+julia> DBInterface.execute(db, raw"SELECT * FROM MediaType WHERE Name REGEXP '-\d'") |> DataFrame
 1x2 ResultSet
 | Row | "MediaTypeId" | "Name"                        |
 |-----|---------------|-------------------------------|
 | 1   | 3             | "Protected MPEG-4 video file" |
 ```
 
-The `sr"..."` currently escapes all special characters in a string
-but it may be changed in the future to escape only characters which are part of a regex.
-
 
 ### Custom Scalar Functions
 

src/UDF.jl

@@ -306,6 +306,8 @@ regexp(r::AbstractString, s::AbstractString) = occursin(Regex(r), s)
 
 This string literal is used to escape all special characters in the string,
 useful for using regex in a query.
+
+This literal is deprecated and users should switch to `Base.@raw_str` instead.
 """
 macro sr_str(s)
     s

test/runtests.jl

@@ -391,7 +391,7 @@ end
             r =
                 DBInterface.execute(
                     db,
-                    SQLite.@sr_str(
+                    @raw_str(
                         "SELECT LastName FROM Employee WHERE BirthDate REGEXP '^\\d{4}-08'"
                     )
                 ) |> columntable
@@ -907,7 +907,9 @@ function Base.iterate(::UnknownSchemaTable, st = 1)
 end
 
 @testset "SQLite Open Flags" begin
-    @test_throws SQLiteException("unable to open database file") SQLite.DB("file:test.db?mode=ro")
+    @test_throws SQLiteException("unable to open database file") SQLite.DB(
+        "file:test.db?mode=ro",
+    )
 
     db = SQLite.DB("file:test.db?mode=rwc")
     @test db isa SQLite.DB
@@ -953,36 +955,26 @@ end
         UnknownSchemaTable(),
         db,
         "tmp",
-        on_conflict = "ROLLBACK"
+        on_conflict = "ROLLBACK",
     )
     tbl = DBInterface.execute(db, "select * from tmp") |> columntable
     @test tbl == (a = [], b = [], c = [])
     @test_throws SQLite.SQLiteException SQLite.load!(
         UnknownSchemaTable(),
         db,
         "tmp",
-        on_conflict = "ABORT"
+        on_conflict = "ABORT",
     )
     @test_throws SQLite.SQLiteException SQLite.load!(
         UnknownSchemaTable(),
         db,
         "tmp",
-        on_conflict = "FAIL"
-    )
-    SQLite.load!(
-        UnknownSchemaTable(),
-        db,
-        "tmp",
-        on_conflict = "IGNORE"
+        on_conflict = "FAIL",
     )
+    SQLite.load!(UnknownSchemaTable(), db, "tmp"; on_conflict = "IGNORE")
     tbl = DBInterface.execute(db, "select * from tmp") |> columntable
     @test tbl == (a = [1], b = [3], c = [4])
-    SQLite.load!(
-        UnknownSchemaTable(),
-        db,
-        "tmp",
-        on_conflict = "REPLACE"
-    )
+    SQLite.load!(UnknownSchemaTable(), db, "tmp"; on_conflict = "REPLACE")
     tbl = DBInterface.execute(db, "select * from tmp") |> columntable
     @test tbl == (a = [1], b = [5], c = [6])