From 28e090d605e41be83c10ad2a9e7463393b264592 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Tue, 7 Apr 2026 13:14:30 +0200
Subject: [PATCH 01/92] update description file

---
 DESCRIPTION | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/DESCRIPTION b/DESCRIPTION
index b44fb89..120316a 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -29,9 +29,15 @@ License: MIT + file LICENSE
 Encoding: UTF-8
 Roxygen: list(markdown = TRUE)
 RoxygenNote: 7.3.3
+Imports:
+    methods,
+    AnnotationDbi,
+    GO.db
 Suggests: 
     knitr,
     rmarkdown,
+    clusterProfiler,
+    gprofiler2,
     org.Hs.eg.db,
     testthat (>= 3.0.0)
 VignetteBuilder: knitr

From 18696db37aad1a2c04c8f277238c2bfe0d1c5f48 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Tue, 7 Apr 2026 13:15:51 +0200
Subject: [PATCH 02/92] update the main function EMMA_run

---
 R/EMMA_run.R | 94 ++++++++++++++++++++++------------------------------
 1 file changed, 39 insertions(+), 55 deletions(-)

diff --git a/R/EMMA_run.R b/R/EMMA_run.R
index 05a978c..60e997f 100644
--- a/R/EMMA_run.R
+++ b/R/EMMA_run.R
@@ -2,19 +2,30 @@
 #' 
 #' This function executes functional enrichment analysis using existing tools
 #' and captures the associated parameters and provenance information for the
-#' analysis during runtime.
+#' analysis when available during runtime.
+#'
 #' @param expr A function call that performs functional enrichment analysis.
 #' The call is captured and executed by EMMA to record analysis parameters and
 #' provenance information
 #' @param envir An environment in which to evaluate `expr`
+#' @param session Logical, indicating whether to store sessionInfo or not.
+#' It defaults to (`TRUE`) saving the session
+#' @param args_form A character string indicating whether to store the evaluated
+#' or the unevaluated arguments. It default to store the evaluated arguments
 #'
 #' @returns Functional enrichment analysis results in the native format
 #' returned by the original `expr`
 #' @export
 #'
 #' @examples
-#' EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive), universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db, ont = "BP"))
-EMMA_run <- function(expr, envir = parent.frame()) {
+#' data("de_res_IFNg_vs_naive", package = "EMMA")
+#' data("universe", package = "EMMA")
+#' EMMA_run(clusterProfiler::enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+#' universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
+#' ont = "BP"))
+EMMA_run <- function(expr, envir = parent.frame(), session = TRUE,
+                     args_form = c("evaluated", "unevaluated")) {
+  args_form <- match.arg(args_form)
   
   # capture call
   call <- substitute(expr)
@@ -23,46 +34,25 @@ EMMA_run <- function(expr, envir = parent.frame()) {
   if (!is.call(call)) {
     stop("`expr` must be a function call, e.g. enrichGO(...)!")
   }
-
-  # capture function name
-  function_name <- paste(deparse(call[[1]]), collapse = "")
   
+  # capture call information
+  info_call <- .EMMA_capture_call_info(call = call)
+  function_name <- info_call$function_name
+  package_name <- info_call$package_name
+  package_version <- info_call$package_version
+
   # capture args (unevaluated)
   arg_list <- as.list(call)[-1]
-  
   arg_names <- names(arg_list)
   
-  # now we'll put some warning on important args if
-  # the user did not define them (like the fdr correction ...)
-  
-  checks <- list(
-    list(params = c("pAdjustMethod", "correction_method"),
-         label  = "multiple-testing correction method"),
-    list(params = c("universe", "background"),
-         label  = "background gene set")
-    )
-  
-  
-  for (check in checks) {
-    if (!any(check$params %in% arg_names)) {
-      warning(
-        sprintf(
-          "No %s was specified for %s(). 
-Consider using the corresponding parameter for your call.",
-          check$label,
-          function_name
-        ),
-        call. = FALSE
-      )
-    }
-  }
-  
-  # maybe warn when the organism and the gene names dont match? like u have 
-  # mouse data but u defined organism as human
+  # some good practice warning, i.e. when multiple testing correction is skipped
+  # or bg geneset not set
+  .EMMA_warnings(arg_names = arg_names,
+                       function_name = function_name)
   
   #capture analysis time
   start_time <- Sys.time()
-  message("Running Enrichment Analysis with ", function_name, " ...") # maybe we can print the list of arg used also in the msg?
+  message("Running Enrichment Analysis with ", function_name, " ...") 
   
   # capture the value of the arguments
   args <- lapply(arg_list, eval, envir = envir)
@@ -70,30 +60,24 @@ Consider using the corresponding parameter for your call.",
   # get the function
   fun <- eval(call[[1]], envir = envir)
   
-  # run the analysis
+  ##### run the analysis ####
   results <- do.call(fun, args)
   
-  # capture pkg used
-  enrich_function <- match.fun(function_name)
-  pkg <- environmentName(environment(enrich_function))
-
-  
-  # store everything
-  EMMA_record <- list(
-    call = call,
-    package = pkg,
-    package_version = if (!is.na(pkg)) 
-      as.character(packageVersion(pkg)) else NA,
-    arguments = args,
-    gene_set_library = NA, #placeholder
-    gene_set_library_version = NA,
-    organism = NA,
-    runtime = start_time, 
-    session = sessionInfo()
+  # capture metadata from the used function and arguments
+  metadata <- .EMMA_get_metadata(
+    function_name = function_name,
+    package_name = package_name,
+    args = args
   )
   
-  # store the emma records as attribute of the results obj
+  # record everything in EMMA_record
+  EMMA_record <- .EMMA_build_record(call, function_name, package_name,
+                                    package_version, args,
+                                    arg_list, args_form, metadata,
+                                    start_time, session)
+    
+  # store the EMMA_record as attribute of the results obj
   attr(results, "EMMA_record") <- EMMA_record
-  
+
   return(results)
 }

From 2b3ea7f9bce37ff1906f22b34f35c3bd6830f5e5 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Tue, 7 Apr 2026 13:17:41 +0200
Subject: [PATCH 03/92] update the functions EMMA_show, EMMA_freeze and
 EMMA_explain with prototype functions/placeholders/docs

---
 R/EMMA_explain.R |  3 +++
 R/EMMA_freeze.R  | 44 +++++++++++++++++++++++++++++++++++++++++---
 R/EMMA_show.R    | 37 ++++++++++++++++++++++++++++++++-----
 3 files changed, 76 insertions(+), 8 deletions(-)

diff --git a/R/EMMA_explain.R b/R/EMMA_explain.R
index 3a32aea..b8ce103 100644
--- a/R/EMMA_explain.R
+++ b/R/EMMA_explain.R
@@ -4,6 +4,9 @@
 #' to a Materials and Methods section of a paper, by summarizing the executed
 #' call, the parameters, software context, and reference databases used.
 #'
+#' @param res A functional enrichment analysis results object as returned by
+#' `EMMA_run()`. Its attributes contain `EMMA_record` of class `EMMARecord`, which
+#' contains all provenance information of the performed FEA
 EMMA_explain <- function(res){
   # code
 }
\ No newline at end of file
diff --git a/R/EMMA_freeze.R b/R/EMMA_freeze.R
index 0b2efb0..c71e18c 100644
--- a/R/EMMA_freeze.R
+++ b/R/EMMA_freeze.R
@@ -1,8 +1,46 @@
 #' EMMA_freeze
 #' 
 #' This function records the R environment during analysis runtime and generates
-#' a lockfile that can be used with tools such as `renv`
+#' a lockfile that can be used with tools such as `renv`.
+#' By default, all currently loaded namespaces are recorded.
 #'
-EMMA_freeze <- function(){
-  #code
+#' @param project Character string corresponding to the path to the project
+#' directory where the lockfile should be written. If the directory does not
+#' exist, it will be created. It defaults to the current working directory
+#' @param file Character string refering to the name of the lockfile to generate.
+#' It defaults to "renv.lock"
+#' @param pkgs Character vector of package names to snapshot. It defaults to all
+#' currently loaded namespaces via `loadedNamespaces()`
+#' 
+#' @details
+#' This function calls `renv::snapshot()` with the specified packages.
+#' The resulting lockfile can later be restored with `renv::restore()` to
+#' recreate the same package environment.
+#' 
+#' @returns TODO json file like to create a lock.file?
+#' 
+#' @seealso \code{\link[renv]{snapshot}}, \code{\link[renv]{restore}}
+#' 
+#' @export
+#' 
+#' @examples
+#' \dontrun{
+#' # Create a lockfile in a separate directory
+#' EMMA_freeze(project = "emma_env")
+#'
+#' # Restore later with renv
+#' renv::restore(project = "emma_env")
+#' }
+EMMA_freeze <- function(project = getwd(),
+                        file = "renv.lock",
+                        pkgs = loadedNamespaces()){
+  
+  # if (!dir.exists(project)) dir.create(project, recursive = TRUE)
+  # 
+  # renv::snapshot(
+  #   project = project,
+  #   lockfile = file,
+  #   packages = pkgs
+  # )
+  # 
 }
\ No newline at end of file
diff --git a/R/EMMA_show.R b/R/EMMA_show.R
index b8ad0a2..9746a2e 100644
--- a/R/EMMA_show.R
+++ b/R/EMMA_show.R
@@ -6,18 +6,45 @@
 #' @param res A functional enrichment analysis results object as returned by
 #' `EMMA_run()`
 #'
-#' @returns A list of the recorded information
+#' @returns NULL
 #' @export
 #'
 #' @examples
-#' res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive), universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db, ont = "BP"))
+#' data("de_res_IFNg_vs_naive", package = "EMMA")
+#' data("universe", package = "EMMA")
+#' library("clusterProfiler")
+#' res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+#' universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
+#' ont = "BP"))
 #' EMMA_show(res)
 EMMA_show <- function(res){
   if ("EMMA_record" %in% names(attributes(res))) {
     message("Found EMMA record!!")
     emma_rec <- attr(res, "EMMA_record")
-    # should think of a better way to show the records
-    str(emma_rec)
+    if (!is.list(emma_rec)) {
+      stop("'EMMA_record' must be a list!")
+    }
+    
+    if (is.list(res) && "result" %in% names(res)) {
+      
+      cat("Number of Pathways: ", NROW(res$result), "\n")
+    } else {
+      cat("Number of Pathways: ", NROW(res), "\n")
+    }
+    
+    pkg_info <- emma_rec$method
+    db_info <- emma_rec$annotation
+    
+    cat("Call: ", paste(deparse(emma_rec$call), collapse = " "), " \n")
+    cat("Package: ", paste(pkg_info$package_name , "v.",
+                           pkg_info$package_version), " \n")
+    cat("Organism : ", db_info$organism, " \n")
+    cat("Gene set library : ", paste(db_info$gene_set_db, collapse = ", "), " \n")
+    cat("Gene set library version : ",db_info$gene_set_db_version, " \n")
+    cat("\n")
+    
+  } else {
+    warning("No `EMMA_record` attribute was found")
   }
   
-}
\ No newline at end of file
+}

From e5ea209b43c707639c23f54208fcdfed3dae9411 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Tue, 7 Apr 2026 13:18:18 +0200
Subject: [PATCH 04/92] update man

---
 man/EMMA_explain.Rd |  5 +++++
 man/EMMA_freeze.Rd  | 36 ++++++++++++++++++++++++++++++++++--
 man/EMMA_run.Rd     | 21 ++++++++++++++++++---
 man/EMMA_show.Rd    | 10 ++++++----
 4 files changed, 63 insertions(+), 9 deletions(-)

diff --git a/man/EMMA_explain.Rd b/man/EMMA_explain.Rd
index 03e177e..76ca399 100644
--- a/man/EMMA_explain.Rd
+++ b/man/EMMA_explain.Rd
@@ -6,6 +6,11 @@
 \usage{
 EMMA_explain(res)
 }
+\arguments{
+\item{res}{A functional enrichment analysis results object as returned by
+\code{EMMA_run()}. Its attributes contain \code{EMMA_record} of class \code{EMMARecord}, which
+contains all provenance information of the performed FEA}
+}
 \description{
 This function generates a human-readable description of the FEA, similar
 to a Materials and Methods section of a paper, by summarizing the executed
diff --git a/man/EMMA_freeze.Rd b/man/EMMA_freeze.Rd
index 7f7c69f..49813f4 100644
--- a/man/EMMA_freeze.Rd
+++ b/man/EMMA_freeze.Rd
@@ -4,9 +4,41 @@
 \alias{EMMA_freeze}
 \title{EMMA_freeze}
 \usage{
-EMMA_freeze()
+EMMA_freeze(project = getwd(), file = "renv.lock", pkgs = loadedNamespaces())
+}
+\arguments{
+\item{project}{Character string corresponding to the path to the project
+directory where the lockfile should be written. If the directory does not
+exist, it will be created. It defaults to the current working directory}
+
+\item{file}{Character string refering to the name of the lockfile to generate.
+It defaults to "renv.lock"}
+
+\item{pkgs}{Character vector of package names to snapshot. It defaults to all
+currently loaded namespaces via \code{loadedNamespaces()}}
+}
+\value{
+TODO json file like to create a lock.file?
 }
 \description{
 This function records the R environment during analysis runtime and generates
-a lockfile that can be used with tools such as \code{renv}
+a lockfile that can be used with tools such as \code{renv}.
+By default, all currently loaded namespaces are recorded.
+}
+\details{
+This function calls \code{renv::snapshot()} with the specified packages.
+The resulting lockfile can later be restored with \code{renv::restore()} to
+recreate the same package environment.
+}
+\examples{
+\dontrun{
+# Create a lockfile in a separate directory
+EMMA_freeze(project = "emma_env")
+
+# Restore later with renv
+renv::restore(project = "emma_env")
+}
+}
+\seealso{
+\code{\link[renv]{snapshot}}, \code{\link[renv]{restore}}
 }
diff --git a/man/EMMA_run.Rd b/man/EMMA_run.Rd
index bebb97d..f6068ae 100644
--- a/man/EMMA_run.Rd
+++ b/man/EMMA_run.Rd
@@ -4,7 +4,12 @@
 \alias{EMMA_run}
 \title{EMMA_run}
 \usage{
-EMMA_run(expr, envir = parent.frame())
+EMMA_run(
+  expr,
+  envir = parent.frame(),
+  session = TRUE,
+  args_form = c("evaluated", "unevaluated")
+)
 }
 \arguments{
 \item{expr}{A function call that performs functional enrichment analysis.
@@ -12,6 +17,12 @@ The call is captured and executed by EMMA to record analysis parameters and
 provenance information}
 
 \item{envir}{An environment in which to evaluate \code{expr}}
+
+\item{session}{Logical, indicating whether to store sessionInfo or not.
+It defaults to (\code{TRUE}) saving the session}
+
+\item{args_form}{A character string indicating whether to store the evaluated
+or the unevaluated arguments. It default to store the evaluated arguments}
 }
 \value{
 Functional enrichment analysis results in the native format
@@ -20,8 +31,12 @@ returned by the original \code{expr}
 \description{
 This function executes functional enrichment analysis using existing tools
 and captures the associated parameters and provenance information for the
-analysis during runtime.
+analysis when available during runtime.
 }
 \examples{
-EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive), universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db, ont = "BP"))
+data("de_res_IFNg_vs_naive", package = "EMMA")
+data("universe", package = "EMMA")
+EMMA_run(clusterProfiler::enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
+ont = "BP"))
 }
diff --git a/man/EMMA_show.Rd b/man/EMMA_show.Rd
index 14f6ee9..f6e5e32 100644
--- a/man/EMMA_show.Rd
+++ b/man/EMMA_show.Rd
@@ -10,15 +10,17 @@ EMMA_show(res)
 \item{res}{A functional enrichment analysis results object as returned by
 \code{EMMA_run()}}
 }
-\value{
-A list of the recorded information
-}
 \description{
 This function prints the EMMA record associated with a functional enrichment
 analysis object, including the executed call, parameters, and provenance
 information.
 }
 \examples{
-res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive), universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db, ont = "BP"))
+data("de_res_IFNg_vs_naive", package = "EMMA")
+data("universe", package = "EMMA")
+library("clusterProfiler")
+res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
+ont = "BP"))
 EMMA_show(res)
 }

From ef2b2d3259011dcea06bb1713426c2447ffe2f4c Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Tue, 7 Apr 2026 13:18:38 +0200
Subject: [PATCH 05/92] update namespace

---
 NAMESPACE    | 6 ++++++
 R/EMMA-pkg.R | 6 ++++--
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/NAMESPACE b/NAMESPACE
index 4ee2689..012134d 100644
--- a/NAMESPACE
+++ b/NAMESPACE
@@ -1,5 +1,11 @@
 # Generated by roxygen2: do not edit by hand
 
+export(EMMA_freeze)
 export(EMMA_run)
 export(EMMA_show)
+export(getEMMARecord)
+import(GO.db)
+import(methods)
+importFrom(AnnotationDbi,metadata)
 importFrom(utils,packageVersion)
+importFrom(utils,sessionInfo)
diff --git a/R/EMMA-pkg.R b/R/EMMA-pkg.R
index 328fa03..8af20dd 100644
--- a/R/EMMA-pkg.R
+++ b/R/EMMA-pkg.R
@@ -3,8 +3,10 @@
 #' EMMA stands for Enrichment Methods Matter.
 #' And EMMA stands to help you in realizing it.
 #'
-#'
-#' @importFrom utils packageVersion
+#' @import methods
+#' @import GO.db
+#' @importFrom AnnotationDbi metadata
+#' @importFrom utils packageVersion sessionInfo
 #' @name EMMA-pkg
 #' @docType package
 "_PACKAGE"

From f50039480e4e2ded9b0826933f8c71cbb70e8b7f Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Tue, 7 Apr 2026 13:19:13 +0200
Subject: [PATCH 06/92] add example data

---
 R/EMMA-data.R                           | 46 +++++++++++++++++++++++++
 inst/scripts/create_datasets_examples.R |  2 +-
 man/de_res_IFNg_vs_naive.Rd             | 31 +++++++++++++++++
 man/getEMMARecord.Rd                    | 26 ++++++++++++++
 man/universe.Rd                         | 30 ++++++++++++++++
 5 files changed, 134 insertions(+), 1 deletion(-)
 create mode 100644 R/EMMA-data.R
 create mode 100644 man/de_res_IFNg_vs_naive.Rd
 create mode 100644 man/getEMMARecord.Rd
 create mode 100644 man/universe.Rd

diff --git a/R/EMMA-data.R b/R/EMMA-data.R
new file mode 100644
index 0000000..2d8b7ea
--- /dev/null
+++ b/R/EMMA-data.R
@@ -0,0 +1,46 @@
+#' A sample `data.frame` containing Differential Expression Analysis, generated
+#' with `DESeq2`
+#'
+#' @details This `data.frame` object contains the results of a Differential
+#' Expression Analysis performed on data from the `macrophage` package, more
+#' precisely contrasting the counts from naive macrophage to those associated
+#' with IFNg.
+#'
+#' The code to create said object can be found in the folder `/inst/scripts` in
+#' the EMMA package, the file is called `create_datasets_examples.R`.
+#'
+#' @return A sample `data.frame` object, extracted from `DESeq2` results
+#'
+#' @format A `data.frame` object
+#'
+#'
+#' @references Alasoo, et al. "Shared genetic effects on chromatin and gene
+#' expression indicate a role for enhancer priming in immune response",
+#' Nature Genetics, January 2018 doi: 10.1038/s41588-018-0046-7.
+#'
+#' @name de_res_IFNg_vs_naive
+#' @docType data
+NULL
+
+#' A sample `character vector` containing the background gene list used to
+#' perform FEA on the `macrophage` dataset
+#'
+#' @details This `character vector` object that contains the assay's `rownames`
+#' of the `macrophage` data
+#'
+#' The code to create said object can be found in the folder `/inst/scripts` in
+#' the EMMA package, the file is called `create_datasets_examples.R`.
+#'
+#' @return A sample `character vector` containing the assay's `rownames`
+#' of the `macrophage` data
+#'
+#' @format A `character vector`
+#'
+#'
+#' @references Alasoo, et al. "Shared genetic effects on chromatin and gene
+#' expression indicate a role for enhancer priming in immune response",
+#' Nature Genetics, January 2018 doi: 10.1038/s41588-018-0046-7.
+#'
+#' @name universe
+#' @docType data
+NULL
\ No newline at end of file
diff --git a/inst/scripts/create_datasets_examples.R b/inst/scripts/create_datasets_examples.R
index 1603ca9..cdf1187 100644
--- a/inst/scripts/create_datasets_examples.R
+++ b/inst/scripts/create_datasets_examples.R
@@ -14,7 +14,7 @@ dds_macrophage
 
 # set seed for reproducibility
 set.seed(42)
-# sample randomly for 1k genes
+# sample randomly for 2k genes
 selected_genes <- sample(rownames(dds_macrophage), 2000)
 
 dds_macrophage <- dds_macrophage[selected_genes, ]
diff --git a/man/de_res_IFNg_vs_naive.Rd b/man/de_res_IFNg_vs_naive.Rd
new file mode 100644
index 0000000..dae7c8f
--- /dev/null
+++ b/man/de_res_IFNg_vs_naive.Rd
@@ -0,0 +1,31 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/EMMA-data.R
+\docType{data}
+\name{de_res_IFNg_vs_naive}
+\alias{de_res_IFNg_vs_naive}
+\title{A sample \code{data.frame} containing Differential Expression Analysis, generated
+with \code{DESeq2}}
+\format{
+A \code{data.frame} object
+}
+\value{
+A sample \code{data.frame} object, extracted from \code{DESeq2} results
+}
+\description{
+A sample \code{data.frame} containing Differential Expression Analysis, generated
+with \code{DESeq2}
+}
+\details{
+This \code{data.frame} object contains the results of a Differential
+Expression Analysis performed on data from the \code{macrophage} package, more
+precisely contrasting the counts from naive macrophage to those associated
+with IFNg.
+
+The code to create said object can be found in the folder \verb{/inst/scripts} in
+the EMMA package, the file is called \code{create_datasets_examples.R}.
+}
+\references{
+Alasoo, et al. "Shared genetic effects on chromatin and gene
+expression indicate a role for enhancer priming in immune response",
+Nature Genetics, January 2018 doi: 10.1038/s41588-018-0046-7.
+}
diff --git a/man/getEMMARecord.Rd b/man/getEMMARecord.Rd
new file mode 100644
index 0000000..cdc4023
--- /dev/null
+++ b/man/getEMMARecord.Rd
@@ -0,0 +1,26 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/geEMMARecord.R
+\name{getEMMARecord}
+\alias{getEMMARecord}
+\title{getEMMARecord}
+\usage{
+getEMMARecord(res)
+}
+\arguments{
+\item{res}{Functional Enrichment Analysis results (enrichResult, gseaResult ...)}
+}
+\value{
+list of metadata recorded during FEA runtime
+}
+\description{
+getEMMARecord
+}
+\examples{
+data("de_res_IFNg_vs_naive", package = "EMMA")
+data("universe", package = "EMMA")
+library("clusterProfiler")
+res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
+ont = "BP"))
+getEMMARecord(res)
+}
diff --git a/man/universe.Rd b/man/universe.Rd
new file mode 100644
index 0000000..7a7e772
--- /dev/null
+++ b/man/universe.Rd
@@ -0,0 +1,30 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/EMMA-data.R
+\docType{data}
+\name{universe}
+\alias{universe}
+\title{A sample \verb{character vector} containing the background gene list used to
+perform FEA on the \code{macrophage} dataset}
+\format{
+A \verb{character vector}
+}
+\value{
+A sample \verb{character vector} containing the assay's \code{rownames}
+of the \code{macrophage} data
+}
+\description{
+A sample \verb{character vector} containing the background gene list used to
+perform FEA on the \code{macrophage} dataset
+}
+\details{
+This \verb{character vector} object that contains the assay's \code{rownames}
+of the \code{macrophage} data
+
+The code to create said object can be found in the folder \verb{/inst/scripts} in
+the EMMA package, the file is called \code{create_datasets_examples.R}.
+}
+\references{
+Alasoo, et al. "Shared genetic effects on chromatin and gene
+expression indicate a role for enhancer priming in immune response",
+Nature Genetics, January 2018 doi: 10.1038/s41588-018-0046-7.
+}

From 50cb3ed8ad968dce65cad48dea21fab9b6d42b1b Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Tue, 7 Apr 2026 13:20:08 +0200
Subject: [PATCH 07/92] add helper functions to capture metadata base on the
 call passed to EMMA_run

---
 R/EMMA_internal-utils.R | 281 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 281 insertions(+)
 create mode 100644 R/EMMA_internal-utils.R

diff --git a/R/EMMA_internal-utils.R b/R/EMMA_internal-utils.R
new file mode 100644
index 0000000..0e3656e
--- /dev/null
+++ b/R/EMMA_internal-utils.R
@@ -0,0 +1,281 @@
+# metadata capture -------------------------------------------------------------
+#' get the basic structure for the metadata elements to be captured depending on
+#' the method
+#' 
+#' @noRd
+.EMMA_empty_metadata <- function() {
+  list(
+    organism = NA_character_,
+    gene_set_db = NA_character_,
+    gene_set_db_version = NA_character_
+  )
+}
+
+#' depending on the function/pkg, decide the right function dispatch
+#'
+#' @param function_name A character string specifying the function name used to
+#' perform FEA
+#' @param package_name A character string containing the package name used to
+#' perform FEA
+#' @param args A list containing the evaluated arguments passed into the
+#' function call to perform FEA 
+#'
+#' @noRd
+.EMMA_get_metadata <- function(function_name,
+                               package_name,
+                               args) {
+  switch(
+    package_name,
+    clusterProfiler = .EMMA_get_clusterprofiler_metadata(function_name, args),
+    gprofiler2      = .EMMA_get_gprofiler2_metadata(args),
+    mosdef          = .EMMA_cp_GO_metadata(args$mapping),
+    .EMMA_empty_metadata()
+  )
+}
+
+#' get metadata from clusterProfiler functions
+#' @param function_name A character string specifying the function name used to
+#' perform FEA
+#'
+#' @param args A list containing the evaluated arguments passed into the
+#' function call to perform FEA 
+#'
+#' @noRd
+.EMMA_get_clusterprofiler_metadata <- function(function_name, args) {
+  switch(
+    function_name,
+    enrichGO   = .EMMA_cp_GO_metadata(args$OrgDb),
+    gseGO = .EMMA_cp_GO_metadata(args$OrgDb),
+    groupGO = .EMMA_cp_GO_metadata(args$OrgDb),
+    enrichKEGG = .EMMA_cp_KEGG_metadata(args),
+    gseKEGG = .EMMA_cp_KEGG_metadata(args),
+    .EMMA_empty_metadata()
+  )
+}
+
+#' extract the organism from org,*.eg.db objects
+#' @param orgdb Organism object from org.*.eg.db packages
+#'
+#' @noRd
+.EMMA_get_organism_from_OrgDb <- function(orgdb) {
+  
+  if (is.null(orgdb)) {
+    return(NA_character_)
+  }
+  
+  if (is.character(orgdb) && length(orgdb) == 1) {
+    if (!exists(orgdb, mode = "S4")) {
+      stop(orgdb,
+           " was provided as a string, but no loaded object with that name was found. ", 
+           "Please load the corresponding org.*.db library")
+    }
+    orgdb <- get(orgdb)
+  }
+  
+  md <- AnnotationDbi::metadata(orgdb)
+  organism <- md$value[md$name == "ORGANISM"]
+  
+  if (length(organism) != 1L) {
+    return(NA_character_)
+  }
+  return(organism)
+}
+
+
+#' assemble metadata element from clusterProfiler GO analyses
+#' 
+#' @param org 
+#'
+#' @noRd
+.EMMA_cp_GO_metadata <- function(org) {
+  meta <- list()
+  
+  meta$organism <- .EMMA_get_organism_from_OrgDb(org)
+  meta$gene_set_db <- "GO"
+  meta$gene_set_db_version <- if (requireNamespace("GO.db", quietly = TRUE)) {
+    as.character(utils::packageVersion("GO.db"))
+  } else {
+    NA_character_
+  }
+  
+  return(meta)
+}
+
+
+### not tested yet since the kegg server is down and the function couldn't work
+
+#' assemble metadata element from clusterProfiler KEGG analyses
+#' 
+#' @param args A list containing the evaluated arguments passed into the
+#' function call to perform FEA 
+#'
+#' @noRd
+.EMMA_cp_KEGG_metadata <- function(args) {
+  meta <- list()
+  
+  meta$organism <- args$organism
+  meta$gene_set_db <- "KEGG"
+  meta$gene_set_db_version <- NA_character_
+  
+  return(meta)
+}
+
+#' assemble metadata element from gprofiler2
+#' 
+#' @param args A list containing the evaluated arguments passed into the
+#' function call to perform FEA 
+#'
+#' @noRd
+.EMMA_get_gprofiler2_metadata <- function(args) {
+  meta <- list()
+  
+  version_info <- gprofiler2::get_version_info()
+  
+  meta$organism <- if (!is.null(args$organism)) args$organism else NA_character_
+  
+  sources_used <- if (!is.null(args$sources)) {
+    args$sources
+  } else {
+    names(version_info[["sources"]])
+  } 
+  
+  # in case the source is GO, we extract all the dbs ...
+  if ("GO" %in% sources_used) {
+    sources_used <- unique(c(
+      setdiff(sources_used, "GO"),
+      "GO:BP", "GO:CC", "GO:MF"
+    ))
+  }
+  
+  meta$gene_set_db <- sources_used
+  
+  meta$gene_set_db_version <- vapply(
+    version_info[["sources"]][sources_used], function(x) x[["version"]],
+    character(1)
+  ) # needs more work when only GO, no need to print 3 times the same version
+  # also, differentiate between which version corresponds to which db
+
+  return(meta)
+}
+
+# call capture ---------------------
+#' @noRd
+.EMMA_capture_call_info <- function(call, envir = parent.frame()) {
+  
+  # param checks
+  if (!is.call(call)) {
+    stop("`call` must be a function call", call. = FALSE)
+  }
+  
+  # capture function name
+  call_name <- call[[1]]
+  
+  # when we only use function name e.g. enrichGO(...)
+  if (is.symbol(call_name)) {
+    function_name <- as.character(call_name)
+    
+    fun <- get(function_name, envir = envir, mode = "function")
+    
+    pkg <- utils::packageName(environment(fun))
+    package_name <- if (is.null(pkg) || pkg == "" ) NA_character_ else pkg
+
+    pkg_version <- if (!is.na(package_name)) {
+      as.character(packageVersion(package_name))}
+    else NA_character_
+    
+    return(list(
+      function_name = function_name,
+      package_name = package_name,
+      package_version = pkg_version
+    ))
+  }
+  
+  # when we use function name with namespace e.g. clusterProfiler::enrichGO(...)
+  if (is.call(call_name) &&
+      length(call_name) == 3L &&
+      identical(call_name[[1]], as.symbol("::"))) {
+    
+    package_name <- as.character(call_name[[2]])
+    function_name <- as.character(call_name[[3]])
+    pkg_version <- if (!is.na(package_name)) {
+      as.character(utils::packageVersion(package_name))
+    } else {
+      NA_character_
+    }
+    
+    return(list(
+      function_name = function_name,
+      package_name = package_name,
+      package_version = pkg_version
+    ))
+  }
+  
+  stop(
+    "Unsupported call format. Use a direct function call like `enrichGO(...)` or `pkg::fun(...)`",
+    call. = FALSE
+  )
+}
+
+
+
+# build EMMA_record -----------
+#' @noRd
+.EMMA_build_record <- function(call, function_name, package_name,
+                               package_version, args, arg_list, 
+                               args_form, metadata,
+                               start_time,session) {
+  emma_rec <- list(
+                   method = list(
+                     call = call,
+                     function_name = function_name,
+                     package_name = package_name,
+                     package_version = package_version
+                   ),
+                   input = list(
+                     arguments = if (args_form == "evaluated") args else arg_list
+                   ),
+                   annotation = list(
+                     organism = metadata$organism,
+                     gene_set_db = metadata$gene_set_db,
+                     gene_set_db_version = metadata$gene_set_db_version
+                   ),
+                   timestamp = start_time,
+                   session_info = if (isTRUE(session)) sessionInfo() else NULL,
+                   user_metadata = list(),# free form user additions
+                   emma_version = as.character(packageVersion(pkg = "EMMA"))
+                   )
+  
+  return(emma_rec)
+  
+}
+
+# good practice warnings ---------
+#' @noRd
+.EMMA_warnings <- function(arg_names, function_name){
+  checks <- list(
+    list(
+      params = c("pAdjustMethod", "correction_method", "do_padj"),
+      label  = "multiple-testing correction method"
+    ),
+    list(
+      params = c("universe", "background", "custom_bg", "bg_genes"),
+      label  = "background gene set"
+    )
+  )
+  
+  for (check in checks) {
+    if (!any(check$params %in% arg_names)) {
+      warning(
+        sprintf(
+          "No %s was specified for %s().
+Consider using the corresponding parameter for your call.",
+          check$label,
+          function_name
+        ),
+        call. = FALSE
+      )
+    }
+  }
+  invisible()
+}
+

From 1c4eef12bcf8282f0f6b09b3ce49892700137c19 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Tue, 7 Apr 2026 13:20:20 +0200
Subject: [PATCH 08/92] setup tests

---
 tests/testthat/setuptests_EMMA.R |  9 ++++++++
 tests/testthat/test-EMMA.R       | 38 ++++++++++++++++++++++++++++++--
 2 files changed, 45 insertions(+), 2 deletions(-)

diff --git a/tests/testthat/setuptests_EMMA.R b/tests/testthat/setuptests_EMMA.R
index 9d480ed..f0e1294 100644
--- a/tests/testthat/setuptests_EMMA.R
+++ b/tests/testthat/setuptests_EMMA.R
@@ -1,2 +1,11 @@
+suppressPackageStartupMessages(
+  library("clusterProfiler")
+)
+
+suppressPackageStartupMessages(
+  library("org.Hs.eg.db")
+)
+
 data("de_res_IFNg_vs_naive", package = "EMMA")
 data("universe", package = "EMMA")
+
diff --git a/tests/testthat/test-EMMA.R b/tests/testthat/test-EMMA.R
index 713438a..ab51bea 100644
--- a/tests/testthat/test-EMMA.R
+++ b/tests/testthat/test-EMMA.R
@@ -12,7 +12,9 @@ test_that("EMMA_run", {
   
   expect_true("EMMA_record" %in% names(attributes(fea_res)))
   
-  expect_type(attr(fea_res, "EMMA_record"), "list")
+  expect_true(is.list(attr(fea_res, "EMMA_record")))
+  
+  expect_true(length(attr(fea_res, "EMMA_record")) == 7)
   
   expect_error(EMMA_run(enrichGO,gene = rownames(de_res_IFNg_vs_naive),
                         keyType = "ENSEMBL",
@@ -23,4 +25,36 @@ test_that("EMMA_run", {
                         universe = universe,
                         readable = TRUE))
   
-})
\ No newline at end of file
+  expect_error(EMMA_run("enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+                        keyType = 'ENSEMBL',
+                        OrgDb = org.Hs.eg.db)"))
+  
+  expect_error(EMMA_run(gene = rownames(de_res_IFNg_vs_naive),
+                        keyType = "ENSEMBL",
+                        OrgDb = org.Hs.eg.db,
+                        pAdjustMethod = "BH",
+                        pvalueCutoff = 0.05,
+                        qvalueCutoff = 0.1,
+                        universe = universe,
+                        readable = TRUE))
+  
+  expect_warning(EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+                          keyType = "ENSEMBL",
+                          OrgDb = org.Hs.eg.db,
+                          pvalueCutoff = 0.05,
+                          qvalueCutoff = 0.1,
+                          universe = universe,
+                          readable = TRUE)))
+  
+  expect_warning(EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+                          keyType = "ENSEMBL",
+                          OrgDb = org.Hs.eg.db,
+                          pvalueCutoff = 0.05,
+                          qvalueCutoff = 0.1,
+                          pAdjustMethod = "BH",
+                          readable = TRUE)))
+  
+
+  
+})
+

From 52cdd99d2df6c263ed3d2da05298edde0b5a2409 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Tue, 7 Apr 2026 13:20:29 +0200
Subject: [PATCH 09/92] update vignette

---
 vignettes/Introduction_to_EMMA.Rmd | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/vignettes/Introduction_to_EMMA.Rmd b/vignettes/Introduction_to_EMMA.Rmd
index 3e45a11..f3425b4 100644
--- a/vignettes/Introduction_to_EMMA.Rmd
+++ b/vignettes/Introduction_to_EMMA.Rmd
@@ -46,6 +46,8 @@ knitr::opts_chunk$set(
 
 # Introduction {#introduction}
 
+TODO: add a paragraph of why we need this pkg, and which gap is this filling
+
 This vignette describes how to use the `r BiocStyle::Biocpkg("EMMA")`
 package to perform Functional Enrichment Analysis using existing tools (e.g.
 `clusterProfiler`, `topGO`, `Enrichr`, `gprofiler2`), while systematically
@@ -176,7 +178,7 @@ de_res_list <- list()
 for (i in names(contrast_list)) {
   de_res <- as.data.frame(contrast_list[[i]])
   de_res <- de_res[order(de_res$padj), ]
-  de_res <- de_res[!(is.na(de_res$padj)) & de_res$padj <= 0.05, ]
+  #de_res <- de_res[!(is.na(de_res$padj)) & de_res$padj <= 0.05, ]
   
   de_res_list[[i]] <- de_res
 }
@@ -199,20 +201,21 @@ it is, while capturing the associated parameters and provenance information:
 de_res_IFNg_vs_naive <- de_res_list$IFNg_vs_naive
 
 # perform FEA, but with EMMA!
-fea_res <- enrichGO(gene = de_res_IFNg_vs_naive$SYMBOL,
-                    keyType = "SYMBOL",
+fea_res <- enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+                    keyType = "ENSEMBL",
                     OrgDb = org.Hs.eg.db,
                     ont = "BP",
                     pAdjustMethod = "BH",
                     pvalueCutoff = 0.05,
-                    qvalueCutoff = 0.1) |> 
+                    qvalueCutoff = 0.1,
+                    universe = universe) |> 
   EMMA_run() # simply pipe your call to EMMA_run()
 ```
 
 ... or you can simply wrap `EMMA_run()` around your call:
 
 ```{r EMMA_run_2}
-fea_res <- EMMA_run(enrichGO(gene = de_res_IFNg_vs_naive$SYMBOL,
+fea_res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
                     keyType = "ENSEMBL",
                     OrgDb = org.Hs.eg.db,
                     ont = "BP",

From 78bb115063dea4b6f411b625b03b9abde81a5935 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Tue, 7 Apr 2026 13:21:38 +0200
Subject: [PATCH 10/92] add getEMMARecord to fetch the captured info from the
 attr (in raw state)

---
 R/getEMMARecord.R | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 R/getEMMARecord.R

diff --git a/R/getEMMARecord.R b/R/getEMMARecord.R
new file mode 100644
index 0000000..7f85f6f
--- /dev/null
+++ b/R/getEMMARecord.R
@@ -0,0 +1,18 @@
+#' getEMMARecord
+#'
+#' @param res Functional Enrichment Analysis results (enrichResult, gseaResult ...)
+#'
+#' @return list of metadata recorded during FEA runtime
+#' @export
+#'
+#' @examples
+#' data("de_res_IFNg_vs_naive", package = "EMMA")
+#' data("universe", package = "EMMA")
+#' library("clusterProfiler")
+#' res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+#' universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
+#' ont = "BP"))
+#' getEMMARecord(res)
+getEMMARecord <- function(res){
+  attr(res, "EMMA_record")
+}
\ No newline at end of file

From ca719832a25550ed41ca5eec2ca3aa1f5282f5f5 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Thu, 9 Apr 2026 12:33:27 +0200
Subject: [PATCH 11/92] fix the printing of the call in EMMA_show()

---
 R/EMMA_show.R | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/R/EMMA_show.R b/R/EMMA_show.R
index 9746a2e..a95c4fb 100644
--- a/R/EMMA_show.R
+++ b/R/EMMA_show.R
@@ -32,12 +32,12 @@ EMMA_show <- function(res){
       cat("Number of Pathways: ", NROW(res), "\n")
     }
     
-    pkg_info <- emma_rec$method
+    method_info <- emma_rec$method
     db_info <- emma_rec$annotation
     
-    cat("Call: ", paste(deparse(emma_rec$call), collapse = " "), " \n")
-    cat("Package: ", paste(pkg_info$package_name , "v.",
-                           pkg_info$package_version), " \n")
+    cat("Call: ", paste(deparse(method_info$call), collapse = " "), " \n")
+    cat("Package: ", paste(method_info$package_name , "v.",
+                           method_info$package_version), " \n")
     cat("Organism : ", db_info$organism, " \n")
     cat("Gene set library : ", paste(db_info$gene_set_db, collapse = ", "), " \n")
     cat("Gene set library version : ",db_info$gene_set_db_version, " \n")

From 8b03865162ca57b15b83ea85fd15f29df8186d36 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Thu, 9 Apr 2026 12:33:37 +0200
Subject: [PATCH 12/92] add news

---
 NEWS.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/NEWS.md b/NEWS.md
index bbd341d..dc2d3bb 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -1,3 +1,16 @@
+# EMMA 0.1.0
+
+* `EMMA_run()` captures a function call, executes the FEA analysis, and returns
+the results in their native format while attaching structured metadata to the
+result object as attribute.
+* `EMMA_run()` can now capture information from functions in `mosdef`,
+`gprofiler2`, and 5 commonly used functions from `clusterProfiler`.
+* `EMMA_show()` prints the captured metadata in a more user-friendly format.
+* Added `getEMMARecord()` to fetch all metadata stored in the attributes of an
+object returned by `EMMA_run()`.
+* Added toy data.
+
+
 # EMMA 0.0.1
 
 * Added the initial implementation of `EMMA_run()` and `EMMA_show()`.

From a52d9796dfc22cea30503a95c3fa24b406908d30 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Thu, 9 Apr 2026 12:33:58 +0200
Subject: [PATCH 13/92] fix typo in man page

---
 man/getEMMARecord.Rd | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man/getEMMARecord.Rd b/man/getEMMARecord.Rd
index cdc4023..c0f9bbe 100644
--- a/man/getEMMARecord.Rd
+++ b/man/getEMMARecord.Rd
@@ -1,5 +1,5 @@
 % Generated by roxygen2: do not edit by hand
-% Please edit documentation in R/geEMMARecord.R
+% Please edit documentation in R/getEMMARecord.R
 \name{getEMMARecord}
 \alias{getEMMARecord}
 \title{getEMMARecord}

From 9e54d5d3cd958898a2618584a9139b501aa5427f Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Thu, 9 Apr 2026 15:01:48 +0200
Subject: [PATCH 14/92] update description

---
 DESCRIPTION | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/DESCRIPTION b/DESCRIPTION
index 120316a..3e2fdd8 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -1,7 +1,7 @@
 Package: EMMA
 Title: EMMA: Enrichment Methods Matter for enabeling fully reproducible and 
     provenance-aware pathway analysis
-Version: 0.0.1
+Version: 0.1.0
 Authors@R: 
     c(
         person(
@@ -43,6 +43,6 @@ Suggests:
 VignetteBuilder: knitr
 URL: https://github.com/imbeimainz/EMMA
 BugReports: https://github.com/imbeimainz/EMMA/issues
-biocViews:  Pathways, GO, KEGG, GeneSetEnrichment, Annotation, ImmunoOncology,
-    ReproducibleResearch, Transcriptomics, SingleCell, Software
+biocViews:  Software, Pathways, GO, KEGG, GeneSetEnrichment, ImmunoOncology,
+    ReproducibleResearch, Transcriptomics, SingleCell
 Config/testthat/edition: 3

From cf184b0d0311c4d64b9f8cc1b6d35516494d227c Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Thu, 9 Apr 2026 15:02:57 +0200
Subject: [PATCH 15/92] add returned value by EMMA_show

---
 R/EMMA_show.R | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/R/EMMA_show.R b/R/EMMA_show.R
index a95c4fb..2ebae26 100644
--- a/R/EMMA_show.R
+++ b/R/EMMA_show.R
@@ -47,4 +47,6 @@ EMMA_show <- function(res){
     warning("No `EMMA_record` attribute was found")
   }
   
+  invisible(NULL)
+  
 }

From b85ee3b065765ae2efa80a3fa7ef18a36beaa757 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Thu, 9 Apr 2026 15:03:12 +0200
Subject: [PATCH 16/92] adding more tests

---
 tests/testthat/setuptests_EMMA.R |  1 +
 tests/testthat/test-EMMA.R       | 43 ++++++++++++++++++++++++++++++++
 2 files changed, 44 insertions(+)

diff --git a/tests/testthat/setuptests_EMMA.R b/tests/testthat/setuptests_EMMA.R
index f0e1294..2a9aff3 100644
--- a/tests/testthat/setuptests_EMMA.R
+++ b/tests/testthat/setuptests_EMMA.R
@@ -6,6 +6,7 @@ suppressPackageStartupMessages(
   library("org.Hs.eg.db")
 )
 
+
 data("de_res_IFNg_vs_naive", package = "EMMA")
 data("universe", package = "EMMA")
 
diff --git a/tests/testthat/test-EMMA.R b/tests/testthat/test-EMMA.R
index ab51bea..fb02737 100644
--- a/tests/testthat/test-EMMA.R
+++ b/tests/testthat/test-EMMA.R
@@ -54,7 +54,50 @@ test_that("EMMA_run", {
                           pAdjustMethod = "BH",
                           readable = TRUE)))
   
+})
+
+
+test_that("getEMMARecord", {
+  fea_res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+                               keyType = "ENSEMBL",
+                               OrgDb = org.Hs.eg.db,
+                               pAdjustMethod = "BH",
+                               pvalueCutoff = 0.05,
+                               qvalueCutoff = 0.1,
+                               universe = universe,
+                               readable = TRUE))
+  
+  expect_true(is.list(getEMMARecord(fea_res)))
+  expect_length(getEMMARecord(fea_res), 7)
+  
+})
 
+
+test_that("testing the record content", {
+  
+  fea_res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+                               keyType = "ENSEMBL",
+                               OrgDb = org.Hs.eg.db,
+                               pAdjustMethod = "BH",
+                               pvalueCutoff = 0.05,
+                               qvalueCutoff = 0.1,
+                               universe = universe,
+                               readable = TRUE))
+  
+  emma_rec <- attr(fea_res, "EMMA_record")
+  
+  org <- emma_rec$annotation$organism
+  
+  db <- emma_rec$annotation$gene_set_db
+  
+  expect_true(is.list(emma_rec$annotation))
+  expect_true(is.list(emma_rec$method))
+  expect_true(is.list(emma_rec$input))
+  
+  expect_identical(org, "Homo sapiens")
+  expect_identical(db, "GO")
+  
+  
   
 })
 

From 1bb2682fe2d69e5949887479b41fe828cc961b5e Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Thu, 9 Apr 2026 15:20:10 +0200
Subject: [PATCH 17/92] add more tests

---
 tests/testthat/test-EMMA.R | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/tests/testthat/test-EMMA.R b/tests/testthat/test-EMMA.R
index fb02737..a31f19d 100644
--- a/tests/testthat/test-EMMA.R
+++ b/tests/testthat/test-EMMA.R
@@ -101,3 +101,20 @@ test_that("testing the record content", {
   
 })
 
+
+test_that("EMMA_show", {
+  
+  fea_res <- enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+                               keyType = "ENSEMBL",
+                               OrgDb = org.Hs.eg.db,
+                               pAdjustMethod = "BH",
+                               pvalueCutoff = 0.05,
+                               qvalueCutoff = 0.1,
+                               universe = universe,
+                               readable = TRUE)
+  
+  
+  expect_warning(EMMA_show(fea_res))
+})
+
+

From 8eadb423cc7df208a82af5a2accdf9a64a476436 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Thu, 9 Apr 2026 17:13:23 +0200
Subject: [PATCH 18/92] update vignette to reflect the state/content of the
 package

---
 vignettes/Introduction_to_EMMA.Rmd | 99 +++++++++++++++++++++++++-----
 1 file changed, 82 insertions(+), 17 deletions(-)

diff --git a/vignettes/Introduction_to_EMMA.Rmd b/vignettes/Introduction_to_EMMA.Rmd
index f3425b4..934bdb0 100644
--- a/vignettes/Introduction_to_EMMA.Rmd
+++ b/vignettes/Introduction_to_EMMA.Rmd
@@ -46,12 +46,28 @@ knitr::opts_chunk$set(
 
 # Introduction {#introduction}
 
-TODO: add a paragraph of why we need this pkg, and which gap is this filling
+Functional Enrichment Analysis (FEA) is a key downstream step in omics workflows,
+commonly applied after differential expression analysis to support biological
+interpretation and generate pathway-level hypotheses. A wide range of tools and
+methods are available, leading to substantial heterogeneity in analytical choices
+and reported results.
+
+Despite its widespread use, FEA is often insufficiently documented. Critical
+parameters such as background gene sets or multiple testing correction methods
+are frequently missing or inconsistently reported in scientific papers,
+limiting reproducibility and interpretability. Currently, no standardized method
+exists to ensure transparent and reproducible documentation of FEA workflows.
+
+To address this gap, we introduce `r BiocStyle::Biocpkg("EMMA")`, a framework
+that automatically captures key analytical parameters and provenance information
+during the execution of FEA methods.
+
+This vignette demonstrates how `EMMA` integrates with existing tools
+(e.g. `clusterProfiler`, `topGO`, `Enrichr`, `gprofiler2`) to execute enrichment
+analyses while systematically capturing analysis parameters and provenance
+information during runtime, and returning enrichment results in their native
+format alongside structured and reusable metadata.
 
-This vignette describes how to use the `r BiocStyle::Biocpkg("EMMA")`
-package to perform Functional Enrichment Analysis using existing tools (e.g.
-`clusterProfiler`, `topGO`, `Enrichr`, `gprofiler2`), while systematically
-capturing analysis parameters and provenance information during runtime.
 
 # Getting started {#gettingstarted}
 
@@ -215,6 +231,8 @@ fea_res <- enrichGO(gene = rownames(de_res_IFNg_vs_naive),
 ... or you can simply wrap `EMMA_run()` around your call:
 
 ```{r EMMA_run_2}
+# you can also pass the function name and its namespace
+# e.g. `clusterProfiler::enrichGO(...)`
 fea_res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
                     keyType = "ENSEMBL",
                     OrgDb = org.Hs.eg.db,
@@ -228,25 +246,72 @@ fea_res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
 fea_res
 ```
 
-As you can see, EMMA returns the FEA results in their **native/standard** format.
-EMMA also warns you about good practices when performing FEA, like in this
+As you can see, `EMMA` returns the FEA results in their **native/standard** format.
+`EMMA` also warns you about good practices when performing FEA, like in this
 example, we didn't define a list of background genes, so we get warned about that.
 
-To check what EMMA captured while we ran the analysis, we use `EMMA_show()`:
+To get a quick summary of what `EMMA` captured while we ran the analysis, we use
+`EMMA_show()`:
 
 ```{r EMMA_show}
 EMMA_show(fea_res)
 ```
 
-EMMA aims to capture the following elements:
- 
- * the full call used to perform the FEA
- * the package used and its version
- * the evaluated arguments used
- * the gene set library (GO, KEGG, Reactome ...) and its version
- * the organism type
- * the runtime, i.e. when the analysis started
- * Information about the current R session (`sessionInfo`)
+`EMMA` stores the captured metadata within the attributes of the results object.
+That's why it is always a good practice to save the original results, and not
+only the subsets of interest.
+To see the full recorded information, we use `getEMMARecord()`:
+
+```{r getEMMARecord}
+emma_record <- getEMMARecord(fea_res)
+
+emma_record
+```
+
+`EMMA` aims to capture the following elements:
+
+```
+├── EMMA_record
+│   ├── method
+│   │   ├── call
+│   │   └── function_name
+│   │   └── package_name
+│   │   └── package_version
+│   └── input
+│   │   └── arguments
+│   └── annotation
+│   │   ├── organism
+│   │   └── gene_set_db
+│   │   └── gene_set_db_version
+│   └── timestamp
+│   └── session_info
+│   └── user_metadata # the user can pass any extra metadata freely in this field
+│   ├── emma_version
+```
+
+As we can see a lot of information was recorded. With `EMMA_run()`, we can decide
+whether we want to save the value of arguments used in our call or not. For this,
+we can use the argument `args_form`:
+
+```{r argument_form}
+fea_res_no_param <- enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+                             universe = universe,
+                             keyType = "ENSEMBL",
+                             OrgDb = org.Hs.eg.db,
+                             ont = "BP",
+                             pAdjustMethod = "BH",
+                             pvalueCutoff = 0.05,
+                             qvalueCutoff = 0.1,
+                             readable = TRUE) |> 
+  EMMA_run(args_form = "unevaluated") # if we don't want the values stored
+                                      # else set to evaluated (default)
+
+# check
+getEMMARecord(fea_res_no_param)
+```
+
+We can also choose whether to save the session info with the record using the 
+argument `session`, which defaults to true.
 
 `EMMA_freeze()` records the R environment during analysis runtime and generates
 a lockfile that can be used with tools such as `renv`, to facilitate

From 5078c9e073bd3fa8a6baf342c81617bb83f12bbe Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Thu, 9 Apr 2026 17:31:21 +0200
Subject: [PATCH 19/92] update workflow

---
 .github/workflows/R-CMD-check.yaml | 143 ++++++++++++++++++++++++++---
 1 file changed, 131 insertions(+), 12 deletions(-)

diff --git a/.github/workflows/R-CMD-check.yaml b/.github/workflows/R-CMD-check.yaml
index 5bef95c..b97a276 100644
--- a/.github/workflows/R-CMD-check.yaml
+++ b/.github/workflows/R-CMD-check.yaml
@@ -1,28 +1,147 @@
-# Workflow derived from https://github.com/r-lib/actions/tree/master/examples
-# Need help debugging build failures? Start at https://github.com/r-lib/actions#where-to-find-help
 on:
   push:
-    branches: [main, master]
   pull_request:
-    branches: [main, master]
+    branches:
+      - devel
+  schedule:
+    - cron: '0 8 * * 5'
 
 name: R-CMD-check
 
 jobs:
   R-CMD-check:
-    runs-on: ubuntu-latest
+    runs-on: ${{ matrix.config.os }}
+    container: ${{ matrix.config.image }}
+
+    name: ${{ matrix.config.os }} (${{ matrix.config.bioc }} - ${{ matrix.config.image }})
+
+    strategy:
+      fail-fast: false
+      matrix:
+        config:
+        - { os: windows-latest, bioc: 'devel'}
+        - { os: macOS-latest, bioc: 'devel', curlConfigPath: '/usr/bin/'}
+        - { os: ubuntu-latest, bioc: 'devel'}
+        # - { os: ubuntu-latest, bioc: 'devel', cran: "https://demo.rstudiopm.com/all/__linux__/xenial/latest"}
+        - { os: ubuntu-latest, image: 'bioconductor/bioconductor_docker:devel'}
+
     env:
+      R_REMOTES_NO_ERRORS_FROM_WARNINGS: true
+      CRAN: ${{ matrix.config.cran }}
+      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}
-      R_KEEP_PKG_SOURCE: yes
+      CURL_CONFIG: ${{ matrix.config.curlConfigPath }}curl-config
+
     steps:
-      - uses: actions/checkout@v2
+      - name: Check out repo
+        uses: actions/checkout@v2
 
-      - uses: r-lib/actions/setup-r@v1
+      - name: Set up R and install BiocManager
+        uses: grimbough/bioc-actions/setup-bioc@v1
+        if: matrix.config.image == null
         with:
-          use-public-rspm: true
+          bioc-version: ${{ matrix.config.bioc }}
+
+      - name: Set up pandoc
+        uses: r-lib/actions/setup-pandoc@v2
+        if: matrix.config.image == null
+
+      - name: Install remotes
+        run: |
+          install.packages('remotes')
+        shell: Rscript {0}
 
-      - uses: r-lib/actions/setup-r-dependencies@v1
+      - name: Query dependencies
+        run: |
+          saveRDS(remotes::dev_package_deps(dependencies = TRUE, repos = c(getOption('repos'), BiocManager::repositories())), 'depends.Rds', version = 2)
+        shell: Rscript {0}
+
+      - name: Cache R packages
+        if: runner.os != 'Windows' && matrix.config.image == null
+        uses: actions/cache@v4
+        with:
+          path: ${{ env.R_LIBS_USER }}
+          key: ${{ runner.os }}-bioc-${{ matrix.config.bioc }}-${{ hashFiles('depends.Rds') }}
+          restore-keys: ${{ runner.os }}-bioc-${{ matrix.config.bioc }}-
+
+      - name: Install system dependencies
+        if: runner.os == 'Linux'
+        env:
+          RHUB_PLATFORM: linux-x86_64-ubuntu-gcc
+        uses: r-lib/actions/setup-r-dependencies@v2
         with:
-          extra-packages: rcmdcheck
+          extra-packages: any::rcmdcheck
+          pak-version: devel
+
+      - name: Install system dependencies (macOS)
+        if: runner.os == 'macOS'
+        run: |
+          brew install cairo
+          brew install --cask xquartz
+          brew install harfbuzz
+          brew install fribidi
+          brew install fftw
+
+      # - name: Set up gfortran symlinks (macOS)
+      #   if: runner.os == 'macOS'
+      #   run: |
+      #     set -x
+      #     sudo ln -s /usr/local/Cellar/gcc@11/*/lib/gcc/11 /usr/local/gfortran/lib
+      #     gfortran --version
+
+      - name: Install dependencies
+        run: |
+          local_deps <- remotes::local_package_deps(dependencies = TRUE)
+          deps <- remotes::dev_package_deps(dependencies = TRUE, repos = BiocManager::repositories())
+          BiocManager::install(local_deps[local_deps %in% deps$package[deps$diff != 0]], Ncpu = 2L)
+          BiocManager::install(c("GenomeInfoDbData", "GO.db"), Ncpu = 2L)
+          remotes::install_cran('rcmdcheck', Ncpu = 2L)
+        shell: Rscript {0}
+
+      - name: Session info
+        run: |
+          options(width = 100)
+          pkgs <- installed.packages()[, "Package"]
+          sessioninfo::session_info(pkgs, include_base = TRUE)
+        shell: Rscript {0}
+
+      - name: Build, Install, Check
+        uses: grimbough/bioc-actions/build-install-check@v1
+
+      - name: Run BiocCheck
+        uses: grimbough/bioc-actions/run-BiocCheck@v1
+        with:
+          arguments: '--no-check-bioc-views --no-check-bioc-help'
+          error-on: 'error'
+
+      # - name: Upload check results
+      #   if: failure()
+      #   uses: actions/upload-artifact@master
+      #   with:
+      #     name: ${{ runner.os }}-r${{ matrix.config.r }}-results
+      #     path: check
+
+      - name: Show testthat output
+        if: always()
+        run: find check -name 'testthat.Rout*' -exec cat '{}' \; || true
+        shell: bash
+
+      - name: Upload check results
+        if: failure()
+        uses: actions/upload-artifact@master
+        with:
+          name: ${{ runner.os }}-bioc-${{ matrix.config.bioc }}-results
+          path: check
+
+      - name: Test coverage
+        if: matrix.config.os == 'macOS-latest'
+        run: |
+          install.packages("covr")
+          covr::codecov(token = "${{secrets.CODECOV_TOKEN}}")
+        shell: Rscript {0}
 
-      - uses: r-lib/actions/check-r-package@v1
+      - name: Deploy
+        if: github.event_name == 'push' && github.ref == 'refs/heads/devel' && matrix.config.os == 'macOS-latest'
+        run: |
+          R CMD INSTALL .
+          Rscript -e "remotes::install_dev('pkgdown'); pkgdown::deploy_to_branch(new_process = FALSE)"

From c74d859bdd3f8c4f1bf6fd7ddd58c153e633d30b Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Fri, 10 Apr 2026 16:46:22 +0200
Subject: [PATCH 20/92] update description with pkg for vignettes and tests

---
 DESCRIPTION | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/DESCRIPTION b/DESCRIPTION
index 3e2fdd8..3429ecf 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -36,13 +36,16 @@ Imports:
 Suggests: 
     knitr,
     rmarkdown,
+    macrophage,
+    DESeq2,
     clusterProfiler,
     gprofiler2,
     org.Hs.eg.db,
+    mosdef,
     testthat (>= 3.0.0)
 VignetteBuilder: knitr
 URL: https://github.com/imbeimainz/EMMA
 BugReports: https://github.com/imbeimainz/EMMA/issues
-biocViews:  Software, Pathways, GO, KEGG, GeneSetEnrichment, ImmunoOncology,
+biocViews: Software, Pathways, GO, KEGG, GeneSetEnrichment, ImmunoOncology,
     ReproducibleResearch, Transcriptomics, SingleCell
 Config/testthat/edition: 3

From 7d1d8ecfe08ac4634d0918987704c372830724b8 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Fri, 10 Apr 2026 16:47:02 +0200
Subject: [PATCH 21/92] initial implementation of EMMA_explain

---
 NAMESPACE           |  1 +
 NEWS.md             |  1 +
 R/EMMA_explain.R    | 84 +++++++++++++++++++++++++++++++++++++++++++--
 man/EMMA_explain.Rd | 16 ++++++++-
 4 files changed, 99 insertions(+), 3 deletions(-)

diff --git a/NAMESPACE b/NAMESPACE
index 012134d..2effdbe 100644
--- a/NAMESPACE
+++ b/NAMESPACE
@@ -1,5 +1,6 @@
 # Generated by roxygen2: do not edit by hand
 
+export(EMMA_explain)
 export(EMMA_freeze)
 export(EMMA_run)
 export(EMMA_show)
diff --git a/NEWS.md b/NEWS.md
index dc2d3bb..10bd428 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -9,6 +9,7 @@ result object as attribute.
 * Added `getEMMARecord()` to fetch all metadata stored in the attributes of an
 object returned by `EMMA_run()`.
 * Added toy data.
+* Added the initial implementation of `EMMA_explain`.
 
 
 # EMMA 0.0.1
diff --git a/R/EMMA_explain.R b/R/EMMA_explain.R
index b8ce103..02e3eea 100644
--- a/R/EMMA_explain.R
+++ b/R/EMMA_explain.R
@@ -5,8 +5,88 @@
 #' call, the parameters, software context, and reference databases used.
 #'
 #' @param res A functional enrichment analysis results object as returned by
-#' `EMMA_run()`. Its attributes contain `EMMA_record` of class `EMMARecord`, which
+#' `EMMA_run()`. Its attributes contain `EMMA_record`, which
 #' contains all provenance information of the performed FEA
+#' @returns A character string describing how the FEA was performed using the
+#' recorded metadata
+#' @export
+#' @examples
+#' data("de_res_IFNg_vs_naive", package = "EMMA")
+#' data("universe", package = "EMMA")
+#' library("clusterProfiler")
+#' res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+#' universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
+#' ont = "BP", pAdjustMethod = "BH"))
+#' EMMA_explain(res)
+#' 
 EMMA_explain <- function(res){
-  # code
+  
+  emma_rec <- getEMMARecord(res)
+  
+  function_name <- emma_rec$method$function_name
+  pkg_name <- emma_rec$method$package_name
+  pkg_version <- emma_rec$method$package_version
+  db <- emma_rec$annotation$gene_set_db
+  db_version <- emma_rec$annotation$gene_set_db_version
+  
+  args <- emma_rec$input$arguments
+  arg_names <- names(args)
+  
+  message("You can always grab information using `getEMMARecord()` to complete the text with any addition metadata of your choice!")
+  
+  text <- paste0("Functional Enrichment Analysis was performed using the ",
+                         function_name, "() function")
+  
+  # checks to avoid text with NA
+  if (!is.null(pkg_name) && !is.na(pkg_name)) {
+    text <- paste0(text, " from the ", pkg_name, " package")
+  }
+  
+  if (!is.null(pkg_version) && !is.na(pkg_version)) {
+    text <- paste0(text, " (version ", pkg_version, ")")
+  }
+  
+  if (!is.null(db) && !all(is.na(db))) {
+    text <- paste0(text, " with the ",
+                  paste(db, collapse = ", "), " database")
+  }
+  
+  if (!is.null(db_version) && !all(is.na(db_version))) {
+    text <- paste0(text, " (version ",
+                  paste(db_version, collapse = ", "),")")
+  }
+  
+  text <- paste0(text, ".")
+  
+  ### info abt bg genes
+  bg_arg <- intersect(c("universe", "background", "custom_bg", "bg_genes"),
+                      arg_names)
+  fdr_arg <- intersect(c("correction_method", "pAdjustMethod"), arg_names)
+  
+  if (length(bg_arg) == 1) {
+      text <- paste0(text,
+        " A custom background gene set was provided (n = ",
+        length(args[[bg_arg]]),
+        ")."
+      )
+    } else {
+      text <- paste0(text, " A custom background gene set was provided.")
+    }
+  
+  
+  ### info abt the fdr correction
+  if (length(fdr_arg) == 1) {
+    text <- paste0(text,
+      " Multiple testing correction was performed using the ",
+      args[[fdr_arg]], " method."
+    )
+  } else if ("do_padj" %in% arg_names) {
+    if (isTRUE(args[["do_padj"]])) {
+      text <- paste0(text, " Multiple testing correction was applied.")
+    } else if (identical(args[["do_padj"]], FALSE)) {
+      text <- paste0(text, " Multiple testing correction was not applied.")
+    }
+  }
+  
+  return(text)
 }
\ No newline at end of file
diff --git a/man/EMMA_explain.Rd b/man/EMMA_explain.Rd
index 76ca399..4807582 100644
--- a/man/EMMA_explain.Rd
+++ b/man/EMMA_explain.Rd
@@ -8,11 +8,25 @@ EMMA_explain(res)
 }
 \arguments{
 \item{res}{A functional enrichment analysis results object as returned by
-\code{EMMA_run()}. Its attributes contain \code{EMMA_record} of class \code{EMMARecord}, which
+\code{EMMA_run()}. Its attributes contain \code{EMMA_record}, which
 contains all provenance information of the performed FEA}
 }
+\value{
+A character string describing how the FEA was performed using the
+recorded metadata
+}
 \description{
 This function generates a human-readable description of the FEA, similar
 to a Materials and Methods section of a paper, by summarizing the executed
 call, the parameters, software context, and reference databases used.
 }
+\examples{
+data("de_res_IFNg_vs_naive", package = "EMMA")
+data("universe", package = "EMMA")
+library("clusterProfiler")
+res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
+ont = "BP", pAdjustMethod = "BH"))
+EMMA_explain(res)
+
+}

From 8644053636be94daef6d8f30e54e321858b76b72 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Fri, 10 Apr 2026 16:47:41 +0200
Subject: [PATCH 22/92] update documentation

---
 R/EMMA_show.R        | 5 +----
 R/getEMMARecord.R    | 4 ++++
 man/EMMA_show.Rd     | 3 +++
 man/getEMMARecord.Rd | 3 ++-
 4 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/R/EMMA_show.R b/R/EMMA_show.R
index 2ebae26..847e2e8 100644
--- a/R/EMMA_show.R
+++ b/R/EMMA_show.R
@@ -6,7 +6,7 @@
 #' @param res A functional enrichment analysis results object as returned by
 #' `EMMA_run()`
 #'
-#' @returns NULL
+#' @returns A summary of the executed FEA
 #' @export
 #'
 #' @examples
@@ -21,9 +21,6 @@ EMMA_show <- function(res){
   if ("EMMA_record" %in% names(attributes(res))) {
     message("Found EMMA record!!")
     emma_rec <- attr(res, "EMMA_record")
-    if (!is.list(emma_rec)) {
-      stop("'EMMA_record' must be a list!")
-    }
     
     if (is.list(res) && "result" %in% names(res)) {
       
diff --git a/R/getEMMARecord.R b/R/getEMMARecord.R
index 7f85f6f..db93aab 100644
--- a/R/getEMMARecord.R
+++ b/R/getEMMARecord.R
@@ -1,6 +1,7 @@
 #' getEMMARecord
 #'
 #' @param res Functional Enrichment Analysis results (enrichResult, gseaResult ...)
+#' generated by `EMMA_run()`
 #'
 #' @return list of metadata recorded during FEA runtime
 #' @export
@@ -14,5 +15,8 @@
 #' ont = "BP"))
 #' getEMMARecord(res)
 getEMMARecord <- function(res){
+  if(is.null(attr(res, "EMMA_record"))) {
+    stop("No EMMA record was found! Try running `EMMA_run()` first.")
+  }
   attr(res, "EMMA_record")
 }
\ No newline at end of file
diff --git a/man/EMMA_show.Rd b/man/EMMA_show.Rd
index f6e5e32..5909638 100644
--- a/man/EMMA_show.Rd
+++ b/man/EMMA_show.Rd
@@ -10,6 +10,9 @@ EMMA_show(res)
 \item{res}{A functional enrichment analysis results object as returned by
 \code{EMMA_run()}}
 }
+\value{
+A summary of the executed FEA
+}
 \description{
 This function prints the EMMA record associated with a functional enrichment
 analysis object, including the executed call, parameters, and provenance
diff --git a/man/getEMMARecord.Rd b/man/getEMMARecord.Rd
index c0f9bbe..3d55b1f 100644
--- a/man/getEMMARecord.Rd
+++ b/man/getEMMARecord.Rd
@@ -7,7 +7,8 @@
 getEMMARecord(res)
 }
 \arguments{
-\item{res}{Functional Enrichment Analysis results (enrichResult, gseaResult ...)}
+\item{res}{Functional Enrichment Analysis results (enrichResult, gseaResult ...)
+generated by \code{EMMA_run()}}
 }
 \value{
 list of metadata recorded during FEA runtime

From 2fe47a2e32273050f3acb45910b2f1f55ce902af Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Fri, 10 Apr 2026 16:48:37 +0200
Subject: [PATCH 23/92] remove the dot for all unexported functions

---
 R/EMMA_internal-utils.R | 42 ++++++++++++++++++++---------------------
 R/EMMA_run.R            |  8 ++++----
 2 files changed, 25 insertions(+), 25 deletions(-)

diff --git a/R/EMMA_internal-utils.R b/R/EMMA_internal-utils.R
index 0e3656e..a163213 100644
--- a/R/EMMA_internal-utils.R
+++ b/R/EMMA_internal-utils.R
@@ -3,7 +3,7 @@
 #' the method
 #' 
 #' @noRd
-.EMMA_empty_metadata <- function() {
+EMMA_empty_metadata <- function() {
   list(
     organism = NA_character_,
     gene_set_db = NA_character_,
@@ -21,15 +21,15 @@
 #' function call to perform FEA 
 #'
 #' @noRd
-.EMMA_get_metadata <- function(function_name,
+EMMA_get_metadata <- function(function_name,
                                package_name,
                                args) {
   switch(
     package_name,
-    clusterProfiler = .EMMA_get_clusterprofiler_metadata(function_name, args),
-    gprofiler2      = .EMMA_get_gprofiler2_metadata(args),
-    mosdef          = .EMMA_cp_GO_metadata(args$mapping),
-    .EMMA_empty_metadata()
+    clusterProfiler = EMMA_get_clusterprofiler_metadata(function_name, args),
+    gprofiler2      = EMMA_get_gprofiler2_metadata(args),
+    mosdef          = EMMA_cp_GO_metadata(args$mapping),
+    EMMA_empty_metadata()
   )
 }
 
@@ -41,15 +41,15 @@
 #' function call to perform FEA 
 #'
 #' @noRd
-.EMMA_get_clusterprofiler_metadata <- function(function_name, args) {
+EMMA_get_clusterprofiler_metadata <- function(function_name, args) {
   switch(
     function_name,
-    enrichGO   = .EMMA_cp_GO_metadata(args$OrgDb),
-    gseGO = .EMMA_cp_GO_metadata(args$OrgDb),
-    groupGO = .EMMA_cp_GO_metadata(args$OrgDb),
-    enrichKEGG = .EMMA_cp_KEGG_metadata(args),
-    gseKEGG = .EMMA_cp_KEGG_metadata(args),
-    .EMMA_empty_metadata()
+    enrichGO   = EMMA_cp_GO_metadata(args$OrgDb),
+    gseGO = EMMA_cp_GO_metadata(args$OrgDb),
+    groupGO = EMMA_cp_GO_metadata(args$OrgDb),
+    enrichKEGG = EMMA_cp_KEGG_metadata(args),
+    gseKEGG = EMMA_cp_KEGG_metadata(args),
+    EMMA_empty_metadata()
   )
 }
 
@@ -57,7 +57,7 @@
 #' @param orgdb Organism object from org.*.eg.db packages
 #'
 #' @noRd
-.EMMA_get_organism_from_OrgDb <- function(orgdb) {
+EMMA_get_organism_from_OrgDb <- function(orgdb) {
   
   if (is.null(orgdb)) {
     return(NA_character_)
@@ -87,10 +87,10 @@
 #' @param org 
 #'
 #' @noRd
-.EMMA_cp_GO_metadata <- function(org) {
+EMMA_cp_GO_metadata <- function(org) {
   meta <- list()
   
-  meta$organism <- .EMMA_get_organism_from_OrgDb(org)
+  meta$organism <- EMMA_get_organism_from_OrgDb(org)
   meta$gene_set_db <- "GO"
   meta$gene_set_db_version <- if (requireNamespace("GO.db", quietly = TRUE)) {
     as.character(utils::packageVersion("GO.db"))
@@ -110,7 +110,7 @@
 #' function call to perform FEA 
 #'
 #' @noRd
-.EMMA_cp_KEGG_metadata <- function(args) {
+EMMA_cp_KEGG_metadata <- function(args) {
   meta <- list()
   
   meta$organism <- args$organism
@@ -126,7 +126,7 @@
 #' function call to perform FEA 
 #'
 #' @noRd
-.EMMA_get_gprofiler2_metadata <- function(args) {
+EMMA_get_gprofiler2_metadata <- function(args) {
   meta <- list()
   
   version_info <- gprofiler2::get_version_info()
@@ -160,7 +160,7 @@
 
 # call capture ---------------------
 #' @noRd
-.EMMA_capture_call_info <- function(call, envir = parent.frame()) {
+EMMA_capture_call_info <- function(call, envir = parent.frame()) {
   
   # param checks
   if (!is.call(call)) {
@@ -220,7 +220,7 @@
 
 # build EMMA_record -----------
 #' @noRd
-.EMMA_build_record <- function(call, function_name, package_name,
+EMMA_build_record <- function(call, function_name, package_name,
                                package_version, args, arg_list, 
                                args_form, metadata,
                                start_time,session) {
@@ -251,7 +251,7 @@
 
 # good practice warnings ---------
 #' @noRd
-.EMMA_warnings <- function(arg_names, function_name){
+EMMA_warnings <- function(arg_names, function_name){
   checks <- list(
     list(
       params = c("pAdjustMethod", "correction_method", "do_padj"),
diff --git a/R/EMMA_run.R b/R/EMMA_run.R
index 60e997f..4a24db3 100644
--- a/R/EMMA_run.R
+++ b/R/EMMA_run.R
@@ -36,7 +36,7 @@ EMMA_run <- function(expr, envir = parent.frame(), session = TRUE,
   }
   
   # capture call information
-  info_call <- .EMMA_capture_call_info(call = call)
+  info_call <- EMMA_capture_call_info(call = call)
   function_name <- info_call$function_name
   package_name <- info_call$package_name
   package_version <- info_call$package_version
@@ -47,7 +47,7 @@ EMMA_run <- function(expr, envir = parent.frame(), session = TRUE,
   
   # some good practice warning, i.e. when multiple testing correction is skipped
   # or bg geneset not set
-  .EMMA_warnings(arg_names = arg_names,
+  EMMA_warnings(arg_names = arg_names,
                        function_name = function_name)
   
   #capture analysis time
@@ -64,14 +64,14 @@ EMMA_run <- function(expr, envir = parent.frame(), session = TRUE,
   results <- do.call(fun, args)
   
   # capture metadata from the used function and arguments
-  metadata <- .EMMA_get_metadata(
+  metadata <- EMMA_get_metadata(
     function_name = function_name,
     package_name = package_name,
     args = args
   )
   
   # record everything in EMMA_record
-  EMMA_record <- .EMMA_build_record(call, function_name, package_name,
+  EMMA_record <- EMMA_build_record(call, function_name, package_name,
                                     package_version, args,
                                     arg_list, args_form, metadata,
                                     start_time, session)

From 7ed84e577c6e0d531f0695572baec0704995a970 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Fri, 10 Apr 2026 16:49:04 +0200
Subject: [PATCH 24/92] add more tests

---
 tests/testthat/setuptests_EMMA.R |  3 +++
 tests/testthat/test-EMMA.R       | 40 ++++++++++++++------------------
 tests/testthat/test-EMMA_show.R  | 14 +++++++++++
 3 files changed, 35 insertions(+), 22 deletions(-)
 create mode 100644 tests/testthat/test-EMMA_show.R

diff --git a/tests/testthat/setuptests_EMMA.R b/tests/testthat/setuptests_EMMA.R
index 2a9aff3..06ec1e8 100644
--- a/tests/testthat/setuptests_EMMA.R
+++ b/tests/testthat/setuptests_EMMA.R
@@ -6,6 +6,9 @@ suppressPackageStartupMessages(
   library("org.Hs.eg.db")
 )
 
+suppressPackageStartupMessages(
+  library("mosdef")
+)
 
 data("de_res_IFNg_vs_naive", package = "EMMA")
 data("universe", package = "EMMA")
diff --git a/tests/testthat/test-EMMA.R b/tests/testthat/test-EMMA.R
index a31f19d..f63af15 100644
--- a/tests/testthat/test-EMMA.R
+++ b/tests/testthat/test-EMMA.R
@@ -70,19 +70,28 @@ test_that("getEMMARecord", {
   expect_true(is.list(getEMMARecord(fea_res)))
   expect_length(getEMMARecord(fea_res), 7)
   
+  fea_no_emma <- mosdef::run_cluPro(de_genes = 
+                                      rownames(de_res_IFNg_vs_naive),
+                                    bg_genes = universe,
+                                    mapping = "org.Hs.eg.db",
+                                    keyType = "ENSEMBL",
+                                    ont = "BP",
+                                    pAdjustMethod = "BH")
+  
+  expect_error(getEMMARecord(fea_no_emma))
+  
 })
 
 
 test_that("testing the record content", {
   
-  fea_res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
-                               keyType = "ENSEMBL",
-                               OrgDb = org.Hs.eg.db,
-                               pAdjustMethod = "BH",
-                               pvalueCutoff = 0.05,
-                               qvalueCutoff = 0.1,
-                               universe = universe,
-                               readable = TRUE))
+  fea_res <- EMMA_run(mosdef::run_cluPro(de_genes = 
+                                           rownames(de_res_IFNg_vs_naive),
+                                         bg_genes = universe,
+                                         mapping = "org.Hs.eg.db",
+                                         keyType = "ENSEMBL",
+                                         ont = "BP",
+                                         pAdjustMethod = "BH"))
   
   emma_rec <- attr(fea_res, "EMMA_record")
   
@@ -102,19 +111,6 @@ test_that("testing the record content", {
 })
 
 
-test_that("EMMA_show", {
-  
-  fea_res <- enrichGO(gene = rownames(de_res_IFNg_vs_naive),
-                               keyType = "ENSEMBL",
-                               OrgDb = org.Hs.eg.db,
-                               pAdjustMethod = "BH",
-                               pvalueCutoff = 0.05,
-                               qvalueCutoff = 0.1,
-                               universe = universe,
-                               readable = TRUE)
-  
-  
-  expect_warning(EMMA_show(fea_res))
-})
+
 
 
diff --git a/tests/testthat/test-EMMA_show.R b/tests/testthat/test-EMMA_show.R
new file mode 100644
index 0000000..69608c2
--- /dev/null
+++ b/tests/testthat/test-EMMA_show.R
@@ -0,0 +1,14 @@
+test_that("EMMA_show", {
+  
+  fea_res <- enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+                      keyType = "ENSEMBL",
+                      OrgDb = org.Hs.eg.db,
+                      pAdjustMethod = "BH",
+                      pvalueCutoff = 0.05,
+                      qvalueCutoff = 0.1,
+                      universe = universe,
+                      readable = TRUE)
+  
+  
+  expect_warning(EMMA_show(fea_res))
+})
\ No newline at end of file

From 896add05dbfe844b5b4cab28f4f9d2b5e679d747 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Fri, 10 Apr 2026 16:49:14 +0200
Subject: [PATCH 25/92] update vignette

---
 vignettes/Introduction_to_EMMA.Rmd | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/vignettes/Introduction_to_EMMA.Rmd b/vignettes/Introduction_to_EMMA.Rmd
index 934bdb0..21876d3 100644
--- a/vignettes/Introduction_to_EMMA.Rmd
+++ b/vignettes/Introduction_to_EMMA.Rmd
@@ -39,7 +39,7 @@ knitr::opts_chunk$set(
   comment  = "#>",
   error    = FALSE,
   warning  = FALSE,
-  eval     = FALSE,
+  eval     = TRUE,
   message  = FALSE
 )
 ```
@@ -183,7 +183,7 @@ Both_vs_naive
 
 Now let's sort the results based on the adjusted p-value:
 
-```{r}
+```{r DEGs}
 # have a list of de results per contrast
 contrast_list <- list(IFNg_vs_naive = IFNg_vs_naive,
                       Salm_vs_naive = Salm_vs_naive,
@@ -311,14 +311,14 @@ getEMMARecord(fea_res_no_param)
 ```
 
 We can also choose whether to save the session info with the record using the 
-argument `session`, which defaults to true.
+argument `session`, which defaults to `TRUE`.
 
 `EMMA_freeze()` records the R environment during analysis runtime and generates
 a lockfile that can be used with tools such as `renv`, to facilitate
 reproducible reconstruction of the analysis environment.
 
 ```{r EMMA_freeze}
-EMMA_freeze()
+#EMMA_freeze()
 ```
 
 `EMMA_explain()` generates a human-readable description of the FEA, similar

From 04bc8f522897217057e8e317b7f7b49d55666723 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Fri, 17 Apr 2026 16:45:07 +0200
Subject: [PATCH 26/92] fixing the odd implementation of EMMA_build_record

---
 R/EMMA_internal-utils.R | 29 +++++++++++++++++++----------
 R/EMMA_run.R            | 15 +++++++--------
 2 files changed, 26 insertions(+), 18 deletions(-)

diff --git a/R/EMMA_internal-utils.R b/R/EMMA_internal-utils.R
index a163213..9d4955d 100644
--- a/R/EMMA_internal-utils.R
+++ b/R/EMMA_internal-utils.R
@@ -183,10 +183,15 @@ EMMA_capture_call_info <- function(call, envir = parent.frame()) {
       as.character(packageVersion(package_name))}
     else NA_character_
     
+    # capture args (unevaluated)
+    arg_list <- as.list(call)[-1]
+    
     return(list(
+      call = call,
       function_name = function_name,
       package_name = package_name,
-      package_version = pkg_version
+      package_version = pkg_version,
+      arg_list = arg_list
     ))
   }
   
@@ -203,10 +208,15 @@ EMMA_capture_call_info <- function(call, envir = parent.frame()) {
       NA_character_
     }
     
+    # capture args (unevaluated)
+    arg_list <- as.list(call)[-1]
+    
     return(list(
+      call = call,
       function_name = function_name,
       package_name = package_name,
-      package_version = pkg_version
+      package_version = pkg_version,
+      arg_list = arg_list
     ))
   }
   
@@ -220,19 +230,18 @@ EMMA_capture_call_info <- function(call, envir = parent.frame()) {
 
 # build EMMA_record -----------
 #' @noRd
-EMMA_build_record <- function(call, function_name, package_name,
-                               package_version, args, arg_list, 
-                               args_form, metadata,
+EMMA_build_record <- function(info_call, args_form, metadata,
                                start_time,session) {
   emma_rec <- list(
                    method = list(
-                     call = call,
-                     function_name = function_name,
-                     package_name = package_name,
-                     package_version = package_version
+                     call = info_call$call,
+                     function_name = info_call$function_name,
+                     package_name = info_call$package_name,
+                     package_version = info_call$package_version
                    ),
                    input = list(
-                     arguments = if (args_form == "evaluated") args else arg_list
+                     arguments = if (args_form == "evaluated") info_call$args 
+                     else info_call$arg_list
                    ),
                    annotation = list(
                      organism = metadata$organism,
diff --git a/R/EMMA_run.R b/R/EMMA_run.R
index 4a24db3..c99d4a6 100644
--- a/R/EMMA_run.R
+++ b/R/EMMA_run.R
@@ -37,12 +37,11 @@ EMMA_run <- function(expr, envir = parent.frame(), session = TRUE,
   
   # capture call information
   info_call <- EMMA_capture_call_info(call = call)
-  function_name <- info_call$function_name
-  package_name <- info_call$package_name
-  package_version <- info_call$package_version
+   function_name <- info_call$function_name
+   package_name <- info_call$package_name
 
   # capture args (unevaluated)
-  arg_list <- as.list(call)[-1]
+  arg_list <- info_call$arg_list
   arg_names <- names(arg_list)
   
   # some good practice warning, i.e. when multiple testing correction is skipped
@@ -56,6 +55,8 @@ EMMA_run <- function(expr, envir = parent.frame(), session = TRUE,
   
   # capture the value of the arguments
   args <- lapply(arg_list, eval, envir = envir)
+  info_call$args <- args 
+  
   
   # get the function
   fun <- eval(call[[1]], envir = envir)
@@ -71,10 +72,8 @@ EMMA_run <- function(expr, envir = parent.frame(), session = TRUE,
   )
   
   # record everything in EMMA_record
-  EMMA_record <- EMMA_build_record(call, function_name, package_name,
-                                    package_version, args,
-                                    arg_list, args_form, metadata,
-                                    start_time, session)
+  EMMA_record <- EMMA_build_record(info_call, args_form, metadata,
+                                   start_time, session)
     
   # store the EMMA_record as attribute of the results obj
   attr(results, "EMMA_record") <- EMMA_record

From 77234d267867fa74f64ab33de00cd153fa913c67 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Fri, 17 Apr 2026 17:51:32 +0200
Subject: [PATCH 27/92] updating documentation

---
 R/EMMA_internal-utils.R | 68 ++++++++++++++++++++++++++++++-----------
 R/EMMA_run.R            | 23 ++++++++------
 R/EMMA_show.R           |  9 +++---
 man/EMMA_run.Rd         | 23 ++++++++------
 man/EMMA_show.Rd        |  7 ++---
 5 files changed, 85 insertions(+), 45 deletions(-)

diff --git a/R/EMMA_internal-utils.R b/R/EMMA_internal-utils.R
index 9d4955d..3ba5dc1 100644
--- a/R/EMMA_internal-utils.R
+++ b/R/EMMA_internal-utils.R
@@ -120,10 +120,12 @@ EMMA_cp_KEGG_metadata <- function(args) {
   return(meta)
 }
 
-#' assemble metadata element from gprofiler2
+#' This function assembles annotation metadata from a `gprofiler2` enrichment call
 #' 
 #' @param args A list containing the evaluated arguments passed into the
-#' function call to perform FEA 
+#' function call to perform FEA
+#' 
+#' @return A named list 
 #'
 #' @noRd
 EMMA_get_gprofiler2_metadata <- function(args) {
@@ -158,34 +160,39 @@ EMMA_get_gprofiler2_metadata <- function(args) {
   return(meta)
 }
 
-# call capture ---------------------
+# call capture -----------------------------------------------------------------
+
+#' EMMA_capture_call_info
+#' 
+#' This function extracts call related metadata. It handles two call
+#' formats: bare function calls (e.g. `enrichGO(...)`) and namespace-qualified
+#' calls (e.g. `clusterProfiler::enrichGO(...)`).
+#'
+#' @param call A call object
+#' @param envir The environment in which to look up the function when a bare
+#' call is used. Defaults to `base::parent.frame()`.
+#'
+#' @return A named list
 #' @noRd
 EMMA_capture_call_info <- function(call, envir = parent.frame()) {
-  
   # param checks
   if (!is.call(call)) {
     stop("`call` must be a function call", call. = FALSE)
   }
-  
   # capture function name
   call_name <- call[[1]]
-  
   # when we only use function name e.g. enrichGO(...)
   if (is.symbol(call_name)) {
     function_name <- as.character(call_name)
-    
     fun <- get(function_name, envir = envir, mode = "function")
-    
     pkg <- utils::packageName(environment(fun))
     package_name <- if (is.null(pkg) || pkg == "" ) NA_character_ else pkg
-
     pkg_version <- if (!is.na(package_name)) {
       as.character(packageVersion(package_name))}
     else NA_character_
-    
     # capture args (unevaluated)
     arg_list <- as.list(call)[-1]
-    
+
     return(list(
       call = call,
       function_name = function_name,
@@ -199,7 +206,6 @@ EMMA_capture_call_info <- function(call, envir = parent.frame()) {
   if (is.call(call_name) &&
       length(call_name) == 3L &&
       identical(call_name[[1]], as.symbol("::"))) {
-    
     package_name <- as.character(call_name[[2]])
     function_name <- as.character(call_name[[3]])
     pkg_version <- if (!is.na(package_name)) {
@@ -207,7 +213,6 @@ EMMA_capture_call_info <- function(call, envir = parent.frame()) {
     } else {
       NA_character_
     }
-    
     # capture args (unevaluated)
     arg_list <- as.list(call)[-1]
     
@@ -222,16 +227,30 @@ EMMA_capture_call_info <- function(call, envir = parent.frame()) {
   
   stop(
     "Unsupported call format. Use a direct function call like `enrichGO(...)` or `pkg::fun(...)`",
-    call. = FALSE
-  )
+    call. = FALSE)
 }
 
 
+# build EMMA record ------------------------------------------------------------
 
-# build EMMA_record -----------
+#' EMMA_build_record
+#' 
+#' This function assembles the structured provenance record that is stored as
+#' an attribute on the FEA results object.
+#' 
+#' @param info_call A list returned by `EMMA_capture_call_info()`
+#' @param args_form A character string, either `"evaluated"` or `"unevaluated"`
+#' to decide how to store the arguments
+#' @param metadata A list returned by `EMMA_get_metadata()`
+#' @param start_time A timestamp marking when the enrichment analysis started
+#' @param session Logical. If `TRUE`, `sessionInfo()` is captured and stored in
+#' the record; if `FALSE` the `session_info` slot is `NULL`
+#'  
+#' @return A named list of the recorded metadata
+#'   
 #' @noRd
 EMMA_build_record <- function(info_call, args_form, metadata,
-                               start_time,session) {
+                               start_time, session) {
   emma_rec <- list(
                    method = list(
                      call = info_call$call,
@@ -258,7 +277,20 @@ EMMA_build_record <- function(info_call, args_form, metadata,
   
 }
 
-# good practice warnings ---------
+# good practice warnings -------------------------------------------------------
+
+#' EMMA_warnings
+#' 
+#' This function warns about missing good-practice arguments in enrichment calls.
+#' A warning is raised if none of the synonyms for a given category appear
+#' in `arg_names`
+#' 
+#' @param arg_names A character vector of argument names as written in the
+#' user's call, obtained within `EMMA_run()`
+#' @param function_name A character corresponding to the name of the enrichment
+#' function called, used only for constructing the warning message
+#' 
+#' @return `base::invisible()`
 #' @noRd
 EMMA_warnings <- function(arg_names, function_name){
   checks <- list(
diff --git a/R/EMMA_run.R b/R/EMMA_run.R
index c99d4a6..1fe9721 100644
--- a/R/EMMA_run.R
+++ b/R/EMMA_run.R
@@ -1,20 +1,25 @@
 #' EMMA_run
 #' 
-#' This function executes functional enrichment analysis using existing tools
-#' and captures the associated parameters and provenance information for the
-#' analysis when available during runtime.
+#' This function executes any supported functional enrichment analysis function
+#' and automatically captures the call, its associated parameters and provenance
+#' information when available during runtime as an `EMMA_record` attribute
+#' on the returned results object.
 #'
 #' @param expr A function call that performs functional enrichment analysis.
 #' The call is captured and executed by EMMA to record analysis parameters and
-#' provenance information
+#' provenance information. Both bare calls (`enrichGO(...)`) and namespace-qualified
+#' calls (`clusterProfiler::enrichGO(...)`) are supported. Any other form
+#' (e.g. `do.call`, `get()`) will raise an error
 #' @param envir An environment in which to evaluate `expr`
-#' @param session Logical, indicating whether to store sessionInfo or not.
-#' It defaults to (`TRUE`) saving the session
+#' @param session Logical, indicating whether to store the output of
+#' `sessionInfo()` or not. If `TRUE` (default), the session is stored in the
+#' provenance record
 #' @param args_form A character string indicating whether to store the evaluated
-#' or the unevaluated arguments. It default to store the evaluated arguments
+#' or the unevaluated arguments in the provenance record. It default to `"evaluated"`
 #'
-#' @returns Functional enrichment analysis results in the native format
-#' returned by the original `expr`
+#' @returns The result object returned by the enrichment function in `expr`,
+#'   unmodified except for an added `EMMA_record` attribute containing the
+#'   provenance information. Use `getEMMARecord()` to access it
 #' @export
 #'
 #' @examples
diff --git a/R/EMMA_show.R b/R/EMMA_show.R
index 847e2e8..a378d98 100644
--- a/R/EMMA_show.R
+++ b/R/EMMA_show.R
@@ -1,12 +1,11 @@
 #' EMMA_show
 #' 
-#' This function prints the EMMA record associated with a functional enrichment
-#' analysis object, including the executed call, parameters, and provenance
-#' information.
+#' This function displays a human-readable summary of the `EMMA_record` attribute
+#' attached to a result object produced by `EMMA_run()`
 #' @param res A functional enrichment analysis results object as returned by
 #' `EMMA_run()`
 #'
-#' @returns A summary of the executed FEA
+#' @returns Returns `base::invisible()`
 #' @export
 #'
 #' @examples
@@ -44,6 +43,6 @@ EMMA_show <- function(res){
     warning("No `EMMA_record` attribute was found")
   }
   
-  invisible(NULL)
+  invisible()
   
 }
diff --git a/man/EMMA_run.Rd b/man/EMMA_run.Rd
index f6068ae..e62720a 100644
--- a/man/EMMA_run.Rd
+++ b/man/EMMA_run.Rd
@@ -14,24 +14,29 @@ EMMA_run(
 \arguments{
 \item{expr}{A function call that performs functional enrichment analysis.
 The call is captured and executed by EMMA to record analysis parameters and
-provenance information}
+provenance information. Both bare calls (\code{enrichGO(...)}) and namespace-qualified
+calls (\code{clusterProfiler::enrichGO(...)}) are supported. Any other form
+(e.g. \code{do.call}, \code{get()}) will raise an error}
 
 \item{envir}{An environment in which to evaluate \code{expr}}
 
-\item{session}{Logical, indicating whether to store sessionInfo or not.
-It defaults to (\code{TRUE}) saving the session}
+\item{session}{Logical, indicating whether to store the output of
+\code{sessionInfo()} or not. If \code{TRUE} (default), the session is stored in the
+provenance record}
 
 \item{args_form}{A character string indicating whether to store the evaluated
-or the unevaluated arguments. It default to store the evaluated arguments}
+or the unevaluated arguments in the provenance record. It default to \code{"evaluated"}}
 }
 \value{
-Functional enrichment analysis results in the native format
-returned by the original \code{expr}
+The result object returned by the enrichment function in \code{expr},
+unmodified except for an added \code{EMMA_record} attribute containing the
+provenance information. Use \code{getEMMARecord()} to access it
 }
 \description{
-This function executes functional enrichment analysis using existing tools
-and captures the associated parameters and provenance information for the
-analysis when available during runtime.
+This function executes any supported functional enrichment analysis function
+and automatically captures the call, its associated parameters and provenance
+information when available during runtime as an \code{EMMA_record} attribute
+on the returned results object.
 }
 \examples{
 data("de_res_IFNg_vs_naive", package = "EMMA")
diff --git a/man/EMMA_show.Rd b/man/EMMA_show.Rd
index 5909638..026f466 100644
--- a/man/EMMA_show.Rd
+++ b/man/EMMA_show.Rd
@@ -11,12 +11,11 @@ EMMA_show(res)
 \code{EMMA_run()}}
 }
 \value{
-A summary of the executed FEA
+Returns \code{base::invisible()}
 }
 \description{
-This function prints the EMMA record associated with a functional enrichment
-analysis object, including the executed call, parameters, and provenance
-information.
+This function displays a human-readable summary of the \code{EMMA_record} attribute
+attached to a result object produced by \code{EMMA_run()}
 }
 \examples{
 data("de_res_IFNg_vs_naive", package = "EMMA")

From 3e9441fca0f7dcc184335e1911935df85d4de922 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 27 Apr 2026 18:12:02 +0200
Subject: [PATCH 28/92] add code to EMMA_explain

---
 R/EMMA_explain.R | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/R/EMMA_explain.R b/R/EMMA_explain.R
index 02e3eea..e915f93 100644
--- a/R/EMMA_explain.R
+++ b/R/EMMA_explain.R
@@ -32,10 +32,15 @@ EMMA_explain <- function(res){
   args <- emma_rec$input$arguments
   arg_names <- names(args)
   
-  message("You can always grab information using `getEMMARecord()` to complete the text with any addition metadata of your choice!")
+  message("You can always complete your text with additional information from `getEMMARecord()`!")
   
-  text <- paste0("Functional Enrichment Analysis was performed using the ",
-                         function_name, "() function")
+  if (emma_rec$method$wrapper) {
+    text <- paste0("Functional Enrichment Analysis was performed using a wrapper function ",
+                   function_name, "()")
+  } else {
+    text <- paste0("Functional Enrichment Analysis was performed using the ",
+                   function_name, "() function")
+  }
   
   # checks to avoid text with NA
   if (!is.null(pkg_name) && !is.na(pkg_name)) {
@@ -69,9 +74,11 @@ EMMA_explain <- function(res){
         length(args[[bg_arg]]),
         ")."
       )
-    } else {
-      text <- paste0(text, " A custom background gene set was provided.")
-    }
+  } else if (length(bg_arg) > 1L) {
+    text <- paste0(text, " A custom background gene set was provided.")
+  } else {
+    text <- paste0(text, " No custom background gene set was recorded.")
+  }
   
   
   ### info abt the fdr correction

From 1ad7ee3f34a5d3b546c1a6dc4da19db2b7fecdbc Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 27 Apr 2026 18:12:28 +0200
Subject: [PATCH 29/92] update pkg version

---
 DESCRIPTION | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/DESCRIPTION b/DESCRIPTION
index 3429ecf..a00d977 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -1,7 +1,7 @@
 Package: EMMA
 Title: EMMA: Enrichment Methods Matter for enabeling fully reproducible and 
     provenance-aware pathway analysis
-Version: 0.1.0
+Version: 0.2.0
 Authors@R: 
     c(
         person(
@@ -42,6 +42,7 @@ Suggests:
     gprofiler2,
     org.Hs.eg.db,
     mosdef,
+    topGO,
     testthat (>= 3.0.0)
 VignetteBuilder: knitr
 URL: https://github.com/imbeimainz/EMMA

From 9ec20d8ad0f0e4a2c9177221dbcdfa880051e371 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 27 Apr 2026 18:12:35 +0200
Subject: [PATCH 30/92] add news

---
 NEWS.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/NEWS.md b/NEWS.md
index 10bd428..2fffc1d 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -1,3 +1,12 @@
+# EMMA 0.2.0
+
+* `EMMA_run()` can accept custom functions and wrappers and collect metadata
+based on which function was used in the wrapper.
+* Added `EMMA_add_custom_metadata()` to give the user manual/easy access to modify
+`user_metdata` field in `EMMA_record`.
+* Added a fully runnable vignette.
+
+
 # EMMA 0.1.0
 
 * `EMMA_run()` captures a function call, executes the FEA analysis, and returns

From 5cf683c9fce9c7afe18427c20d5b3d26102d60dc Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 27 Apr 2026 18:13:41 +0200
Subject: [PATCH 31/92] update readme

---
 README.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 55e4485..913b805 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,9 @@
 # EMMA
 
-EMMA aims to explicitly capture analytical parameters during functional
-enrichment analysis runtime, while returning native enrichment results together
-with structured metadata.
+EMMA enables the execution of Functional Enrichment Analyses using existing
+tools (e.g. `clusterProfiler`, `topGO`, `gprofiler2`) while systematically capturing
+analysis parameters and provenance information during runtime, and returning
+enrichment results in their standard format alongside structured and reusable metadata.
 
 ## Installation
 

From f8dd505c4d531cda360b511c696fb98adea604d8 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 27 Apr 2026 18:14:04 +0200
Subject: [PATCH 32/92] update EMMA_show

---
 R/EMMA_show.R | 25 ++++++++++++++++++++-----
 1 file changed, 20 insertions(+), 5 deletions(-)

diff --git a/R/EMMA_show.R b/R/EMMA_show.R
index a378d98..5bfaca0 100644
--- a/R/EMMA_show.R
+++ b/R/EMMA_show.R
@@ -2,10 +2,11 @@
 #' 
 #' This function displays a human-readable summary of the `EMMA_record` attribute
 #' attached to a result object produced by `EMMA_run()`
+#' 
 #' @param res A functional enrichment analysis results object as returned by
 #' `EMMA_run()`
 #'
-#' @returns Returns `base::invisible()`
+#' @returns `base::invisible()`
 #' @export
 #'
 #' @examples
@@ -17,13 +18,26 @@
 #' ont = "BP"))
 #' EMMA_show(res)
 EMMA_show <- function(res){
+  
   if ("EMMA_record" %in% names(attributes(res))) {
-    message("Found EMMA record!!")
-    emma_rec <- attr(res, "EMMA_record")
+    message("Found EMMA record!")
     
-    if (is.list(res) && "result" %in% names(res)) {
+    emma_rec <- getEMMARecord(res)
+    
+    if (is.list(res) && !is.data.frame(res)) {
+      # let's say if we have of list of FEAs (returned by custom function)
+      cat("Number of FEAs: ", length(res), "\n")
+      
+      nms <- names(res)
+      if (is.null(nms) || any(nms == "")) {
+        nms <- paste0("FEA_", seq_along(res))
+      }
+        
+      for (i in seq_along(res)) {
+        # check the number of pathways for each element of the list
+        cat(" -", nms[i], ": ", NROW(res[[i]]), " pathways\n")
+      }
       
-      cat("Number of Pathways: ", NROW(res$result), "\n")
     } else {
       cat("Number of Pathways: ", NROW(res), "\n")
     }
@@ -32,6 +46,7 @@ EMMA_show <- function(res){
     db_info <- emma_rec$annotation
     
     cat("Call: ", paste(deparse(method_info$call), collapse = " "), " \n")
+    cat("Wrapper: ", method_info$wrapper, " \n")
     cat("Package: ", paste(method_info$package_name , "v.",
                            method_info$package_version), " \n")
     cat("Organism : ", db_info$organism, " \n")

From b7ab70309140e3fb3d63455796071dceab6a534b Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 27 Apr 2026 18:14:26 +0200
Subject: [PATCH 33/92] update getEMMARecord

---
 R/getEMMARecord.R | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/R/getEMMARecord.R b/R/getEMMARecord.R
index db93aab..f982bed 100644
--- a/R/getEMMARecord.R
+++ b/R/getEMMARecord.R
@@ -15,8 +15,16 @@
 #' ont = "BP"))
 #' getEMMARecord(res)
 getEMMARecord <- function(res){
-  if(is.null(attr(res, "EMMA_record"))) {
-    stop("No EMMA record was found! Try running `EMMA_run()` first.")
+  
+  rec <- attr(res, "EMMA_record")
+  
+  if (is.null(rec)) {
+    stop("No `EMMA_record` was found. Try running `EMMA_run()` first.")
   }
+  
+  if (!is.list(rec)) {
+    stop("Invalid structure. `EMMA_record` must be a `list`")
+  }
+  
   attr(res, "EMMA_record")
 }
\ No newline at end of file

From 98d21308491a21a38dbb2222c72ccccba88f0263 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 27 Apr 2026 18:15:26 +0200
Subject: [PATCH 34/92] add EMMA_add_custom_metadata to give the user
 possibility to modify the content of extra in EMMA_record

---
 R/EMMA_add_custom_metadata.R | 44 ++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 R/EMMA_add_custom_metadata.R

diff --git a/R/EMMA_add_custom_metadata.R b/R/EMMA_add_custom_metadata.R
new file mode 100644
index 0000000..3a854a9
--- /dev/null
+++ b/R/EMMA_add_custom_metadata.R
@@ -0,0 +1,44 @@
+#' EMMA_add_custom_metadata
+#' 
+#' Append or replace the `extra` field in the `EMMA_record` attribute
+#' of a result object returned by `EMMA_run()`. This allows users to manually
+#' provide additional annotation or contextual information that could not be
+#' captured automatically
+#'
+#' @param res A functional enrichment analysis results object as returned by
+#' `EMMA_run()`
+#' @param extra A named list of user-defined metadata elements to store in
+#' the `extra` field
+#'
+#' @returns The input result object with updated `EMMA_record` attribute
+#' @export
+#'
+#' @examples
+#' data("de_res_IFNg_vs_naive", package = "EMMA")
+#' data("universe", package = "EMMA")
+#' library("clusterProfiler")
+#' res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+#' universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
+#' ont = "BP"))
+#' res <- EMMA_add_custom_metadata(res, extra =
+#' list(note = "The background gene set list was all expressed genes in the assay"))
+EMMA_add_custom_metadata <- function(res,
+                                     extra = list()) {
+  
+  if (!is.list(extra)) {
+    stop("`extra` must be a list!")
+  }
+  
+  if (length(extra) > 0L && is.null(names(extra))) {
+    stop("`extra` must be a named list!")
+  }
+  
+  emma_rec <- getEMMARecord(res = res)
+  
+  emma_rec$extra <- extra
+  
+  # update
+  attr(res, "EMMA_record") <- emma_rec
+  
+  return(res)
+}
\ No newline at end of file

From 136d4d6b90933ace8d2e895789c5d391d20f1ad3 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 27 Apr 2026 18:15:55 +0200
Subject: [PATCH 35/92] update man

---
 man/EMMA_add_custom_metadata.Rd | 34 +++++++++++++++++++++++++++++++++
 man/EMMA_run.Rd                 | 26 +++++++++++++++----------
 man/EMMA_show.Rd                |  2 +-
 3 files changed, 51 insertions(+), 11 deletions(-)
 create mode 100644 man/EMMA_add_custom_metadata.Rd

diff --git a/man/EMMA_add_custom_metadata.Rd b/man/EMMA_add_custom_metadata.Rd
new file mode 100644
index 0000000..c3849f5
--- /dev/null
+++ b/man/EMMA_add_custom_metadata.Rd
@@ -0,0 +1,34 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/EMMA_add_custom_metadata.R
+\name{EMMA_add_custom_metadata}
+\alias{EMMA_add_custom_metadata}
+\title{EMMA_add_custom_metadata}
+\usage{
+EMMA_add_custom_metadata(res, extra = list())
+}
+\arguments{
+\item{res}{A functional enrichment analysis results object as returned by
+\code{EMMA_run()}}
+
+\item{extra}{A named list of user-defined metadata elements to store in
+the \code{extra} field}
+}
+\value{
+The input result object with updated \code{EMMA_record} attribute
+}
+\description{
+Append or replace the \code{extra} field in the \code{EMMA_record} attribute
+of a result object returned by \code{EMMA_run()}. This allows users to manually
+provide additional annotation or contextual information that could not be
+captured automatically
+}
+\examples{
+data("de_res_IFNg_vs_naive", package = "EMMA")
+data("universe", package = "EMMA")
+library("clusterProfiler")
+res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
+ont = "BP"))
+res <- EMMA_add_custom_metadata(res, extra =
+list(note = "The background gene set list was all expressed genes in the assay"))
+}
diff --git a/man/EMMA_run.Rd b/man/EMMA_run.Rd
index e62720a..caed5d4 100644
--- a/man/EMMA_run.Rd
+++ b/man/EMMA_run.Rd
@@ -14,9 +14,8 @@ EMMA_run(
 \arguments{
 \item{expr}{A function call that performs functional enrichment analysis.
 The call is captured and executed by EMMA to record analysis parameters and
-provenance information. Both bare calls (\code{enrichGO(...)}) and namespace-qualified
-calls (\code{clusterProfiler::enrichGO(...)}) are supported. Any other form
-(e.g. \code{do.call}, \code{get()}) will raise an error}
+provenance information. Both bare calls (\code{enrichGO(...)}) and
+namespace-qualified calls (\code{clusterProfiler::enrichGO(...)}) are supported.}
 
 \item{envir}{An environment in which to evaluate \code{expr}}
 
@@ -25,18 +24,25 @@ calls (\code{clusterProfiler::enrichGO(...)}) are supported. Any other form
 provenance record}
 
 \item{args_form}{A character string indicating whether to store the evaluated
-or the unevaluated arguments in the provenance record. It default to \code{"evaluated"}}
+or the unevaluated arguments in the provenance record. It default to
+\code{"evaluated"}}
 }
 \value{
 The result object returned by the enrichment function in \code{expr},
-unmodified except for an added \code{EMMA_record} attribute containing the
-provenance information. Use \code{getEMMARecord()} to access it
+in standard format, with an additional \code{EMMA_record} attribute containing the
+provenance information. Use \code{getEMMARecord()} to retrieve this record
 }
 \description{
-This function executes any supported functional enrichment analysis function
-and automatically captures the call, its associated parameters and provenance
-information when available during runtime as an \code{EMMA_record} attribute
-on the returned results object.
+This function executes any functional enrichment analysis function and
+attaches a provenance record (\code{EMMA_record}) describing the analysis. The
+captured record includes the original call, metadata derived from the call
+and its arguments, runtime information, and optionally the current session
+information.
+}
+\details{
+\code{EMMA_run()} accepts both direct calls to known enrichment functions
+(\code{enrichGO()}, \code{GSEA()}, \code{fgsea()} ...) and calls to wrapper functions that
+internally invoke a know enrichment function.
 }
 \examples{
 data("de_res_IFNg_vs_naive", package = "EMMA")
diff --git a/man/EMMA_show.Rd b/man/EMMA_show.Rd
index 026f466..8207750 100644
--- a/man/EMMA_show.Rd
+++ b/man/EMMA_show.Rd
@@ -11,7 +11,7 @@ EMMA_show(res)
 \code{EMMA_run()}}
 }
 \value{
-Returns \code{base::invisible()}
+\code{base::invisible()}
 }
 \description{
 This function displays a human-readable summary of the \code{EMMA_record} attribute

From 0ff0442dc0fa2e5d023520c5b514646e46358358 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 27 Apr 2026 18:16:09 +0200
Subject: [PATCH 36/92] update namespace

---
 NAMESPACE | 1 +
 1 file changed, 1 insertion(+)

diff --git a/NAMESPACE b/NAMESPACE
index 2effdbe..8893a13 100644
--- a/NAMESPACE
+++ b/NAMESPACE
@@ -1,5 +1,6 @@
 # Generated by roxygen2: do not edit by hand
 
+export(EMMA_add_custom_metadata)
 export(EMMA_explain)
 export(EMMA_freeze)
 export(EMMA_run)

From 075eb80f5c811c9fc96f8ae3e81944512202c6e7 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 27 Apr 2026 18:16:36 +0200
Subject: [PATCH 37/92] adding tests

---
 tests/testthat/setuptests_EMMA.R              |  16 +--
 tests/testthat/test-EMMA_explain.R            |  57 ++++++++++
 tests/testthat/test-EMMA_metadata.R           | 105 ++++++++++++++++++
 .../testthat/{test-EMMA.R => test-EMMA_run.R} |  78 ++++---------
 tests/testthat/test-EMMA_show.R               |  63 +++++++++--
 tests/testthat/test-getEMMArecord.R           |  28 +++++
 6 files changed, 271 insertions(+), 76 deletions(-)
 create mode 100644 tests/testthat/test-EMMA_explain.R
 create mode 100644 tests/testthat/test-EMMA_metadata.R
 rename tests/testthat/{test-EMMA.R => test-EMMA_run.R} (56%)
 create mode 100644 tests/testthat/test-getEMMArecord.R

diff --git a/tests/testthat/setuptests_EMMA.R b/tests/testthat/setuptests_EMMA.R
index 06ec1e8..e73a0fe 100644
--- a/tests/testthat/setuptests_EMMA.R
+++ b/tests/testthat/setuptests_EMMA.R
@@ -1,14 +1,8 @@
-suppressPackageStartupMessages(
-  library("clusterProfiler")
-)
-
-suppressPackageStartupMessages(
-  library("org.Hs.eg.db")
-)
-
-suppressPackageStartupMessages(
-  library("mosdef")
-)
+invisible(lapply(
+  c("clusterProfiler", "org.Hs.eg.db", "mosdef", "topGO", "gprofiler2"),
+  function(pkg) suppressPackageStartupMessages(
+    library(pkg, character.only = TRUE))
+))
 
 data("de_res_IFNg_vs_naive", package = "EMMA")
 data("universe", package = "EMMA")
diff --git a/tests/testthat/test-EMMA_explain.R b/tests/testthat/test-EMMA_explain.R
new file mode 100644
index 0000000..114b182
--- /dev/null
+++ b/tests/testthat/test-EMMA_explain.R
@@ -0,0 +1,57 @@
+test_that("EMMA_explain", {
+  res <- data.frame(ID = "GO:0000001")
+  
+  attr(res, "EMMA_record") <- list(
+    method = list(
+      function_name = "enrichGO",
+      package_name = "clusterProfiler",
+      package_version = "4.10.0",
+      wrapper = FALSE
+    ),
+    input = list(
+      arguments = list(
+        gene = c("g1", "g2"),
+        universe = c("g1", "g2", "g3", "g4"),
+        pAdjustMethod = "BH"
+      )
+    ),
+    annotation = list(
+      gene_set_db = "GO",
+      gene_set_db_version = "3.18.0"
+    )
+  )
+  
+  expect_message(
+    txt <- EMMA_explain(res),
+    "You can always complete your text"
+  )
+  
+  expect_match(txt, "Functional Enrichment Analysis was performed using the enrichGO\\(\\) function")
+  expect_match(txt, "from the clusterProfiler package")
+  expect_match(txt, "with the GO database")
+  expect_match(txt, "A custom background gene set was provided \\(n = 4\\)")
+  expect_match(txt, "Multiple testing correction was performed using the BH method")
+  expect_false(grepl("NA", txt))
+  
+  de_res <- de_res_IFNg_vs_naive[!(is.na(de_res_IFNg_vs_naive$padj)) & de_res_IFNg_vs_naive$padj <= 0.05, ]
+  
+  
+  res_topGO <- run_topGO(de_genes = rownames(de_res),
+                         bg_genes = universe,
+                         ontology = "BP",
+                         gene_id = "ENSEMBL",
+                         mapping = "org.Hs.eg.db",
+                         add_gene_to_terms = TRUE,
+                         do_padj = TRUE) |> EMMA_run()
+  
+  expect_message(
+    txt <- EMMA_explain(res_topGO),
+    "You can always complete your text"
+  )
+  
+  expect_match(txt,
+               "Functional Enrichment Analysis was performed using a wrapper function run_topGO\\(\\)")
+  
+  expect_match(txt,"Multiple testing correction was applied")
+  
+})
diff --git a/tests/testthat/test-EMMA_metadata.R b/tests/testthat/test-EMMA_metadata.R
new file mode 100644
index 0000000..f59e0d4
--- /dev/null
+++ b/tests/testthat/test-EMMA_metadata.R
@@ -0,0 +1,105 @@
+test_that("test metadata content & structure", {
+  
+  fea_res <- EMMA_run(mosdef::run_cluPro(de_genes = 
+                                           rownames(de_res_IFNg_vs_naive),
+                                         bg_genes = universe,
+                                         mapping = "org.Hs.eg.db",
+                                         keyType = "ENSEMBL",
+                                         ont = "BP",
+                                         pAdjustMethod = "BH"))
+  
+  emma_rec <- attr(fea_res, "EMMA_record")
+  
+  org <- emma_rec$annotation$organism
+  
+  db <- emma_rec$annotation$gene_set_db
+  
+  expect_true(is.list(emma_rec$annotation))
+  expect_true(is.list(emma_rec$method))
+  expect_true(is.list(emma_rec$input))
+  
+  expect_identical(org, "Homo sapiens")
+  expect_identical(db, "GO")
+  
+  expect_true(emma_rec$method$wrapper)
+  
+  expect_null(EMMA_find_original_wrapped_fun("mosdef::run_cluPro(de_genes = rownames(de_res_IFNg_vs_naive),
+                                                                bg_genes = universe,
+                                                                mapping = 'org.Hs.eg.db',
+                                                                keyType = 'ENSEMBL',
+                                                                ont = 'BP')"))
+  
+  
+  custom <- EMMA_classify_call(substitute(summary(getEMMARecord(fea_res))))
+  
+  expect_equal(custom$type, "custom")
+  
+  
+  expect_warning(res <- EMMA_run(mosdef::run_goseq(de_genes = rownames(de_res_IFNg_vs_naive),
+                                   bg_genes = universe,
+                                   mapping = "org.Hs.eg.db",
+                                   id = "ensGene",
+                                   genome = "hg19")))
+  
+  
+  res <- EMMA_add_custom_metadata(res,
+                                  extra = list(
+                                    note = "The background gene set list was all expressed genes in the assay"))
+  
+  rec <- getEMMARecord(res)
+  
+  expect_equal(
+    rec$extra$note,
+    "The background gene set list was all expressed genes in the assay"
+  )
+  
+  expect_null(rec$extra$notfoud)
+  
+  expect_error(res <- EMMA_add_custom_metadata(res,
+                                               extra = list("The background gene set list was all expressed genes in the assay"))
+  )
+  
+  expect_error(res <- EMMA_add_custom_metadata(res,
+                                               extra = "The background gene set list was all expressed genes in the assay"))
+  
+  
+  fea_res <- gprofiler2::gost(query = de_res_IFNg_vs_naive$SYMBOL,
+                              organism = "hsapiens",
+                              correction_method = "fdr",
+                              custom_bg = universe) |> EMMA_run()
+  
+  rec <- getEMMARecord(fea_res)
+  
+  expect_true(length(rec$annotation$gene_set_db_version) != 1)
+  
+  
+  custom_fun <- function(gene, OrgDb) {
+    clusterProfiler::groupGO(
+      gene = gene,
+      OrgDb = OrgDb,
+      keyType = "ENSEMBL",
+      ont = "BP",
+      level = 2,
+      readable = FALSE
+    ) 
+  }
+  
+  expect_warning(wrapper <- EMMA_run(custom_fun(rownames(de_res_IFNg_vs_naive),
+                                                org.Hs.eg.db)))
+
+  expect_equal(getEMMARecord(wrapper)$method$function_name, "custom_fun")
+  expect_equal(getEMMARecord(wrapper)$method$wrapped_package, "clusterProfiler")
+  expect_equal(getEMMARecord(wrapper)$method$wrapped_function, "groupGO")
+  expect_true(getEMMARecord(wrapper)$method$wrapper) 
+
+  
+  empty <- EMMA_run(summary(rec$method))
+  
+  expect_null(getEMMARecord(empty)$annotation$organism)
+  expect_null(getEMMARecord(empty)$annotation$gene_set_db)
+  expect_null(getEMMARecord(empty)$annotation$gene_set_db_version)
+  
+  
+})
+
+
diff --git a/tests/testthat/test-EMMA.R b/tests/testthat/test-EMMA_run.R
similarity index 56%
rename from tests/testthat/test-EMMA.R
rename to tests/testthat/test-EMMA_run.R
index f63af15..b6f30a7 100644
--- a/tests/testthat/test-EMMA.R
+++ b/tests/testthat/test-EMMA_run.R
@@ -16,6 +16,19 @@ test_that("EMMA_run", {
   
   expect_true(length(attr(fea_res, "EMMA_record")) == 7)
   
+  info <- EMMA_capture_call_info(substitute(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+                                                     keyType = "ENSEMBL",
+                                                     OrgDb = org.Hs.eg.db,
+                                                     pAdjustMethod = "BH",
+                                                     pvalueCutoff = 0.05,
+                                                     qvalueCutoff = 0.1,
+                                                     universe = universe,
+                                                     readable = TRUE)))
+  
+  expect_type(info, "list")
+  expect_length(info, 5)
+  expect_length(info$arg_list, 8)
+  
   expect_error(EMMA_run(enrichGO,gene = rownames(de_res_IFNg_vs_naive),
                         keyType = "ENSEMBL",
                         OrgDb = org.Hs.eg.db,
@@ -54,63 +67,18 @@ test_that("EMMA_run", {
                           pAdjustMethod = "BH",
                           readable = TRUE)))
   
-})
-
-
-test_that("getEMMARecord", {
-  fea_res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
-                               keyType = "ENSEMBL",
-                               OrgDb = org.Hs.eg.db,
-                               pAdjustMethod = "BH",
-                               pvalueCutoff = 0.05,
-                               qvalueCutoff = 0.1,
-                               universe = universe,
-                               readable = TRUE))
+  expect_error(EMMA_run(groupGO(gene = rownames(de_res_IFNg_vs_naive),
+                                OrgDb = org.Hs.eg.db,
+                                keyType = "ENSEMBL",
+                                ont = "CC",
+                                level = 2), envir = getwd()))
   
-  expect_true(is.list(getEMMARecord(fea_res)))
-  expect_length(getEMMARecord(fea_res), 7)
-  
-  fea_no_emma <- mosdef::run_cluPro(de_genes = 
-                                      rownames(de_res_IFNg_vs_naive),
-                                    bg_genes = universe,
-                                    mapping = "org.Hs.eg.db",
-                                    keyType = "ENSEMBL",
-                                    ont = "BP",
-                                    pAdjustMethod = "BH")
-  
-  expect_error(getEMMARecord(fea_no_emma))
+  expect_error(EMMA_run(groupGO(gene = rownames(de_res_IFNg_vs_naive),
+                                OrgDb = org.Hs.eg.db,
+                                keyType = "ENSEMBL",
+                                ont = "CC",
+                                level = 2), session = "yes"))
   
 })
 
 
-test_that("testing the record content", {
-  
-  fea_res <- EMMA_run(mosdef::run_cluPro(de_genes = 
-                                           rownames(de_res_IFNg_vs_naive),
-                                         bg_genes = universe,
-                                         mapping = "org.Hs.eg.db",
-                                         keyType = "ENSEMBL",
-                                         ont = "BP",
-                                         pAdjustMethod = "BH"))
-  
-  emma_rec <- attr(fea_res, "EMMA_record")
-  
-  org <- emma_rec$annotation$organism
-  
-  db <- emma_rec$annotation$gene_set_db
-  
-  expect_true(is.list(emma_rec$annotation))
-  expect_true(is.list(emma_rec$method))
-  expect_true(is.list(emma_rec$input))
-  
-  expect_identical(org, "Homo sapiens")
-  expect_identical(db, "GO")
-  
-  
-  
-})
-
-
-
-
-
diff --git a/tests/testthat/test-EMMA_show.R b/tests/testthat/test-EMMA_show.R
index 69608c2..333a0df 100644
--- a/tests/testthat/test-EMMA_show.R
+++ b/tests/testthat/test-EMMA_show.R
@@ -1,14 +1,57 @@
 test_that("EMMA_show", {
   
-  fea_res <- enrichGO(gene = rownames(de_res_IFNg_vs_naive),
-                      keyType = "ENSEMBL",
-                      OrgDb = org.Hs.eg.db,
-                      pAdjustMethod = "BH",
-                      pvalueCutoff = 0.05,
-                      qvalueCutoff = 0.1,
-                      universe = universe,
-                      readable = TRUE)
-  
+  fea_res <- data.frame(ID = "term1")
   
   expect_warning(EMMA_show(fea_res))
-})
\ No newline at end of file
+  
+  
+  res <- data.frame(ID = c("term1", "term2"))
+  
+  attr(res, "EMMA_record") <- list(
+    method = list(
+      call = substitute(fake_enrich(gene = genes)),
+      wrapper = FALSE,
+      package_name = "fakepkg",
+      package_version = "1.0.0"
+    ),
+    annotation = list(
+      organism = "Homo sapiens",
+      gene_set_db = "GO",
+      gene_set_db_version = "3.22.0"
+    )
+  )
+  
+  expect_message(
+    expect_output(
+      EMMA_show(res),
+      "Number of Pathways"
+    ),
+    "Found EMMA record"
+  )
+  
+  expect_output(EMMA_show(res), "Package")
+  expect_output(EMMA_show(res), "Organism")
+  expect_output(EMMA_show(res), "Gene set library")
+  
+  
+  fea2 <- list(fea_res,
+               res)
+  
+  attr(fea2, "EMMA_record") <- list(
+    method = list(
+      call = substitute(fake_enrich(gene = genes)),
+      wrapper = TRUE,
+      package_name = NA,
+      package_version = NA
+    ),
+    annotation = list(
+      organism = "Homo sapiens",
+      gene_set_db = "KEGG",
+      gene_set_db_version = NA
+    )
+  )
+  expect_output(EMMA_show(fea2), "Number of FEAs:  2")
+  expect_output(EMMA_show(fea2), "- FEA_1")
+  expect_output(EMMA_show(fea2),"FEA_2")
+  
+})
diff --git a/tests/testthat/test-getEMMArecord.R b/tests/testthat/test-getEMMArecord.R
new file mode 100644
index 0000000..9152707
--- /dev/null
+++ b/tests/testthat/test-getEMMArecord.R
@@ -0,0 +1,28 @@
+test_that("getEMMARecord", {
+  fea_res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+                               keyType = "ENSEMBL",
+                               OrgDb = org.Hs.eg.db,
+                               pAdjustMethod = "BH",
+                               pvalueCutoff = 0.05,
+                               qvalueCutoff = 0.1,
+                               universe = universe,
+                               readable = TRUE))
+  
+  expect_true(is.list(getEMMARecord(fea_res)))
+  expect_length(getEMMARecord(fea_res), 7)
+  
+  fea_no_emma <- mosdef::run_cluPro(de_genes = 
+                                      rownames(de_res_IFNg_vs_naive),
+                                    bg_genes = universe,
+                                    mapping = "org.Hs.eg.db",
+                                    keyType = "ENSEMBL",
+                                    ont = "BP",
+                                    pAdjustMethod = "BH")
+  
+  expect_error(getEMMARecord(fea_no_emma))
+  
+  attr(fea_no_emma, "EMMA_record") <- c()
+  
+  expect_error(getEMMARecord(fea_no_emma))
+  
+})
\ No newline at end of file

From 3947e09499e4b8a5f00d13e44f38eca75463c9ad Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 27 Apr 2026 18:16:56 +0200
Subject: [PATCH 38/92] update vignette

---
 vignettes/Introduction_to_EMMA.Rmd | 250 +++++++++++++++++++----------
 1 file changed, 169 insertions(+), 81 deletions(-)

diff --git a/vignettes/Introduction_to_EMMA.Rmd b/vignettes/Introduction_to_EMMA.Rmd
index 21876d3..5416a15 100644
--- a/vignettes/Introduction_to_EMMA.Rmd
+++ b/vignettes/Introduction_to_EMMA.Rmd
@@ -68,6 +68,15 @@ analyses while systematically capturing analysis parameters and provenance
 information during runtime, and returning enrichment results in their native
 format alongside structured and reusable metadata.
 
+## What do you get with `EMMA`?
+
+Using `EMMA` allows you to:
+
+* Record the exact function call and parameters used for FEA
+* Automatically track annotation sources (e.g. organism, gene set database)
+* Retain provenance directly within the results object
+* Generate reproducible summaries of the analysis (e.g. Methods sections)
+* Facilitate sharing of results together with their analysis context
 
 # Getting started {#gettingstarted}
 
@@ -113,6 +122,9 @@ library("macrophage")
 library("DESeq2")
 library("org.Hs.eg.db")
 library("clusterProfiler")
+library("mosdef")
+library("topGO")
+library("GO.db")
 ```
 
 We will show an example of how  `r BiocStyle::Biocpkg("EMMA")` fits into a
@@ -146,7 +158,8 @@ dds_macrophage <- DESeq(dds_macrophage)
 resultsNames(dds_macrophage)
 ```
 
-Let's extract the DE results for each contrast. We will do three contrasts:
+Let's extract the DE results for each contrast. For the sake of demonstration,
+we will do one contrast:
 
 ```{r get_de_res}
 # get de res for 1st contrast
@@ -158,46 +171,14 @@ IFNg_vs_naive <- lfcShrink(dds_macrophage, coef = "condition_IFNg_vs_naive",
                            type = "apeglm")
 IFNg_vs_naive$SYMBOL <- rowData(dds_macrophage)$SYMBOL
 IFNg_vs_naive
-
-# get de res for 2nd contrast
-Salm_vs_naive <- results(dds_macrophage,
-                         contrast = c("condition", "SL1344", "naive"),
-                         lfcThreshold = 1, alpha = 0.05)
-Salm_vs_naive <- lfcShrink(dds_macrophage, coef = "condition_SL1344_vs_naive",
-                           res = Salm_vs_naive,
-                           type = "apeglm")
-Salm_vs_naive$SYMBOL <- rowData(dds_macrophage)$SYMBOL
-Salm_vs_naive
-
-# get de res for 3rd contrast
-Both_vs_naive <- results(dds_macrophage,
-                         contrast = c("condition", "IFNg_SL1344", "naive"),
-                         lfcThreshold = 1, alpha = 0.05)
-Both_vs_naive <- lfcShrink(dds_macrophage,
-                           coef = "condition_IFNg_SL1344_vs_naive",
-                           res = Both_vs_naive,
-                           type = "apeglm")
-Both_vs_naive$SYMBOL <- rowData(dds_macrophage)$SYMBOL
-Both_vs_naive
 ```
 
-Now let's sort the results based on the adjusted p-value:
+Now we'll sort the results based on the adjusted p-value:
 
 ```{r DEGs}
-# have a list of de results per contrast
-contrast_list <- list(IFNg_vs_naive = IFNg_vs_naive,
-                      Salm_vs_naive = Salm_vs_naive,
-                      Both_vs_naive = Both_vs_naive)
-
-de_res_list <- list()
 # sort
-for (i in names(contrast_list)) {
-  de_res <- as.data.frame(contrast_list[[i]])
-  de_res <- de_res[order(de_res$padj), ]
-  #de_res <- de_res[!(is.na(de_res$padj)) & de_res$padj <= 0.05, ]
-  
-  de_res_list[[i]] <- de_res
-}
+de_res <- IFNg_vs_naive[order(IFNg_vs_naive$padj), ]
+de_res <- de_res[!(is.na(de_res$padj)) & de_res$padj <= 0.05, ]
 
 # set universe
 universe <- rownames(dds_macrophage)
@@ -205,35 +186,38 @@ universe <- rownames(dds_macrophage)
 
 # Perform Functional Enrichment Analysis (FEA)
 
-Now that we have a list of DE genes for each contrast, we can perform Functional
-Enrichment Analysis. For the first contrast `IFNg_vs_naive`, we will use the
+## `EMMA` with available common packages/functions
+
+Now that we have a list of DE genes for this contrast, we can perform Functional
+Enrichment Analysis. In the following example, we will use the
 function `enrichGO()` from `r BiocStyle::Biocpkg("clusterProfiler")`
 
+### Capturing record with `EMMA_run()`
+
 `EMMA_run()` accepts a function call (e.g. `enrichGO(...)`) and executes it as
 it is, while capturing the associated parameters and provenance information:
 
 ```{r EMMA_run_1}
-# get de res from the list
-de_res_IFNg_vs_naive <- de_res_list$IFNg_vs_naive
-
 # perform FEA, but with EMMA!
-fea_res <- enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+fea_res <- enrichGO(gene = rownames(de_res),
                     keyType = "ENSEMBL",
                     OrgDb = org.Hs.eg.db,
                     ont = "BP",
                     pAdjustMethod = "BH",
                     pvalueCutoff = 0.05,
-                    qvalueCutoff = 0.1,
-                    universe = universe) |> 
+                    qvalueCutoff = 0.1) |> 
   EMMA_run() # simply pipe your call to EMMA_run()
+# check res
+fea_res
 ```
 
 ... or you can simply wrap `EMMA_run()` around your call:
 
-```{r EMMA_run_2}
+```{r EMMA_run_2, eval=FALSE}
 # you can also pass the function name and its namespace
 # e.g. `clusterProfiler::enrichGO(...)`
-fea_res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+fea_res <- EMMA_run(clusterProfiler::enrichGO(
+                    gene = rownames(de_res),
                     keyType = "ENSEMBL",
                     OrgDb = org.Hs.eg.db,
                     ont = "BP",
@@ -241,14 +225,14 @@ fea_res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
                     pvalueCutoff = 0.05,
                     qvalueCutoff = 0.1,
                     readable = TRUE))
-
-# check res
-fea_res
 ```
 
 As you can see, `EMMA` returns the FEA results in their **native/standard** format.
 `EMMA` also warns you about good practices when performing FEA, like in this
-example, we didn't define a list of background genes, so we get warned about that.
+example, we didn't define a list of background genes (which can influence the 
+results), so we get warned about that.
+
+### Retrieving recorded information with `getEMMARecord()` & `EMMA_show()`
 
 To get a quick summary of what `EMMA` captured while we ran the analysis, we use
 `EMMA_show()`:
@@ -257,44 +241,54 @@ To get a quick summary of what `EMMA` captured while we ran the analysis, we use
 EMMA_show(fea_res)
 ```
 
-`EMMA` stores the captured metadata within the attributes of the results object.
-That's why it is always a good practice to save the original results, and not
-only the subsets of interest.
-To see the full recorded information, we use `getEMMARecord()`:
+`EMMA` attaches the captured metadata to the attributes of the
+results object. That's why it is always a good practice to save the original
+results, and not only the subsets of interest.
+
+To access the full recorded information, we use `getEMMARecord()`:
 
 ```{r getEMMARecord}
 emma_record <- getEMMARecord(fea_res)
 
+# get all the record
 emma_record
 ```
 
-`EMMA` aims to capture the following elements:
+`EMMA` structures the `EMMA_record` attribute (i.e. the recorded provenance
+information) into a list of elements:
 
-```
+```{EMMA_record_str}
 ├── EMMA_record
-│   ├── method
+│   ├── method         # how the analysis was performed
 │   │   ├── call
-│   │   └── function_name
-│   │   └── package_name
-│   │   └── package_version
-│   └── input
+│   │   ├── function_name
+│   │   ├── package_name
+│   │   ├── package_version
+│   │   ├── wrapped_function
+│   │   ├── wrapped_package
+│   │   └── wrapper
+│   ├── input         # inputs used for the analysis
 │   │   └── arguments
-│   └── annotation
+│   ├── annotation    # annotation context
 │   │   ├── organism
-│   │   └── gene_set_db
+│   │   ├── gene_set_db
 │   │   └── gene_set_db_version
-│   └── timestamp
-│   └── session_info
-│   └── user_metadata # the user can pass any extra metadata freely in this field
-│   ├── emma_version
+│   ├── timestamp     # when the analysis was run
+│   ├── session_info  # R session information
+│   ├── extra         # user-defined additions
+│   └── emma_version
+```
+
+```{r EMMA_method}
+# get the method record
+emma_record$method
 ```
 
-As we can see a lot of information was recorded. With `EMMA_run()`, we can decide
-whether we want to save the value of arguments used in our call or not. For this,
-we can use the argument `args_form`:
+With `EMMA_run()`, we can decide whether we want to save the value of arguments
+used in our call or not. For this, we can use the argument `args_form`:
 
 ```{r argument_form}
-fea_res_no_param <- enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+fea_res_no_param <- enrichGO(gene = rownames(de_res),
                              universe = universe,
                              keyType = "ENSEMBL",
                              OrgDb = org.Hs.eg.db,
@@ -303,23 +297,17 @@ fea_res_no_param <- enrichGO(gene = rownames(de_res_IFNg_vs_naive),
                              pvalueCutoff = 0.05,
                              qvalueCutoff = 0.1,
                              readable = TRUE) |> 
-  EMMA_run(args_form = "unevaluated") # if we don't want the values stored
+  EMMA_run(args_form = "unevaluated") # when we don't want the values stored
                                       # else set to evaluated (default)
 
 # check
 getEMMARecord(fea_res_no_param)
 ```
 
-We can also choose whether to save the session info with the record using the 
-argument `session`, which defaults to `TRUE`.
+We can also choose whether to save the R session information with the record
+using the argument `session`, which defaults to `TRUE`.
 
-`EMMA_freeze()` records the R environment during analysis runtime and generates
-a lockfile that can be used with tools such as `renv`, to facilitate
-reproducible reconstruction of the analysis environment.
-
-```{r EMMA_freeze}
-#EMMA_freeze()
-```
+### Summarizing captured information into text
 
 `EMMA_explain()` generates a human-readable description of the FEA, similar
 to a Materials and Methods section of a paper, by summarizing the executed call,
@@ -329,6 +317,106 @@ the parameters, software context, and reference databases used.
 EMMA_explain(fea_res)
 ```
 
+## `EMMA` with custom/wrapper functions
+
+You can also use a custom function that you developed, or a wrapper function
+(from packages such as `r BiocStyle::Biocpkg("mosdef")`). In this case,
+`EMMA_run()` will attempt to capture as much metadata as possible:
+
+```{r mosdef_eg}
+fea_res <- mosdef::run_goseq(de_genes = rownames(de_res),
+                             bg_genes = universe,
+                             mapping = "org.Hs.eg.db",
+                             id = "ensGene",
+                             genome = "hg19") |> EMMA_run(session = FALSE,
+                                                          args_form = "unevaluated")
+
+# quick inspection
+getEMMARecord(fea_res)
+```
+
+```{r custom_eg}
+# a custom function (not from a package)
+my_custom_function <- function(gene, universe = NULL,
+                               ontology = "BP", id_type = "ENTREZID",
+                               org_db_name = "org.Hs.eg.db", 
+                               organism = "hsapiens") {
+  # a wrapper of a wrapper :D
+  res1 <- mosdef::run_topGO(de_genes = gene,
+                            bg_genes = universe,
+                            ontology = ontology,
+                            gene_id = id_type,
+                            mapping = org_db_name,
+                            add_gene_to_terms = TRUE)
+
+  res2 <- gprofiler2::gost(query = gene,
+                           organism = organism,
+                           custom_bg = universe)
+
+  return(list(topGO_res = res1,
+              gost_res = res2
+  ))
+}
+
+# run analysis with EMMA
+frankenstein_fea <- my_custom_function(
+  gene = rownames(de_res),
+  universe = universe,
+  ontology = "BP",
+  id_type = "ENSEMBL",
+  org_db_name = "org.Hs.eg.db",
+  organism = "hsapiens"
+  ) |> EMMA_run(session = FALSE, args_form = "unevaluated") 
+
+# quick inspection
+getEMMARecord(frankenstein_fea)
+```
+
+# Adding extra information
+
+The user can always attach extra metadata that `EMMA` might not be able to
+capture automatically. To keep everything organized, we can use
+`EMMA_add_custom_metadata()` function
+
+```{r add_custom_metadata}
+
+frankenstein_fea <- EMMA_add_custom_metadata(res = frankenstein_fea,
+                                             extra = list(
+                                               wrapped_function_topGO = "runTest",
+                                               notes = "any other meaningful info"))
+
+getEMMARecord(frankenstein_fea)$extra
+```
+
+Since the `EMMA_record` is attached as attribute to the original results objects,
+it can be preserved when integrating results into structured containers
+such as `DeeDeeExperiment`. This enables both FEA results and
+their associated provenance information to be stored and managed together,
+facilitating reproducibility, organization, and sharing of complex omics analyses.
+
+```{r emma&dde, eval=FALSE}
+#### should we have this chunk runnable and suggest dde?
+dde <- DeeDeeExperiment::DeeDeeExperiment(sce = dds_macrophage,
+                                          de_results = IFNg_vs_naive,
+                                          enrich_results =  list(
+                                            IFNg_vs_naive = fea_res_no_param))
+
+fea <- DeeDeeExperiment::getFEA(dde, format = "original")
+
+getEMMARecord(fea)
+```
+
+
+# Recording the Analysis Environment with `EMMA_freeze()`
+
+`EMMA_freeze()` records the R environment during analysis runtime and generates
+a lockfile that can be used with tools such as `renv`, to facilitate
+reproducible reconstruction of the analysis environment.
+
+```{r EMMA_freeze}
+#EMMA_freeze()
+```
+
 # Session info {.unnumbered .smaller}
 
 ```{r sessioinfo}

From 0e1718ada53c9c118fb04c373208507d78beaa2c Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 27 Apr 2026 18:18:05 +0200
Subject: [PATCH 39/92] updating EMMA_run to handle wrappers/custom functions

---
 R/EMMA_internal-utils.R | 403 +++++++++++++++++++++++++++++++++++-----
 R/EMMA_run.R            |  67 ++++---
 2 files changed, 404 insertions(+), 66 deletions(-)

diff --git a/R/EMMA_internal-utils.R b/R/EMMA_internal-utils.R
index 3ba5dc1..e532c10 100644
--- a/R/EMMA_internal-utils.R
+++ b/R/EMMA_internal-utils.R
@@ -1,44 +1,74 @@
 # metadata capture -------------------------------------------------------------
-#' get the basic structure for the metadata elements to be captured depending on
-#' the method
+#' This function creates a standardized metadata structure used to store
+#' annotation info for FEAs. This ensures a consistent structure across
+#' different enrichment methods and packages
 #' 
 #' @noRd
-EMMA_empty_metadata <- function() {
+EMMA_empty_metadata <- function() { 
   list(
     organism = NA_character_,
     gene_set_db = NA_character_,
     gene_set_db_version = NA_character_
-  )
+)
 }
 
-#' depending on the function/pkg, decide the right function dispatch
+
+#' This function acts as a dispatcher, routing to package-specific helpers
+#' (e.g. for `clusterProfiler`, `gprofiler2` ...) to standardize metadata
+#' collection across different enrichment tools
 #'
-#' @param function_name A character string specifying the function name used to
-#' perform FEA
-#' @param package_name A character string containing the package name used to
-#' perform FEA
-#' @param args A list containing the evaluated arguments passed into the
-#' function call to perform FEA 
+#' @param info_call A list containing captured call information, including
+#' at least `function_name`, `package_name`, and the original `call`
+#'   
+#' @param args A list of evaluated arguments passed to the enrichment function 
+#' 
+#' @param envir The environment in which the original call was evaluated
+#' 
+#' @return A list containing annotation metadata(organism, gene set database and 
+#' its version), depending on the originating package. It returns an empty
+#' metadata structure if no package-specific method is available
 #'
 #' @noRd
-EMMA_get_metadata <- function(function_name,
-                               package_name,
-                               args) {
-  switch(
+EMMA_get_metadata <- function(call_class,
+                              args,
+                              envir = parent.frame()) {
+  info_call <- call_class$info_call
+  function_name <- info_call$function_name
+  package_name <- info_call$package_name
+  call <- info_call$call
+  
+  meta <- EMMA_empty_metadata()
+  
+  if (is.null(package_name) || is.na(package_name) || package_name == "") {
+    package_name <- "custom"
+  }
+  
+  meta <- switch(
     package_name,
     clusterProfiler = EMMA_get_clusterprofiler_metadata(function_name, args),
     gprofiler2      = EMMA_get_gprofiler2_metadata(args),
     mosdef          = EMMA_cp_GO_metadata(args$mapping),
-    EMMA_empty_metadata()
+    custom          = EMMA_get_custom_metadata(call_class,
+                                               args,
+                                               envir = parent.frame())
   )
+  
+  return(meta)
+  
 }
 
-#' get metadata from clusterProfiler functions
-#' @param function_name A character string specifying the function name used to
-#' perform FEA
+#' This function retrieves metadata associated with FEAs performed using
+#' functions from the `clusterProfiler` package. The specific metadata
+#' extraction method is selected based on the enrichment function used
+#' 
+#' @param function_name A character string specifying the name of the
+#' `clusterProfiler` function used to perform FEA
 #'
 #' @param args A list containing the evaluated arguments passed into the
 #' function call to perform FEA 
+#' 
+#' @return A list containing annotation metadata (organism, gene set database
+#' and its version), depending on the underlying database used (e.g. GO vs KEGG)
 #'
 #' @noRd
 EMMA_get_clusterprofiler_metadata <- function(function_name, args) {
@@ -50,11 +80,17 @@ EMMA_get_clusterprofiler_metadata <- function(function_name, args) {
     enrichKEGG = EMMA_cp_KEGG_metadata(args),
     gseKEGG = EMMA_cp_KEGG_metadata(args),
     EMMA_empty_metadata()
+    # more to be added
   )
 }
 
-#' extract the organism from org,*.eg.db objects
-#' @param orgdb Organism object from org.*.eg.db packages
+#' This function extracts the organism from OrgDb objects
+#' 
+#' @param orgdb An `OrgDb` object or a single character string giving the name
+#' of such an object (e.g. `"org.Hs.eg.db"`)
+#' 
+#' @return A character string containing the organism name (e.g. `"Homo sapiens"`)
+#' and returns `NA_character_` if the organism cannot be determined
 #'
 #' @noRd
 EMMA_get_organism_from_OrgDb <- function(orgdb) {
@@ -82,13 +118,19 @@ EMMA_get_organism_from_OrgDb <- function(orgdb) {
 }
 
 
-#' assemble metadata element from clusterProfiler GO analyses
+#' This function assembles standardized metadata describing GO enrichment
+#' analyses performed with `clusterProfiler`. The metadata includes the
+#' organism, the geneset database used, and its version when available
 #' 
-#' @param org 
+#' @param org An `OrgDb` object or a single character string giving the name of
+#' such an object (e.g. `"org.Hs.eg.db"`)
+#' 
+#' @return A named list containing annotation metadata, mainly the organism, the
+#' geneset database and its version
 #'
 #' @noRd
 EMMA_cp_GO_metadata <- function(org) {
-  meta <- list()
+  meta <- EMMA_empty_metadata()
   
   meta$organism <- EMMA_get_organism_from_OrgDb(org)
   meta$gene_set_db <- "GO"
@@ -104,14 +146,20 @@ EMMA_cp_GO_metadata <- function(org) {
 
 ### not tested yet since the kegg server is down and the function couldn't work
 
-#' assemble metadata element from clusterProfiler KEGG analyses
+#' This function assembles standardized metadata describing KEGG enrichment
+#' analyses performed with `clusterProfiler`. The metadata includes the
+#' organism, the geneset database used. The database version is currently not
+#' captured
 #' 
 #' @param args A list containing the evaluated arguments passed into the
 #' function call to perform FEA 
+#' 
+#' @return A named list containing annotation metadata, mainly the organism, the
+#' geneset database and its version
 #'
 #' @noRd
 EMMA_cp_KEGG_metadata <- function(args) {
-  meta <- list()
+  meta <- EMMA_empty_metadata()
   
   meta$organism <- args$organism
   meta$gene_set_db <- "KEGG"
@@ -120,16 +168,19 @@ EMMA_cp_KEGG_metadata <- function(args) {
   return(meta)
 }
 
-#' This function assembles annotation metadata from a `gprofiler2` enrichment call
+
+#' This function retrieves metadata associated with FEAs performed using
+#' functions from the `gprofiler2` package
 #' 
 #' @param args A list containing the evaluated arguments passed into the
 #' function call to perform FEA
 #' 
-#' @return A named list 
+#' @return A named list containing annotation metadata, mainly the organism, the
+#' geneset database and its version
 #'
 #' @noRd
 EMMA_get_gprofiler2_metadata <- function(args) {
-  meta <- list()
+  meta <- EMMA_empty_metadata()
   
   version_info <- gprofiler2::get_version_info()
   
@@ -160,17 +211,69 @@ EMMA_get_gprofiler2_metadata <- function(args) {
   return(meta)
 }
 
-# call capture -----------------------------------------------------------------
 
-#' EMMA_capture_call_info
 #' 
+#' @noRd
+EMMA_get_custom_metadata <- function(call_class, args,
+                                     envir = parent.frame()) {
+  
+  meta <- EMMA_empty_metadata()
+  
+  if (call_class$type == "wrapper") {
+    # get all known functions used in the wrapper
+    wrapped_fun <- unique(call_class$wrapped_original$fun)
+    
+    go_funs <- c("enrichGO", "gseGO", "groupGO")
+    kegg_funs <- c("enrichKEGG", "gseKEGG")
+    # dont use EMMA_get_clusterprofiler_metadata cause the switch wont work with
+    # more than 1 wrapped fun
+    meta_list <- list()
+    if (any(wrapped_fun %in% go_funs)) {
+      meta_list$GO <- EMMA_cp_GO_metadata(args$OrgDb)
+    }
+    
+    if (any(wrapped_fun %in% kegg_funs)) {
+      meta_list$KEGG <- EMMA_cp_KEGG_metadata(args)
+    }
+    
+    if (any(wrapped_fun %in% c("gost"))) {
+      meta_list$gprofiler2 <- EMMA_get_gprofiler2_metadata(args)
+    }
+    
+    if (length(meta_list) == 0L) {
+      return(meta)
+    }
+    
+    meta$organism <- unique(unlist(lapply(meta_list, `[[`, "organism")))
+    meta$gene_set_db <- unique(unlist(lapply(meta_list, `[[`, "gene_set_db")))
+    meta$gene_set_db_version <- unique(unlist(lapply(meta_list, `[[`, "gene_set_db_version")))
+    
+    return(meta)
+
+  }
+  
+  if (call_class$type == "custom") {
+    # if 100% custom
+    message("You used a custom function, so `EMMA` wasn't able to record annotation-",
+            "related information. Please consider adding the `organism`, `geneset database`",
+            " and its `version` manually into the `extra` field in EMMA_record.")
+    return(meta)
+  }
+  
+  return(meta)
+}
+
+
+
+# call info capture -----------------------------------------------------------------
+
 #' This function extracts call related metadata. It handles two call
-#' formats: bare function calls (e.g. `enrichGO(...)`) and namespace-qualified
-#' calls (e.g. `clusterProfiler::enrichGO(...)`).
+#' formats: bare function calls (e.g. `fun(...)`) and namespace-qualified
+#' calls (e.g. `pkg::fun(...)`)
 #'
 #' @param call A call object
 #' @param envir The environment in which to look up the function when a bare
-#' call is used. Defaults to `base::parent.frame()`.
+#' call is used
 #'
 #' @return A named list
 #' @noRd
@@ -184,12 +287,18 @@ EMMA_capture_call_info <- function(call, envir = parent.frame()) {
   # when we only use function name e.g. enrichGO(...)
   if (is.symbol(call_name)) {
     function_name <- as.character(call_name)
+    
     fun <- get(function_name, envir = envir, mode = "function")
+    
     pkg <- utils::packageName(environment(fun))
+    
     package_name <- if (is.null(pkg) || pkg == "" ) NA_character_ else pkg
+    
     pkg_version <- if (!is.na(package_name)) {
       as.character(packageVersion(package_name))}
+    
     else NA_character_
+    
     # capture args (unevaluated)
     arg_list <- as.list(call)[-1]
 
@@ -226,17 +335,220 @@ EMMA_capture_call_info <- function(call, envir = parent.frame()) {
   }
   
   stop(
-    "Unsupported call format. Use a direct function call like `enrichGO(...)` or `pkg::fun(...)`",
+    "Unsupported call format. Use a direct function call like `fun(...)` or `pkg::fun(...)`",
     call. = FALSE)
 }
 
 
-# build EMMA record ------------------------------------------------------------
+#' This function, used in in `EMMA_walk()`, converts the head of a call into a character
+#' string representing the function being called. It supports both bare calls
+#' (e.g. `fun`) and namespace-qualified calls (e.g. `pkg::fun`)
+#'
+#' @param x The head of a call (the function being called)
+#' 
+#' @return A character string representing the function name
+#'
+#' @noRd
+EMMA_call_name <- function(x) {
+  if (is.symbol(x)) {
+    return(as.character(x))
+  }
+  if (
+    is.call(x) &&
+    identical(x[[1]], as.name("::")) &&
+    length(x) == 3
+  ) {
+    return(paste0(as.character(x[[2]]), "::", as.character(x[[3]])))
+  }
+  NULL
+}
+
+
+#' This function recursively collects function names/operators from a call. It
+#' is used to inspect the body of a wrapper function and to identify whether it
+#' calls any known functional enrichment functions (e.g. `enrichGO()`)
+#' 
+#' @param x A call object
+#' 
+#' @return A character vector containing the names of all functions and 
+#' operators found in `x`, including nested calls
+#' 
+#' @noRd
+EMMA_walk <- function(x) {
+  out <- character()
+  
+  if (is.call(x)) {
+    # extract function/operator name
+    nm <- EMMA_call_name(x[[1]])
+    if (!is.null(nm)) {
+      out <- c(out, nm)
+    }
+    
+  }
+  if (is.call(x) || is.pairlist(x) || is.expression(x)) {
+    #check children/nested elements
+    for (i in seq_along(x)) {
+      out <- c(out, EMMA_walk(x[[i]]))
+    }
+  }
+  
+  return(out)
+}
+
 
-#' EMMA_build_record
+#' This function inspects the body of a function call and determines whether
+#' it wraps one or more known FEA functions (e.g. from `clusterProfiler` or
+#' any other package). This is used internally by `EMMA_run()` when the top-level
+#' call is not itself a known enrichment function, but may be a user-defined
+#' wrapper around one
+#'
+#' @param call An unevaluated call
+#' @param envir An environment in which to evaluate `call`
+#'
+#' @return `NULL` if no known enrichment function is detected in the wrapper body.
+#' Otherwise, a list with two components: `pkg`, a character vector of package
+#' names, and `fun`, character vector of corresponding function names used in the
+#' wrapper
 #' 
+#' @noRd
+EMMA_find_original_wrapped_fun <- function(call, envir = parent.frame()) {
+  
+  if (!is.call(call)) {
+    # do i want it to fail here ?
+    return(NULL)
+  }
+  
+  available <- list(
+    clusterProfiler = c("enrichGO", "gseGO", "groupGO", "enrichKEGG", "gseKEGG"),
+    gprofiler2 = c("gost"),
+    goseq = c("goseq"),
+    mosdef = c("run_topGO", "run_cluPro", "run_goseq"),
+    topGO = c("runTest")
+    # will add more later here
+  )
+  
+  # flatten available into full names
+  full_targets <- mapply(function(pkg, funs){
+    paste0(pkg, "::", funs)}, 
+    names(available), #pkg
+    available, #funs
+    SIMPLIFY = FALSE) |>  unlist(use.names = FALSE)
+  
+  # get wrapper name
+  call_head <- call[[1]]
+  
+  # get function object, from which we'll extract the body
+  # if we have a bare wrapper name
+  if (is.symbol(call_head)) {
+    fun <- get(as.character(call_head), envir = envir, mode = "function")
+  }
+  # if the wrapper is namespace qualified function name,
+  # extract the fun name to get the body
+  else if (is.call(call_head) &&
+      length(call_head) == 3L &&
+      identical(call_head[[1]], as.symbol("::"))) {
+    pkg <- as.character(call_head[[2]])
+    fn  <- as.character(call_head[[3]])
+    fun <- getExportedValue(pkg, fn)
+  } else {
+    stop(
+      "Only `fun(...)` and `pkg::fun(...)` are supported",
+      call. = FALSE
+    )
+  }
+  
+  
+  found <- EMMA_walk(body(fun)) |> unique()
+  
+  matched <- unique(c(
+    intersect(found, full_targets),
+    #remove the pkg name (what s before ::)
+    full_targets[sub("^.*::", "", full_targets) %in% found]
+  ))
+  
+  if (length(matched) == 0) {
+    return(NULL)
+  }
+  
+  parts <- strsplit(matched, "::", fixed = TRUE)
+
+  return(list(
+    pkg = vapply(parts, `[`, character(1), 1),
+    fun = vapply(parts, `[`, character(1), 2)
+  ))
+}
+
+
+#' decide if top-level function passed to EMMA_run is a known fun or a wrapper
+#'
+#' @noRd
+EMMA_classify_call <- function(call, envir = parent.frame()) {
+  # listing all the functions that are not wrappers
+  originals <- list(
+    clusterProfiler = c("enrichGO", "gseGO", "groupGO", "enrichKEGG", "gseKEGG"),
+    gprofiler2 = c("gost"),
+    goseq = c("goseq"),
+    topGO = c("runTest")
+  )
+  
+  full_originals <- mapply( function(pkg, funs) paste0(pkg, "::", funs),
+                            names(originals),
+                            originals,
+                            SIMPLIFY = FALSE) |> unlist(use.names = FALSE)
+  
+  # capture call information
+  info_call <- EMMA_capture_call_info(call = call, envir = envir)
+  function_name <- info_call$function_name
+  package_name <- info_call$package_name
+  
+  top_name <- if (!is.na(package_name) && !is.null(package_name)
+                  && package_name != "" && length(package_name) == 1L) {
+    paste0(package_name, "::", function_name)
+  } else {
+    function_name
+  }
+  
+  is_original_top_level <- if (!is.na(package_name) && !is.null(package_name)
+                               && package_name != "" && length(package_name) == 1L) {
+    paste0(package_name, "::", function_name) %in% full_originals
+  } else {
+    function_name %in% sub("^.*::", "", full_originals)
+  }
+  
+  wrapped_original <- NULL
+  wrapper <- FALSE # default
+  
+  if (!is_original_top_level) {
+    # inspect body of expr function, because this could be a wrapper
+    wrapped_original <- EMMA_find_original_wrapped_fun(call = call,
+                                                       envir = envir)
+    wrapper <- !is.null(wrapped_original)
+  }
+  
+  type <- if (is_original_top_level) {
+    "original"
+  } else if (wrapper) {
+    "wrapper"
+  } else {
+    "custom"
+  }
+  
+  return(list(
+    type = type,
+    is_original_top_level = is_original_top_level,
+    wrapper = wrapper,
+    wrapped_original = wrapped_original,
+    info_call = info_call
+  ))
+  
+}
+
+
+# build EMMA record ------------------------------------------------------------
+
+
 #' This function assembles the structured provenance record that is stored as
-#' an attribute on the FEA results object.
+#' an attribute on the FEA results object
 #' 
 #' @param info_call A list returned by `EMMA_capture_call_info()`
 #' @param args_form A character string, either `"evaluated"` or `"unevaluated"`
@@ -250,13 +562,19 @@ EMMA_capture_call_info <- function(call, envir = parent.frame()) {
 #'   
 #' @noRd
 EMMA_build_record <- function(info_call, args_form, metadata,
-                               start_time, session) {
+                              wrapped_original, wrapper,
+                              start_time, session) {
   emma_rec <- list(
                    method = list(
                      call = info_call$call,
                      function_name = info_call$function_name,
                      package_name = info_call$package_name,
-                     package_version = info_call$package_version
+                     package_version = info_call$package_version,
+                     wrapped_function = if (!is.null(wrapped_original)) 
+                       wrapped_original$fun else NULL,
+                     wrapped_package = if (!is.null(wrapped_original)) 
+                       wrapped_original$pkg else NULL,
+                     wrapper = wrapper
                    ),
                    input = list(
                      arguments = if (args_form == "evaluated") info_call$args 
@@ -269,7 +587,7 @@ EMMA_build_record <- function(info_call, args_form, metadata,
                    ),
                    timestamp = start_time,
                    session_info = if (isTRUE(session)) sessionInfo() else NULL,
-                   user_metadata = list(),# free form user additions
+                   extra = list(),# free field for extra metadata (added by user)
                    emma_version = as.character(packageVersion(pkg = "EMMA"))
                    )
   
@@ -279,8 +597,7 @@ EMMA_build_record <- function(info_call, args_form, metadata,
 
 # good practice warnings -------------------------------------------------------
 
-#' EMMA_warnings
-#' 
+
 #' This function warns about missing good-practice arguments in enrichment calls.
 #' A warning is raised if none of the synonyms for a given category appear
 #' in `arg_names`
diff --git a/R/EMMA_run.R b/R/EMMA_run.R
index 1fe9721..c3e72cd 100644
--- a/R/EMMA_run.R
+++ b/R/EMMA_run.R
@@ -1,25 +1,32 @@
 #' EMMA_run
 #' 
-#' This function executes any supported functional enrichment analysis function
-#' and automatically captures the call, its associated parameters and provenance
-#' information when available during runtime as an `EMMA_record` attribute
-#' on the returned results object.
+#' This function executes any functional enrichment analysis function and
+#' attaches a provenance record (`EMMA_record`) describing the analysis. The
+#' captured record includes the original call, metadata derived from the call
+#' and its arguments, runtime information, and optionally the current session
+#' information.
+#' 
+#' `EMMA_run()` accepts both direct calls to known enrichment functions
+#' (`enrichGO()`, `GSEA()`, `fgsea()` ...) and calls to wrapper functions that
+#' internally invoke a know enrichment function.
+#' 
 #'
 #' @param expr A function call that performs functional enrichment analysis.
 #' The call is captured and executed by EMMA to record analysis parameters and
-#' provenance information. Both bare calls (`enrichGO(...)`) and namespace-qualified
-#' calls (`clusterProfiler::enrichGO(...)`) are supported. Any other form
-#' (e.g. `do.call`, `get()`) will raise an error
+#' provenance information. Both bare calls (`enrichGO(...)`) and
+#' namespace-qualified calls (`clusterProfiler::enrichGO(...)`) are supported.
 #' @param envir An environment in which to evaluate `expr`
 #' @param session Logical, indicating whether to store the output of
 #' `sessionInfo()` or not. If `TRUE` (default), the session is stored in the
 #' provenance record
 #' @param args_form A character string indicating whether to store the evaluated
-#' or the unevaluated arguments in the provenance record. It default to `"evaluated"`
+#' or the unevaluated arguments in the provenance record. It default to
+#' `"evaluated"`
 #'
 #' @returns The result object returned by the enrichment function in `expr`,
-#'   unmodified except for an added `EMMA_record` attribute containing the
-#'   provenance information. Use `getEMMARecord()` to access it
+#' in standard format, with an additional `EMMA_record` attribute containing the
+#' provenance information. Use `getEMMARecord()` to retrieve this record
+#' 
 #' @export
 #'
 #' @examples
@@ -28,8 +35,11 @@
 #' EMMA_run(clusterProfiler::enrichGO(gene = rownames(de_res_IFNg_vs_naive),
 #' universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
 #' ont = "BP"))
-EMMA_run <- function(expr, envir = parent.frame(), session = TRUE,
+EMMA_run <- function(expr,
+                     envir = parent.frame(),
+                     session = TRUE,
                      args_form = c("evaluated", "unevaluated")) {
+  
   args_form <- match.arg(args_form)
   
   # capture call
@@ -40,11 +50,22 @@ EMMA_run <- function(expr, envir = parent.frame(), session = TRUE,
     stop("`expr` must be a function call, e.g. enrichGO(...)!")
   }
   
-  # capture call information
-  info_call <- EMMA_capture_call_info(call = call)
-   function_name <- info_call$function_name
-   package_name <- info_call$package_name
-
+  if (!is.environment(envir)) {
+    stop("`envir` must be an environment!")
+  }
+  
+  if (!is.logical(session) || length(session) != 1L || is.na(session)) {
+    stop("`session` must be a single TRUE or FALSE value")
+  }
+  
+  # decide whether we are dealing with a known function or a wrapper
+  call_class <- EMMA_classify_call(call, envir = envir)
+  info_call <- call_class$info_call
+  function_name <- info_call$function_name
+  package_name <- info_call$package_name
+  wrapper <- call_class$wrapper
+  wrapped_original <- call_class$wrapped_original
+  
   # capture args (unevaluated)
   arg_list <- info_call$arg_list
   arg_names <- names(arg_list)
@@ -52,7 +73,7 @@ EMMA_run <- function(expr, envir = parent.frame(), session = TRUE,
   # some good practice warning, i.e. when multiple testing correction is skipped
   # or bg geneset not set
   EMMA_warnings(arg_names = arg_names,
-                       function_name = function_name)
+                function_name = function_name)
   
   #capture analysis time
   start_time <- Sys.time()
@@ -62,7 +83,6 @@ EMMA_run <- function(expr, envir = parent.frame(), session = TRUE,
   args <- lapply(arg_list, eval, envir = envir)
   info_call$args <- args 
   
-  
   # get the function
   fun <- eval(call[[1]], envir = envir)
   
@@ -71,16 +91,17 @@ EMMA_run <- function(expr, envir = parent.frame(), session = TRUE,
   
   # capture metadata from the used function and arguments
   metadata <- EMMA_get_metadata(
-    function_name = function_name,
-    package_name = package_name,
-    args = args
+    call_class,
+    args,
+    envir = envir
   )
   
   # record everything in EMMA_record
-  EMMA_record <- EMMA_build_record(info_call, args_form, metadata,
+  EMMA_record <- EMMA_build_record(info_call, args_form, metadata, 
+                                   wrapped_original,wrapper,
                                    start_time, session)
     
-  # store the EMMA_record as attribute of the results obj
+  # attach EMMA_record as attribute of the results obj
   attr(results, "EMMA_record") <- EMMA_record
 
   return(results)

From 848c99dfb13684d355bb741a718f8be8f32bafbe Mon Sep 17 00:00:00 2001
From: Federico Marini <marinif@uni-mainz.de>
Date: Thu, 30 Apr 2026 16:57:46 +0200
Subject: [PATCH 40/92] typos fixed

---
 DESCRIPTION     |  2 +-
 R/EMMA_freeze.R | 30 +++++++++++++++---------------
 2 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/DESCRIPTION b/DESCRIPTION
index a00d977..5bc8d6c 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -1,5 +1,5 @@
 Package: EMMA
-Title: EMMA: Enrichment Methods Matter for enabeling fully reproducible and 
+Title: EMMA: Enrichment Methods Matter for enabling fully reproducible and 
     provenance-aware pathway analysis
 Version: 0.2.0
 Authors@R: 
diff --git a/R/EMMA_freeze.R b/R/EMMA_freeze.R
index c71e18c..99df609 100644
--- a/R/EMMA_freeze.R
+++ b/R/EMMA_freeze.R
@@ -1,5 +1,5 @@
 #' EMMA_freeze
-#' 
+#'
 #' This function records the R environment during analysis runtime and generates
 #' a lockfile that can be used with tools such as `renv`.
 #' By default, all currently loaded namespaces are recorded.
@@ -7,40 +7,40 @@
 #' @param project Character string corresponding to the path to the project
 #' directory where the lockfile should be written. If the directory does not
 #' exist, it will be created. It defaults to the current working directory
-#' @param file Character string refering to the name of the lockfile to generate.
+#' @param file Character string referring to the name of the lockfile to generate.
 #' It defaults to "renv.lock"
 #' @param pkgs Character vector of package names to snapshot. It defaults to all
 #' currently loaded namespaces via `loadedNamespaces()`
-#' 
+#'
 #' @details
 #' This function calls `renv::snapshot()` with the specified packages.
 #' The resulting lockfile can later be restored with `renv::restore()` to
 #' recreate the same package environment.
-#' 
+#'
 #' @returns TODO json file like to create a lock.file?
-#' 
+#'
 #' @seealso \code{\link[renv]{snapshot}}, \code{\link[renv]{restore}}
-#' 
+#'
 #' @export
-#' 
+#'
 #' @examples
 #' \dontrun{
-#' # Create a lockfile in a separate directory
-#' EMMA_freeze(project = "emma_env")
+#'   # Create a lockfile in a separate directory
+#'   EMMA_freeze(project = "emma_env")
 #'
-#' # Restore later with renv
-#' renv::restore(project = "emma_env")
+#'   # Restore later with renv
+#'   renv::restore(project = "emma_env")
 #' }
 EMMA_freeze <- function(project = getwd(),
                         file = "renv.lock",
                         pkgs = loadedNamespaces()){
-  
+
   # if (!dir.exists(project)) dir.create(project, recursive = TRUE)
-  # 
+  #
   # renv::snapshot(
   #   project = project,
   #   lockfile = file,
   #   packages = pkgs
   # )
-  # 
-}
\ No newline at end of file
+  #
+}

From c8dd29a8beb0d0b657b34f09a4eebfd715791463 Mon Sep 17 00:00:00 2001
From: Federico Marini <marinif@uni-mainz.de>
Date: Thu, 30 Apr 2026 16:58:31 +0200
Subject: [PATCH 41/92] spacing in the examples

---
 R/EMMA_add_custom_metadata.R    | 32 ++++++++++++++----------
 R/EMMA_explain.R                | 44 ++++++++++++++++++---------------
 man/EMMA_add_custom_metadata.Rd | 16 ++++++++----
 man/EMMA_explain.Rd             | 10 +++++---
 man/EMMA_freeze.Rd              | 10 ++++----
 5 files changed, 66 insertions(+), 46 deletions(-)

diff --git a/R/EMMA_add_custom_metadata.R b/R/EMMA_add_custom_metadata.R
index 3a854a9..56b3bc8 100644
--- a/R/EMMA_add_custom_metadata.R
+++ b/R/EMMA_add_custom_metadata.R
@@ -1,5 +1,5 @@
 #' EMMA_add_custom_metadata
-#' 
+#'
 #' Append or replace the `extra` field in the `EMMA_record` attribute
 #' of a result object returned by `EMMA_run()`. This allows users to manually
 #' provide additional annotation or contextual information that could not be
@@ -17,28 +17,34 @@
 #' data("de_res_IFNg_vs_naive", package = "EMMA")
 #' data("universe", package = "EMMA")
 #' library("clusterProfiler")
-#' res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
-#' universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
-#' ont = "BP"))
-#' res <- EMMA_add_custom_metadata(res, extra =
-#' list(note = "The background gene set list was all expressed genes in the assay"))
+#' res <- EMMA_run(
+#'   enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+#'     universe = universe, keyType = "ENSEMBL",
+#'     OrgDb = org.Hs.eg.db::org.Hs.eg.db,
+#'     ont = "BP"
+#'   )
+#' )
+#' res <- EMMA_add_custom_metadata(
+#'   res,
+#'   extra = list(note = "The background gene set list was all expressed genes in the assay")
+#' )
 EMMA_add_custom_metadata <- function(res,
                                      extra = list()) {
-  
+
   if (!is.list(extra)) {
     stop("`extra` must be a list!")
   }
-  
+
   if (length(extra) > 0L && is.null(names(extra))) {
     stop("`extra` must be a named list!")
   }
-  
+
   emma_rec <- getEMMARecord(res = res)
-  
+
   emma_rec$extra <- extra
-  
+
   # update
   attr(res, "EMMA_record") <- emma_rec
-  
+
   return(res)
-}
\ No newline at end of file
+}
diff --git a/R/EMMA_explain.R b/R/EMMA_explain.R
index e915f93..33790d4 100644
--- a/R/EMMA_explain.R
+++ b/R/EMMA_explain.R
@@ -14,26 +14,30 @@
 #' data("de_res_IFNg_vs_naive", package = "EMMA")
 #' data("universe", package = "EMMA")
 #' library("clusterProfiler")
-#' res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
-#' universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
-#' ont = "BP", pAdjustMethod = "BH"))
+#' res <- EMMA_run(
+#'   enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+#'     universe = universe, keyType = "ENSEMBL",
+#'     OrgDb = org.Hs.eg.db::org.Hs.eg.db,
+#'     ont = "BP", pAdjustMethod = "BH"
+#'   )
+#' )
 #' EMMA_explain(res)
-#' 
+#'
 EMMA_explain <- function(res){
-  
+
   emma_rec <- getEMMARecord(res)
-  
+
   function_name <- emma_rec$method$function_name
   pkg_name <- emma_rec$method$package_name
   pkg_version <- emma_rec$method$package_version
   db <- emma_rec$annotation$gene_set_db
   db_version <- emma_rec$annotation$gene_set_db_version
-  
+
   args <- emma_rec$input$arguments
   arg_names <- names(args)
-  
+
   message("You can always complete your text with additional information from `getEMMARecord()`!")
-  
+
   if (emma_rec$method$wrapper) {
     text <- paste0("Functional Enrichment Analysis was performed using a wrapper function ",
                    function_name, "()")
@@ -41,33 +45,33 @@ EMMA_explain <- function(res){
     text <- paste0("Functional Enrichment Analysis was performed using the ",
                    function_name, "() function")
   }
-  
+
   # checks to avoid text with NA
   if (!is.null(pkg_name) && !is.na(pkg_name)) {
     text <- paste0(text, " from the ", pkg_name, " package")
   }
-  
+
   if (!is.null(pkg_version) && !is.na(pkg_version)) {
     text <- paste0(text, " (version ", pkg_version, ")")
   }
-  
+
   if (!is.null(db) && !all(is.na(db))) {
     text <- paste0(text, " with the ",
                   paste(db, collapse = ", "), " database")
   }
-  
+
   if (!is.null(db_version) && !all(is.na(db_version))) {
     text <- paste0(text, " (version ",
                   paste(db_version, collapse = ", "),")")
   }
-  
+
   text <- paste0(text, ".")
-  
+
   ### info abt bg genes
   bg_arg <- intersect(c("universe", "background", "custom_bg", "bg_genes"),
                       arg_names)
   fdr_arg <- intersect(c("correction_method", "pAdjustMethod"), arg_names)
-  
+
   if (length(bg_arg) == 1) {
       text <- paste0(text,
         " A custom background gene set was provided (n = ",
@@ -79,8 +83,8 @@ EMMA_explain <- function(res){
   } else {
     text <- paste0(text, " No custom background gene set was recorded.")
   }
-  
-  
+
+
   ### info abt the fdr correction
   if (length(fdr_arg) == 1) {
     text <- paste0(text,
@@ -94,6 +98,6 @@ EMMA_explain <- function(res){
       text <- paste0(text, " Multiple testing correction was not applied.")
     }
   }
-  
+
   return(text)
-}
\ No newline at end of file
+}
diff --git a/man/EMMA_add_custom_metadata.Rd b/man/EMMA_add_custom_metadata.Rd
index c3849f5..7b092bb 100644
--- a/man/EMMA_add_custom_metadata.Rd
+++ b/man/EMMA_add_custom_metadata.Rd
@@ -26,9 +26,15 @@ captured automatically
 data("de_res_IFNg_vs_naive", package = "EMMA")
 data("universe", package = "EMMA")
 library("clusterProfiler")
-res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
-universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
-ont = "BP"))
-res <- EMMA_add_custom_metadata(res, extra =
-list(note = "The background gene set list was all expressed genes in the assay"))
+res <- EMMA_run(
+  enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+    universe = universe, keyType = "ENSEMBL",
+    OrgDb = org.Hs.eg.db::org.Hs.eg.db,
+    ont = "BP"
+  )
+)
+res <- EMMA_add_custom_metadata(
+  res,
+  extra = list(note = "The background gene set list was all expressed genes in the assay")
+)
 }
diff --git a/man/EMMA_explain.Rd b/man/EMMA_explain.Rd
index 4807582..6e1317a 100644
--- a/man/EMMA_explain.Rd
+++ b/man/EMMA_explain.Rd
@@ -24,9 +24,13 @@ call, the parameters, software context, and reference databases used.
 data("de_res_IFNg_vs_naive", package = "EMMA")
 data("universe", package = "EMMA")
 library("clusterProfiler")
-res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
-universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
-ont = "BP", pAdjustMethod = "BH"))
+res <- EMMA_run(
+  enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+    universe = universe, keyType = "ENSEMBL",
+    OrgDb = org.Hs.eg.db::org.Hs.eg.db,
+    ont = "BP", pAdjustMethod = "BH"
+  )
+)
 EMMA_explain(res)
 
 }
diff --git a/man/EMMA_freeze.Rd b/man/EMMA_freeze.Rd
index 49813f4..0e20767 100644
--- a/man/EMMA_freeze.Rd
+++ b/man/EMMA_freeze.Rd
@@ -11,7 +11,7 @@ EMMA_freeze(project = getwd(), file = "renv.lock", pkgs = loadedNamespaces())
 directory where the lockfile should be written. If the directory does not
 exist, it will be created. It defaults to the current working directory}
 
-\item{file}{Character string refering to the name of the lockfile to generate.
+\item{file}{Character string referring to the name of the lockfile to generate.
 It defaults to "renv.lock"}
 
 \item{pkgs}{Character vector of package names to snapshot. It defaults to all
@@ -32,11 +32,11 @@ recreate the same package environment.
 }
 \examples{
 \dontrun{
-# Create a lockfile in a separate directory
-EMMA_freeze(project = "emma_env")
+  # Create a lockfile in a separate directory
+  EMMA_freeze(project = "emma_env")
 
-# Restore later with renv
-renv::restore(project = "emma_env")
+  # Restore later with renv
+  renv::restore(project = "emma_env")
 }
 }
 \seealso{

From ee0455a4993d7d0f627f13571622fbf904a07171 Mon Sep 17 00:00:00 2001
From: Federico Marini <marinif@uni-mainz.de>
Date: Thu, 30 Apr 2026 16:58:41 +0200
Subject: [PATCH 42/92] suppress all messages in setup of tests

---
 tests/testthat/setuptests_EMMA.R | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/tests/testthat/setuptests_EMMA.R b/tests/testthat/setuptests_EMMA.R
index e73a0fe..d7ad68c 100644
--- a/tests/testthat/setuptests_EMMA.R
+++ b/tests/testthat/setuptests_EMMA.R
@@ -1,8 +1,10 @@
-invisible(lapply(
-  c("clusterProfiler", "org.Hs.eg.db", "mosdef", "topGO", "gprofiler2"),
-  function(pkg) suppressPackageStartupMessages(
-    library(pkg, character.only = TRUE))
-))
+suppressPackageStartupMessages({
+  library("clusterProfiler")
+  library("org.Hs.eg.db")
+  library("mosdef")
+  library("topGO")
+  library("gprofiler2")
+})
 
 data("de_res_IFNg_vs_naive", package = "EMMA")
 data("universe", package = "EMMA")

From 44f92df4fca5892d0fd88a7126e82a6da8c48b70 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 11 May 2026 18:38:41 +0200
Subject: [PATCH 43/92] update build ignore

---
 .Rbuildignore | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.Rbuildignore b/.Rbuildignore
index b7aa75c..2a7eb9b 100644
--- a/.Rbuildignore
+++ b/.Rbuildignore
@@ -7,3 +7,5 @@
 ^_pkgdown\.yml$
 ^docs$
 ^pkgdown$
+^\.positai$
+^\.claude$

From 2349b5562db2c2c252164bba0f80207890a8ef4f Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 11 May 2026 18:39:23 +0200
Subject: [PATCH 44/92] update description file

---
 DESCRIPTION | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/DESCRIPTION b/DESCRIPTION
index a00d977..d09d2f9 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -28,11 +28,10 @@ Description: EMMA is a package that provides a provenance-aware execution
 License: MIT + file LICENSE
 Encoding: UTF-8
 Roxygen: list(markdown = TRUE)
-RoxygenNote: 7.3.3
+RoxygenNote: 8.0.0
 Imports:
-    methods,
     AnnotationDbi,
-    GO.db
+    cli
 Suggests: 
     knitr,
     rmarkdown,
@@ -41,12 +40,15 @@ Suggests:
     clusterProfiler,
     gprofiler2,
     org.Hs.eg.db,
+    GO.db,
     mosdef,
     topGO,
+    renv,
+    DeeDeeExperiment,
     testthat (>= 3.0.0)
 VignetteBuilder: knitr
 URL: https://github.com/imbeimainz/EMMA
 BugReports: https://github.com/imbeimainz/EMMA/issues
 biocViews: Software, Pathways, GO, KEGG, GeneSetEnrichment, ImmunoOncology,
-    ReproducibleResearch, Transcriptomics, SingleCell
+    Transcriptomics, SingleCell, GeneExpression, DifferentialExpression
 Config/testthat/edition: 3

From cc8d9331b43feccca4a8b183f80f415039a4957c Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 11 May 2026 18:41:57 +0200
Subject: [PATCH 45/92] update man page

---
 man/EMMA-pkg.Rd                 |  1 +
 man/EMMA_add_custom_metadata.Rd |  9 ++-----
 man/EMMA_explain.Rd             | 19 +++++++--------
 man/EMMA_freeze.Rd              | 42 +++++++++++++++++++++++++--------
 man/EMMA_get_record.Rd          | 22 +++++++++++++++++
 man/EMMA_run.Rd                 | 14 ++++++-----
 man/fea_res.Rd                  | 32 +++++++++++++++++++++++++
 man/getEMMARecord.Rd            | 27 ---------------------
 man/universe.Rd                 |  2 +-
 9 files changed, 107 insertions(+), 61 deletions(-)
 create mode 100644 man/EMMA_get_record.Rd
 create mode 100644 man/fea_res.Rd
 delete mode 100644 man/getEMMARecord.Rd

diff --git a/man/EMMA-pkg.Rd b/man/EMMA-pkg.Rd
index c4f1850..e3590ec 100644
--- a/man/EMMA-pkg.Rd
+++ b/man/EMMA-pkg.Rd
@@ -23,6 +23,7 @@ Useful links:
 
 Authors:
 \itemize{
+  \item Najla Abassi \email{abassi.nejla96@gmail.com} (\href{https://orcid.org/0000-0001-8357-0938}{ORCID})
   \item Annekathrin Nedwed \email{anneludt@uni-mainz.de} (\href{https://orcid.org/0000-0002-2475-4945}{ORCID})
   \item Federico Marini \email{marinif@uni-mainz.de} (\href{https://orcid.org/0000-0003-3252-7758}{ORCID})
 }
diff --git a/man/EMMA_add_custom_metadata.Rd b/man/EMMA_add_custom_metadata.Rd
index c3849f5..502249f 100644
--- a/man/EMMA_add_custom_metadata.Rd
+++ b/man/EMMA_add_custom_metadata.Rd
@@ -23,12 +23,7 @@ provide additional annotation or contextual information that could not be
 captured automatically
 }
 \examples{
-data("de_res_IFNg_vs_naive", package = "EMMA")
-data("universe", package = "EMMA")
-library("clusterProfiler")
-res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
-universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
-ont = "BP"))
-res <- EMMA_add_custom_metadata(res, extra =
+data("fea_res", package = "EMMA")
+fea_res <- EMMA_add_custom_metadata(fea_res, extra =
 list(note = "The background gene set list was all expressed genes in the assay"))
 }
diff --git a/man/EMMA_explain.Rd b/man/EMMA_explain.Rd
index 4807582..b3f5d4b 100644
--- a/man/EMMA_explain.Rd
+++ b/man/EMMA_explain.Rd
@@ -4,12 +4,16 @@
 \alias{EMMA_explain}
 \title{EMMA_explain}
 \usage{
-EMMA_explain(res)
+EMMA_explain(res, get_citation = TRUE)
 }
 \arguments{
 \item{res}{A functional enrichment analysis results object as returned by
-\code{EMMA_run()}. Its attributes contain \code{EMMA_record}, which
-contains all provenance information of the performed FEA}
+\code{EMMA_run()}. Its attributes contain \code{EMMA_record}, which contains all
+provenance information of the performed FEA}
+
+\item{get_citation}{Logical indicating whether to display the citations of
+the packages used in the FEA. It only prints the citations in an interactive
+session (e.g console). Defaults to \code{TRUE}}
 }
 \value{
 A character string describing how the FEA was performed using the
@@ -21,12 +25,7 @@ to a Materials and Methods section of a paper, by summarizing the executed
 call, the parameters, software context, and reference databases used.
 }
 \examples{
-data("de_res_IFNg_vs_naive", package = "EMMA")
-data("universe", package = "EMMA")
-library("clusterProfiler")
-res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
-universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
-ont = "BP", pAdjustMethod = "BH"))
-EMMA_explain(res)
+data("fea_res", package = "EMMA")
+EMMA_explain(fea_res)
 
 }
diff --git a/man/EMMA_freeze.Rd b/man/EMMA_freeze.Rd
index 49813f4..bb8eca1 100644
--- a/man/EMMA_freeze.Rd
+++ b/man/EMMA_freeze.Rd
@@ -4,7 +4,13 @@
 \alias{EMMA_freeze}
 \title{EMMA_freeze}
 \usage{
-EMMA_freeze(project = getwd(), file = "renv.lock", pkgs = loadedNamespaces())
+EMMA_freeze(
+  project = getwd(),
+  file = "renv.lock",
+  pkgs = loadedNamespaces(),
+  prompt = interactive(),
+  force = TRUE
+)
 }
 \arguments{
 \item{project}{Character string corresponding to the path to the project
@@ -16,27 +22,43 @@ It defaults to "renv.lock"}
 
 \item{pkgs}{Character vector of package names to snapshot. It defaults to all
 currently loaded namespaces via \code{loadedNamespaces()}}
+
+\item{prompt}{Logical indicating whether to prompt before taking actions.
+Defaults to \code{interactive()}}
+
+\item{force}{Logical indicating whether to force creation of the lockfile.
+Defaults to \code{TRUE}}
 }
 \value{
-TODO json file like to create a lock.file?
+Invisibly returns the path to the generated lockfile.
+The lockfile is written in JSON format and can be used with \code{renv::restore()}
+to recreate the package environment
 }
 \description{
-This function records the R environment during analysis runtime and generates
-a lockfile that can be used with tools such as \code{renv}.
-By default, all currently loaded namespaces are recorded.
+This function records the R environment at the time of analysis and generates
+a lockfile that can be used with tools such as \code{renv}
 }
 \details{
 This function calls \code{renv::snapshot()} with the specified packages.
 The resulting lockfile can later be restored with \code{renv::restore()} to
 recreate the same package environment.
+
+By default, the lockfile is created with \code{force = TRUE}, allowing snapshot
+creation even if inconsistencies are detected in the environment.
 }
 \examples{
-\dontrun{
-# Create a lockfile in a separate directory
-EMMA_freeze(project = "emma_env")
+# create a lockfile
+if (requireNamespace("renv", quietly = TRUE)) {
+tmp <- tempfile("emma_env")
+dir.create(tmp)
+
+EMMA_freeze(project = tmp)
+
+# inspect generated files
+list.files(tmp)
 
-# Restore later with renv
-renv::restore(project = "emma_env")
+# to restore the environment later
+# renv::restore(project = tmp)
 }
 }
 \seealso{
diff --git a/man/EMMA_get_record.Rd b/man/EMMA_get_record.Rd
new file mode 100644
index 0000000..a2c2617
--- /dev/null
+++ b/man/EMMA_get_record.Rd
@@ -0,0 +1,22 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/EMMA_get_record.R
+\name{EMMA_get_record}
+\alias{EMMA_get_record}
+\title{EMMA_get_record}
+\usage{
+EMMA_get_record(res)
+}
+\arguments{
+\item{res}{Functional Enrichment Analysis results (enrichResult, gseaResult ...)
+generated by \code{EMMA_run()}}
+}
+\value{
+list of metadata recorded during FEA runtime
+}
+\description{
+EMMA_get_record
+}
+\examples{
+data("fea_res", package = "EMMA")
+EMMA_get_record(fea_res)
+}
diff --git a/man/EMMA_run.Rd b/man/EMMA_run.Rd
index caed5d4..72dee43 100644
--- a/man/EMMA_run.Rd
+++ b/man/EMMA_run.Rd
@@ -7,7 +7,7 @@
 EMMA_run(
   expr,
   envir = parent.frame(),
-  session = TRUE,
+  store_session_info = TRUE,
   args_form = c("evaluated", "unevaluated")
 )
 }
@@ -19,7 +19,7 @@ namespace-qualified calls (\code{clusterProfiler::enrichGO(...)}) are supported.
 
 \item{envir}{An environment in which to evaluate \code{expr}}
 
-\item{session}{Logical, indicating whether to store the output of
+\item{store_session_info}{Logical, indicating whether to store the output of
 \code{sessionInfo()} or not. If \code{TRUE} (default), the session is stored in the
 provenance record}
 
@@ -30,7 +30,7 @@ or the unevaluated arguments in the provenance record. It default to
 \value{
 The result object returned by the enrichment function in \code{expr},
 in standard format, with an additional \code{EMMA_record} attribute containing the
-provenance information. Use \code{getEMMARecord()} to retrieve this record
+provenance information. Use \code{EMMA_get_record()} to retrieve this record
 }
 \description{
 This function executes any functional enrichment analysis function and
@@ -47,7 +47,9 @@ internally invoke a know enrichment function.
 \examples{
 data("de_res_IFNg_vs_naive", package = "EMMA")
 data("universe", package = "EMMA")
-EMMA_run(clusterProfiler::enrichGO(gene = rownames(de_res_IFNg_vs_naive),
-universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
-ont = "BP"))
+library(gprofiler2)
+
+EMMA_run(gost(query = de_res_IFNg_vs_naive$SYMBOL, organism = "hsapiens",
+correction_method = "fdr", custom_bg = universe, sources = "GO:BP"),
+store_session_info = FALSE, args_form = "unevaluated")
 }
diff --git a/man/fea_res.Rd b/man/fea_res.Rd
new file mode 100644
index 0000000..b08224c
--- /dev/null
+++ b/man/fea_res.Rd
@@ -0,0 +1,32 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/EMMA-data.R
+\docType{data}
+\name{fea_res}
+\alias{fea_res}
+\title{A sample \code{list} containing Functional Enrichment Analysis results,
+generated with \code{gprofiler2}}
+\format{
+A \code{list}
+}
+\value{
+A sample \code{list} containing the FEA results \code{result} and \code{metadata}.
+This results object has the \code{EMMA_record} attribute.
+}
+\description{
+A sample \code{list} containing Functional Enrichment Analysis results,
+generated with \code{gprofiler2}
+}
+\details{
+This \code{list} object contains the result table and metadata of the
+functional enrichment analysis (FEA) performed on the \code{macrophage} data,
+specifically using the \code{gost()} function from the \code{gprofiler2} package, and
+wrapped in \code{EMMA_run()}
+
+The code to create said object can be found in the folder \verb{/inst/scripts} in
+the EMMA package, the file is called \code{create_datasets_examples.R}.
+}
+\references{
+Alasoo, et al. "Shared genetic effects on chromatin and gene
+expression indicate a role for enhancer priming in immune response",
+Nature Genetics, January 2018 doi: 10.1038/s41588-018-0046-7.
+}
diff --git a/man/getEMMARecord.Rd b/man/getEMMARecord.Rd
deleted file mode 100644
index 3d55b1f..0000000
--- a/man/getEMMARecord.Rd
+++ /dev/null
@@ -1,27 +0,0 @@
-% Generated by roxygen2: do not edit by hand
-% Please edit documentation in R/getEMMARecord.R
-\name{getEMMARecord}
-\alias{getEMMARecord}
-\title{getEMMARecord}
-\usage{
-getEMMARecord(res)
-}
-\arguments{
-\item{res}{Functional Enrichment Analysis results (enrichResult, gseaResult ...)
-generated by \code{EMMA_run()}}
-}
-\value{
-list of metadata recorded during FEA runtime
-}
-\description{
-getEMMARecord
-}
-\examples{
-data("de_res_IFNg_vs_naive", package = "EMMA")
-data("universe", package = "EMMA")
-library("clusterProfiler")
-res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
-universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
-ont = "BP"))
-getEMMARecord(res)
-}
diff --git a/man/universe.Rd b/man/universe.Rd
index 7a7e772..aae40db 100644
--- a/man/universe.Rd
+++ b/man/universe.Rd
@@ -17,7 +17,7 @@ A sample \verb{character vector} containing the background gene list used to
 perform FEA on the \code{macrophage} dataset
 }
 \details{
-This \verb{character vector} object that contains the assay's \code{rownames}
+This \verb{character vector} object contains the assay's \code{rownames}
 of the \code{macrophage} data
 
 The code to create said object can be found in the folder \verb{/inst/scripts} in

From 91064d2c68b5b7cde7d797955efe38c37a47b7f7 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 11 May 2026 18:42:51 +0200
Subject: [PATCH 46/92] expending vignette

---
 vignettes/EMMA_bibliography.bib    |  80 ++++++++++-
 vignettes/Introduction_to_EMMA.Rmd | 204 +++++++++++++++++------------
 2 files changed, 199 insertions(+), 85 deletions(-)

diff --git a/vignettes/EMMA_bibliography.bib b/vignettes/EMMA_bibliography.bib
index 1c783b0..5cd3758 100644
--- a/vignettes/EMMA_bibliography.bib
+++ b/vignettes/EMMA_bibliography.bib
@@ -13,4 +13,82 @@ @article{Alasoo2018
 url = {http://dx.doi.org/10.1038/s41588-018-0046-7},
 volume = {50},
 year = {2018}
-}
\ No newline at end of file
+}
+
+@article{Khatri2012,
+  title = {Ten Years of Pathway Analysis: Current Approaches and Outstanding Challenges},
+  volume = {8},
+  ISSN = {1553-7358},
+  url = {http://dx.doi.org/10.1371/journal.pcbi.1002375},
+  DOI = {10.1371/journal.pcbi.1002375},
+  number = {2},
+  journal = {PLoS Computational Biology},
+  publisher = {Public Library of Science (PLoS)},
+  author = {Khatri,  Purvesh and Sirota,  Marina and Butte,  Atul J.},
+  editor = {Ouzounis,  Christos A.},
+  year = {2012},
+  month = Feb,
+  pages = {e1002375}
+}
+
+@article{Subramanian2005,
+  title = {Gene set enrichment analysis: A knowledge-based approach for interpreting genome-wide expression profiles},
+  volume = {102},
+  ISSN = {1091-6490},
+  url = {http://dx.doi.org/10.1073/pnas.0506580102},
+  DOI = {10.1073/pnas.0506580102},
+  number = {43},
+  journal = {Proceedings of the National Academy of Sciences},
+  publisher = {Proceedings of the National Academy of Sciences},
+  author = {Subramanian,  Aravind and Tamayo,  Pablo and Mootha,  Vamsi K. and Mukherjee,  Sayan and Ebert,  Benjamin L. and Gillette,  Michael A. and Paulovich,  Amanda and Pomeroy,  Scott L. and Golub,  Todd R. and Lander,  Eric S. and Mesirov,  Jill P.},
+  year = {2005},
+  month = Sept,
+  pages = {15545–15550}
+}
+
+@article{Wijesooriya2022,
+  title = {Urgent need for consistent standards in functional enrichment analysis},
+  volume = {18},
+  ISSN = {1553-7358},
+  url = {http://dx.doi.org/10.1371/journal.pcbi.1009935},
+  DOI = {10.1371/journal.pcbi.1009935},
+  number = {3},
+  journal = {PLOS Computational Biology},
+  publisher = {Public Library of Science (PLoS)},
+  author = {Wijesooriya,  Kaumadi and Jadaan,  Sameer A. and Perera,  Kaushalya L. and Kaur,  Tanuveer and Ziemann,  Mark},
+  editor = {Kemp,  Melissa L.},
+  year = {2022},
+  month = Mar,
+  pages = {e1009935}
+}
+
+@article{Brazma2001,
+  title = {Minimum information about a microarray experiment (MIAME)—toward standards for microarray data},
+  volume = {29},
+  ISSN = {1546-1718},
+  url = {http://dx.doi.org/10.1038/ng1201-365},
+  DOI = {10.1038/ng1201-365},
+  number = {4},
+  journal = {Nature Genetics},
+  publisher = {Springer Science and Business Media LLC},
+  author = {Brazma,  Alvis and Hingamp,  Pascal and Quackenbush,  John and Sherlock,  Gavin and Spellman,  Paul and Stoeckert,  Chris and Aach,  John and Ansorge,  Wilhelm and Ball,  Catherine A. and Causton,  Helen C. and Gaasterland,  Terry and Glenisson,  Patrick and Holstege,  Frank C.P. and Kim,  Irene F. and Markowitz,  Victor and Matese,  John C. and Parkinson,  Helen and Robinson,  Alan and Sarkans,  Ugis and Schulze-Kremer,  Steffen and Stewart,  Jason and Taylor,  Ronald and Vilo,  Jaak and Vingron,  Martin},
+  year = {2001},
+  month = Dec,
+  pages = {365–371}
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/vignettes/Introduction_to_EMMA.Rmd b/vignettes/Introduction_to_EMMA.Rmd
index 5416a15..c34b6b1 100644
--- a/vignettes/Introduction_to_EMMA.Rmd
+++ b/vignettes/Introduction_to_EMMA.Rmd
@@ -34,13 +34,19 @@ editor_options:
 bibliography: EMMA_bibliography.bib
 ---
 
-```{r, include = FALSE}
+<style type="text/css">
+.smaller {
+  font-size: 10px
+}
+</style>
+
+```{r knitr, include = FALSE}
 knitr::opts_chunk$set(
-  comment  = "#>",
-  error    = FALSE,
-  warning  = FALSE,
-  eval     = TRUE,
-  message  = FALSE
+  comment   = "#>",
+  error     = FALSE,
+  warning   = FALSE,
+  eval      = TRUE,
+  message   = FALSE
 )
 ```
 
@@ -49,24 +55,30 @@ knitr::opts_chunk$set(
 Functional Enrichment Analysis (FEA) is a key downstream step in omics workflows,
 commonly applied after differential expression analysis to support biological
 interpretation and generate pathway-level hypotheses. A wide range of tools and
-methods are available, leading to substantial heterogeneity in analytical choices
-and reported results.
-
-Despite its widespread use, FEA is often insufficiently documented. Critical
-parameters such as background gene sets or multiple testing correction methods
-are frequently missing or inconsistently reported in scientific papers,
-limiting reproducibility and interpretability. Currently, no standardized method
-exists to ensure transparent and reproducible documentation of FEA workflows.
+methods are available, mainly Over-Representation Analysis (ORA) [@Khatri2012] [doi:10.1371/journal.pcbi.1002375](https://doi.org/10.1371/journal.pcbi.1002375)
+and Gene Set Enrichment Analysis (GSEA) [@Subramanian2005] [doi:10.1073/pnas.0506580102](https://doi.org/10.1073/pnas.0506580102), leading
+to substantial heterogeneity in analytical choices and reported results.
+
+Despite its widespread use, FEA is often insufficiently documented [@Wijesooriya2022] 
+[doi:10.1371/journal.pcbi.1009935](https://doi.org/10.1371/journal.pcbi.1009935).
+Critical parameters such as background gene sets or multiple testing correction
+methods are frequently missing or inconsistently reported in scientific papers,
+limiting reproducibility and interpretability. Currently, no standardized framework
+exists to ensure transparent and reproducible documentation of FEA workflows,
+comparable to the MIAME guidelines [@Brazma2001] 
+[doi:10.1038/ng1201-365]( https://doi.org/10.1038/ng1201-365).
 
 To address this gap, we introduce `r BiocStyle::Biocpkg("EMMA")`, a framework
 that automatically captures key analytical parameters and provenance information
 during the execution of FEA methods.
 
 This vignette demonstrates how `EMMA` integrates with existing tools
-(e.g. `clusterProfiler`, `topGO`, `Enrichr`, `gprofiler2`) to execute enrichment
+(e.g. `r BiocStyle::Biocpkg("clusterProfiler")`,
+`r BiocStyle::Biocpkg("topGO")`, `r BiocStyle::Biocpkg("Enrichr")`, 
+`r BiocStyle::Biocpkg("gprofiler2")`) to execute enrichment
 analyses while systematically capturing analysis parameters and provenance
-information during runtime, and returning enrichment results in their native
-format alongside structured and reusable metadata.
+information during runtime, returning enrichment results
+**without altering their original format**, alongside structured and reusable metadata. 
 
 ## What do you get with `EMMA`?
 
@@ -78,15 +90,30 @@ Using `EMMA` allows you to:
 * Generate reproducible summaries of the analysis (e.g. Methods sections)
 * Facilitate sharing of results together with their analysis context
 
+## How does `EMMA` work?
+
+`EMMA` works by wrapping an enrichment call, executing it, and capturing relevant
+provenance information and parameters during runtime. The recorded metadata is then
+attached directly to the result object using R’s **attribute system**.
+
+This approach enables `EMMA` to preserve provenance information
+**without modifying the original result structure or introducing new classes**, 
+allowing users to continue working seamlessly with standard outputs from existing tools.
+
+While Bioconductor provides dedicated metadata slots for certain S4 classes
+(e.g. via `metadata()`), these are not consistently available across all enrichment
+result types. By relying on attributes, provenance information can be attached
+to any result object regardless of its underlying class.
+
 # Getting started {#gettingstarted}
 
-To install the development version of this package, start R and enter:
+To install this package, start R and enter:
 
 ```{r install, eval = FALSE}
-library("remotes")
-remotes::install_github("imbeimainz/EMMA",
-                        dependencies = TRUE,
-                        build_vignettes = TRUE)
+if (!requireNamespace("BiocManager", quietly = TRUE)) {
+  install.packages("BiocManager")}
+
+BiocManager::install("EMMA")
 ```
 
 Once installed, the package can be loaded and attached to the current workspace
@@ -96,12 +123,25 @@ as follows:
 library("EMMA")
 ```
 
+
+# A new section here: TODO?
+
+MAybe where we describe a schematics of the intuition overall?
+Like: stepwise with bullet point
+- run DE
+- run FEA as usual, passing the call (with a pipe or in a call itself) to EMMA_run
+- show how to retrieve info (just the names)
+- summarizing the info
+- explaining it
+(in my eyes, a "chunk not evaluated could be also good") + a figure would be fantastic with a simple diagram?
+Maybe a diagram that would show what EMMA puts in and avoids you to take notes of?
+
+
 # `EMMA` on the `macrophage` dataset
 
-In the remainder of this vignette, we will illustrate the main features of `r BiocStyle::Biocpkg("EMMA")` on a publicly available dataset from
-Alasoo, et al. "Shared genetic effects on chromatin and gene expression indicate
-a role for enhancer priming in immune response", published in Nature Genetics,
-January 2018 
+In the remainder of this vignette, we will illustrate the main features of `r BiocStyle::Biocpkg("EMMA")` on a publicly available dataset from Alasoo, et al. "Shared genetic effects on chromatin
+and gene expression indicate a role for enhancer priming in immune response",
+published in Nature Genetics, January 2018 
 [@Alasoo2018] [doi:10.1038/s41588-018-0046-7](https://doi.org/10.1038/s41588-018-0046-7).
 
 The data is made available via the `r BiocStyle::Biocpkg("macrophage")`
@@ -135,7 +175,7 @@ regular bulk RNA-seq data analysis workflow.
 For this, we will load the `macrophage` data and perform Differential Expression
 Analysis with `r BiocStyle::Biocpkg("DESeq2")`
 
-```{r dds}
+```{r differential_expression}
 # load data
 data(gse, "macrophage")
 # set up design
@@ -145,23 +185,10 @@ rownames(dds_macrophage) <- substr(rownames(dds_macrophage), 1, 15)
 keep <- rowSums(counts(dds_macrophage) >= 10) >= 6
 
 dds_macrophage <- dds_macrophage[keep, ]
-dds_macrophage
-```
-
-We then run the main `DESeq()` function and check the `resultsNames` being
-generated:
 
-```{r run_deseq}
 # run DESeq
 dds_macrophage <- DESeq(dds_macrophage)
-# contrasts
-resultsNames(dds_macrophage)
-```
-
-Let's extract the DE results for each contrast. For the sake of demonstration,
-we will do one contrast:
 
-```{r get_de_res}
 # get de res for 1st contrast
 IFNg_vs_naive <- results(dds_macrophage,
                          contrast = c("condition", "IFNg", "naive"),
@@ -170,21 +197,16 @@ IFNg_vs_naive <- lfcShrink(dds_macrophage, coef = "condition_IFNg_vs_naive",
                            res = IFNg_vs_naive,
                            type = "apeglm")
 IFNg_vs_naive$SYMBOL <- rowData(dds_macrophage)$SYMBOL
-IFNg_vs_naive
-```
-
-Now we'll sort the results based on the adjusted p-value:
 
-```{r DEGs}
-# sort
+# sort by adjusted p value
 de_res <- IFNg_vs_naive[order(IFNg_vs_naive$padj), ]
 de_res <- de_res[!(is.na(de_res$padj)) & de_res$padj <= 0.05, ]
 
-# set universe
-universe <- rownames(dds_macrophage)
+# set background gene list
+gene_universe <- rownames(dds_macrophage)
 ```
 
-# Perform Functional Enrichment Analysis (FEA)
+# Perform Functional Enrichment Analysis (FEA) 
 
 ## `EMMA` with available common packages/functions
 
@@ -192,7 +214,7 @@ Now that we have a list of DE genes for this contrast, we can perform Functional
 Enrichment Analysis. In the following example, we will use the
 function `enrichGO()` from `r BiocStyle::Biocpkg("clusterProfiler")`
 
-### Capturing record with `EMMA_run()`
+### `EMMA_run()` :Capturing the recorded information
 
 `EMMA_run()` accepts a function call (e.g. `enrichGO(...)`) and executes it as
 it is, while capturing the associated parameters and provenance information:
@@ -232,7 +254,7 @@ As you can see, `EMMA` returns the FEA results in their **native/standard** form
 example, we didn't define a list of background genes (which can influence the 
 results), so we get warned about that.
 
-### Retrieving recorded information with `getEMMARecord()` & `EMMA_show()`
+### `EMMA_show()` : Summarizing the recorded information
 
 To get a quick summary of what `EMMA` captured while we ran the analysis, we use
 `EMMA_show()`:
@@ -245,10 +267,12 @@ EMMA_show(fea_res)
 results object. That's why it is always a good practice to save the original
 results, and not only the subsets of interest.
 
-To access the full recorded information, we use `getEMMARecord()`:
+### `EMMA_get_record()` : Retrieving the recorded information
+
+To access the full recorded information, we use `EMMA_get_record()`:
 
-```{r getEMMARecord}
-emma_record <- getEMMARecord(fea_res)
+```{r EMMA_get_record}
+emma_record <- EMMA_get_record(fea_res)
 
 # get all the record
 emma_record
@@ -257,7 +281,7 @@ emma_record
 `EMMA` structures the `EMMA_record` attribute (i.e. the recorded provenance
 information) into a list of elements:
 
-```{EMMA_record_str}
+```{bash EMMA_record_str, eval=FALSE}
 ├── EMMA_record
 │   ├── method         # how the analysis was performed
 │   │   ├── call
@@ -285,11 +309,12 @@ emma_record$method
 ```
 
 With `EMMA_run()`, we can decide whether we want to save the value of arguments
-used in our call or not. For this, we can use the argument `args_form`:
+used in our call or not. This can be useful, for example, to avoid unnecessarily
+increasing the size of the result object. For this, we can use the argument `args_form`:
 
 ```{r argument_form}
 fea_res_no_param <- enrichGO(gene = rownames(de_res),
-                             universe = universe,
+                             universe = gene_universe,
                              keyType = "ENSEMBL",
                              OrgDb = org.Hs.eg.db,
                              ont = "BP",
@@ -301,20 +326,20 @@ fea_res_no_param <- enrichGO(gene = rownames(de_res),
                                       # else set to evaluated (default)
 
 # check
-getEMMARecord(fea_res_no_param)
+EMMA_get_record(fea_res_no_param)
 ```
 
 We can also choose whether to save the R session information with the record
-using the argument `session`, which defaults to `TRUE`.
+using the argument `store_session_info`, which defaults to `TRUE`.
 
-### Summarizing captured information into text
+### `EMMA_explain()`: Summarizing recorded information into text
 
 `EMMA_explain()` generates a human-readable description of the FEA, similar
 to a Materials and Methods section of a paper, by summarizing the executed call,
 the parameters, software context, and reference databases used.
 
-```{r EMMA_explain}
-EMMA_explain(fea_res)
+```{r EMMA_explain, results = 'asis', message=TRUE}
+EMMA_explain(fea_res, get_citation = TRUE)
 ```
 
 ## `EMMA` with custom/wrapper functions
@@ -324,15 +349,16 @@ You can also use a custom function that you developed, or a wrapper function
 `EMMA_run()` will attempt to capture as much metadata as possible:
 
 ```{r mosdef_eg}
-fea_res <- mosdef::run_goseq(de_genes = rownames(de_res),
-                             bg_genes = universe,
+mosdef_fea_res <- mosdef::run_goseq(de_genes = rownames(de_res),
+                             bg_genes = gene_universe,
                              mapping = "org.Hs.eg.db",
                              id = "ensGene",
-                             genome = "hg19") |> EMMA_run(session = FALSE,
-                                                          args_form = "unevaluated")
+                             genome = "hg19") |> 
+  EMMA_run(store_session_info = FALSE,
+           args_form = "unevaluated")
 
 # quick inspection
-getEMMARecord(fea_res)
+EMMA_get_record(mosdef_fea_res)
 ```
 
 ```{r custom_eg}
@@ -343,7 +369,7 @@ my_custom_function <- function(gene, universe = NULL,
                                organism = "hsapiens") {
   # a wrapper of a wrapper :D
   res1 <- mosdef::run_topGO(de_genes = gene,
-                            bg_genes = universe,
+                            bg_genes = gene_universe,
                             ontology = ontology,
                             gene_id = id_type,
                             mapping = org_db_name,
@@ -351,7 +377,7 @@ my_custom_function <- function(gene, universe = NULL,
 
   res2 <- gprofiler2::gost(query = gene,
                            organism = organism,
-                           custom_bg = universe)
+                           custom_bg = gene_universe)
 
   return(list(topGO_res = res1,
               gost_res = res2
@@ -361,31 +387,31 @@ my_custom_function <- function(gene, universe = NULL,
 # run analysis with EMMA
 frankenstein_fea <- my_custom_function(
   gene = rownames(de_res),
-  universe = universe,
+  universe = gene_universe,
   ontology = "BP",
   id_type = "ENSEMBL",
   org_db_name = "org.Hs.eg.db",
   organism = "hsapiens"
-  ) |> EMMA_run(session = FALSE, args_form = "unevaluated") 
+  ) |> EMMA_run(store_session_info = FALSE,
+                args_form = "unevaluated") 
 
 # quick inspection
-getEMMARecord(frankenstein_fea)
+EMMA_get_record(frankenstein_fea)
 ```
 
-# Adding extra information
+# `EMMA_add_custom_metadata()`: Adding extra information
 
 The user can always attach extra metadata that `EMMA` might not be able to
 capture automatically. To keep everything organized, we can use
 `EMMA_add_custom_metadata()` function
 
 ```{r add_custom_metadata}
-
-frankenstein_fea <- EMMA_add_custom_metadata(res = frankenstein_fea,
+frankenstein_fea2 <- EMMA_add_custom_metadata(res = frankenstein_fea,
                                              extra = list(
                                                wrapped_function_topGO = "runTest",
                                                notes = "any other meaningful info"))
 
-getEMMARecord(frankenstein_fea)$extra
+EMMA_get_record(frankenstein_fea2)$extra
 ```
 
 Since the `EMMA_record` is attached as attribute to the original results objects,
@@ -394,8 +420,7 @@ such as `DeeDeeExperiment`. This enables both FEA results and
 their associated provenance information to be stored and managed together,
 facilitating reproducibility, organization, and sharing of complex omics analyses.
 
-```{r emma&dde, eval=FALSE}
-#### should we have this chunk runnable and suggest dde?
+```{r emma_and_dde}
 dde <- DeeDeeExperiment::DeeDeeExperiment(sce = dds_macrophage,
                                           de_results = IFNg_vs_naive,
                                           enrich_results =  list(
@@ -403,18 +428,29 @@ dde <- DeeDeeExperiment::DeeDeeExperiment(sce = dds_macrophage,
 
 fea <- DeeDeeExperiment::getFEA(dde, format = "original")
 
-getEMMARecord(fea)
+EMMA_get_record(fea)
 ```
 
+# `EMMA_freeze()`: Recording the Analysis Environment
 
-# Recording the Analysis Environment with `EMMA_freeze()`
+`EMMA_freeze()` records the R environment at the time of analysis by generating
+a lockfile using `renv`. By default, the snapshot is created with `force = TRUE`,
+allowing the environment to be recorded even when inconsistencies (e.g. version
+mismatches) are present.
 
-`EMMA_freeze()` records the R environment during analysis runtime and generates
-a lockfile that can be used with tools such as `renv`, to facilitate
-reproducible reconstruction of the analysis environment.
+This behavior reflects the goal of preserving the analysis environment as it was
+used in practice, rather than attempting to enforce a fully consistent state.
 
 ```{r EMMA_freeze}
-#EMMA_freeze()
+if (requireNamespace("renv", quietly = TRUE)) {
+   project_path <- tempfile("my_project_with_emma")
+   dir.create(project_path)
+EMMA_freeze(project = project_path,
+            file = "analysis.lock",
+            pkgs = loadedNamespaces(),
+            prompt = FALSE,
+            force = TRUE)
+}
 ```
 
 # Session info {.unnumbered .smaller}

From 5cfe8f2ed88fa65b08b44d86d26810a545796a22 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 11 May 2026 18:43:17 +0200
Subject: [PATCH 47/92] adding toy fea created with EMMA_run

---
 R/EMMA-data.R | 30 +++++++++++++++++++++++++++---
 1 file changed, 27 insertions(+), 3 deletions(-)

diff --git a/R/EMMA-data.R b/R/EMMA-data.R
index 2d8b7ea..c66f05f 100644
--- a/R/EMMA-data.R
+++ b/R/EMMA-data.R
@@ -13,7 +13,6 @@
 #'
 #' @format A `data.frame` object
 #'
-#'
 #' @references Alasoo, et al. "Shared genetic effects on chromatin and gene
 #' expression indicate a role for enhancer priming in immune response",
 #' Nature Genetics, January 2018 doi: 10.1038/s41588-018-0046-7.
@@ -25,7 +24,7 @@ NULL
 #' A sample `character vector` containing the background gene list used to
 #' perform FEA on the `macrophage` dataset
 #'
-#' @details This `character vector` object that contains the assay's `rownames`
+#' @details This `character vector` object contains the assay's `rownames`
 #' of the `macrophage` data
 #'
 #' The code to create said object can be found in the folder `/inst/scripts` in
@@ -43,4 +42,29 @@ NULL
 #'
 #' @name universe
 #' @docType data
-NULL
\ No newline at end of file
+NULL
+
+#' A sample `list` containing Functional Enrichment Analysis results,
+#' generated with `gprofiler2`
+#'
+#' @details This `list` object contains the result table and metadata of the
+#' functional enrichment analysis (FEA) performed on the `macrophage` data,
+#' specifically using the `gost()` function from the `gprofiler2` package, and
+#' wrapped in `EMMA_run()`
+#'
+#' The code to create said object can be found in the folder `/inst/scripts` in
+#' the EMMA package, the file is called `create_datasets_examples.R`.
+#'
+#' @return A sample `list` containing the FEA results `result` and `metadata`.
+#' This results object has the `EMMA_record` attribute.
+#'
+#' @format A `list`
+#'
+#'
+#' @references Alasoo, et al. "Shared genetic effects on chromatin and gene
+#' expression indicate a role for enhancer priming in immune response",
+#' Nature Genetics, January 2018 doi: 10.1038/s41588-018-0046-7.
+#'
+#' @name fea_res
+#' @docType data
+NULL

From 61cf847cc742517f359e7a494dec231f97edb0ff Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 11 May 2026 18:47:47 +0200
Subject: [PATCH 48/92] beautify msgs with cli

---
 R/EMMA-pkg.R            | 1 +
 R/EMMA_explain.R        | 5 ++++-
 R/EMMA_freeze.R         | 2 ++
 R/EMMA_internal-utils.R | 6 +++---
 R/EMMA_run.R            | 4 +++-
 R/EMMA_show.R           | 2 +-
 6 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/R/EMMA-pkg.R b/R/EMMA-pkg.R
index 8af20dd..b11a174 100644
--- a/R/EMMA-pkg.R
+++ b/R/EMMA-pkg.R
@@ -7,6 +7,7 @@
 #' @import GO.db
 #' @importFrom AnnotationDbi metadata
 #' @importFrom utils packageVersion sessionInfo
+#' @importFrom cli cli_alert_info
 #' @name EMMA-pkg
 #' @docType package
 "_PACKAGE"
diff --git a/R/EMMA_explain.R b/R/EMMA_explain.R
index e915f93..e86cf61 100644
--- a/R/EMMA_explain.R
+++ b/R/EMMA_explain.R
@@ -32,7 +32,10 @@ EMMA_explain <- function(res){
   args <- emma_rec$input$arguments
   arg_names <- names(args)
   
-  message("You can always complete your text with additional information from `getEMMARecord()`!")
+  cli::cli_alert_info(
+    "You can always complete your text with additional information from `getEMMARecord()`!"
+  )
+  
   
   if (emma_rec$method$wrapper) {
     text <- paste0("Functional Enrichment Analysis was performed using a wrapper function ",
diff --git a/R/EMMA_freeze.R b/R/EMMA_freeze.R
index c71e18c..3e42e3d 100644
--- a/R/EMMA_freeze.R
+++ b/R/EMMA_freeze.R
@@ -43,4 +43,6 @@ EMMA_freeze <- function(project = getwd(),
   #   packages = pkgs
   # )
   # 
+  cli::cli_alert_info(
+    "Environment snapshot saved to: {.val {lockfile}}. \nTo recreate this environment, use `renv::restore()`.")
 }
\ No newline at end of file
diff --git a/R/EMMA_internal-utils.R b/R/EMMA_internal-utils.R
index e532c10..a635449 100644
--- a/R/EMMA_internal-utils.R
+++ b/R/EMMA_internal-utils.R
@@ -254,9 +254,9 @@ EMMA_get_custom_metadata <- function(call_class, args,
   
   if (call_class$type == "custom") {
     # if 100% custom
-    message("You used a custom function, so `EMMA` wasn't able to record annotation-",
-            "related information. Please consider adding the `organism`, `geneset database`",
-            " and its `version` manually into the `extra` field in EMMA_record.")
+    cli::cli_alert_info(
+      "You used a custom function, so `EMMA` wasn't able to record annotation-related information. Please consider adding the `organism`, `geneset database` and its `version` manually into the `extra` field in EMMA_record using EMMA_add_custom_metadata.")
+    
     return(meta)
   }
   
diff --git a/R/EMMA_run.R b/R/EMMA_run.R
index c3e72cd..7c1fc14 100644
--- a/R/EMMA_run.R
+++ b/R/EMMA_run.R
@@ -77,7 +77,9 @@ EMMA_run <- function(expr,
   
   #capture analysis time
   start_time <- Sys.time()
-  message("Running Enrichment Analysis with ", function_name, " ...") 
+  
+  cli::cli_alert_info(
+    "Running Enrichment Analysis with  {.val {function_name}} ...")
   
   # capture the value of the arguments
   args <- lapply(arg_list, eval, envir = envir)
diff --git a/R/EMMA_show.R b/R/EMMA_show.R
index 5bfaca0..6d57a6d 100644
--- a/R/EMMA_show.R
+++ b/R/EMMA_show.R
@@ -20,7 +20,7 @@
 EMMA_show <- function(res){
   
   if ("EMMA_record" %in% names(attributes(res))) {
-    message("Found EMMA record!")
+    cli::cli_alert_info("Found EMMA record!")
     
     emma_rec <- getEMMARecord(res)
     

From f57080fe3641f86fcce01a5e261d0d84d680f6a5 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 11 May 2026 18:50:02 +0200
Subject: [PATCH 49/92] upding the internal functions nomenclature to use the
 dot before the name

---
 R/EMMA_internal-utils.R | 101 +++++++++++++++++++---------------------
 R/EMMA_run.R            |   8 ++--
 2 files changed, 53 insertions(+), 56 deletions(-)

diff --git a/R/EMMA_internal-utils.R b/R/EMMA_internal-utils.R
index a635449..0db2ae1 100644
--- a/R/EMMA_internal-utils.R
+++ b/R/EMMA_internal-utils.R
@@ -4,7 +4,7 @@
 #' different enrichment methods and packages
 #' 
 #' @noRd
-EMMA_empty_metadata <- function() { 
+.EMMA_empty_metadata <- function() { 
   list(
     organism = NA_character_,
     gene_set_db = NA_character_,
@@ -29,7 +29,7 @@ EMMA_empty_metadata <- function() {
 #' metadata structure if no package-specific method is available
 #'
 #' @noRd
-EMMA_get_metadata <- function(call_class,
+.EMMA_get_metadata <- function(call_class,
                               args,
                               envir = parent.frame()) {
   info_call <- call_class$info_call
@@ -37,7 +37,7 @@ EMMA_get_metadata <- function(call_class,
   package_name <- info_call$package_name
   call <- info_call$call
   
-  meta <- EMMA_empty_metadata()
+  meta <- .EMMA_empty_metadata()
   
   if (is.null(package_name) || is.na(package_name) || package_name == "") {
     package_name <- "custom"
@@ -45,10 +45,10 @@ EMMA_get_metadata <- function(call_class,
   
   meta <- switch(
     package_name,
-    clusterProfiler = EMMA_get_clusterprofiler_metadata(function_name, args),
-    gprofiler2      = EMMA_get_gprofiler2_metadata(args),
-    mosdef          = EMMA_cp_GO_metadata(args$mapping),
-    custom          = EMMA_get_custom_metadata(call_class,
+    clusterProfiler = .EMMA_get_clusterprofiler_metadata(function_name, args),
+    gprofiler2      = .EMMA_get_gprofiler2_metadata(args),
+    mosdef          = .EMMA_cp_GO_metadata(args$mapping),
+    custom          = .EMMA_get_custom_metadata(call_class,
                                                args,
                                                envir = parent.frame())
   )
@@ -71,15 +71,15 @@ EMMA_get_metadata <- function(call_class,
 #' and its version), depending on the underlying database used (e.g. GO vs KEGG)
 #'
 #' @noRd
-EMMA_get_clusterprofiler_metadata <- function(function_name, args) {
+.EMMA_get_clusterprofiler_metadata <- function(function_name, args) {
   switch(
     function_name,
-    enrichGO   = EMMA_cp_GO_metadata(args$OrgDb),
-    gseGO = EMMA_cp_GO_metadata(args$OrgDb),
-    groupGO = EMMA_cp_GO_metadata(args$OrgDb),
-    enrichKEGG = EMMA_cp_KEGG_metadata(args),
-    gseKEGG = EMMA_cp_KEGG_metadata(args),
-    EMMA_empty_metadata()
+    enrichGO   = .EMMA_cp_GO_metadata(args$OrgDb),
+    gseGO = .EMMA_cp_GO_metadata(args$OrgDb),
+    groupGO = .EMMA_cp_GO_metadata(args$OrgDb),
+    enrichKEGG = .EMMA_cp_KEGG_metadata(args),
+    gseKEGG = .EMMA_cp_KEGG_metadata(args),
+    .EMMA_empty_metadata()
     # more to be added
   )
 }
@@ -93,7 +93,7 @@ EMMA_get_clusterprofiler_metadata <- function(function_name, args) {
 #' and returns `NA_character_` if the organism cannot be determined
 #'
 #' @noRd
-EMMA_get_organism_from_OrgDb <- function(orgdb) {
+.EMMA_get_organism_from_OrgDb <- function(orgdb) {
   
   if (is.null(orgdb)) {
     return(NA_character_)
@@ -129,10 +129,10 @@ EMMA_get_organism_from_OrgDb <- function(orgdb) {
 #' geneset database and its version
 #'
 #' @noRd
-EMMA_cp_GO_metadata <- function(org) {
-  meta <- EMMA_empty_metadata()
+.EMMA_cp_GO_metadata <- function(org) {
+  meta <- .EMMA_empty_metadata()
   
-  meta$organism <- EMMA_get_organism_from_OrgDb(org)
+  meta$organism <- .EMMA_get_organism_from_OrgDb(org)
   meta$gene_set_db <- "GO"
   meta$gene_set_db_version <- if (requireNamespace("GO.db", quietly = TRUE)) {
     as.character(utils::packageVersion("GO.db"))
@@ -158,8 +158,8 @@ EMMA_cp_GO_metadata <- function(org) {
 #' geneset database and its version
 #'
 #' @noRd
-EMMA_cp_KEGG_metadata <- function(args) {
-  meta <- EMMA_empty_metadata()
+.EMMA_cp_KEGG_metadata <- function(args) {
+  meta <- .EMMA_empty_metadata()
   
   meta$organism <- args$organism
   meta$gene_set_db <- "KEGG"
@@ -179,8 +179,8 @@ EMMA_cp_KEGG_metadata <- function(args) {
 #' geneset database and its version
 #'
 #' @noRd
-EMMA_get_gprofiler2_metadata <- function(args) {
-  meta <- EMMA_empty_metadata()
+.EMMA_get_gprofiler2_metadata <- function(args) {
+  meta <- .EMMA_empty_metadata()
   
   version_info <- gprofiler2::get_version_info()
   
@@ -214,10 +214,10 @@ EMMA_get_gprofiler2_metadata <- function(args) {
 
 #' 
 #' @noRd
-EMMA_get_custom_metadata <- function(call_class, args,
+.EMMA_get_custom_metadata <- function(call_class, args,
                                      envir = parent.frame()) {
   
-  meta <- EMMA_empty_metadata()
+  meta <- .EMMA_empty_metadata()
   
   if (call_class$type == "wrapper") {
     # get all known functions used in the wrapper
@@ -225,19 +225,19 @@ EMMA_get_custom_metadata <- function(call_class, args,
     
     go_funs <- c("enrichGO", "gseGO", "groupGO")
     kegg_funs <- c("enrichKEGG", "gseKEGG")
-    # dont use EMMA_get_clusterprofiler_metadata cause the switch wont work with
+    # dont use .EMMA_get_clusterprofiler_metadata cause the switch wont work with
     # more than 1 wrapped fun
     meta_list <- list()
     if (any(wrapped_fun %in% go_funs)) {
-      meta_list$GO <- EMMA_cp_GO_metadata(args$OrgDb)
+      meta_list$GO <- .EMMA_cp_GO_metadata(args$OrgDb)
     }
     
     if (any(wrapped_fun %in% kegg_funs)) {
-      meta_list$KEGG <- EMMA_cp_KEGG_metadata(args)
+      meta_list$KEGG <- .EMMA_cp_KEGG_metadata(args)
     }
     
     if (any(wrapped_fun %in% c("gost"))) {
-      meta_list$gprofiler2 <- EMMA_get_gprofiler2_metadata(args)
+      meta_list$gprofiler2 <- .EMMA_get_gprofiler2_metadata(args)
     }
     
     if (length(meta_list) == 0L) {
@@ -277,10 +277,10 @@ EMMA_get_custom_metadata <- function(call_class, args,
 #'
 #' @return A named list
 #' @noRd
-EMMA_capture_call_info <- function(call, envir = parent.frame()) {
+.EMMA_capture_call_info <- function(call, envir = parent.frame()) {
   # param checks
   if (!is.call(call)) {
-    stop("`call` must be a function call", call. = FALSE)
+    stop("`call` must be a function call")
   }
   # capture function name
   call_name <- call[[1]]
@@ -335,12 +335,11 @@ EMMA_capture_call_info <- function(call, envir = parent.frame()) {
   }
   
   stop(
-    "Unsupported call format. Use a direct function call like `fun(...)` or `pkg::fun(...)`",
-    call. = FALSE)
+    "Unsupported call format. Use a direct function call like `fun(...)` or `pkg::fun(...)`")
 }
 
 
-#' This function, used in in `EMMA_walk()`, converts the head of a call into a character
+#' This function, used in in `.EMMA_walk()`, converts the head of a call into a character
 #' string representing the function being called. It supports both bare calls
 #' (e.g. `fun`) and namespace-qualified calls (e.g. `pkg::fun`)
 #'
@@ -349,7 +348,7 @@ EMMA_capture_call_info <- function(call, envir = parent.frame()) {
 #' @return A character string representing the function name
 #'
 #' @noRd
-EMMA_call_name <- function(x) {
+.EMMA_call_name <- function(x) {
   if (is.symbol(x)) {
     return(as.character(x))
   }
@@ -374,12 +373,12 @@ EMMA_call_name <- function(x) {
 #' operators found in `x`, including nested calls
 #' 
 #' @noRd
-EMMA_walk <- function(x) {
+.EMMA_walk <- function(x) {
   out <- character()
   
   if (is.call(x)) {
     # extract function/operator name
-    nm <- EMMA_call_name(x[[1]])
+    nm <- .EMMA_call_name(x[[1]])
     if (!is.null(nm)) {
       out <- c(out, nm)
     }
@@ -388,7 +387,7 @@ EMMA_walk <- function(x) {
   if (is.call(x) || is.pairlist(x) || is.expression(x)) {
     #check children/nested elements
     for (i in seq_along(x)) {
-      out <- c(out, EMMA_walk(x[[i]]))
+      out <- c(out, .EMMA_walk(x[[i]]))
     }
   }
   
@@ -411,7 +410,7 @@ EMMA_walk <- function(x) {
 #' wrapper
 #' 
 #' @noRd
-EMMA_find_original_wrapped_fun <- function(call, envir = parent.frame()) {
+.EMMA_find_original_wrapped_fun <- function(call, envir = parent.frame()) {
   
   if (!is.call(call)) {
     # do i want it to fail here ?
@@ -452,13 +451,12 @@ EMMA_find_original_wrapped_fun <- function(call, envir = parent.frame()) {
     fun <- getExportedValue(pkg, fn)
   } else {
     stop(
-      "Only `fun(...)` and `pkg::fun(...)` are supported",
-      call. = FALSE
+      "Only `fun(...)` and `pkg::fun(...)` are supported"
     )
   }
   
   
-  found <- EMMA_walk(body(fun)) |> unique()
+  found <- .EMMA_walk(body(fun)) |> unique()
   
   matched <- unique(c(
     intersect(found, full_targets),
@@ -482,7 +480,7 @@ EMMA_find_original_wrapped_fun <- function(call, envir = parent.frame()) {
 #' decide if top-level function passed to EMMA_run is a known fun or a wrapper
 #'
 #' @noRd
-EMMA_classify_call <- function(call, envir = parent.frame()) {
+.EMMA_classify_call <- function(call, envir = parent.frame()) {
   # listing all the functions that are not wrappers
   originals <- list(
     clusterProfiler = c("enrichGO", "gseGO", "groupGO", "enrichKEGG", "gseKEGG"),
@@ -497,7 +495,7 @@ EMMA_classify_call <- function(call, envir = parent.frame()) {
                             SIMPLIFY = FALSE) |> unlist(use.names = FALSE)
   
   # capture call information
-  info_call <- EMMA_capture_call_info(call = call, envir = envir)
+  info_call <- .EMMA_capture_call_info(call = call, envir = envir)
   function_name <- info_call$function_name
   package_name <- info_call$package_name
   
@@ -520,7 +518,7 @@ EMMA_classify_call <- function(call, envir = parent.frame()) {
   
   if (!is_original_top_level) {
     # inspect body of expr function, because this could be a wrapper
-    wrapped_original <- EMMA_find_original_wrapped_fun(call = call,
+    wrapped_original <- .EMMA_find_original_wrapped_fun(call = call,
                                                        envir = envir)
     wrapper <- !is.null(wrapped_original)
   }
@@ -550,20 +548,20 @@ EMMA_classify_call <- function(call, envir = parent.frame()) {
 #' This function assembles the structured provenance record that is stored as
 #' an attribute on the FEA results object
 #' 
-#' @param info_call A list returned by `EMMA_capture_call_info()`
+#' @param info_call A list returned by `.EMMA_capture_call_info()`
 #' @param args_form A character string, either `"evaluated"` or `"unevaluated"`
 #' to decide how to store the arguments
-#' @param metadata A list returned by `EMMA_get_metadata()`
+#' @param metadata A list returned by `.EMMA_get_metadata()`
 #' @param start_time A timestamp marking when the enrichment analysis started
-#' @param session Logical. If `TRUE`, `sessionInfo()` is captured and stored in
+#' @param store_session_info Logical. If `TRUE`, `sessionInfo()` is captured and stored in
 #' the record; if `FALSE` the `session_info` slot is `NULL`
 #'  
 #' @return A named list of the recorded metadata
 #'   
 #' @noRd
-EMMA_build_record <- function(info_call, args_form, metadata,
+.EMMA_build_record <- function(info_call, args_form, metadata,
                               wrapped_original, wrapper,
-                              start_time, session) {
+                              start_time, store_session_info) {
   emma_rec <- list(
                    method = list(
                      call = info_call$call,
@@ -586,7 +584,7 @@ EMMA_build_record <- function(info_call, args_form, metadata,
                      gene_set_db_version = metadata$gene_set_db_version
                    ),
                    timestamp = start_time,
-                   session_info = if (isTRUE(session)) sessionInfo() else NULL,
+                   session_info = if (isTRUE(store_session_info)) sessionInfo() else NULL,
                    extra = list(),# free field for extra metadata (added by user)
                    emma_version = as.character(packageVersion(pkg = "EMMA"))
                    )
@@ -609,7 +607,7 @@ EMMA_build_record <- function(info_call, args_form, metadata,
 #' 
 #' @return `base::invisible()`
 #' @noRd
-EMMA_warnings <- function(arg_names, function_name){
+.EMMA_warnings <- function(arg_names, function_name){
   checks <- list(
     list(
       params = c("pAdjustMethod", "correction_method", "do_padj"),
@@ -636,4 +634,3 @@ Consider using the corresponding parameter for your call.",
   }
   invisible()
 }
-
diff --git a/R/EMMA_run.R b/R/EMMA_run.R
index 7c1fc14..2537243 100644
--- a/R/EMMA_run.R
+++ b/R/EMMA_run.R
@@ -59,7 +59,7 @@ EMMA_run <- function(expr,
   }
   
   # decide whether we are dealing with a known function or a wrapper
-  call_class <- EMMA_classify_call(call, envir = envir)
+  call_class <- .EMMA_classify_call(call, envir = envir)
   info_call <- call_class$info_call
   function_name <- info_call$function_name
   package_name <- info_call$package_name
@@ -72,7 +72,7 @@ EMMA_run <- function(expr,
   
   # some good practice warning, i.e. when multiple testing correction is skipped
   # or bg geneset not set
-  EMMA_warnings(arg_names = arg_names,
+  .EMMA_warnings(arg_names = arg_names,
                 function_name = function_name)
   
   #capture analysis time
@@ -92,14 +92,14 @@ EMMA_run <- function(expr,
   results <- do.call(fun, args)
   
   # capture metadata from the used function and arguments
-  metadata <- EMMA_get_metadata(
+  metadata <- .EMMA_get_metadata(
     call_class,
     args,
     envir = envir
   )
   
   # record everything in EMMA_record
-  EMMA_record <- EMMA_build_record(info_call, args_form, metadata, 
+  EMMA_record <- .EMMA_build_record(info_call, args_form, metadata, 
                                    wrapped_original,wrapper,
                                    start_time, session)
     

From 7812a81da994ba02a4f2a627702e1dbb39834872 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 11 May 2026 18:50:33 +0200
Subject: [PATCH 50/92] updating tests

---
 tests/testthat/setuptests_EMMA.R      |  1 +
 tests/testthat/test-EMMA_freeze.R     | 34 +++++++++++++++++++++++++++
 tests/testthat/test-EMMA_get_record.R | 27 +++++++++++++++++++++
 tests/testthat/test-EMMA_metadata.R   | 22 ++++++++---------
 tests/testthat/test-EMMA_run.R        |  4 ++--
 tests/testthat/test-EMMA_show.R       | 24 +++++++++++++++++++
 tests/testthat/test-getEMMArecord.R   | 28 ----------------------
 7 files changed, 99 insertions(+), 41 deletions(-)
 create mode 100644 tests/testthat/test-EMMA_freeze.R
 create mode 100644 tests/testthat/test-EMMA_get_record.R
 delete mode 100644 tests/testthat/test-getEMMArecord.R

diff --git a/tests/testthat/setuptests_EMMA.R b/tests/testthat/setuptests_EMMA.R
index e73a0fe..1d08be5 100644
--- a/tests/testthat/setuptests_EMMA.R
+++ b/tests/testthat/setuptests_EMMA.R
@@ -6,4 +6,5 @@ invisible(lapply(
 
 data("de_res_IFNg_vs_naive", package = "EMMA")
 data("universe", package = "EMMA")
+data("fea_res", package = "EMMA")
 
diff --git a/tests/testthat/test-EMMA_freeze.R b/tests/testthat/test-EMMA_freeze.R
new file mode 100644
index 0000000..2e54fb0
--- /dev/null
+++ b/tests/testthat/test-EMMA_freeze.R
@@ -0,0 +1,34 @@
+test_that("EMMA_freeze", {
+  
+  tmp <- tempfile("emma_env")
+  dir.create(tmp)
+  
+  lockfile <- file.path(tmp, "renv.lock")
+  
+  res_path <- EMMA_freeze(
+    project = tmp,
+    file = "renv.lock",
+    pkgs = "stats",
+    prompt = TRUE,
+    force = TRUE
+  )
+  
+  expect_true(dir.exists(tmp))
+  
+  expect_true(file.exists(lockfile))
+  
+  expect_identical(res_path, lockfile)
+  
+  expect_error(EMMA_freeze(project = 2))
+  
+  expect_error(EMMA_freeze(file = NULL))
+  
+  expect_error(EMMA_freeze(file = NA_character_))
+  
+  expect_error(EMMA_freeze(pkgs = 1:3))
+  
+  expect_error(EMMA_freeze(promt = "no"))
+  
+  expect_error(EMMA_freeze(force = "yes"))
+    
+})
diff --git a/tests/testthat/test-EMMA_get_record.R b/tests/testthat/test-EMMA_get_record.R
new file mode 100644
index 0000000..44df8b9
--- /dev/null
+++ b/tests/testthat/test-EMMA_get_record.R
@@ -0,0 +1,27 @@
+test_that("EMMA_get_record", {
+  expect_true(is.list(EMMA_get_record(fea_res)))
+  expect_length(EMMA_get_record(fea_res), 7)
+  
+  fea_no_emma <- mosdef::run_cluPro(de_genes = 
+                                      rownames(de_res_IFNg_vs_naive),
+                                    bg_genes = universe,
+                                    mapping = "org.Hs.eg.db",
+                                    keyType = "ENSEMBL",
+                                    ont = "BP",
+                                    pAdjustMethod = "BH")
+  
+  expect_error(EMMA_get_record(fea_no_emma))
+  
+  attr(fea_no_emma, "EMMA_record") <- c()
+  
+  expect_error(EMMA_get_record(fea_no_emma))
+  
+  expect_error(EMMA_get_record("guiga"))
+  
+  attr(fea_res, "EMMA_record") <- NULL
+  expect_error(EMMA_get_record(fea_res))
+  
+  attr(fea_res, "EMMA_record") <- "i am a corrupted rec"
+  expect_error(EMMA_get_record(fea_res))
+  
+})
\ No newline at end of file
diff --git a/tests/testthat/test-EMMA_metadata.R b/tests/testthat/test-EMMA_metadata.R
index f59e0d4..f11fee9 100644
--- a/tests/testthat/test-EMMA_metadata.R
+++ b/tests/testthat/test-EMMA_metadata.R
@@ -23,14 +23,14 @@ test_that("test metadata content & structure", {
   
   expect_true(emma_rec$method$wrapper)
   
-  expect_null(EMMA_find_original_wrapped_fun("mosdef::run_cluPro(de_genes = rownames(de_res_IFNg_vs_naive),
+  expect_null(.EMMA_find_original_wrapped_fun("mosdef::run_cluPro(de_genes = rownames(de_res_IFNg_vs_naive),
                                                                 bg_genes = universe,
                                                                 mapping = 'org.Hs.eg.db',
                                                                 keyType = 'ENSEMBL',
                                                                 ont = 'BP')"))
   
   
-  custom <- EMMA_classify_call(substitute(summary(getEMMARecord(fea_res))))
+  custom <- .EMMA_classify_call(substitute(summary(EMMA_get_record(fea_res))))
   
   expect_equal(custom$type, "custom")
   
@@ -46,7 +46,7 @@ test_that("test metadata content & structure", {
                                   extra = list(
                                     note = "The background gene set list was all expressed genes in the assay"))
   
-  rec <- getEMMARecord(res)
+  rec <- EMMA_get_record(res)
   
   expect_equal(
     rec$extra$note,
@@ -68,7 +68,7 @@ test_that("test metadata content & structure", {
                               correction_method = "fdr",
                               custom_bg = universe) |> EMMA_run()
   
-  rec <- getEMMARecord(fea_res)
+  rec <- EMMA_get_record(fea_res)
   
   expect_true(length(rec$annotation$gene_set_db_version) != 1)
   
@@ -87,17 +87,17 @@ test_that("test metadata content & structure", {
   expect_warning(wrapper <- EMMA_run(custom_fun(rownames(de_res_IFNg_vs_naive),
                                                 org.Hs.eg.db)))
 
-  expect_equal(getEMMARecord(wrapper)$method$function_name, "custom_fun")
-  expect_equal(getEMMARecord(wrapper)$method$wrapped_package, "clusterProfiler")
-  expect_equal(getEMMARecord(wrapper)$method$wrapped_function, "groupGO")
-  expect_true(getEMMARecord(wrapper)$method$wrapper) 
+  expect_equal(EMMA_get_record(wrapper)$method$function_name, "custom_fun")
+  expect_equal(EMMA_get_record(wrapper)$method$wrapped_package, "clusterProfiler")
+  expect_equal(EMMA_get_record(wrapper)$method$wrapped_function, "groupGO")
+  expect_true(EMMA_get_record(wrapper)$method$wrapper) 
 
   
   empty <- EMMA_run(summary(rec$method))
   
-  expect_null(getEMMARecord(empty)$annotation$organism)
-  expect_null(getEMMARecord(empty)$annotation$gene_set_db)
-  expect_null(getEMMARecord(empty)$annotation$gene_set_db_version)
+  expect_null(EMMA_get_record(empty)$annotation$organism)
+  expect_null(EMMA_get_record(empty)$annotation$gene_set_db)
+  expect_null(EMMA_get_record(empty)$annotation$gene_set_db_version)
   
   
 })
diff --git a/tests/testthat/test-EMMA_run.R b/tests/testthat/test-EMMA_run.R
index b6f30a7..1c862c6 100644
--- a/tests/testthat/test-EMMA_run.R
+++ b/tests/testthat/test-EMMA_run.R
@@ -16,7 +16,7 @@ test_that("EMMA_run", {
   
   expect_true(length(attr(fea_res, "EMMA_record")) == 7)
   
-  info <- EMMA_capture_call_info(substitute(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
+  info <- .EMMA_capture_call_info(substitute(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
                                                      keyType = "ENSEMBL",
                                                      OrgDb = org.Hs.eg.db,
                                                      pAdjustMethod = "BH",
@@ -77,7 +77,7 @@ test_that("EMMA_run", {
                                 OrgDb = org.Hs.eg.db,
                                 keyType = "ENSEMBL",
                                 ont = "CC",
-                                level = 2), session = "yes"))
+                                level = 2), store_session_info = "yes"))
   
 })
 
diff --git a/tests/testthat/test-EMMA_show.R b/tests/testthat/test-EMMA_show.R
index 333a0df..db0ec52 100644
--- a/tests/testthat/test-EMMA_show.R
+++ b/tests/testthat/test-EMMA_show.R
@@ -54,4 +54,28 @@ test_that("EMMA_show", {
   expect_output(EMMA_show(fea2), "- FEA_1")
   expect_output(EMMA_show(fea2),"FEA_2")
   
+  
+  fea_gost <- fea2
+  names(fea_gost)[2] <- "result"
+  
+  attr(fea_gost, "EMMA_record") <- list(
+    method = list(
+      call = substitute(gost(query = de_res_IFNg_vs_naive$SYMBOL,
+                             organism = "hsapiens",
+                             correction_method = "fdr", custom_bg = universe,
+                             sources = "GO:BP")),
+      wrapper = FALSE,
+      package_name = "gprofiler2",
+      package_version = NA
+    ),
+    annotation = list(
+      organism = "Homo sapiens",
+      gene_set_db = "GO",
+      gene_set_db_version = NA
+    )
+  )
+  
+  expect_output(EMMA_show(fea_gost), "Number of Pathways:  2")
+  
+  
 })
diff --git a/tests/testthat/test-getEMMArecord.R b/tests/testthat/test-getEMMArecord.R
deleted file mode 100644
index 9152707..0000000
--- a/tests/testthat/test-getEMMArecord.R
+++ /dev/null
@@ -1,28 +0,0 @@
-test_that("getEMMARecord", {
-  fea_res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
-                               keyType = "ENSEMBL",
-                               OrgDb = org.Hs.eg.db,
-                               pAdjustMethod = "BH",
-                               pvalueCutoff = 0.05,
-                               qvalueCutoff = 0.1,
-                               universe = universe,
-                               readable = TRUE))
-  
-  expect_true(is.list(getEMMARecord(fea_res)))
-  expect_length(getEMMARecord(fea_res), 7)
-  
-  fea_no_emma <- mosdef::run_cluPro(de_genes = 
-                                      rownames(de_res_IFNg_vs_naive),
-                                    bg_genes = universe,
-                                    mapping = "org.Hs.eg.db",
-                                    keyType = "ENSEMBL",
-                                    ont = "BP",
-                                    pAdjustMethod = "BH")
-  
-  expect_error(getEMMARecord(fea_no_emma))
-  
-  attr(fea_no_emma, "EMMA_record") <- c()
-  
-  expect_error(getEMMARecord(fea_no_emma))
-  
-})
\ No newline at end of file

From 55d98412556d0f3351bb421c9fc3f6dbcbb3060c Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 11 May 2026 18:51:29 +0200
Subject: [PATCH 51/92] remove unused pkg from import

---
 NAMESPACE    | 2 --
 R/EMMA-pkg.R | 2 --
 2 files changed, 4 deletions(-)

diff --git a/NAMESPACE b/NAMESPACE
index 8893a13..841d1e7 100644
--- a/NAMESPACE
+++ b/NAMESPACE
@@ -6,8 +6,6 @@ export(EMMA_freeze)
 export(EMMA_run)
 export(EMMA_show)
 export(getEMMARecord)
-import(GO.db)
-import(methods)
 importFrom(AnnotationDbi,metadata)
 importFrom(utils,packageVersion)
 importFrom(utils,sessionInfo)
diff --git a/R/EMMA-pkg.R b/R/EMMA-pkg.R
index b11a174..1537c72 100644
--- a/R/EMMA-pkg.R
+++ b/R/EMMA-pkg.R
@@ -3,8 +3,6 @@
 #' EMMA stands for Enrichment Methods Matter.
 #' And EMMA stands to help you in realizing it.
 #'
-#' @import methods
-#' @import GO.db
 #' @importFrom AnnotationDbi metadata
 #' @importFrom utils packageVersion sessionInfo
 #' @importFrom cli cli_alert_info

From 0cb4185e8510b0a36f1db9e5b48e3719ca1f3f76 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 11 May 2026 18:51:43 +0200
Subject: [PATCH 52/92] update pkg version

---
 DESCRIPTION | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DESCRIPTION b/DESCRIPTION
index d09d2f9..0d4de97 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -1,7 +1,7 @@
 Package: EMMA
 Title: EMMA: Enrichment Methods Matter for enabeling fully reproducible and 
     provenance-aware pathway analysis
-Version: 0.2.0
+Version: 0.3.0
 Authors@R: 
     c(
         person(

From b0718a6d6d013e2546e4f7bc47b579af0fb9de2e Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 11 May 2026 18:52:39 +0200
Subject: [PATCH 53/92] update example data

---
 data/de_res_IFNg_vs_naive.RData         | Bin 5612 -> 676 bytes
 data/fea_res.RData                      | Bin 0 -> 5584 bytes
 data/universe.RData                     | Bin 6080 -> 1756 bytes
 inst/scripts/create_datasets_examples.R |  26 +++++++++++++++---------
 4 files changed, 16 insertions(+), 10 deletions(-)
 create mode 100644 data/fea_res.RData

diff --git a/data/de_res_IFNg_vs_naive.RData b/data/de_res_IFNg_vs_naive.RData
index 8c20de5c186c0c4e1dbe96d72beea5581528c37c..15286019999dd0cf794b177a35696ba9e502f162 100644
GIT binary patch
delta 663
zcmV;I0%-m0E2IUG8Gi$x0%ctQDG>)$Xc6RYQp%t+#U&xO2pjWu$<TtY?NMA!{I{_%
zt<02F@}-o5PcFLshV^awGT8{3+1>);`x;dP=Z$|b9jLH3j12|Q=Xi3l$pP&JM!k@<
zDeF3yn9pA6^(-qDTQkm=lfes{zoPEQ6Pp<|g(M{>^YXGkTYpl<icP$yHGbGjVD?r#
zY-o4yP*PM}1-;Mtavdh%F8z~@<CNmTN;s@W72vr2!zT;cI@brqAGX!^q2;cQeR#I&
z*LRYb$~>Y%i*2xD2B@`eV2=qUVZ?EEUCagqJx0(^!uiyGnXvyxp97Z;B2W5aqlr#>
zz)}yEra3Yd`hVk@e-r9wEt^WpXjen{Y+L|@h#)$i*KhNLB-6DHT8VThA|Vi5Ss0yY
zv=2gAy7Mc=c6O*%U($95WzmyU8uX|yKZh(^%BFu9-AhUyV}@#R>|~9%`7$j9U)yT?
z?$)oqF5$5_L#vg75fb&Dp}!N(DG41GEv;T(Obp9*g?|G;LjF%)1fe(T;r&oVa?)R<
z`w!2M#|qtsRbYf~YAO9X_Sh=o`?RtQKRHX@!P^NG%LrWnFQ~mJ$JD%K(xF2#JHo^q
zqh56=(TL_8Ge}nEQ=pQ~7x9Ik6!L(|(;%Y&SXWGB0$61Y$2l$^_<I3wT?VMhP5ENW
z_Ej_Hi+|1DVlkxb5N3WYWpXMll-~YtHbLqP%a0kd#%VZ{Gt21dx7#2I0f}zh%P8Lu
zSIta5&|VuA6wHX_^22JgVQgMYA(pGXY_F6?471+WSN2{B*urWIlv)`Pc-)D};F3@Q
xDl@`CBC}q7ngd*}0000002%jvQ2+t`1fT~101#St{ntJ)4T}N*00001Sz20SI0FCx

literal 5612
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
G0a;plzvE>9

diff --git a/data/fea_res.RData b/data/fea_res.RData
new file mode 100644
index 0000000000000000000000000000000000000000..4c5a56a7d9e2e1a0f0539fb0a3aec5c06da4b1b4
GIT binary patch
literal 5584
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

literal 0
HcmV?d00001

diff --git a/data/universe.RData b/data/universe.RData
index 74e9c0db78f2f02a2aff2c4f20a4b684ccf74ea6..f8f7c84cf6a03b6cff7144e83239045ba463b1d2 100644
GIT binary patch
delta 1751
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

literal 6080
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
G0a;p3u*Q-A

diff --git a/inst/scripts/create_datasets_examples.R b/inst/scripts/create_datasets_examples.R
index cdf1187..0f4ff02 100644
--- a/inst/scripts/create_datasets_examples.R
+++ b/inst/scripts/create_datasets_examples.R
@@ -7,15 +7,10 @@ rownames(dds_macrophage) <- substr(rownames(dds_macrophage), 1, 15)
 dds_macrophage
 
 # DE run
-keep <- rowSums(counts(dds_macrophage) >= 10) >= 6
-dds_macrophage <- dds_macrophage[keep, ]
-dds_macrophage
-
-
 # set seed for reproducibility
-set.seed(42)
+set.seed(2711)
 # sample randomly for 2k genes
-selected_genes <- sample(rownames(dds_macrophage), 2000)
+selected_genes <- sample(rownames(dds_macrophage), 500)
 
 dds_macrophage <- dds_macrophage[selected_genes, ]
 
@@ -38,10 +33,21 @@ de_res_IFNg_vs_naive <- de_res_IFNg_vs_naive[order(de_res_IFNg_vs_naive$padj), ]
 de_res_IFNg_vs_naive <- de_res_IFNg_vs_naive[!(is.na(de_res_IFNg_vs_naive$padj)) &
                                                de_res_IFNg_vs_naive$padj <= 0.05, ]
 
-universe <- rownames(dds_macrophage)
+# define gene universe
+gene_universe <- rownames(dds_macrophage)
 
-save(de_res_IFNg_vs_naive, file = "de_res_IFNg_vs_naive.RData", compress = "xz")
-save(universe, file = "universe.RData", compress = "xz")
 
+# perform FEA
+library("gprofiler2")
+fea_res <- gprofiler2::gost(query = de_res_IFNg_vs_naive$SYMBOL,
+                            organism = "hsapiens",
+                            correction_method = "fdr",
+                            custom_bg = universe,
+                            sources = "GO:BP") |> EMMA_run(
+                              store_session_info = FALSE,
+                              args_form = "unevaluated")
 
+save(de_res_IFNg_vs_naive, file = "de_res_IFNg_vs_naive.RData", compress = "xz")
+save(universe, file = "universe.RData", compress = "xz")
+save(fea_res, file = "fea_res.RData", compress = "xz")
 

From 9b7d274eeadfaf5aee5e42b8952d22b431482d1a Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 11 May 2026 18:54:08 +0200
Subject: [PATCH 54/92] fix EMMA_show to display the number of pathways/FEAs
 correctly, and update the example

---
 R/EMMA_show.R    | 37 ++++++++++++++++++-------------------
 man/EMMA_show.Rd |  9 ++-------
 2 files changed, 20 insertions(+), 26 deletions(-)

diff --git a/R/EMMA_show.R b/R/EMMA_show.R
index 6d57a6d..4d249bd 100644
--- a/R/EMMA_show.R
+++ b/R/EMMA_show.R
@@ -10,34 +10,33 @@
 #' @export
 #'
 #' @examples
-#' data("de_res_IFNg_vs_naive", package = "EMMA")
-#' data("universe", package = "EMMA")
-#' library("clusterProfiler")
-#' res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
-#' universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
-#' ont = "BP"))
-#' EMMA_show(res)
+#' data("fea_res", package = "EMMA")
+#' EMMA_show(fea_res)
 EMMA_show <- function(res){
   
   if ("EMMA_record" %in% names(attributes(res))) {
     cli::cli_alert_info("Found EMMA record!")
     
-    emma_rec <- getEMMARecord(res)
+    emma_rec <- EMMA_get_record(res)
     
     if (is.list(res) && !is.data.frame(res)) {
-      # let's say if we have of list of FEAs (returned by custom function)
-      cat("Number of FEAs: ", length(res), "\n")
-      
-      nms <- names(res)
-      if (is.null(nms) || any(nms == "")) {
-        nms <- paste0("FEA_", seq_along(res))
-      }
+      # e.g. case of gost, returns a list but it's 1 FEA (result)
+      if ("result" %in% names(res)) {
+        cat("Number of Pathways: ", NROW(res$result), "\n")
+      } else {
+        # let's say if we have of list of FEAs (returned by custom function)
+        cat("Number of FEAs: ", length(res), "\n")
+        
+        nms <- names(res)
+        if (is.null(nms) || any(nms == "")) {
+          nms <- paste0("FEA_", seq_along(res))
+        }
         
-      for (i in seq_along(res)) {
-        # check the number of pathways for each element of the list
-        cat(" -", nms[i], ": ", NROW(res[[i]]), " pathways\n")
+        for (i in seq_along(res)) {
+          # check the number of pathways for each element of the list
+          cat(" -", nms[i], ": ", NROW(res[[i]]), " pathways\n")
+        }
       }
-      
     } else {
       cat("Number of Pathways: ", NROW(res), "\n")
     }
diff --git a/man/EMMA_show.Rd b/man/EMMA_show.Rd
index 8207750..cd30ba3 100644
--- a/man/EMMA_show.Rd
+++ b/man/EMMA_show.Rd
@@ -18,11 +18,6 @@ This function displays a human-readable summary of the \code{EMMA_record} attrib
 attached to a result object produced by \code{EMMA_run()}
 }
 \examples{
-data("de_res_IFNg_vs_naive", package = "EMMA")
-data("universe", package = "EMMA")
-library("clusterProfiler")
-res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
-universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
-ont = "BP"))
-EMMA_show(res)
+data("fea_res", package = "EMMA")
+EMMA_show(fea_res)
 }

From 3a31b236e789a2b436fc22d8534b3dd264dc023c Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 11 May 2026 18:54:37 +0200
Subject: [PATCH 55/92] rename getEMMARecord to EMMA_get_record

---
 R/{getEMMARecord.R => EMMA_get_record.R} | 13 ++++---------
 1 file changed, 4 insertions(+), 9 deletions(-)
 rename R/{getEMMARecord.R => EMMA_get_record.R} (56%)

diff --git a/R/getEMMARecord.R b/R/EMMA_get_record.R
similarity index 56%
rename from R/getEMMARecord.R
rename to R/EMMA_get_record.R
index f982bed..5dd2e86 100644
--- a/R/getEMMARecord.R
+++ b/R/EMMA_get_record.R
@@ -1,4 +1,4 @@
-#' getEMMARecord
+#' EMMA_get_record
 #'
 #' @param res Functional Enrichment Analysis results (enrichResult, gseaResult ...)
 #' generated by `EMMA_run()`
@@ -7,14 +7,9 @@
 #' @export
 #'
 #' @examples
-#' data("de_res_IFNg_vs_naive", package = "EMMA")
-#' data("universe", package = "EMMA")
-#' library("clusterProfiler")
-#' res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
-#' universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
-#' ont = "BP"))
-#' getEMMARecord(res)
-getEMMARecord <- function(res){
+#' data("fea_res", package = "EMMA")
+#' EMMA_get_record(fea_res)
+EMMA_get_record <- function(res){
   
   rec <- attr(res, "EMMA_record")
   

From a9f5be978ac5e8f6326fdbeb9af4c54e894d6ce3 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 11 May 2026 18:55:26 +0200
Subject: [PATCH 56/92] updating documentation, arg names, and example for
 EMMA_run

---
 R/EMMA_run.R | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/R/EMMA_run.R b/R/EMMA_run.R
index 2537243..3b461f8 100644
--- a/R/EMMA_run.R
+++ b/R/EMMA_run.R
@@ -16,7 +16,7 @@
 #' provenance information. Both bare calls (`enrichGO(...)`) and
 #' namespace-qualified calls (`clusterProfiler::enrichGO(...)`) are supported.
 #' @param envir An environment in which to evaluate `expr`
-#' @param session Logical, indicating whether to store the output of
+#' @param store_session_info Logical, indicating whether to store the output of
 #' `sessionInfo()` or not. If `TRUE` (default), the session is stored in the
 #' provenance record
 #' @param args_form A character string indicating whether to store the evaluated
@@ -25,19 +25,21 @@
 #'
 #' @returns The result object returned by the enrichment function in `expr`,
 #' in standard format, with an additional `EMMA_record` attribute containing the
-#' provenance information. Use `getEMMARecord()` to retrieve this record
+#' provenance information. Use `EMMA_get_record()` to retrieve this record
 #' 
 #' @export
 #'
 #' @examples
 #' data("de_res_IFNg_vs_naive", package = "EMMA")
 #' data("universe", package = "EMMA")
-#' EMMA_run(clusterProfiler::enrichGO(gene = rownames(de_res_IFNg_vs_naive),
-#' universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
-#' ont = "BP"))
+#' library(gprofiler2)
+#' 
+#' EMMA_run(gost(query = de_res_IFNg_vs_naive$SYMBOL, organism = "hsapiens",
+#' correction_method = "fdr", custom_bg = universe, sources = "GO:BP"),
+#' store_session_info = FALSE, args_form = "unevaluated")
 EMMA_run <- function(expr,
                      envir = parent.frame(),
-                     session = TRUE,
+                     store_session_info = TRUE,
                      args_form = c("evaluated", "unevaluated")) {
   
   args_form <- match.arg(args_form)
@@ -54,8 +56,8 @@ EMMA_run <- function(expr,
     stop("`envir` must be an environment!")
   }
   
-  if (!is.logical(session) || length(session) != 1L || is.na(session)) {
-    stop("`session` must be a single TRUE or FALSE value")
+  if (!is.logical(store_session_info) || length(store_session_info) != 1L || is.na(store_session_info)) {
+    stop("`store_session_info` must be a single TRUE or FALSE value")
   }
   
   # decide whether we are dealing with a known function or a wrapper
@@ -101,7 +103,7 @@ EMMA_run <- function(expr,
   # record everything in EMMA_record
   EMMA_record <- .EMMA_build_record(info_call, args_form, metadata, 
                                    wrapped_original,wrapper,
-                                   start_time, session)
+                                   start_time, store_session_info)
     
   # attach EMMA_record as attribute of the results obj
   attr(results, "EMMA_record") <- EMMA_record

From d47c5ad98a8bd126dbd4b59c151d80698f392e4f Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 11 May 2026 18:55:49 +0200
Subject: [PATCH 57/92] add EMMA_freeze

---
 R/EMMA_freeze.R | 102 +++++++++++++++++++++++++++++++++++++++---------
 1 file changed, 83 insertions(+), 19 deletions(-)

diff --git a/R/EMMA_freeze.R b/R/EMMA_freeze.R
index 3e42e3d..2ce47d4 100644
--- a/R/EMMA_freeze.R
+++ b/R/EMMA_freeze.R
@@ -1,8 +1,7 @@
 #' EMMA_freeze
 #' 
-#' This function records the R environment during analysis runtime and generates
-#' a lockfile that can be used with tools such as `renv`.
-#' By default, all currently loaded namespaces are recorded.
+#' This function records the R environment at the time of analysis and generates
+#' a lockfile that can be used with tools such as `renv`
 #'
 #' @param project Character string corresponding to the path to the project
 #' directory where the lockfile should be written. If the directory does not
@@ -11,38 +10,103 @@
 #' It defaults to "renv.lock"
 #' @param pkgs Character vector of package names to snapshot. It defaults to all
 #' currently loaded namespaces via `loadedNamespaces()`
+#' @param prompt Logical indicating whether to prompt before taking actions.
+#' Defaults to `interactive()`
+#' @param force Logical indicating whether to force creation of the lockfile.
+#' Defaults to `TRUE`
 #' 
 #' @details
 #' This function calls `renv::snapshot()` with the specified packages.
 #' The resulting lockfile can later be restored with `renv::restore()` to
 #' recreate the same package environment.
 #' 
-#' @returns TODO json file like to create a lock.file?
+#' By default, the lockfile is created with `force = TRUE`, allowing snapshot
+#' creation even if inconsistencies are detected in the environment.
+#' 
+#' @returns Invisibly returns the path to the generated lockfile.
+#' The lockfile is written in JSON format and can be used with `renv::restore()`
+#' to recreate the package environment
 #' 
 #' @seealso \code{\link[renv]{snapshot}}, \code{\link[renv]{restore}}
 #' 
 #' @export
 #' 
 #' @examples
-#' \dontrun{
-#' # Create a lockfile in a separate directory
-#' EMMA_freeze(project = "emma_env")
+#' # create a lockfile
+#' if (requireNamespace("renv", quietly = TRUE)) {
+#' tmp <- tempfile("emma_env")
+#' dir.create(tmp)
+#'
+#' EMMA_freeze(project = tmp)
+#' 
+#' # inspect generated files
+#' list.files(tmp)
 #'
-#' # Restore later with renv
-#' renv::restore(project = "emma_env")
+#' # to restore the environment later
+#' # renv::restore(project = tmp)
 #' }
 EMMA_freeze <- function(project = getwd(),
                         file = "renv.lock",
-                        pkgs = loadedNamespaces()){
-  
-  # if (!dir.exists(project)) dir.create(project, recursive = TRUE)
-  # 
-  # renv::snapshot(
-  #   project = project,
-  #   lockfile = file,
-  #   packages = pkgs
-  # )
-  # 
+                        pkgs = loadedNamespaces(),
+                        prompt = interactive(),
+                        force = TRUE){
+  
+  # when using EMMA_freeze, we only need renv loaded (without attaching)
+  # to avoid extra heavy dependency.
+  if (!requireNamespace("renv", quietly = TRUE)) {
+    stop(
+      "The 'renv' package is required for EMMA_freeze(). Please install it."
+    )
+  }
+  
+  # checks on args
+  if (!is.character(project) || length(project) != 1L || is.na(project)) {
+    stop("`project` must be a single character string.")
+  }
+  
+  if (!is.character(file) || length(file) != 1L || is.na(file)) {
+    stop("`file` must be a single character string.")
+  }
+  
+  if (!is.character(pkgs)) {
+    stop("`pkgs` must be a character vector of package names.")
+  }
+  
+  if (!is.logical(prompt) || length(prompt) != 1L || is.na(prompt)) {
+    stop("`prompt` must be TRUE or FALSE.")
+  }
+  
+  if (!is.logical(force) || length(force) != 1L || is.na(force)) {
+    stop("`force` must be TRUE or FALSE.")
+  }
+  
+  
+  # create project dir if needed
+  if (!dir.exists(project)) {
+    dir.create(project, recursive = TRUE)
+  } 
+  
+  lockfile <- file.path(project, file)
+  
+  prompt <- isTRUE(prompt) # if interactive it s TRUE, else takes what the user passes
+  
+  # no prompt in non interactive sessions
+  if (!interactive()) {
+    prompt <- FALSE
+  }
+  
+  ##### snapshot environment
+  renv::snapshot(
+    project = project,
+    lockfile = lockfile,
+    packages = pkgs,
+    prompt = prompt,
+    force = force
+  )
+
   cli::cli_alert_info(
     "Environment snapshot saved to: {.val {lockfile}}. \nTo recreate this environment, use `renv::restore()`.")
+  
+  invisible(lockfile)
+
 }
\ No newline at end of file

From 3d8f2dbf5dd70de2f2b4d933d8a4bff1d6dd2188 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 11 May 2026 18:56:57 +0200
Subject: [PATCH 58/92] update EMMA_explain to return also citation

---
 R/EMMA_explain.R | 65 ++++++++++++++++++++++++++++++++----------------
 1 file changed, 44 insertions(+), 21 deletions(-)

diff --git a/R/EMMA_explain.R b/R/EMMA_explain.R
index e86cf61..e1b95d3 100644
--- a/R/EMMA_explain.R
+++ b/R/EMMA_explain.R
@@ -5,23 +5,22 @@
 #' call, the parameters, software context, and reference databases used.
 #'
 #' @param res A functional enrichment analysis results object as returned by
-#' `EMMA_run()`. Its attributes contain `EMMA_record`, which
-#' contains all provenance information of the performed FEA
+#' `EMMA_run()`. Its attributes contain `EMMA_record`, which contains all 
+#' provenance information of the performed FEA
+#' @param get_citation Logical indicating whether to display the citations of
+#' the packages used in the FEA. It only prints the citations in an interactive
+#' session (e.g console). Defaults to `TRUE`
 #' @returns A character string describing how the FEA was performed using the
-#' recorded metadata
+#' recorded metadata 
+#' 
 #' @export
 #' @examples
-#' data("de_res_IFNg_vs_naive", package = "EMMA")
-#' data("universe", package = "EMMA")
-#' library("clusterProfiler")
-#' res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
-#' universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
-#' ont = "BP", pAdjustMethod = "BH"))
-#' EMMA_explain(res)
+#' data("fea_res", package = "EMMA")
+#' EMMA_explain(fea_res)
 #' 
-EMMA_explain <- function(res){
+EMMA_explain <- function(res, get_citation = TRUE){
   
-  emma_rec <- getEMMARecord(res)
+  emma_rec <- EMMA_get_record(res)
   
   function_name <- emma_rec$method$function_name
   pkg_name <- emma_rec$method$package_name
@@ -37,7 +36,7 @@ EMMA_explain <- function(res){
   )
   
   
-  if (emma_rec$method$wrapper) {
+  if (isTRUE(emma_rec$method$wrapper)) {
     text <- paste0("Functional Enrichment Analysis was performed using a wrapper function ",
                    function_name, "()")
   } else {
@@ -72,13 +71,19 @@ EMMA_explain <- function(res){
   fdr_arg <- intersect(c("correction_method", "pAdjustMethod"), arg_names)
   
   if (length(bg_arg) == 1) {
+    bg_value <- args[[bg_arg]]
+    
+    if (length(bg_value) > 1) {
+      # evaluated arguments
       text <- paste0(text,
-        " A custom background gene set was provided (n = ",
-        length(args[[bg_arg]]),
-        ")."
-      )
-  } else if (length(bg_arg) > 1L) {
-    text <- paste0(text, " A custom background gene set was provided.")
+                     " A custom background gene set was provided (n = ",
+                     length(bg_value),").")
+      
+    } else if (length(bg_value) == 1) {
+      # unevaluated arguments.
+      text <- paste0(text, " A custom background gene set was provided.")
+    }
+      
   } else {
     text <- paste0(text, " No custom background gene set was recorded.")
   }
@@ -86,9 +91,10 @@ EMMA_explain <- function(res){
   
   ### info abt the fdr correction
   if (length(fdr_arg) == 1) {
+    fdr_value <- args[[fdr_arg]]
     text <- paste0(text,
       " Multiple testing correction was performed using the ",
-      args[[fdr_arg]], " method."
+      fdr_value, " method."
     )
   } else if ("do_padj" %in% arg_names) {
     if (isTRUE(args[["do_padj"]])) {
@@ -97,6 +103,23 @@ EMMA_explain <- function(res){
       text <- paste0(text, " Multiple testing correction was not applied.")
     }
   }
-  
+
+  ### get citations
+  
+  if (get_citation) {
+    pkgs <- unique(stats::na.omit(c(
+      emma_rec$method$package_name,
+      emma_rec$method$wrapped_package
+    )))
+    
+    if (length(pkgs) > 0L) {
+      cli::cli_alert_info("References:")
+      for (pkg in pkgs) {
+          cli::cli_verbatim(paste(format(utils::citation(pkg)),
+                                  collapse = "\n"))
+      }
+    }
+    
+  }
   return(text)
 }
\ No newline at end of file

From 2d2eeb86559c4a091dd77d7f3bde7bf129688383 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 11 May 2026 18:57:28 +0200
Subject: [PATCH 59/92] update example and fun name

---
 R/EMMA_add_custom_metadata.R | 11 +++--------
 1 file changed, 3 insertions(+), 8 deletions(-)

diff --git a/R/EMMA_add_custom_metadata.R b/R/EMMA_add_custom_metadata.R
index 3a854a9..a59884f 100644
--- a/R/EMMA_add_custom_metadata.R
+++ b/R/EMMA_add_custom_metadata.R
@@ -14,13 +14,8 @@
 #' @export
 #'
 #' @examples
-#' data("de_res_IFNg_vs_naive", package = "EMMA")
-#' data("universe", package = "EMMA")
-#' library("clusterProfiler")
-#' res <- EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
-#' universe = universe, keyType = "ENSEMBL", OrgDb = org.Hs.eg.db::org.Hs.eg.db,
-#' ont = "BP"))
-#' res <- EMMA_add_custom_metadata(res, extra =
+#' data("fea_res", package = "EMMA")
+#' fea_res <- EMMA_add_custom_metadata(fea_res, extra =
 #' list(note = "The background gene set list was all expressed genes in the assay"))
 EMMA_add_custom_metadata <- function(res,
                                      extra = list()) {
@@ -33,7 +28,7 @@ EMMA_add_custom_metadata <- function(res,
     stop("`extra` must be a named list!")
   }
   
-  emma_rec <- getEMMARecord(res = res)
+  emma_rec <- EMMA_get_record(res = res)
   
   emma_rec$extra <- extra
   

From 7b8b76cd96c55a441690bd7b5a92bfc15c7b1317 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 11 May 2026 18:57:39 +0200
Subject: [PATCH 60/92] update namespace

---
 NAMESPACE | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/NAMESPACE b/NAMESPACE
index 841d1e7..b47fb89 100644
--- a/NAMESPACE
+++ b/NAMESPACE
@@ -3,9 +3,10 @@
 export(EMMA_add_custom_metadata)
 export(EMMA_explain)
 export(EMMA_freeze)
+export(EMMA_get_record)
 export(EMMA_run)
 export(EMMA_show)
-export(getEMMARecord)
 importFrom(AnnotationDbi,metadata)
+importFrom(cli,cli_alert_info)
 importFrom(utils,packageVersion)
 importFrom(utils,sessionInfo)

From 32a0543106096c506842210e22fca09978baf334 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 11 May 2026 18:57:51 +0200
Subject: [PATCH 61/92] update the news

---
 NEWS.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/NEWS.md b/NEWS.md
index 2fffc1d..9b52e36 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -1,3 +1,12 @@
+# EMMA 0.3.0
+
+* Added the initial implementation of `EMMA_freeze()`.
+* `EMMA_explain()` now returns also citations of the used packages.
+* Renamed `getEMMARecord()` to `EMMA_get_record()` for consistency.
+* Resizing toy data to speed up examples.
+* Updated the vignette.
+* Updating unit tests.
+
 # EMMA 0.2.0
 
 * `EMMA_run()` can accept custom functions and wrappers and collect metadata

From 864dd6bb13a20dfeb332f1d74d8c7801e9a648c4 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 11 May 2026 19:20:38 +0200
Subject: [PATCH 62/92] adding minimal pkgdown yaml

---
 _pkgdown.yml | 12 ++++++++++++
 1 file changed, 12 insertions(+)
 create mode 100644 _pkgdown.yml

diff --git a/_pkgdown.yml b/_pkgdown.yml
new file mode 100644
index 0000000..81d9b19
--- /dev/null
+++ b/_pkgdown.yml
@@ -0,0 +1,12 @@
+authors:
+  Najla Abassi:
+    href: https://najlaabassi.github.io/
+  Annekathrin Nedwed:
+    href: https://github.com/AnnekathrinSilvia
+  Federico Marini:
+    href: https://federicomarini.github.io
+
+url: ~
+template:
+  bootstrap: 5
+  bootswatch: minty
\ No newline at end of file

From 3ad16857197dc7469cf822c140a34197f35e03ee Mon Sep 17 00:00:00 2001
From: Federico Marini <marinif@uni-mainz.de>
Date: Tue, 12 May 2026 11:44:29 +0200
Subject: [PATCH 63/92] minimal fixes on the indentation

---
 vignettes/Introduction_to_EMMA.Rmd | 53 ++++++++++++++++--------------
 1 file changed, 28 insertions(+), 25 deletions(-)

diff --git a/vignettes/Introduction_to_EMMA.Rmd b/vignettes/Introduction_to_EMMA.Rmd
index c34b6b1..807b1cf 100644
--- a/vignettes/Introduction_to_EMMA.Rmd
+++ b/vignettes/Introduction_to_EMMA.Rmd
@@ -238,21 +238,24 @@ fea_res
 ```{r EMMA_run_2, eval=FALSE}
 # you can also pass the function name and its namespace
 # e.g. `clusterProfiler::enrichGO(...)`
-fea_res <- EMMA_run(clusterProfiler::enrichGO(
-                    gene = rownames(de_res),
-                    keyType = "ENSEMBL",
-                    OrgDb = org.Hs.eg.db,
-                    ont = "BP",
-                    pAdjustMethod = "BH",
-                    pvalueCutoff = 0.05,
-                    qvalueCutoff = 0.1,
-                    readable = TRUE))
+fea_res <- EMMA_run(
+  clusterProfiler::enrichGO(
+    gene = rownames(de_res),
+    keyType = "ENSEMBL",
+    OrgDb = org.Hs.eg.db,
+    ont = "BP",
+    pAdjustMethod = "BH",
+    pvalueCutoff = 0.05,
+    qvalueCutoff = 0.1,
+    readable = TRUE
+  )
+)
 ```
 
 As you can see, `EMMA` returns the FEA results in their **native/standard** format.
 `EMMA` also warns you about good practices when performing FEA, like in this
 example, we didn't define a list of background genes (which can influence the 
-results), so we get warned about that.
+results TODO leading to a larger amount of false discoveries as a consequence of smaller p-values, see Wiiesorija again?), so we get warned about that.
 
 ### `EMMA_show()` : Summarizing the recorded information
 
@@ -350,10 +353,10 @@ You can also use a custom function that you developed, or a wrapper function
 
 ```{r mosdef_eg}
 mosdef_fea_res <- mosdef::run_goseq(de_genes = rownames(de_res),
-                             bg_genes = gene_universe,
-                             mapping = "org.Hs.eg.db",
-                             id = "ensGene",
-                             genome = "hg19") |> 
+                                    bg_genes = gene_universe,
+                                    mapping = "org.Hs.eg.db",
+                                    id = "ensGene",
+                                    genome = "hg19") |> 
   EMMA_run(store_session_info = FALSE,
            args_form = "unevaluated")
 
@@ -407,16 +410,16 @@ capture automatically. To keep everything organized, we can use
 
 ```{r add_custom_metadata}
 frankenstein_fea2 <- EMMA_add_custom_metadata(res = frankenstein_fea,
-                                             extra = list(
-                                               wrapped_function_topGO = "runTest",
-                                               notes = "any other meaningful info"))
+                                              extra = list(
+                                                wrapped_function_topGO = "runTest",
+                                                notes = "any other meaningful info"))
 
 EMMA_get_record(frankenstein_fea2)$extra
 ```
 
 Since the `EMMA_record` is attached as attribute to the original results objects,
 it can be preserved when integrating results into structured containers
-such as `DeeDeeExperiment`. This enables both FEA results and
+such as `DeeDeeExperiment` TODO link with BiocPkg? + link to citation, let's ride the wave!. This enables both FEA results and
 their associated provenance information to be stored and managed together,
 facilitating reproducibility, organization, and sharing of complex omics analyses.
 
@@ -443,13 +446,13 @@ used in practice, rather than attempting to enforce a fully consistent state.
 
 ```{r EMMA_freeze}
 if (requireNamespace("renv", quietly = TRUE)) {
-   project_path <- tempfile("my_project_with_emma")
-   dir.create(project_path)
-EMMA_freeze(project = project_path,
-            file = "analysis.lock",
-            pkgs = loadedNamespaces(),
-            prompt = FALSE,
-            force = TRUE)
+  project_path <- tempfile("my_project_with_emma")
+  dir.create(project_path)
+  EMMA_freeze(project = project_path,
+              file = "analysis.lock",
+              pkgs = loadedNamespaces(),
+              prompt = FALSE,
+              force = TRUE)
 }
 ```
 

From b9ecd18228cdc726c799efb54490549d9d013f7a Mon Sep 17 00:00:00 2001
From: Federico Marini <marinif@uni-mainz.de>
Date: Tue, 12 May 2026 11:48:49 +0200
Subject: [PATCH 64/92] removing the extra links

---
 vignettes/Introduction_to_EMMA.Rmd | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/vignettes/Introduction_to_EMMA.Rmd b/vignettes/Introduction_to_EMMA.Rmd
index 807b1cf..a2113b6 100644
--- a/vignettes/Introduction_to_EMMA.Rmd
+++ b/vignettes/Introduction_to_EMMA.Rmd
@@ -142,7 +142,7 @@ Maybe a diagram that would show what EMMA puts in and avoids you to take notes o
 In the remainder of this vignette, we will illustrate the main features of `r BiocStyle::Biocpkg("EMMA")` on a publicly available dataset from Alasoo, et al. "Shared genetic effects on chromatin
 and gene expression indicate a role for enhancer priming in immune response",
 published in Nature Genetics, January 2018 
-[@Alasoo2018] [doi:10.1038/s41588-018-0046-7](https://doi.org/10.1038/s41588-018-0046-7).
+[@Alasoo2018].
 
 The data is made available via the `r BiocStyle::Biocpkg("macrophage")`
 Bioconductor package, which contains the files output from the Salmon

From 3b595bdc985856499249246067edc32176ee44a4 Mon Sep 17 00:00:00 2001
From: Federico Marini <marinif@uni-mainz.de>
Date: Tue, 12 May 2026 11:49:11 +0200
Subject: [PATCH 65/92] adding citation to DeeDeeExp

---
 vignettes/Introduction_to_EMMA.Rmd | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/vignettes/Introduction_to_EMMA.Rmd b/vignettes/Introduction_to_EMMA.Rmd
index a2113b6..62bd014 100644
--- a/vignettes/Introduction_to_EMMA.Rmd
+++ b/vignettes/Introduction_to_EMMA.Rmd
@@ -419,7 +419,7 @@ EMMA_get_record(frankenstein_fea2)$extra
 
 Since the `EMMA_record` is attached as attribute to the original results objects,
 it can be preserved when integrating results into structured containers
-such as `DeeDeeExperiment` TODO link with BiocPkg? + link to citation, let's ride the wave!. This enables both FEA results and
+such as `r BiocStyle::Biocpkg("DeeDeeExperiment")` [@Abassi2026]. This enables both FEA results and
 their associated provenance information to be stored and managed together,
 facilitating reproducibility, organization, and sharing of complex omics analyses.
 
@@ -427,7 +427,8 @@ facilitating reproducibility, organization, and sharing of complex omics analyse
 dde <- DeeDeeExperiment::DeeDeeExperiment(sce = dds_macrophage,
                                           de_results = IFNg_vs_naive,
                                           enrich_results =  list(
-                                            IFNg_vs_naive = fea_res_no_param))
+                                            IFNg_vs_naive = fea_res_no_param)
+                                          )
 
 fea <- DeeDeeExperiment::getFEA(dde, format = "original")
 

From 098175b3805f5581927427e662da73dd2aed5974 Mon Sep 17 00:00:00 2001
From: Federico Marini <marinif@uni-mainz.de>
Date: Tue, 12 May 2026 11:49:18 +0200
Subject: [PATCH 66/92] bibtex updated

---
 vignettes/EMMA_bibliography.bib | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/vignettes/EMMA_bibliography.bib b/vignettes/EMMA_bibliography.bib
index 5cd3758..6238d17 100644
--- a/vignettes/EMMA_bibliography.bib
+++ b/vignettes/EMMA_bibliography.bib
@@ -77,7 +77,20 @@ @article{Brazma2001
   pages = {365–371}
 }
 
-
+@article{Abassi2026,
+  title = {DeeDeeExperiment: building an infrastructure for integrating and managing omics data analysis results in R/Bioconductor},
+  volume = {42},
+  ISSN = {1367-4811},
+  url = {http://dx.doi.org/10.1093/bioinformatics/btag157},
+  DOI = {10.1093/bioinformatics/btag157},
+  number = {4},
+  journal = {Bioinformatics},
+  publisher = {Oxford University Press (OUP)},
+  author = {Abassi,  Najla and Schwarz,  Lea and Filippi,  Edoardo and Marini,  Federico},
+  editor = {Schwartz,  Russell},
+  year = {2026},
+  month = Mar
+}
 
 
 

From c614baf74db9edec7a461faf8eb575486c614f78 Mon Sep 17 00:00:00 2001
From: Federico Marini <marinif@uni-mainz.de>
Date: Tue, 12 May 2026 11:49:43 +0200
Subject: [PATCH 67/92] some styling for pkgdown landing page added

---
 _pkgdown.yml      | 11 +++++-
 pkgdown/extra.css | 97 +++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 107 insertions(+), 1 deletion(-)
 create mode 100644 pkgdown/extra.css

diff --git a/_pkgdown.yml b/_pkgdown.yml
index 81d9b19..f753f9e 100644
--- a/_pkgdown.yml
+++ b/_pkgdown.yml
@@ -9,4 +9,13 @@ authors:
 url: ~
 template:
   bootstrap: 5
-  bootswatch: minty
\ No newline at end of file
+  bslib:
+    preset: "bootstrap"
+    font_scale: 1.0
+    base_font:
+      google: "Atkinson Hyperlegible"
+    code_font:
+      google: "IBM Plex Mono"
+
+navbar:
+  type: light
diff --git a/pkgdown/extra.css b/pkgdown/extra.css
new file mode 100644
index 0000000..c51e05b
--- /dev/null
+++ b/pkgdown/extra.css
@@ -0,0 +1,97 @@
+/*
+Developed and maintained by Kevin Rue-Albrecht (@kevinrue)
+*/
+
+/*
+#0092ac   blue
+#00758a   darker blue (active menu)
+#c4d931   green (on blue)
+#87b13f   green (on white)
+*/
+
+.headroom {
+  background-color: #0092ac;
+}
+
+.navbar-default .navbar-link {
+    color: #ffffff;
+}
+
+.navbar-default .navbar-link:hover {
+    color: #c4d931;
+}
+
+.navbar-default .navbar-nav>.active>a,
+.navbar-default .navbar-nav>.active>a:hover,
+.navbar-default .navbar-nav>.active>a:focus {
+    color: #c4d931;
+    background-color: #00758a;
+}
+
+.navbar-default .navbar-nav>.open>a,
+.navbar-default .navbar-nav>.open>a:hover,
+.navbar-default .navbar-nav>.open>a:focus {
+    color: #c4d931;
+    background-color: #00758a;
+}
+
+.dropdown-menu>.active>a,
+.dropdown-menu>.active>a:hover,
+.dropdown-menu>.active>a:focus {
+    color: #c4d931;
+    background-color: #00758a;
+}
+
+.navbar-default .navbar-nav>li>a:hover,
+.navbar-default .navbar-nav>li>a:focus {
+    color: #c4d931;
+}
+
+.dropdown-menu>li>a:hover {
+    color: #87b13f;
+    background-color: #ffffff;
+}
+
+.navbar-default .navbar-nav>li>a {
+    color: #ffffff;
+}
+
+h1 {
+  color: #87b13f;
+}
+
+h2 {
+  color: #1a81c2;
+}
+
+h3 {
+  color: #1a81c2;
+  font-weight: bold;
+}
+
+.btn-copy-ex {
+  color: #ffffff;
+  background-color: #0092ac;
+  border-color: #0092ac;
+}
+
+.btn-copy-ex:hover {
+  color: #ffffff;
+  background-color: #00758a;
+  border-color: #00758a;
+}
+
+.btn-copy-ex:active:focus {
+  color: #c4d931;
+  background-color: #00758a;
+  border-color: #0092ac;
+}
+
+p>.fa,
+p>.fas {
+  color: #0092ac;
+}
+
+img {
+  width: auto;
+}

From 2df7bdddde3f6fb041aa13b9d263006aa4130dd3 Mon Sep 17 00:00:00 2001
From: Federico Marini <marinif@uni-mainz.de>
Date: Tue, 12 May 2026 11:50:54 +0200
Subject: [PATCH 68/92] fixed the spot with correct citation

---
 vignettes/Introduction_to_EMMA.Rmd | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/vignettes/Introduction_to_EMMA.Rmd b/vignettes/Introduction_to_EMMA.Rmd
index 62bd014..849bcea 100644
--- a/vignettes/Introduction_to_EMMA.Rmd
+++ b/vignettes/Introduction_to_EMMA.Rmd
@@ -255,7 +255,8 @@ fea_res <- EMMA_run(
 As you can see, `EMMA` returns the FEA results in their **native/standard** format.
 `EMMA` also warns you about good practices when performing FEA, like in this
 example, we didn't define a list of background genes (which can influence the 
-results TODO leading to a larger amount of false discoveries as a consequence of smaller p-values, see Wiiesorija again?), so we get warned about that.
+results leading e.g. to a larger amount of false discoveries, as a consequence 
+of over-optimistic smaller p-values [@Wijesooriya2022]), so we get warned about that.
 
 ### `EMMA_show()` : Summarizing the recorded information
 

From 6f1e4f9916c1d84257f466597dc27c215196f82b Mon Sep 17 00:00:00 2001
From: Federico Marini <marinif@uni-mainz.de>
Date: Tue, 12 May 2026 12:10:09 +0200
Subject: [PATCH 69/92] structuring a bit differently the vignette

---
 vignettes/Introduction_to_EMMA.Rmd | 43 ++++++++++++++++++++++--------
 1 file changed, 32 insertions(+), 11 deletions(-)

diff --git a/vignettes/Introduction_to_EMMA.Rmd b/vignettes/Introduction_to_EMMA.Rmd
index 849bcea..069e0bb 100644
--- a/vignettes/Introduction_to_EMMA.Rmd
+++ b/vignettes/Introduction_to_EMMA.Rmd
@@ -139,6 +139,8 @@ Maybe a diagram that would show what EMMA puts in and avoids you to take notes o
 
 # `EMMA` on the `macrophage` dataset
 
+## About the data
+
 In the remainder of this vignette, we will illustrate the main features of `r BiocStyle::Biocpkg("EMMA")` on a publicly available dataset from Alasoo, et al. "Shared genetic effects on chromatin
 and gene expression indicate a role for enhancer priming in immune response",
 published in Nature Genetics, January 2018 
@@ -170,7 +172,7 @@ library("GO.db")
 We will show an example of how  `r BiocStyle::Biocpkg("EMMA")` fits into a
 regular bulk RNA-seq data analysis workflow.
 
-# Get a list of Differentially Expressed Genes
+## Getting a list of Differentially Expressed Genes
 
 For this, we will load the `macrophage` data and perform Differential Expression
 Analysis with `r BiocStyle::Biocpkg("DESeq2")`
@@ -206,15 +208,33 @@ de_res <- de_res[!(is.na(de_res$padj)) & de_res$padj <= 0.05, ]
 gene_universe <- rownames(dds_macrophage)
 ```
 
-# Perform Functional Enrichment Analysis (FEA) 
-
-## `EMMA` with available common packages/functions
+## Performing Functional Enrichment Analysis (FEA) 
 
 Now that we have a list of DE genes for this contrast, we can perform Functional
-Enrichment Analysis. In the following example, we will use the
+Enrichment Analysis.  
+We do this first *without* the functionality provided by `EMMA`.
+
+In the following example, we will use the
 function `enrichGO()` from `r BiocStyle::Biocpkg("clusterProfiler")`
 
-### `EMMA_run()` :Capturing the recorded information
+```{r withoutemma}
+fea_res <- enrichGO(gene = rownames(de_res),
+                    # TODO add universe, to have the first one "done right"
+                    keyType = "ENSEMBL",
+                    OrgDb = org.Hs.eg.db,
+                    ont = "BP",
+                    pAdjustMethod = "BH",
+                    pvalueCutoff = 0.05,
+                    qvalueCutoff = 0.1)
+```
+
+# Entering the `EMMA` framework
+
+From now on, we will complement the existing workflow with the functionality 
+provided by `EMMA`.
+
+
+## `EMMA_run()`: Capturing the recorded information
 
 `EMMA_run()` accepts a function call (e.g. `enrichGO(...)`) and executes it as
 it is, while capturing the associated parameters and provenance information:
@@ -222,6 +242,7 @@ it is, while capturing the associated parameters and provenance information:
 ```{r EMMA_run_1}
 # perform FEA, but with EMMA!
 fea_res <- enrichGO(gene = rownames(de_res),
+                    # TODO add universe, to have the first one "done right"
                     keyType = "ENSEMBL",
                     OrgDb = org.Hs.eg.db,
                     ont = "BP",
@@ -258,7 +279,7 @@ example, we didn't define a list of background genes (which can influence the
 results leading e.g. to a larger amount of false discoveries, as a consequence 
 of over-optimistic smaller p-values [@Wijesooriya2022]), so we get warned about that.
 
-### `EMMA_show()` : Summarizing the recorded information
+## `EMMA_show()`: Summarizing the recorded information
 
 To get a quick summary of what `EMMA` captured while we ran the analysis, we use
 `EMMA_show()`:
@@ -271,7 +292,7 @@ EMMA_show(fea_res)
 results object. That's why it is always a good practice to save the original
 results, and not only the subsets of interest.
 
-### `EMMA_get_record()` : Retrieving the recorded information
+## `EMMA_get_record()`: Retrieving the recorded information
 
 To access the full recorded information, we use `EMMA_get_record()`:
 
@@ -336,7 +357,7 @@ EMMA_get_record(fea_res_no_param)
 We can also choose whether to save the R session information with the record
 using the argument `store_session_info`, which defaults to `TRUE`.
 
-### `EMMA_explain()`: Summarizing recorded information into text
+## `EMMA_explain()`: Summarizing recorded information into text
 
 `EMMA_explain()` generates a human-readable description of the FEA, similar
 to a Materials and Methods section of a paper, by summarizing the executed call,
@@ -403,7 +424,7 @@ frankenstein_fea <- my_custom_function(
 EMMA_get_record(frankenstein_fea)
 ```
 
-# `EMMA_add_custom_metadata()`: Adding extra information
+## `EMMA_add_custom_metadata()`: Adding extra information
 
 The user can always attach extra metadata that `EMMA` might not be able to
 capture automatically. To keep everything organized, we can use
@@ -436,7 +457,7 @@ fea <- DeeDeeExperiment::getFEA(dde, format = "original")
 EMMA_get_record(fea)
 ```
 
-# `EMMA_freeze()`: Recording the Analysis Environment
+## `EMMA_freeze()`: Recording the Analysis Environment
 
 `EMMA_freeze()` records the R environment at the time of analysis by generating
 a lockfile using `renv`. By default, the snapshot is created with `force = TRUE`,

From 33c3afef638ac4dc335e8eab790329c8eeeae305 Mon Sep 17 00:00:00 2001
From: Federico Marini <marinif@uni-mainz.de>
Date: Tue, 12 May 2026 12:51:07 +0200
Subject: [PATCH 70/92] scollout & smaller css tricks are in

---
 vignettes/Introduction_to_EMMA.Rmd | 48 +++++++++++++++++++++++-------
 1 file changed, 38 insertions(+), 10 deletions(-)

diff --git a/vignettes/Introduction_to_EMMA.Rmd b/vignettes/Introduction_to_EMMA.Rmd
index 069e0bb..04c9749 100644
--- a/vignettes/Introduction_to_EMMA.Rmd
+++ b/vignettes/Introduction_to_EMMA.Rmd
@@ -1,6 +1,6 @@
 ---
 title: >
-  The `EMMA` User's Guide
+  The `EMMA` User's Guide - Enrichment Method MAtters
 author:
 - name: Najla Abassi
   affiliation: 
@@ -34,11 +34,6 @@ editor_options:
 bibliography: EMMA_bibliography.bib
 ---
 
-<style type="text/css">
-.smaller {
-  font-size: 10px
-}
-</style>
 
 ```{r knitr, include = FALSE}
 knitr::opts_chunk$set(
@@ -68,8 +63,9 @@ exists to ensure transparent and reproducible documentation of FEA workflows,
 comparable to the MIAME guidelines [@Brazma2001] 
 [doi:10.1038/ng1201-365]( https://doi.org/10.1038/ng1201-365).
 
-To address this gap, we introduce `r BiocStyle::Biocpkg("EMMA")`, a framework
-that automatically captures key analytical parameters and provenance information
+To address this gap, we introduce `r BiocStyle::Biocpkg("EMMA")` (standing for 
+**E**nrichment **M**ethods **MA**tters), a framework that automatically captures key 
+analytical parameters and provenance information
 during the execution of FEA methods.
 
 This vignette demonstrates how `EMMA` integrates with existing tools
@@ -137,7 +133,8 @@ Like: stepwise with bullet point
 Maybe a diagram that would show what EMMA puts in and avoids you to take notes of?
 
 
-# `EMMA` on the `macrophage` dataset
+
+# Usage example of `EMMA`: the `macrophage` dataset
 
 ## About the data
 
@@ -296,7 +293,18 @@ results, and not only the subsets of interest.
 
 To access the full recorded information, we use `EMMA_get_record()`:
 
+```{css}
+/*| echo: false */
+
+.scrollout {
+max-height: 500px;
+overflow-y: scroll;
+}
+```
+
 ```{r EMMA_get_record}
+#| class-output: scrollout
+
 emma_record <- EMMA_get_record(fea_res)
 
 # get all the record
@@ -338,6 +346,8 @@ used in our call or not. This can be useful, for example, to avoid unnecessarily
 increasing the size of the result object. For this, we can use the argument `args_form`:
 
 ```{r argument_form}
+#| class-output: scrollout
+
 fea_res_no_param <- enrichGO(gene = rownames(de_res),
                              universe = gene_universe,
                              keyType = "ENSEMBL",
@@ -374,6 +384,8 @@ You can also use a custom function that you developed, or a wrapper function
 `EMMA_run()` will attempt to capture as much metadata as possible:
 
 ```{r mosdef_eg}
+#| class-output: scrollout
+
 mosdef_fea_res <- mosdef::run_goseq(de_genes = rownames(de_res),
                                     bg_genes = gene_universe,
                                     mapping = "org.Hs.eg.db",
@@ -387,6 +399,8 @@ EMMA_get_record(mosdef_fea_res)
 ```
 
 ```{r custom_eg}
+#| class-output: scrollout
+
 # a custom function (not from a package)
 my_custom_function <- function(gene, universe = NULL,
                                ontology = "BP", id_type = "ENTREZID",
@@ -431,6 +445,8 @@ capture automatically. To keep everything organized, we can use
 `EMMA_add_custom_metadata()` function
 
 ```{r add_custom_metadata}
+#| class-output: scrollout
+
 frankenstein_fea2 <- EMMA_add_custom_metadata(res = frankenstein_fea,
                                               extra = list(
                                                 wrapped_function_topGO = "runTest",
@@ -446,6 +462,8 @@ their associated provenance information to be stored and managed together,
 facilitating reproducibility, organization, and sharing of complex omics analyses.
 
 ```{r emma_and_dde}
+#| class-output: scrollout
+
 dde <- DeeDeeExperiment::DeeDeeExperiment(sce = dds_macrophage,
                                           de_results = IFNg_vs_naive,
                                           enrich_results =  list(
@@ -479,9 +497,19 @@ if (requireNamespace("renv", quietly = TRUE)) {
 }
 ```
 
-# Session info {.unnumbered .smaller}
+# Session info {.unnumbered}
+
+```{css}
+/*| echo: false */
+
+.smaller {
+  font-size: 10px
+}
+```
 
 ```{r sessioinfo}
+#| class-output: smaller
+
 sessionInfo()
 ```
 

From 49a3014ab8b3e9d14fa777128d1794903120d862 Mon Sep 17 00:00:00 2001
From: Federico Marini <marinif@uni-mainz.de>
Date: Tue, 12 May 2026 12:51:24 +0200
Subject: [PATCH 71/92] remove "redundancy" in doi + cit + links

---
 vignettes/Introduction_to_EMMA.Rmd | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/vignettes/Introduction_to_EMMA.Rmd b/vignettes/Introduction_to_EMMA.Rmd
index 04c9749..555959c 100644
--- a/vignettes/Introduction_to_EMMA.Rmd
+++ b/vignettes/Introduction_to_EMMA.Rmd
@@ -50,18 +50,16 @@ knitr::opts_chunk$set(
 Functional Enrichment Analysis (FEA) is a key downstream step in omics workflows,
 commonly applied after differential expression analysis to support biological
 interpretation and generate pathway-level hypotheses. A wide range of tools and
-methods are available, mainly Over-Representation Analysis (ORA) [@Khatri2012] [doi:10.1371/journal.pcbi.1002375](https://doi.org/10.1371/journal.pcbi.1002375)
-and Gene Set Enrichment Analysis (GSEA) [@Subramanian2005] [doi:10.1073/pnas.0506580102](https://doi.org/10.1073/pnas.0506580102), leading
+methods are available, mainly Over-Representation Analysis (ORA) [@Khatri2012] 
+and Gene Set Enrichment Analysis (GSEA) [@Subramanian2005], leading
 to substantial heterogeneity in analytical choices and reported results.
 
-Despite its widespread use, FEA is often insufficiently documented [@Wijesooriya2022] 
-[doi:10.1371/journal.pcbi.1009935](https://doi.org/10.1371/journal.pcbi.1009935).
+Despite its widespread use, FEA is often insufficiently documented [@Wijesooriya2022].
 Critical parameters such as background gene sets or multiple testing correction
 methods are frequently missing or inconsistently reported in scientific papers,
 limiting reproducibility and interpretability. Currently, no standardized framework
 exists to ensure transparent and reproducible documentation of FEA workflows,
-comparable to the MIAME guidelines [@Brazma2001] 
-[doi:10.1038/ng1201-365]( https://doi.org/10.1038/ng1201-365).
+comparable to the MIAME guidelines [@Brazma2001].
 
 To address this gap, we introduce `r BiocStyle::Biocpkg("EMMA")` (standing for 
 **E**nrichment **M**ethods **MA**tters), a framework that automatically captures key 

From c4fca5b9d414b684b5781a36090410c44cd3c3f9 Mon Sep 17 00:00:00 2001
From: Federico Marini <marinif@uni-mainz.de>
Date: Tue, 12 May 2026 12:51:46 +0200
Subject: [PATCH 72/92] update title in the README

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 913b805..56ae0f1 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# EMMA
+# EMMA - Enrichment Methods MAtter
 
 EMMA enables the execution of Functional Enrichment Analyses using existing
 tools (e.g. `clusterProfiler`, `topGO`, `gprofiler2`) while systematically capturing

From 5222d3985e82b5b3f2d4e7a6e3385819fac8c32d Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Tue, 12 May 2026 12:53:59 +0200
Subject: [PATCH 73/92] updating the readme content

---
 README.md | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 913b805..5bff5ce 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,10 @@
 # EMMA
 
-EMMA enables the execution of Functional Enrichment Analyses using existing
-tools (e.g. `clusterProfiler`, `topGO`, `gprofiler2`) while systematically capturing
-analysis parameters and provenance information during runtime, and returning
-enrichment results in their standard format alongside structured and reusable metadata.
+EMMA enables the execution of Functional Enrichment Analyses using a wide range
+of existing tools (e.g. `clusterProfiler`, `topGO`, `gprofiler2` among others)
+while systematically capturing analysis parameters and provenance information
+during runtime, and returning enrichment results in their standard format
+alongside structured and reusable metadata.
 
 ## Installation
 
@@ -34,6 +35,11 @@ fea_results <- enrichGO(gene = rownames(de_res_IFNg_vs_naive),
 
 ```
 
+## Usage Overview
+
+You can find the rendered version of the documentation of `EMMA` at the project
+website https://imbeimainz.github.io/EMMA/
+
 ## Development
 
 If you encounter a bug, have usage questions, or want to share ideas and

From ca9df8b1b0e1600a087371d2011b52b699242849 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Tue, 12 May 2026 13:04:10 +0200
Subject: [PATCH 74/92] updating the code of conduct

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 0717a18..d4fdc85 100644
--- a/README.md
+++ b/README.md
@@ -49,7 +49,7 @@ functionality to make this package better, feel free to file an
 ## Code of Conduct
 
 Please note that the EMMA project is released with a [Contributor Code
-of Conduct](https://contributor-covenant.org/version/2/0/CODE_OF_CONDUCT.html).
+of Conduct](https://contributor-covenant.org/version/3/0/CODE_OF_CONDUCT.html).
 By contributing to this project, you agree to abide by its terms.
 
 ## License

From dacaff2015b97bfe127e13ce2f29d2741b59bd73 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Tue, 12 May 2026 13:40:41 +0200
Subject: [PATCH 75/92] adding bg genes for the first example and remove it
 from the second

---
 vignettes/Introduction_to_EMMA.Rmd | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/vignettes/Introduction_to_EMMA.Rmd b/vignettes/Introduction_to_EMMA.Rmd
index 555959c..a2cbd59 100644
--- a/vignettes/Introduction_to_EMMA.Rmd
+++ b/vignettes/Introduction_to_EMMA.Rmd
@@ -214,7 +214,7 @@ function `enrichGO()` from `r BiocStyle::Biocpkg("clusterProfiler")`
 
 ```{r withoutemma}
 fea_res <- enrichGO(gene = rownames(de_res),
-                    # TODO add universe, to have the first one "done right"
+                    universe = gene_universe,
                     keyType = "ENSEMBL",
                     OrgDb = org.Hs.eg.db,
                     ont = "BP",
@@ -237,7 +237,7 @@ it is, while capturing the associated parameters and provenance information:
 ```{r EMMA_run_1}
 # perform FEA, but with EMMA!
 fea_res <- enrichGO(gene = rownames(de_res),
-                    # TODO add universe, to have the first one "done right"
+                    universe = gene_universe,
                     keyType = "ENSEMBL",
                     OrgDb = org.Hs.eg.db,
                     ont = "BP",
@@ -251,11 +251,12 @@ fea_res
 
 ... or you can simply wrap `EMMA_run()` around your call:
 
-```{r EMMA_run_2, eval=FALSE}
+```{r EMMA_run_2}
 # you can also pass the function name and its namespace
 # e.g. `clusterProfiler::enrichGO(...)`
-fea_res <- EMMA_run(
+fea_res_nobg <- EMMA_run(
   clusterProfiler::enrichGO(
+    # no universe set
     gene = rownames(de_res),
     keyType = "ENSEMBL",
     OrgDb = org.Hs.eg.db,
@@ -404,7 +405,6 @@ my_custom_function <- function(gene, universe = NULL,
                                ontology = "BP", id_type = "ENTREZID",
                                org_db_name = "org.Hs.eg.db", 
                                organism = "hsapiens") {
-  # a wrapper of a wrapper :D
   res1 <- mosdef::run_topGO(de_genes = gene,
                             bg_genes = gene_universe,
                             ontology = ontology,

From ba994b56ddb1d7843f6c0751c0160bda64899f49 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Fri, 15 May 2026 14:24:05 +0200
Subject: [PATCH 76/92] updating internal documentation

---
 R/EMMA_internal-utils.R | 51 +++++++++++++++++++++++++----------------
 1 file changed, 31 insertions(+), 20 deletions(-)

diff --git a/R/EMMA_internal-utils.R b/R/EMMA_internal-utils.R
index 0db2ae1..62e8a0e 100644
--- a/R/EMMA_internal-utils.R
+++ b/R/EMMA_internal-utils.R
@@ -17,11 +17,11 @@
 #' (e.g. for `clusterProfiler`, `gprofiler2` ...) to standardize metadata
 #' collection across different enrichment tools
 #'
-#' @param info_call A list containing captured call information, including
-#' at least `function_name`, `package_name`, and the original `call`
-#'   
-#' @param args A list of evaluated arguments passed to the enrichment function 
 #' 
+#' @param call_class A named list returned by `.EMMA_classify_call()`. It must
+#' contain an `info_call` list with at least `function_name`, `package_name`,
+#' and the original `call`
+#' @param args A list of evaluated arguments passed to the enrichment function 
 #' @param envir The environment in which the original call was evaluated
 #' 
 #' @return A list containing annotation metadata(organism, gene set database and 
@@ -63,7 +63,6 @@
 #' 
 #' @param function_name A character string specifying the name of the
 #' `clusterProfiler` function used to perform FEA
-#'
 #' @param args A list containing the evaluated arguments passed into the
 #' function call to perform FEA 
 #' 
@@ -143,9 +142,6 @@
   return(meta)
 }
 
-
-### not tested yet since the kegg server is down and the function couldn't work
-
 #' This function assembles standardized metadata describing KEGG enrichment
 #' analyses performed with `clusterProfiler`. The metadata includes the
 #' organism, the geneset database used. The database version is currently not
@@ -212,10 +208,19 @@
 }
 
 
+#' This function retrieves metadata associated with FEAs performed using
+#' user-defined wrapper functions or fully custom functions
 #' 
+#' @param call_class A named list returned by `.EMMA_classify_call()`
+#' @param args A list of evaluated arguments passed to the enrichment function
+#' @param envir The environment in which the original call was evaluated
+#' 
+#' @return A named list
+#'
 #' @noRd
-.EMMA_get_custom_metadata <- function(call_class, args,
-                                     envir = parent.frame()) {
+.EMMA_get_custom_metadata <- function(call_class,
+                                      args,
+                                      envir = parent.frame()) {
   
   meta <- .EMMA_empty_metadata()
   
@@ -265,7 +270,7 @@
 
 
 
-# call info capture -----------------------------------------------------------------
+# call info capture ------------------------------------------------------------
 
 #' This function extracts call related metadata. It handles two call
 #' formats: bare function calls (e.g. `fun(...)`) and namespace-qualified
@@ -339,9 +344,9 @@
 }
 
 
-#' This function, used in in `.EMMA_walk()`, converts the head of a call into a character
-#' string representing the function being called. It supports both bare calls
-#' (e.g. `fun`) and namespace-qualified calls (e.g. `pkg::fun`)
+#' This function, used in in `.EMMA_walk()`, converts the head of a call into
+#' a character string representing the function being called. It supports both
+#' bare calls (e.g. `fun`) and namespace-qualified calls (e.g. `pkg::fun`)
 #'
 #' @param x The head of a call (the function being called)
 #' 
@@ -479,6 +484,11 @@
 
 #' decide if top-level function passed to EMMA_run is a known fun or a wrapper
 #'
+#' @param call A call object passed to `EMMA_run()`
+#' @param envir The environment in which `call` should be evaluated
+#' 
+#' @return A named list
+#'
 #' @noRd
 .EMMA_classify_call <- function(call, envir = parent.frame()) {
   # listing all the functions that are not wrappers
@@ -553,15 +563,15 @@
 #' to decide how to store the arguments
 #' @param metadata A list returned by `.EMMA_get_metadata()`
 #' @param start_time A timestamp marking when the enrichment analysis started
-#' @param store_session_info Logical. If `TRUE`, `sessionInfo()` is captured and stored in
-#' the record; if `FALSE` the `session_info` slot is `NULL`
+#' @param store_session_info Logical. If `TRUE`, `sessionInfo()` is captured
+#' and stored in the record; if `FALSE` the `session_info` slot is `NULL`
 #'  
 #' @return A named list of the recorded metadata
 #'   
 #' @noRd
 .EMMA_build_record <- function(info_call, args_form, metadata,
-                              wrapped_original, wrapper,
-                              start_time, store_session_info) {
+                               wrapped_original, wrapper,
+                               start_time, store_session_info) {
   emma_rec <- list(
                    method = list(
                      call = info_call$call,
@@ -584,8 +594,9 @@
                      gene_set_db_version = metadata$gene_set_db_version
                    ),
                    timestamp = start_time,
-                   session_info = if (isTRUE(store_session_info)) sessionInfo() else NULL,
-                   extra = list(),# free field for extra metadata (added by user)
+                   session_info = if (isTRUE(store_session_info)) sessionInfo() 
+                   else NULL,
+                   extra = list(),# free field for extra metadata added by user
                    emma_version = as.character(packageVersion(pkg = "EMMA"))
                    )
   

From 627ba5da908815ee1307f1fce63ed688738a4790 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Fri, 15 May 2026 14:28:16 +0200
Subject: [PATCH 77/92] adding more tests

---
 tests/testthat/test-EMMA_metadata.R | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/tests/testthat/test-EMMA_metadata.R b/tests/testthat/test-EMMA_metadata.R
index f11fee9..6d3135a 100644
--- a/tests/testthat/test-EMMA_metadata.R
+++ b/tests/testthat/test-EMMA_metadata.R
@@ -100,6 +100,30 @@ test_that("test metadata content & structure", {
   expect_null(EMMA_get_record(empty)$annotation$gene_set_db_version)
   
   
+  geneList <- de_res_IFNg_vs_naive$log2FoldChange
+  names(geneList) <- rownames(de_res_IFNg_vs_naive)
+  geneList <- sort(geneList, decreasing = TRUE)
+  
+  expect_warning(gse_res <- gseGO( geneList = geneList, keyType = "ENSEMBL",
+                    OrgDb = org.Hs.eg.db, ont = "BP",
+                    minGSSize = 100, maxGSSize = 500,
+                    pvalueCutoff = 0.05, verbose = FALSE,
+                    pAdjustMethod = "BH") |>  EMMA_run())
+  
+  expect_equal(EMMA_get_record(gse_res)$method$function_name, "gseGO")
+  expect_null(EMMA_get_record(gse_res)$method$wrapped_function)
+  expect_null(EMMA_get_record(gse_res)$method$wrapped_package)
+  expect_equal(EMMA_get_record(gse_res)$annotation$gene_set_db, "GO")
+  
+  # pretending a function that doesn't exist in any package, so fallback
+  # to empty metadata
+  expect_warning(user_only_fea <- summary(as.data.frame(gse_res)) |> 
+    EMMA_run(store_session_info = FALSE, args_form = "unevaluated"))
+  
+  expect_null(EMMA_get_record(user_only_fea)$annotation$organism)
+  expect_null(EMMA_get_record(user_only_fea)$annotation$gene_set_db)
+  expect_null(EMMA_get_record(user_only_fea)$annotation$gene_set_db_version)
+  
 })
 
 

From 17e6758eedff2ee05e91208145fbb73e2eb17ff4 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Fri, 15 May 2026 14:28:51 +0200
Subject: [PATCH 78/92] adding workflow figure and updating vignette

---
 vignettes/EMMA_workflow.png        | Bin 0 -> 114552 bytes
 vignettes/Introduction_to_EMMA.Rmd |  29 +++++++++--------------------
 2 files changed, 9 insertions(+), 20 deletions(-)
 create mode 100644 vignettes/EMMA_workflow.png

diff --git a/vignettes/EMMA_workflow.png b/vignettes/EMMA_workflow.png
new file mode 100644
index 0000000000000000000000000000000000000000..d0f9da255b16b6f82c8c07d9a6d458c49e1e19c6
GIT binary patch
literal 114552
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

literal 0
HcmV?d00001

diff --git a/vignettes/Introduction_to_EMMA.Rmd b/vignettes/Introduction_to_EMMA.Rmd
index a2cbd59..1d6892f 100644
--- a/vignettes/Introduction_to_EMMA.Rmd
+++ b/vignettes/Introduction_to_EMMA.Rmd
@@ -99,6 +99,8 @@ While Bioconductor provides dedicated metadata slots for certain S4 classes
 result types. By relying on attributes, provenance information can be attached
 to any result object regardless of its underlying class.
 
+![](EMMA_workflow.png)
+
 # Getting started {#gettingstarted}
 
 To install this package, start R and enter:
@@ -117,27 +119,13 @@ as follows:
 library("EMMA")
 ```
 
-
-# A new section here: TODO?
-
-MAybe where we describe a schematics of the intuition overall?
-Like: stepwise with bullet point
-- run DE
-- run FEA as usual, passing the call (with a pipe or in a call itself) to EMMA_run
-- show how to retrieve info (just the names)
-- summarizing the info
-- explaining it
-(in my eyes, a "chunk not evaluated could be also good") + a figure would be fantastic with a simple diagram?
-Maybe a diagram that would show what EMMA puts in and avoids you to take notes of?
-
-
-
 # Usage example of `EMMA`: the `macrophage` dataset
 
 ## About the data
 
-In the remainder of this vignette, we will illustrate the main features of `r BiocStyle::Biocpkg("EMMA")` on a publicly available dataset from Alasoo, et al. "Shared genetic effects on chromatin
-and gene expression indicate a role for enhancer priming in immune response",
+In the remainder of this vignette, we will illustrate the main features of `r BiocStyle::Biocpkg("EMMA")` on a publicly available dataset from
+Alasoo, et al. "Shared genetic effects on chromatin and gene expression
+indicate a role for enhancer priming in immune response", 
 published in Nature Genetics, January 2018 
 [@Alasoo2018].
 
@@ -455,9 +443,10 @@ EMMA_get_record(frankenstein_fea2)$extra
 
 Since the `EMMA_record` is attached as attribute to the original results objects,
 it can be preserved when integrating results into structured containers
-such as `r BiocStyle::Biocpkg("DeeDeeExperiment")` [@Abassi2026]. This enables both FEA results and
-their associated provenance information to be stored and managed together,
-facilitating reproducibility, organization, and sharing of complex omics analyses.
+such as `r BiocStyle::Biocpkg("DeeDeeExperiment")` [@Abassi2026].
+This enables both FEA results and their associated provenance information
+to be stored and managed together, facilitating reproducibility, organization,
+and sharing of complex omics analyses.
 
 ```{r emma_and_dde}
 #| class-output: scrollout

From 3ecb3434a8328edd8d898919c4dfee8005811a8d Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Fri, 15 May 2026 15:02:26 +0200
Subject: [PATCH 79/92] adding reference to tidylog and omicslog

---
 vignettes/Introduction_to_EMMA.Rmd | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/vignettes/Introduction_to_EMMA.Rmd b/vignettes/Introduction_to_EMMA.Rmd
index 1d6892f..ac44db6 100644
--- a/vignettes/Introduction_to_EMMA.Rmd
+++ b/vignettes/Introduction_to_EMMA.Rmd
@@ -61,6 +61,14 @@ limiting reproducibility and interpretability. Currently, no standardized framew
 exists to ensure transparent and reproducible documentation of FEA workflows,
 comparable to the MIAME guidelines [@Brazma2001].
 
+Similar approaches have been developed outside the Bioconductor ecosystem to
+improve transparency and reproducibility in other analytical contexts.
+For example, `tidylog` records operations performed with `dplyr` and `tidyr`,
+while [`omicslog`](https://github.com/tidyomics/omicslog) tracks transformations
+applied to omics-oriented objects.
+However, no tool specifically addresses the metadata and provenance requirements
+of FEA workflows.
+
 To address this gap, we introduce `r BiocStyle::Biocpkg("EMMA")` (standing for 
 **E**nrichment **M**ethods **MA**tters), a framework that automatically captures key 
 analytical parameters and provenance information

From 18a9a77b6eaf8800cd48303e545c68912013133d Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 18 May 2026 12:06:20 +0200
Subject: [PATCH 80/92] removing unecessary installations from gha yaml

---
 .github/workflows/R-CMD-check.yaml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/workflows/R-CMD-check.yaml b/.github/workflows/R-CMD-check.yaml
index b97a276..5631f06 100644
--- a/.github/workflows/R-CMD-check.yaml
+++ b/.github/workflows/R-CMD-check.yaml
@@ -94,7 +94,6 @@ jobs:
           local_deps <- remotes::local_package_deps(dependencies = TRUE)
           deps <- remotes::dev_package_deps(dependencies = TRUE, repos = BiocManager::repositories())
           BiocManager::install(local_deps[local_deps %in% deps$package[deps$diff != 0]], Ncpu = 2L)
-          BiocManager::install(c("GenomeInfoDbData", "GO.db"), Ncpu = 2L)
           remotes::install_cran('rcmdcheck', Ncpu = 2L)
         shell: Rscript {0}
 

From f5e8873410d68e619b97da773e3060825733f441 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 18 May 2026 12:07:29 +0200
Subject: [PATCH 81/92] update the universe data name and fix comments

---
 R/EMMA-data.R                           |   2 +-
 data/gene_universe.RData                | Bin 0 -> 1780 bytes
 data/universe.RData                     | Bin 1756 -> 0 bytes
 inst/scripts/create_datasets_examples.R |   6 +++---
 4 files changed, 4 insertions(+), 4 deletions(-)
 create mode 100644 data/gene_universe.RData
 delete mode 100644 data/universe.RData

diff --git a/R/EMMA-data.R b/R/EMMA-data.R
index c66f05f..d7ad654 100644
--- a/R/EMMA-data.R
+++ b/R/EMMA-data.R
@@ -40,7 +40,7 @@ NULL
 #' expression indicate a role for enhancer priming in immune response",
 #' Nature Genetics, January 2018 doi: 10.1038/s41588-018-0046-7.
 #'
-#' @name universe
+#' @name gene_universe
 #' @docType data
 NULL
 
diff --git a/data/gene_universe.RData b/data/gene_universe.RData
new file mode 100644
index 0000000000000000000000000000000000000000..4a0f0218dabbf8d8c63634e94fadd7a3afc8e8b4
GIT binary patch
literal 1780
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
WS^xks?ZVVPFb#_W000000a;pPOKy7r

literal 0
HcmV?d00001

diff --git a/data/universe.RData b/data/universe.RData
deleted file mode 100644
index f8f7c84cf6a03b6cff7144e83239045ba463b1d2..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 1756
zcmV<21|#|XH+ooF0004LBHlIv03iV!0000G&sfahEh`3~T>vQ&2UKVg<Ze>RpfklK
zA+`t`^LEM5g0JmSTuuD9u`sR7lvVPfyqs-C2`X*g$FXF@Vf-KrBKoy<BxSK32(6E>
z-5)p_@$tCQRs)!MY79i+!i}BM8O$erVo4MQA|^&cn0h;<zSbN3ia`Tx#jL$MMr{}p
zPn+&4XBFH^<?<0CbTSj+<Kjuv%j-TL6f6fQNw<0P;9svzb$J6J>E3rPmEuOl*rYN^
z5J1Blz+W3#azvdO8*pL?v6eaB!F%32F;lq7x;7?FtN<-(vQ~<w&W6~Dem&}Yu1~_e
zVaQ?oH{pV;hL*ItuaZoV4kafuQ}Nsq`l6P)FL;3|?NPpdGUCO^%Pcdy<LsJa@f*qe
zN9Y;8kD_x8qx1;{@8NrO?pd5S$J90fILKzZ_l0EXR}<xOOf$z3zI`>`XA@y;+iOIP
zs-!QkKbFEYZeZ_0K{UPeW!S$4(n|XNbK=Ruc^4%qnc~lXAXyYWxlF~nw9_HRxUSO=
zXeMVTrY*9EIcIst=@#iO;KIz*ePTt}T8F<P1EJ?Z^KcF{veD1RJ1^3aTLG2gzBExy
z?Drt!2%`(d!!{l@F);|mIp3f|1I7g~M2p9@gfege<mEG)1HuYiSKlpt^2ZN#D@{Pt
zMZ)oHC4?s~Q0#;%rHQf>D<uCF^0k6i&I$vK+YBXG6g1*~#W-waYfovRbU`>I=H55f
z0zB#rlk+*5*(s=7Fg95S<io&V<{f8cX*o%SdN_b+qDyl$Q~b3dm%yr`N6E}ghJvvD
z90n6c9#t$LJ!R#zx3v$#NbBbIh2ql1@vu20y973^!{DFDCoBjI1A*{sItKlk5=$Ec
z?*d#m;Q_o1!g<x{C>vh?BeLU)xoDer$snWi22y#MB^b2H^3gm+6e%^wNe90kNN%#a
zc7C0uC8)!p%At=DgU+W7jI>>;$QAcU_$!^N3m0mX4(OOp51F&OCG=rC<q%dpFT=do
zyGU^HOz@iv#{(_>Z#Xwkb0EzN@GWo|tRhVb0v+*|a;8jAQwqnh=q<dN6v2S-07Ic)
z(HYIqHznPpbGiAw<DHS(dMrwa2jPtW&;!k{5-Fx=kcTPO8$6e0uIodNeSKpo#mMH(
z%=cbr^no(ei-Qo2u^DIz$2|Eo;uD_ti-Pd03$X(KOZGLBZ#sZ8i&rm+SHH@|9I3&5
zS+fYkb4p^d%kb?-jQ$@eo1>$7z|*8mjW@wP5|GdUAM(l2{Hf@g1@~KMq2lRdN{ud(
zS=LU)4Jq^2<a}=vegTyc;!%G0E||ieIGuX10lhrVpjJ$Y;Y+KOlnTfUKutqM=`IC=
z;8s(`dzq$)2CYz~fVd%P6jst>xYQ&<Be`tO#AFtU=xsUo2{w0iY&{CHS-JhxF%_Gi
z#$QVET}Qp?!Rai-?g1$3fEE-p1~On=xuJh%>Oke_%Hw!~Tr}4%-!?Ux<EZ80r*|LW
zy?m=XjA?hu*`pIXyao>3Pw4j5!~(|8=cJ2-8PONjGTB3cUql-{YqsR|DlMdg!9VeL
z{zpEF$ILf&pj7PSasen-=mx0JdtX1>i@cn^L%b3@d+RkVm?o>#_vXC&BKOQQ<^g=V
zr0f3cDZ=!SER_b<%^JHbgn^{KUyqZ;MQpO**br!_2&UHq&|);)n*=_vwOqP4GGpBj
zmBdJcP&unT!=pdxhz}FE66eScmZ4v6!KT+mgZ0QS@<;zuhQY=mlL*E|AKeH<>v0`@
z5)Ss=meJ~V>TC{F^__79%1C>>K|K)0D;Kyw+M@)5x~$}ZAL38P-7*n)E53BG(A*XH
zxFv!Cq;JiAj*Mkp={X%@VcHDlRHdQ)-1%>nOtbEm`NQ3-wVd;df@D(r!W;S9j`5?i
z)2TXsdJoiwQU>bS1sDZPRWpFZtsSOitXokhRYlQ`(LGOGY7Vm}5#Zto7-w?_68sGW
zX&p+w>_EIN1>t%5KUblvjqJTnWb)rgHr=qRwDoEHBI0d8c`?8h!bQAM;#U%Y0ynSr
z>YfHNLsE;BaDg=eHq3Cp4Ckj=7X2Yh_bVq*vCE)mr9VH1{s9sUEQpSb7MsGMm;bCB
zhPoerY0IYCtY#JNR)x!8kz&H*z)(+bEK92-_I&+_@yO%7zdh>#kHs@ZNMw*hm6D5)
z0bmsqe{NGcR1=F|GN2*u5av;sDru6o)`DTCE`k0i)ky5JwRAq1huNZ3Ax}F>kMb{@
yOCisE(K;l11Iwn)Fn9e`&;S5p=F4UP0k{pUS^xmAjLNG%Fb#_W000000a;r7^;Z7?

diff --git a/inst/scripts/create_datasets_examples.R b/inst/scripts/create_datasets_examples.R
index 0f4ff02..d388a9c 100644
--- a/inst/scripts/create_datasets_examples.R
+++ b/inst/scripts/create_datasets_examples.R
@@ -9,7 +9,7 @@ dds_macrophage
 # DE run
 # set seed for reproducibility
 set.seed(2711)
-# sample randomly for 2k genes
+# sample randomly for 500 genes
 selected_genes <- sample(rownames(dds_macrophage), 500)
 
 dds_macrophage <- dds_macrophage[selected_genes, ]
@@ -42,12 +42,12 @@ library("gprofiler2")
 fea_res <- gprofiler2::gost(query = de_res_IFNg_vs_naive$SYMBOL,
                             organism = "hsapiens",
                             correction_method = "fdr",
-                            custom_bg = universe,
+                            custom_bg = gene_universe,
                             sources = "GO:BP") |> EMMA_run(
                               store_session_info = FALSE,
                               args_form = "unevaluated")
 
 save(de_res_IFNg_vs_naive, file = "de_res_IFNg_vs_naive.RData", compress = "xz")
-save(universe, file = "universe.RData", compress = "xz")
+save(gene_universe, file = "gene_universe.RData", compress = "xz")
 save(fea_res, file = "fea_res.RData", compress = "xz")
 

From 4f7d289ee83d610f314653089d0808841e0c1730 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 18 May 2026 12:07:50 +0200
Subject: [PATCH 82/92] update EMMA figure

---
 vignettes/EMMA_workflow.png | Bin 114552 -> 114513 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/vignettes/EMMA_workflow.png b/vignettes/EMMA_workflow.png
index d0f9da255b16b6f82c8c07d9a6d458c49e1e19c6..dc8ba88ad7bede4b1e14c8279ab88e9a757705fe 100644
GIT binary patch
literal 114513
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
H^RNE{Oidk+

literal 114552
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


From 6dcf8f9980a12757b39e958bc9827863d33ff290 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 18 May 2026 12:08:26 +0200
Subject: [PATCH 83/92] add indentation in examples

---
 R/EMMA_add_custom_metadata.R | 2 +-
 R/EMMA_run.R                 | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/R/EMMA_add_custom_metadata.R b/R/EMMA_add_custom_metadata.R
index a41a6fc..675cd0b 100644
--- a/R/EMMA_add_custom_metadata.R
+++ b/R/EMMA_add_custom_metadata.R
@@ -16,7 +16,7 @@
 #' @examples
 #' data("fea_res", package = "EMMA")
 #' fea_res <- EMMA_add_custom_metadata(fea_res, extra =
-#' list(note = "The background gene set list was all expressed genes in the assay"))
+#'   list(note = "The background gene set list was all expressed genes in the assay"))
 EMMA_add_custom_metadata <- function(res,
                                      extra = list()) {
 
diff --git a/R/EMMA_run.R b/R/EMMA_run.R
index 3b461f8..d7cff40 100644
--- a/R/EMMA_run.R
+++ b/R/EMMA_run.R
@@ -35,8 +35,8 @@
 #' library(gprofiler2)
 #' 
 #' EMMA_run(gost(query = de_res_IFNg_vs_naive$SYMBOL, organism = "hsapiens",
-#' correction_method = "fdr", custom_bg = universe, sources = "GO:BP"),
-#' store_session_info = FALSE, args_form = "unevaluated")
+#'   correction_method = "fdr", custom_bg = universe, sources = "GO:BP"),
+#'   store_session_info = FALSE, args_form = "unevaluated")
 EMMA_run <- function(expr,
                      envir = parent.frame(),
                      store_session_info = TRUE,

From 84b2a2371c14ffd370f9f71d4485a23eb74fa680 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 18 May 2026 12:08:56 +0200
Subject: [PATCH 84/92] updating the news before submission

---
 NEWS.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/NEWS.md b/NEWS.md
index 9b52e36..667354d 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -1,3 +1,7 @@
+# EMMA 0.99.0
+
+* Ready for Bioconductor submission!
+
 # EMMA 0.3.0
 
 * Added the initial implementation of `EMMA_freeze()`.

From dca216cdded3f0c19a995b6975d393b14ffa6ac6 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 18 May 2026 12:26:22 +0200
Subject: [PATCH 85/92] adding the current supported functions ... we can
 update it further when we expand the pkg

---
 R/EMMA_get_record.R    | 3 +++
 man/EMMA_get_record.Rd | 4 ++++
 2 files changed, 7 insertions(+)

diff --git a/R/EMMA_get_record.R b/R/EMMA_get_record.R
index 5dd2e86..f105ef2 100644
--- a/R/EMMA_get_record.R
+++ b/R/EMMA_get_record.R
@@ -5,6 +5,9 @@
 #'
 #' @return list of metadata recorded during FEA runtime
 #' @export
+#' 
+#' @seealso [enrichGO()], [groupGO()], [gseGO()], [gseKEGG()], [enrichKEGG()],
+#'  [gost()], [run_cluPro()], [run_topGO()], [run_goseq()]
 #'
 #' @examples
 #' data("fea_res", package = "EMMA")
diff --git a/man/EMMA_get_record.Rd b/man/EMMA_get_record.Rd
index a2c2617..7678801 100644
--- a/man/EMMA_get_record.Rd
+++ b/man/EMMA_get_record.Rd
@@ -20,3 +20,7 @@ EMMA_get_record
 data("fea_res", package = "EMMA")
 EMMA_get_record(fea_res)
 }
+\seealso{
+\code{\link[clusterProfiler:enrichGO]{enrichGO()}}, \code{\link[clusterProfiler:groupGO]{groupGO()}}, \code{\link[clusterProfiler:gseGO]{gseGO()}}, \code{\link[clusterProfiler:gseKEGG]{gseKEGG()}}, \code{\link[clusterProfiler:enrichKEGG]{enrichKEGG()}},
+\code{\link[gprofiler2:gost]{gost()}}, \code{\link[mosdef:run_cluPro]{run_cluPro()}}, \code{\link[mosdef:run_topGO]{run_topGO()}}, \code{\link[mosdef:run_goseq]{run_goseq()}}
+}

From e35c6c8b09f744ec3d0ea920716f7b60fddf19f2 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 18 May 2026 12:26:36 +0200
Subject: [PATCH 86/92] update man page

---
 man/EMMA_add_custom_metadata.Rd       | 2 +-
 man/EMMA_run.Rd                       | 4 ++--
 man/{universe.Rd => gene_universe.Rd} | 4 ++--
 3 files changed, 5 insertions(+), 5 deletions(-)
 rename man/{universe.Rd => gene_universe.Rd} (95%)

diff --git a/man/EMMA_add_custom_metadata.Rd b/man/EMMA_add_custom_metadata.Rd
index 502249f..782521b 100644
--- a/man/EMMA_add_custom_metadata.Rd
+++ b/man/EMMA_add_custom_metadata.Rd
@@ -25,5 +25,5 @@ captured automatically
 \examples{
 data("fea_res", package = "EMMA")
 fea_res <- EMMA_add_custom_metadata(fea_res, extra =
-list(note = "The background gene set list was all expressed genes in the assay"))
+  list(note = "The background gene set list was all expressed genes in the assay"))
 }
diff --git a/man/EMMA_run.Rd b/man/EMMA_run.Rd
index 72dee43..8eb62c6 100644
--- a/man/EMMA_run.Rd
+++ b/man/EMMA_run.Rd
@@ -50,6 +50,6 @@ data("universe", package = "EMMA")
 library(gprofiler2)
 
 EMMA_run(gost(query = de_res_IFNg_vs_naive$SYMBOL, organism = "hsapiens",
-correction_method = "fdr", custom_bg = universe, sources = "GO:BP"),
-store_session_info = FALSE, args_form = "unevaluated")
+  correction_method = "fdr", custom_bg = universe, sources = "GO:BP"),
+  store_session_info = FALSE, args_form = "unevaluated")
 }
diff --git a/man/universe.Rd b/man/gene_universe.Rd
similarity index 95%
rename from man/universe.Rd
rename to man/gene_universe.Rd
index aae40db..aaa6359 100644
--- a/man/universe.Rd
+++ b/man/gene_universe.Rd
@@ -1,8 +1,8 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/EMMA-data.R
 \docType{data}
-\name{universe}
-\alias{universe}
+\name{gene_universe}
+\alias{gene_universe}
 \title{A sample \verb{character vector} containing the background gene list used to
 perform FEA on the \code{macrophage} dataset}
 \format{

From 808656dacb9cd6187ff2753d15a4f30cec9bed7a Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 18 May 2026 12:53:12 +0200
Subject: [PATCH 87/92] update examples and tests to match the universe new
 name

---
 R/EMMA_run.R                          |  4 ++--
 README.md                             |  4 ++--
 man/EMMA_run.Rd                       |  4 ++--
 tests/testthat/setuptests_EMMA.R      |  2 +-
 tests/testthat/test-EMMA_explain.R    |  2 +-
 tests/testthat/test-EMMA_get_record.R |  2 +-
 tests/testthat/test-EMMA_metadata.R   |  8 ++++----
 tests/testthat/test-EMMA_run.R        | 10 +++++-----
 tests/testthat/test-EMMA_show.R       |  3 ++-
 9 files changed, 20 insertions(+), 19 deletions(-)

diff --git a/R/EMMA_run.R b/R/EMMA_run.R
index d7cff40..5926519 100644
--- a/R/EMMA_run.R
+++ b/R/EMMA_run.R
@@ -31,11 +31,11 @@
 #'
 #' @examples
 #' data("de_res_IFNg_vs_naive", package = "EMMA")
-#' data("universe", package = "EMMA")
+#' data("gene_universe", package = "EMMA")
 #' library(gprofiler2)
 #' 
 #' EMMA_run(gost(query = de_res_IFNg_vs_naive$SYMBOL, organism = "hsapiens",
-#'   correction_method = "fdr", custom_bg = universe, sources = "GO:BP"),
+#'   correction_method = "fdr", custom_bg = gene_universe, sources = "GO:BP"),
 #'   store_session_info = FALSE, args_form = "unevaluated")
 EMMA_run <- function(expr,
                      envir = parent.frame(),
diff --git a/README.md b/README.md
index d4fdc85..685fc19 100644
--- a/README.md
+++ b/README.md
@@ -23,11 +23,11 @@ remotes::install_github("imbeimainz/EMMA",
 library(EMMA)
 # load data
 data("de_res_IFNg_vs_naive", package = "EMMA")
-data("universe", package = "EMMA")
+data("gene_universe", package = "EMMA")
 
 # run analysis
 fea_results <- enrichGO(gene = rownames(de_res_IFNg_vs_naive),
-                        universe = universe,
+                        universe = gene_universe,
                         keyType = "ENSEMBL",
                         OrgDb = org.Hs.eg.db,
                         ont = "BP") |> 
diff --git a/man/EMMA_run.Rd b/man/EMMA_run.Rd
index 8eb62c6..c503f82 100644
--- a/man/EMMA_run.Rd
+++ b/man/EMMA_run.Rd
@@ -46,10 +46,10 @@ internally invoke a know enrichment function.
 }
 \examples{
 data("de_res_IFNg_vs_naive", package = "EMMA")
-data("universe", package = "EMMA")
+data("gene_universe", package = "EMMA")
 library(gprofiler2)
 
 EMMA_run(gost(query = de_res_IFNg_vs_naive$SYMBOL, organism = "hsapiens",
-  correction_method = "fdr", custom_bg = universe, sources = "GO:BP"),
+  correction_method = "fdr", custom_bg = gene_universe, sources = "GO:BP"),
   store_session_info = FALSE, args_form = "unevaluated")
 }
diff --git a/tests/testthat/setuptests_EMMA.R b/tests/testthat/setuptests_EMMA.R
index dcc56a1..104f1ae 100644
--- a/tests/testthat/setuptests_EMMA.R
+++ b/tests/testthat/setuptests_EMMA.R
@@ -7,6 +7,6 @@ suppressPackageStartupMessages({
 })
 
 data("de_res_IFNg_vs_naive", package = "EMMA")
-data("universe", package = "EMMA")
+data("gene_universe", package = "EMMA")
 data("fea_res", package = "EMMA")
 
diff --git a/tests/testthat/test-EMMA_explain.R b/tests/testthat/test-EMMA_explain.R
index 114b182..f063cb6 100644
--- a/tests/testthat/test-EMMA_explain.R
+++ b/tests/testthat/test-EMMA_explain.R
@@ -37,7 +37,7 @@ test_that("EMMA_explain", {
   
   
   res_topGO <- run_topGO(de_genes = rownames(de_res),
-                         bg_genes = universe,
+                         bg_genes = gene_universe,
                          ontology = "BP",
                          gene_id = "ENSEMBL",
                          mapping = "org.Hs.eg.db",
diff --git a/tests/testthat/test-EMMA_get_record.R b/tests/testthat/test-EMMA_get_record.R
index 44df8b9..358897f 100644
--- a/tests/testthat/test-EMMA_get_record.R
+++ b/tests/testthat/test-EMMA_get_record.R
@@ -4,7 +4,7 @@ test_that("EMMA_get_record", {
   
   fea_no_emma <- mosdef::run_cluPro(de_genes = 
                                       rownames(de_res_IFNg_vs_naive),
-                                    bg_genes = universe,
+                                    bg_genes = gene_universe,
                                     mapping = "org.Hs.eg.db",
                                     keyType = "ENSEMBL",
                                     ont = "BP",
diff --git a/tests/testthat/test-EMMA_metadata.R b/tests/testthat/test-EMMA_metadata.R
index 6d3135a..023a21f 100644
--- a/tests/testthat/test-EMMA_metadata.R
+++ b/tests/testthat/test-EMMA_metadata.R
@@ -2,7 +2,7 @@ test_that("test metadata content & structure", {
   
   fea_res <- EMMA_run(mosdef::run_cluPro(de_genes = 
                                            rownames(de_res_IFNg_vs_naive),
-                                         bg_genes = universe,
+                                         bg_genes = gene_universe,
                                          mapping = "org.Hs.eg.db",
                                          keyType = "ENSEMBL",
                                          ont = "BP",
@@ -24,7 +24,7 @@ test_that("test metadata content & structure", {
   expect_true(emma_rec$method$wrapper)
   
   expect_null(.EMMA_find_original_wrapped_fun("mosdef::run_cluPro(de_genes = rownames(de_res_IFNg_vs_naive),
-                                                                bg_genes = universe,
+                                                                bg_genes = gene_universe,
                                                                 mapping = 'org.Hs.eg.db',
                                                                 keyType = 'ENSEMBL',
                                                                 ont = 'BP')"))
@@ -36,7 +36,7 @@ test_that("test metadata content & structure", {
   
   
   expect_warning(res <- EMMA_run(mosdef::run_goseq(de_genes = rownames(de_res_IFNg_vs_naive),
-                                   bg_genes = universe,
+                                   bg_genes = gene_universe,
                                    mapping = "org.Hs.eg.db",
                                    id = "ensGene",
                                    genome = "hg19")))
@@ -66,7 +66,7 @@ test_that("test metadata content & structure", {
   fea_res <- gprofiler2::gost(query = de_res_IFNg_vs_naive$SYMBOL,
                               organism = "hsapiens",
                               correction_method = "fdr",
-                              custom_bg = universe) |> EMMA_run()
+                              custom_bg = gene_universe) |> EMMA_run()
   
   rec <- EMMA_get_record(fea_res)
   
diff --git a/tests/testthat/test-EMMA_run.R b/tests/testthat/test-EMMA_run.R
index 1c862c6..ef70d52 100644
--- a/tests/testthat/test-EMMA_run.R
+++ b/tests/testthat/test-EMMA_run.R
@@ -6,7 +6,7 @@ test_that("EMMA_run", {
                                pAdjustMethod = "BH",
                                pvalueCutoff = 0.05,
                                qvalueCutoff = 0.1,
-                               universe = universe,
+                               universe = gene_universe,
                                readable = TRUE))
   expect_s4_class(fea_res, "enrichResult")
   
@@ -22,7 +22,7 @@ test_that("EMMA_run", {
                                                      pAdjustMethod = "BH",
                                                      pvalueCutoff = 0.05,
                                                      qvalueCutoff = 0.1,
-                                                     universe = universe,
+                                                     universe = gene_universe,
                                                      readable = TRUE)))
   
   expect_type(info, "list")
@@ -35,7 +35,7 @@ test_that("EMMA_run", {
                         pAdjustMethod = "BH",
                         pvalueCutoff = 0.05,
                         qvalueCutoff = 0.1,
-                        universe = universe,
+                        universe = gene_universe,
                         readable = TRUE))
   
   expect_error(EMMA_run("enrichGO(gene = rownames(de_res_IFNg_vs_naive),
@@ -48,7 +48,7 @@ test_that("EMMA_run", {
                         pAdjustMethod = "BH",
                         pvalueCutoff = 0.05,
                         qvalueCutoff = 0.1,
-                        universe = universe,
+                        universe = gene_universe,
                         readable = TRUE))
   
   expect_warning(EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
@@ -56,7 +56,7 @@ test_that("EMMA_run", {
                           OrgDb = org.Hs.eg.db,
                           pvalueCutoff = 0.05,
                           qvalueCutoff = 0.1,
-                          universe = universe,
+                          universe = gene_universe,
                           readable = TRUE)))
   
   expect_warning(EMMA_run(enrichGO(gene = rownames(de_res_IFNg_vs_naive),
diff --git a/tests/testthat/test-EMMA_show.R b/tests/testthat/test-EMMA_show.R
index db0ec52..e994932 100644
--- a/tests/testthat/test-EMMA_show.R
+++ b/tests/testthat/test-EMMA_show.R
@@ -62,7 +62,8 @@ test_that("EMMA_show", {
     method = list(
       call = substitute(gost(query = de_res_IFNg_vs_naive$SYMBOL,
                              organism = "hsapiens",
-                             correction_method = "fdr", custom_bg = universe,
+                             correction_method = "fdr",
+                             custom_bg = gene_universe,
                              sources = "GO:BP")),
       wrapper = FALSE,
       package_name = "gprofiler2",

From 723f28c1682c98b86bbdced7359277a58b29c5a5 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 18 May 2026 15:24:02 +0200
Subject: [PATCH 88/92] add supported methods and future extensions section

---
 vignettes/Introduction_to_EMMA.Rmd | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/vignettes/Introduction_to_EMMA.Rmd b/vignettes/Introduction_to_EMMA.Rmd
index ac44db6..25712cb 100644
--- a/vignettes/Introduction_to_EMMA.Rmd
+++ b/vignettes/Introduction_to_EMMA.Rmd
@@ -492,6 +492,16 @@ if (requireNamespace("renv", quietly = TRUE)) {
 }
 ```
 
+# Supported methods and future extensions
+
+`EMMA` currently provides metadata capture support for several commonly used
+FEA tools, including methods from `r BiocStyle::Biocpkg("clusterProfiler")`,
+`r BiocStyle::Biocpkg("gprofiler2")`, and related wrappers/custom functions
+such as `r BiocStyle::Biocpkg("mosdef")`.
+
+`EMMA` is designed to be extensible, and support for additional FEA methods
+and packages will continue to expand over time.
+
 # Session info {.unnumbered}
 
 ```{css}

From e58c66b5492e88b7e3855d9ee86a1c4e7b4b9daa Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Mon, 18 May 2026 15:26:14 +0200
Subject: [PATCH 89/92] update version

---
 DESCRIPTION | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DESCRIPTION b/DESCRIPTION
index 1c616ae..da41875 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -1,7 +1,7 @@
 Package: EMMA
 Title: EMMA: Enrichment Methods Matter for enabling fully reproducible and 
     provenance-aware pathway analysis
-Version: 0.3.0
+Version: 0.99.0
 Authors@R: 
     c(
         person(

From 11bb21255efdb5f43586515701081d3060955d48 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Tue, 19 May 2026 12:21:06 +0200
Subject: [PATCH 90/92] fix spaces in EMMA_show()

---
 R/EMMA_show.R | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/R/EMMA_show.R b/R/EMMA_show.R
index 4d249bd..58c5657 100644
--- a/R/EMMA_show.R
+++ b/R/EMMA_show.R
@@ -22,10 +22,10 @@ EMMA_show <- function(res){
     if (is.list(res) && !is.data.frame(res)) {
       # e.g. case of gost, returns a list but it's 1 FEA (result)
       if ("result" %in% names(res)) {
-        cat("Number of Pathways: ", NROW(res$result), "\n")
+        cat("Number of Pathways:", NROW(res$result), "\n")
       } else {
         # let's say if we have of list of FEAs (returned by custom function)
-        cat("Number of FEAs: ", length(res), "\n")
+        cat("Number of FEAs:", length(res), "\n")
         
         nms <- names(res)
         if (is.null(nms) || any(nms == "")) {
@@ -34,23 +34,23 @@ EMMA_show <- function(res){
         
         for (i in seq_along(res)) {
           # check the number of pathways for each element of the list
-          cat(" -", nms[i], ": ", NROW(res[[i]]), " pathways\n")
+          cat(" -", nms[i], ":", NROW(res[[i]]), " pathways\n")
         }
       }
     } else {
-      cat("Number of Pathways: ", NROW(res), "\n")
+      cat("Number of Pathways:", NROW(res), "\n")
     }
     
     method_info <- emma_rec$method
     db_info <- emma_rec$annotation
     
-    cat("Call: ", paste(deparse(method_info$call), collapse = " "), " \n")
-    cat("Wrapper: ", method_info$wrapper, " \n")
-    cat("Package: ", paste(method_info$package_name , "v.",
+    cat("Call:", paste(deparse(method_info$call), collapse = " "), " \n")
+    cat("Wrapper:", method_info$wrapper, " \n")
+    cat("Package:", paste0(method_info$package_name , " v. ",
                            method_info$package_version), " \n")
-    cat("Organism : ", db_info$organism, " \n")
-    cat("Gene set library : ", paste(db_info$gene_set_db, collapse = ", "), " \n")
-    cat("Gene set library version : ",db_info$gene_set_db_version, " \n")
+    cat("Organism:", db_info$organism, " \n")
+    cat("Gene set library:", paste(db_info$gene_set_db, collapse = ","), " \n")
+    cat("Gene set library version:",db_info$gene_set_db_version, " \n")
     cat("\n")
     
   } else {

From d1cb7f933226563de5ed86a7b5aa3d96efa82e55 Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Tue, 19 May 2026 12:21:19 +0200
Subject: [PATCH 91/92] update tests

---
 tests/testthat/test-EMMA_show.R | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/testthat/test-EMMA_show.R b/tests/testthat/test-EMMA_show.R
index e994932..b5fb514 100644
--- a/tests/testthat/test-EMMA_show.R
+++ b/tests/testthat/test-EMMA_show.R
@@ -50,7 +50,7 @@ test_that("EMMA_show", {
       gene_set_db_version = NA
     )
   )
-  expect_output(EMMA_show(fea2), "Number of FEAs:  2")
+  expect_output(EMMA_show(fea2), "Number of FEAs: 2")
   expect_output(EMMA_show(fea2), "- FEA_1")
   expect_output(EMMA_show(fea2),"FEA_2")
   
@@ -76,7 +76,7 @@ test_that("EMMA_show", {
     )
   )
   
-  expect_output(EMMA_show(fea_gost), "Number of Pathways:  2")
+  expect_output(EMMA_show(fea_gost), "Number of Pathways: 2")
   
   
 })

From 73983e5449b9868b83190ee03a1e5a3e6773176c Mon Sep 17 00:00:00 2001
From: Najla Abassi <abassi.nejla96@gmail.com>
Date: Tue, 19 May 2026 12:22:07 +0200
Subject: [PATCH 92/92] add workflow example with lapply in the vignette

---
 vignettes/Introduction_to_EMMA.Rmd | 77 ++++++++++++++++++++++++++++--
 1 file changed, 73 insertions(+), 4 deletions(-)

diff --git a/vignettes/Introduction_to_EMMA.Rmd b/vignettes/Introduction_to_EMMA.Rmd
index 25712cb..b9ac952 100644
--- a/vignettes/Introduction_to_EMMA.Rmd
+++ b/vignettes/Introduction_to_EMMA.Rmd
@@ -176,9 +176,15 @@ dds_macrophage <- DESeqDataSet(gse, design = ~ line + condition)
 # preprocess
 rownames(dds_macrophage) <- substr(rownames(dds_macrophage), 1, 15)
 keep <- rowSums(counts(dds_macrophage) >= 10) >= 6
-
 dds_macrophage <- dds_macrophage[keep, ]
 
+# set seed for reproducibility
+set.seed(2711)
+# sample randomly for 2k genes
+selected_genes <- sample(rownames(dds_macrophage), 2000)
+
+dds_macrophage <- dds_macrophage[selected_genes, ]
+
 # run DESeq
 dds_macrophage <- DESeq(dds_macrophage)
 
@@ -191,10 +197,26 @@ IFNg_vs_naive <- lfcShrink(dds_macrophage, coef = "condition_IFNg_vs_naive",
                            type = "apeglm")
 IFNg_vs_naive$SYMBOL <- rowData(dds_macrophage)$SYMBOL
 
+# get de res for 2st contrast
+SL1344_vs_naive <- results(dds_macrophage,
+                         contrast = c("condition", "SL1344", "naive"),
+                         lfcThreshold = 1, alpha = 0.05)
+SL1344_vs_naive <- lfcShrink(dds_macrophage, coef = "condition_SL1344_vs_naive",
+                           res = SL1344_vs_naive,
+                           type = "apeglm")
+SL1344_vs_naive$SYMBOL <- rowData(dds_macrophage)$SYMBOL
+
 # sort by adjusted p value
-de_res <- IFNg_vs_naive[order(IFNg_vs_naive$padj), ]
-de_res <- de_res[!(is.na(de_res$padj)) & de_res$padj <= 0.05, ]
+de_list <- list(
+  IFNg_vs_naive = IFNg_vs_naive,
+  SL1344_vs_naive = SL1344_vs_naive
+)
 
+de_list <- lapply(de_list, function(df) {
+  df <- df[order(df$padj), ]
+  df <- df[!is.na(df$padj) & df$padj <= 0.05, ]
+  df
+})
 # set background gene list
 gene_universe <- rownames(dds_macrophage)
 ```
@@ -209,6 +231,8 @@ In the following example, we will use the
 function `enrichGO()` from `r BiocStyle::Biocpkg("clusterProfiler")`
 
 ```{r withoutemma}
+de_res <- de_list$IFNg_vs_naive
+
 fea_res <- enrichGO(gene = rownames(de_res),
                     universe = gene_universe,
                     keyType = "ENSEMBL",
@@ -482,7 +506,7 @@ used in practice, rather than attempting to enforce a fully consistent state.
 
 ```{r EMMA_freeze}
 if (requireNamespace("renv", quietly = TRUE)) {
-  project_path <- tempfile("my_project_with_emma")
+  project_path <- tempdir()
   dir.create(project_path)
   EMMA_freeze(project = project_path,
               file = "analysis.lock",
@@ -492,6 +516,51 @@ if (requireNamespace("renv", quietly = TRUE)) {
 }
 ```
 
+## `EMMA` with iterative workflows
+
+In real-world analyses, multiple FEA results from different contrasts
+are often analyzed in parallel This can be conveniently handled using
+iterative approaches such as `lapply()`.
+
+```{r emma_with_lapply}
+fea_res_list <- lapply(de_list, function(dea){
+  #### perform fea with EMMA_run ####
+  enrichGO(gene = rownames(dea),
+           universe = gene_universe,
+           keyType = "ENSEMBL",
+           OrgDb = org.Hs.eg.db,
+           ont = "BP",
+           pAdjustMethod = "BH",
+           pvalueCutoff = 0.05,
+           qvalueCutoff = 0.1,
+           readable = TRUE) |> 
+    EMMA_run()
+})
+
+#### print the metadata summary for each contrast ####
+invisible(lapply(names(fea_res_list), function(nm) {
+  cat("\n###", nm)
+  EMMA_show(fea_res_list[[nm]])
+}))
+
+#### add more info to the metadata ####
+fea_res_list <- setNames(lapply(names(fea_res_list), function(nm) {
+  EMMA_add_custom_metadata(fea_res_list[[nm]], extra = list(contrast_name = nm))
+  }), 
+names(fea_res_list))
+
+#### get the raw metadata ####
+record_list <- list()
+
+record_list <- setNames(lapply(names(fea_res_list), function(mn){
+  EMMA_get_record(fea_res_list[[mn]])
+  }),
+names(fea_res_list))
+
+record_list$SL1344_vs_naive$extra
+record_list$SL1344_vs_naive$method$package_name
+```
+
 # Supported methods and future extensions
 
 `EMMA` currently provides metadata capture support for several commonly used