Nothing
# Infrastructure for the test-functional_*.R files, mirroring the functional
# testing approach in {manynet} (since v2.2.0, see helper-functional.R there).
# Where manynet enumerates function families (to_*, net_*, ...) over a fixture
# grid, autograph's natural families are its layout algorithms
# (layout_tbl_graph_*), its plot.<class> S3 methods, its palette accessors
# (ag_*), and graphr()'s aesthetic arguments. Each family is enumerated
# automatically from the namespace, so new layouts/methods/palettes are picked
# up and audited without writing new tests. Non-conformant combinations are
# skipped with a structured "AUDIT [...]" message rather than failed, so test
# output can be grepped to find where implementations still need work.
# Exported functions in a family, excluding deprecated/defunct shims
ag_alive_functions <- function(pattern) {
fns <- sort(grep(pattern, getNamespaceExports("autograph"), value = TRUE))
# A retired layout is an ordinary function forwarding to its replacement, so
# nothing in its body marks it as retired. The package declares them instead,
# and this reads that declaration rather than keeping a second copy of it.
retired <- c(paste0("layout_tbl_graph_", autograph:::.deprecated_layouts()),
paste0("layout_", autograph:::.deprecated_layouts()))
keep <- vapply(fns, function(f) {
fun <- get(f, envir = asNamespace("autograph"))
is.function(fun) && !f %in% retired &&
!grepl("Deprecated|Defunct",
paste(deparse(body(fun)), collapse = " "))
}, logical(1))
fns[keep]
}
# plot.<class> S3 methods registered by autograph
ag_plot_classes <- function() {
fns <- grep("^plot\\.", ls(asNamespace("autograph")), value = TRUE)
sort(sub("^plot\\.", "", fns))
}
# Evaluate expr; on error, skip with a structured, greppable audit message.
# Under AUTOGRAPH_STRICT_AUDIT=true (set for CI, see .github/workflows/) the
# error is raised as a failure instead, so a broken layout or plot method
# cannot pass CI green. Locally the default remains skip-and-report, so the
# audits stay usable as a to-do list of implementations still needing work.
run_or_skip <- function(expr, fn, fixture) {
tryCatch(
expr,
error = function(e) {
msg <- paste0("AUDIT [", fn, " x ", fixture, "]: ", conditionMessage(e))
if (isTRUE(as.logical(Sys.getenv("AUTOGRAPH_STRICT_AUDIT", "false")))) {
testthat::fail(msg)
} else testthat::skip(msg)
}
)
}
# A plot is only really tested once it is built: building forces layout
# computation, aesthetic mapping, and scale training, which is where most
# plotting bugs live. Accepts ggplot, patchwork, or ggraph objects.
expect_buildable <- function(p) {
testthat::expect_s3_class(p, "ggplot")
built <- ggplot2::ggplot_build(p)
testthat::expect_true(!is.null(built))
invisible(built)
}
# `plot.goldfishFit()` composes its panels out of goldfish's own
# diagnostics rather than out of the fit alone, so no precooked fixture can
# stand in for them: without goldfish, or with one older than the 1.9.21 that
# added them, every panel drops and the method prints and returns NULL. Tests
# of what the composition contains are skipped there. The test is for the
# functions rather than for the version string, matching the shims in
# R/autograph-defunct.R, since a pre-release build can carry the version
# without yet exporting them.
skip_without_gf_diagnostics <- function() {
testthat::skip_if_not_installed("goldfish")
needed <- c("diagnose_outliers", "test_gof")
missing <- setdiff(needed, getNamespaceExports("goldfish"))
if (length(missing) > 0) {
testthat::skip(paste("goldfish does not export",
paste(missing, collapse = ", ")))
}
}
# Standard grid of fixture networks covering the formats autograph's
# layouts and graphr() aesthetics are expected to handle.
ag_fixtures <- local({
set.seed(1234)
list(
basic = manynet::create_ring(8),
directed = manynet::generate_random(8, directed = TRUE),
labelled = manynet::ison_adolescents,
twomode = manynet::ison_southern_women,
weighted = manynet::add_tie_attribute(manynet::create_ring(8), "weight",
rep(c(1, 2), each = 4)),
signed = manynet::to_signed(manynet::create_ring(8)),
attributed = manynet::add_node_attribute(manynet::create_ring(8), "group",
rep(c("A", "B"), each = 4)),
multiplex = manynet::ison_algebra,
tree = manynet::create_tree(10, directed = TRUE)
)
})
# The candidate pool the layout audit selects from. ag_fixtures covers the
# formats, but several layouts are declared (in .layout_requirements(), see
# R/graph_checks.R) to need a particular size or shape that the grid has no
# example of: the configurational layouts want exactly 2-6 nodes, and a ladder
# wants two equally sized modes. Adding those here rather than pinning a
# network per layout in the test means the audit picks its own fixtures, and a
# new layout needs no test change at all.
ag_layout_pool <- c(ag_fixtures, local({
set.seed(1234)
list(
dyadic = manynet::create_ring(2),
triadic = manynet::create_ring(3),
tetradic = manynet::create_ring(4),
pentadic = manynet::create_ring(5),
hexadic = manynet::create_ring(6),
# Two-mode sizes are given as a vector; ison_southern_women is 18/14, so
# the pool needs an equally sized pair for the ladder layout
balanced = manynet::create_ring(c(4, 4)),
acyclic = manynet::create_tree(8, directed = TRUE),
# Nodes with positions, for the spatial layout
spatial = manynet::mutate_nodes(manynet::create_ring(8),
x = cos(seq(0, 7) * pi / 4),
y = sin(seq(0, 7) * pi / 4))
)
}))
# What a plot draws, layer by layer. Two plots of the same network each hold a
# graph of their own, so the plots themselves never compare equal where the
# network is converted on the way in; what they draw does.
drawn_layers <- function(p) {
lapply(seq_along(p$layers), function(i) ggplot2::layer_data(p, i))
}
Any scripts or data that you put into this service are public.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.