@@ -1,6 +1,6 @@

 Package: SQLDataFrame

 Title: Representation of SQL database in DataFrame metaphor

-Version: 1.1.0

+Version: 1.1.1

 Authors@R: c(

     person("Qian", "Liu", email = "qliu7@buffalo.edu", role = c("aut", "cre"),

     comment = c(ORCID = "0000-0003-1456-5099")),

@@ -32,7 +32,7 @@ Imports:

     tibble

 License: GPL-3

 Encoding: UTF-8

-RoxygenNote: 6.1.1

+RoxygenNote: 7.1.0

 Suggests:

     RMySQL,

     bigrquery,

@@ -335,9 +335,13 @@ setMethod("$", "SQLDataFrame", function(x, name) x[[name]] )

 #'     length 1 or the same length as the number of rows in the group

 #'     (if using ‘group_by()’) or in the entire input (if not using

 #'     groups). The name of each argument will be the name of a new

-#'     variable, and the value will be its corresponding value. Use a

-#'     ‘NULL’ value in ‘mutate’ to drop a variable.  New variables

-#'     overwrite existing variables of the same name.

+#'     variable, and the value will be its corresponding value.

+#'      New variables

+#'     overwrite existing variables of the same name. NOTE that the new

+#'     value could only be of length 1 or the operation of existing columns.

+#'     If a new vector of values are given, error will return. This is due

+#'     to the internal method of 'mutate.tbl_lazy' not being able to take

+#'     new arbitrary values. 

 #' }

 #' @export

 #' @examples

@@ -427,7 +431,8 @@ mutate.SQLDataFrame <- function(.data, ...)

         tbl <- tbl(con, auxSchema)

         }

     }

-    tbl_out <- dplyr::mutate(tbl, ...)

+    tbl_out <- dplyr::mutate(tbl, ...) ## FIXME: use mutate(xx = NULL) to remove column?

+    ## once done, add to @param ...: Use ‘NULL’ value in ‘mutate’ to drop a variable.

     out <- BiocGenerics:::replaceSlots(.data, tblData = tbl_out)

     ## check if not-null for the existing @indexes, and update for mutate.

@@ -1,6 +1,5 @@

 % Generated by roxygen2: do not edit by hand

 % Please edit documentation in R/SQLDataFrame-class.R

-\docType{methods}

 \name{SQLDataFrame}

 \alias{SQLDataFrame}

 \alias{class:SQLDataFrame}

@@ -30,9 +29,18 @@

 \alias{coerce,ANY,SQLDataFrame-method}

 \title{SQLDataFrame class}

 \usage{

-SQLDataFrame(conn, host, user, dbname, password = NULL,

-  billing = character(0), type = c("SQLite", "MySQL", "BigQuery"),

-  dbtable = character(0), dbkey = character(0), col.names = NULL)

+SQLDataFrame(

+  conn,

+  host,

+  user,

+  dbname,

+  password = NULL,

+  billing = character(0),

+  type = c("SQLite", "MySQL", "BigQuery"),

+  dbtable = character(0),

+  dbkey = character(0),

+  col.names = NULL

+)

 \S4method{tblData}{SQLDataFrame}(x)

@@ -50,8 +58,7 @@ SQLDataFrame(conn, host, user, dbname, password = NULL,

 \S4method{show}{SQLDataFrame}(object)

-\S4method{as.data.frame}{SQLDataFrame}(x, row.names = NULL,

-  optional = NULL, ...)

+\S4method{as.data.frame}{SQLDataFrame}(x, row.names = NULL, optional = NULL, ...)

 }

 \arguments{

 \item{conn}{a valid \code{DBIConnection} from \code{SQLite},

@@ -1,6 +1,5 @@

 % Generated by roxygen2: do not edit by hand

 % Please edit documentation in R/SQLDataFrame-methods.R

-\docType{methods}

 \name{SQLDataFrame-methods}

 \alias{SQLDataFrame-methods}

 \alias{head}

@@ -15,11 +14,8 @@

 \alias{length}

 \alias{names,SQLDataFrame-method}

 \alias{names}

-\alias{[,SQLDataFrame,ANY,ANY,ANY-method}

 \alias{[,SQLDataFrame,ANY-method}

-\alias{[,SQLDataFrame,SQLDataFrame,ANY,ANY-method}

 \alias{[,SQLDataFrame,SQLDataFrame-method}

-\alias{[,SQLDataFrame,list,ANY,ANY-method}

 \alias{[,SQLDataFrame,list-method}

 \alias{[[,SQLDataFrame-method}

 \alias{$,SQLDataFrame-method}

@@ -47,12 +43,11 @@

 \S4method{names}{SQLDataFrame}(x)

-\S4method{[}{SQLDataFrame,ANY,ANY,ANY}(x, i, j, ..., drop = TRUE)

+\S4method{[}{SQLDataFrame,ANY}(x, i, j, ..., drop = TRUE)

-\S4method{[}{SQLDataFrame,SQLDataFrame,ANY,ANY}(x, i, j, ...,

-  drop = TRUE)

+\S4method{[}{SQLDataFrame,SQLDataFrame}(x, i, j, ..., drop = TRUE)

-\S4method{[}{SQLDataFrame,list,ANY,ANY}(x, i, j, ..., drop = TRUE)

+\S4method{[}{SQLDataFrame,list}(x, i, j, ..., drop = TRUE)

 \S4method{[[}{SQLDataFrame}(x, i, j, ...)

@@ -93,9 +88,13 @@ values, a named list of key values, and \code{SQLDataFrame},

     length 1 or the same length as the number of rows in the group

     (if using ‘group_by()’) or in the entire input (if not using

     groups). The name of each argument will be the name of a new

-    variable, and the value will be its corresponding value. Use a

-    ‘NULL’ value in ‘mutate’ to drop a variable.  New variables

-    overwrite existing variables of the same name.

+    variable, and the value will be its corresponding value.

+     New variables

+    overwrite existing variables of the same name. NOTE that the new

+    value could only be of length 1 or the operation of existing columns.

+    If a new vector of values are given, error will return. This is due

+    to the internal method of 'mutate.tbl_lazy' not being able to take

+    new arbitrary values. 

 }}

 \item{drop}{Whether to drop with reduced dimension. Default is

@@ -15,17 +15,13 @@

 \alias{anti_join,SQLDataFrame-method}

 \title{join \code{SQLDataFrame} together}

 \usage{

-\method{left_join}{SQLDataFrame}(x, y, by = NULL, copy = FALSE,

-  suffix = c(".x", ".y"), ...)

+\method{left_join}{SQLDataFrame}(x, y, by = NULL, copy = FALSE, suffix = c(".x", ".y"), ...)

-\method{inner_join}{SQLDataFrame}(x, y, by = NULL, copy = FALSE,

-  suffix = c(".x", ".y"), ...)

+\method{inner_join}{SQLDataFrame}(x, y, by = NULL, copy = FALSE, suffix = c(".x", ".y"), ...)

-\method{semi_join}{SQLDataFrame}(x, y, by = NULL, copy = FALSE,

-  suffix = c(".x", ".y"), ...)

+\method{semi_join}{SQLDataFrame}(x, y, by = NULL, copy = FALSE, suffix = c(".x", ".y"), ...)

-\method{anti_join}{SQLDataFrame}(x, y, by = NULL, copy = FALSE,

-  suffix = c(".x", ".y"), ...)

+\method{anti_join}{SQLDataFrame}(x, y, by = NULL, copy = FALSE, suffix = c(".x", ".y"), ...)

 }

 \arguments{

 \item{x}{\code{SQLDataFrame} objects to join.}

@@ -4,9 +4,21 @@

 \alias{makeSQLDataFrame}

 \title{Construct SQLDataFrame from file.}

 \usage{

-makeSQLDataFrame(filename, dbtable = NULL, dbkey = character(), conn,

-  host, user, dbname = NULL, password = NULL, type = c("SQLite",

-  "MySQL"), overwrite = FALSE, sep = ",", index = FALSE, ...)

+makeSQLDataFrame(

+  filename,

+  dbtable = NULL,

+  dbkey = character(),

+  conn,

+  host,

+  user,

+  dbname = NULL,

+  password = NULL,

+  type = c("SQLite", "MySQL"),

+  overwrite = FALSE,

+  sep = ",",

+  index = FALSE,

+  ...

+)

 }

 \arguments{

 \item{filename}{A \code{data.frame} or \code{DataFrame} object, or

@@ -1,6 +1,5 @@

 % Generated by roxygen2: do not edit by hand

 % Please edit documentation in R/rbindSQLDataFrame.R

-\docType{methods}

 \name{rbind}

 \alias{rbind}

 \alias{rbind,SQLDataFrame-method}

@@ -4,9 +4,15 @@

 \alias{saveSQLDataFrame}

 \title{Save SQLDataFrame object as a new database table.}

 \usage{

-saveSQLDataFrame(x, dbname = tempfile(fileext = ".db"),

-  dbtable = deparse(substitute(x)), localConn = connSQLDataFrame(x),

-  overwrite = FALSE, index = TRUE, ...)

+saveSQLDataFrame(

+  x,

+  dbname = tempfile(fileext = ".db"),

+  dbtable = deparse(substitute(x)),

+  localConn = connSQLDataFrame(x),

+  overwrite = FALSE,

+  index = TRUE,

+  ...

+)

 }

 \arguments{

 \item{x}{The \code{SQLDataFrame} object to be saved.}

@@ -1,6 +1,5 @@

 % Generated by roxygen2: do not edit by hand

 % Please edit documentation in R/unionSQLDataFrame.R

-\docType{methods}

 \name{union}

 \alias{union}

 \alias{union,SQLDataFrame,SQLDataFrame-method}