{
  "_id": "6af6ca66535793c85332b0e9",
  "Package": "fnware",
  "Title": "Ready-Made Function Decorators",
  "Version": "0.1.0",
  "Authors@R": "person(\"Dyfan\", \"Jones\", , \"dyfan.r.jones@gmail.com\", role = c(\"aut\", \"cre\"))",
  "Description": "Ready-made function decorators for R, built on the 'adorn'\nframework. Covers resilience (retrying, timeouts, rate\nlimiting, circuit breaking and fallbacks), caching, call\nlogging, context managers and argument validation, with\nasynchronous versions for functions that return promises.",
  "License": "MIT + file LICENSE",
  "URL": "https://dyfanjones.github.io/fnware/,\nhttps://github.com/DyfanJones/fnware",
  "BugReports": "https://github.com/DyfanJones/fnware/issues",
  "Remotes": [
    "DyfanJones/adorn",
    "RConsortium/S7"
  ],
  "Config/testthat/edition": "3",
  "Config/roxygen2/version": "8.1.1",
  "Encoding": "UTF-8",
  "Roxygen": "list(markdown = TRUE)",
  "Collate": "'async_utils.R' 'cache_utils.R' 'async_cache.R'\n'circuit_breaker_utils.R' 'async_circuit_breaker.R'\n'fallback.R' 'async_fallback.R' 'log_logger.R' 'log_call.R'\n'async_log_call.R' 'once.R' 'async_once.R' 'rate_limit.R'\n'async_rate_limit.R' 'retry_utils.R' 'retry_after.R'\n'retry_before.R' 'retry_retry.R' 'retry_wait.R' 'retry_stop.R'\n'async_retry.R' 'timeout_method.R' 'timeout_utils.R'\n'async_timeout.R' 'validate.R' 'async_validate.R' 'cache.R'\n'circuit_breaker.R' 'contextmanager.R' 'log_extend.R'\n'reexport-S7.R' 'reexport-adorn.R' 'retry.R' 'retry_extend.R'\n'timeout.R' 'utils.R' 'zzz.R'",
  "VignetteBuilder": "litedown",
  "Repository": "https://dyfanjones.r-universe.dev",
  "Date/Publication": "2026-11-11 17:02:32 UTC",
  "RemoteUrl": "https://github.com/DyfanJones/fnware",
  "RemoteRef": "HEAD",
  "RemoteSha": "4e5ee11f56d3c838d0b8a2bf2e2ab22d51755a05",
  "NeedsCompilation": "no",
  "Packaged": {
    "Date": "2026-11-11 17:20:59 UTC",
    "User": "root"
  },
  "Author": "Dyfan Jones [aut, cre]",
  "Maintainer": "Dyfan Jones <dyfan.r.jones@gmail.com>",
  "_user": "dyfanjones",
  "_type": "src",
  "_file": "fnware_0.1.0.tar.gz",
  "_fileid": "https://r2.ropensci.org/d4a6468fbe6596faf700d9b67bba47938d829ebbc43aa11dbf9b9369e74096d3",
  "_filesize": 410292,
  "_sha256": "d4a6468fbe6596faf700d9b67bba47938d829ebbc43aa11dbf9b9369e74096d3",
  "_expires": "2027-02-19T17:24:54.000Z",
  "_created": "2026-11-11T17:20:59.000Z",
  "_published": "2026-11-13T08:29:26.225Z",
  "_upstream": "https://github.com/DyfanJones/fnware",
  "_status": "success",
  "_maintainer": {
    "name": "Dyfan Jones",
    "email": "dyfan.r.jones@gmail.com",
    "login": "dyfanjones",
    "description": "",
    "uuid": 23235152
  },
  "_jobs": [
    {
      "job": 131778113484,
      "time": 135,
      "config": "linux-devel-x86_64",
      "r": "4.7.0",
      "check": "FAIL",
      "artifact": ""
    },
    {
      "job": 131778113823,
      "time": 128,
      "config": "linux-release-x86_64",
      "r": "4.6.2",
      "check": "FAIL",
      "artifact": ""
    },
    {
      "job": 131778113895,
      "time": 68,
      "config": "macos-oldrel-arm64",
      "r": "4.5.3",
      "check": "FAIL",
      "artifact": ""
    },
    {
      "job": 131778113778,
      "time": 104,
      "config": "macos-release-arm64",
      "r": "4.6.2",
      "check": "FAIL",
      "artifact": ""
    },
    {
      "job": 131778162832,
      "time": 195,
      "config": "source",
      "r": "4.6.2",
      "check": "OK",
      "artifact": "13876092794"
    },
    {
      "job": 131778116217,
      "time": 92,
      "config": "wasm-release",
      "r": "4.6.0",
      "check": "OK",
      "artifact": "13875763491"
    },
    {
      "job": 131778113870,
      "time": 97,
      "config": "windows-devel-x86_64",
      "r": "4.7.0",
      "check": "FAIL",
      "artifact": ""
    },
    {
      "job": 131778113909,
      "time": 108,
      "config": "windows-oldrel-x86_64",
      "r": "4.5.3",
      "check": "FAIL",
      "artifact": ""
    },
    {
      "job": 131778113958,
      "time": 57,
      "config": "windows-release-x86_64",
      "r": "4.6.2",
      "check": "FAIL",
      "artifact": ""
    }
  ],
  "_buildurl": "https://github.com/r-universe/dyfanjones/actions/runs/43065507289",
  "_commit": {
    "id": "4e5ee11f56d3c838d0b8a2bf2e2ab22d51755a05",
    "author": "Dyfan <dyfanjones@hotmail.com>",
    "committer": "Dyfan <dyfanjones@hotmail.com>",
    "message": "docs: add logo to readme and site\n",
    "time": 1794416552
  },
  "_distro": "resolute",
  "_host": "GitHub-Actions",
  "_registered": true,
  "_dependencies": [
    {
      "package": "R",
      "version": ">= 4.4.0",
      "role": "Depends"
    },
    {
      "package": "adorn",
      "role": "Imports"
    },
    {
      "package": "S7",
      "version": ">= 0.2.2.9000",
      "role": "Imports"
    },
    {
      "package": "rlang",
      "role": "Imports"
    },
    {
      "package": "cachem",
      "role": "Imports"
    },
    {
      "package": "stats",
      "role": "Imports"
    },
    {
      "package": "withr",
      "role": "Imports"
    },
    {
      "package": "callr",
      "role": "Suggests"
    },
    {
      "package": "later",
      "role": "Suggests"
    },
    {
      "package": "litedown",
      "role": "Suggests"
    },
    {
      "package": "logger",
      "role": "Suggests"
    },
    {
      "package": "mirai",
      "role": "Suggests"
    },
    {
      "package": "promises",
      "role": "Suggests"
    },
    {
      "package": "qs2",
      "role": "Suggests"
    },
    {
      "package": "testthat",
      "version": ">= 3.0.0",
      "role": "Suggests"
    }
  ],
  "_owner": "dyfanjones",
  "_selfowned": true,
  "_usedby": 0,
  "_updates": [
    {
      "week": "2026-44",
      "n": 25
    },
    {
      "week": "2026-45",
      "n": 13
    },
    {
      "week": "2026-46",
      "n": 4
    }
  ],
  "_tags": [],
  "_stars": 1,
  "_contributors": [
    {
      "user": "dyfanjones",
      "count": 42,
      "uuid": 23235152
    }
  ],
  "_userbio": {
    "uuid": 23235152,
    "type": "user",
    "name": "Larefly",
    "followers": 41
  },
  "_downloads": {
    "count": 0,
    "source": "https://cranlogs.r-pkg.org/downloads/total/last-month/fnware"
  },
  "_devurl": "https://github.com/dyfanjones/fnware",
  "_pkgdown": "https://dyfanjones.github.io/fnware/",
  "_searchresults": 11,
  "_rbuild": "4.6.2",
  "_assets": [
    "extra/citation.cff",
    "extra/citation.html",
    "extra/citation.json",
    "extra/citation.txt",
    "extra/contents.json",
    "extra/fnware.html",
    "extra/manual.pdf",
    "extra/readme.html",
    "extra/readme.md",
    "LICENSE"
  ],
  "_cranurl": false,
  "_exports": [
    ":=",
    "%@%",
    "after_sleep_base",
    "after_sleep_fn",
    "after_sleep_log",
    "after_sleep_none",
    "as_decorator",
    "async_cache",
    "async_circuit_breaker",
    "async_disk_cache",
    "async_fallback",
    "async_log_call",
    "async_lru_cache",
    "async_once",
    "async_rate_limit",
    "async_retry",
    "async_timeout",
    "async_timeout_base",
    "async_timeout_fn",
    "async_timeout_later",
    "async_validate_return",
    "before_sleep_base",
    "before_sleep_fn",
    "before_sleep_log",
    "before_sleep_none",
    "cache",
    "circuit_breaker",
    "contextmanager",
    "disk_cache",
    "fallback",
    "log_call",
    "log_levels",
    "logger_base",
    "logger_fn",
    "logger_message",
    "lru_cache",
    "once",
    "rate_limit",
    "retry",
    "retry_all",
    "retry_base",
    "retry_fn",
    "retry_if_error",
    "retry_if_error_message",
    "retry_if_result",
    "retry_never",
    "stop_after_attempt",
    "stop_after_delay",
    "stop_all",
    "stop_any",
    "stop_base",
    "stop_before_delay",
    "stop_fn",
    "stop_never",
    "teardown",
    "timeout",
    "timeout_base",
    "timeout_fn",
    "timeout_r",
    "timeout_remaining",
    "validate_args",
    "validate_return",
    "wait_base",
    "wait_chain",
    "wait_combine",
    "wait_exp",
    "wait_exp_jitter",
    "wait_fixed",
    "wait_fn",
    "wait_none",
    "wait_rand",
    "with_context"
  ],
  "_help": [
    {
      "page": "extending_retry",
      "title": "Write your own stop, wait, retry and hook strategies",
      "topics": [
        "after_sleep_base",
        "after_sleep_fn",
        "before_sleep_base",
        "before_sleep_fn",
        "extending_retry",
        "retry_base",
        "retry_fn",
        "stop_base",
        "stop_fn",
        "wait_base",
        "wait_fn"
      ]
    },
    {
      "page": "after_sleep",
      "title": "Run a hook after 'retry()' sleeps",
      "topics": [
        "after_sleep_log",
        "after_sleep_none"
      ]
    },
    {
      "page": "as_decorator",
      "title": "Use a context manager as a decorator",
      "topics": [
        "as_decorator"
      ]
    },
    {
      "page": "async_circuit_breaker",
      "title": "Stop calling an asynchronous function that keeps failing",
      "topics": [
        "async_circuit_breaker"
      ]
    },
    {
      "page": "async_fallback",
      "title": "Return a default when an asynchronous function fails",
      "topics": [
        "async_fallback"
      ]
    },
    {
      "page": "async_log_call",
      "title": "Log the calls to an asynchronous function",
      "topics": [
        "async_log_call"
      ]
    },
    {
      "page": "async_lru_cache",
      "title": "Cache the results of asynchronous functions",
      "topics": [
        "async_cache",
        "async_disk_cache",
        "async_lru_cache"
      ]
    },
    {
      "page": "async_once",
      "title": "Run an asynchronous function only once",
      "topics": [
        "async_once"
      ]
    },
    {
      "page": "async_rate_limit",
      "title": "Limit how often an asynchronous function can be called",
      "topics": [
        "async_rate_limit"
      ]
    },
    {
      "page": "async_retry",
      "title": "Retry a function without blocking",
      "topics": [
        "async_retry"
      ]
    },
    {
      "page": "async_timeout",
      "title": "Bound how long an asynchronous call can take",
      "topics": [
        "async_timeout",
        "async_timeout_base",
        "async_timeout_fn",
        "async_timeout_later"
      ]
    },
    {
      "page": "async_validate_return",
      "title": "Validate the value an asynchronous function resolves to",
      "topics": [
        "async_validate_return"
      ]
    },
    {
      "page": "before_sleep",
      "title": "Run a hook before 'retry()' sleeps",
      "topics": [
        "before_sleep_log",
        "before_sleep_none"
      ]
    },
    {
      "page": "circuit_breaker",
      "title": "Stop calling a function that keeps failing",
      "topics": [
        "circuit_breaker"
      ]
    },
    {
      "page": "contextmanager",
      "title": "Write setup and teardown once",
      "topics": [
        "contextmanager",
        "teardown"
      ]
    },
    {
      "page": "extending_log",
      "title": "Use a logging package with 'log_call()'",
      "topics": [
        "extending_log"
      ]
    },
    {
      "page": "extending_timeout",
      "title": "Write your own timeout method",
      "topics": [
        "extending_timeout",
        "timeout_base",
        "timeout_fn"
      ]
    },
    {
      "page": "fallback",
      "title": "Return a default when a function fails",
      "topics": [
        "fallback"
      ]
    },
    {
      "page": "log_call",
      "title": "Log the calls to a function",
      "topics": [
        "log_call"
      ]
    },
    {
      "page": "log_levels",
      "title": "The level of each event 'log_call()' logs",
      "topics": [
        "log_levels"
      ]
    },
    {
      "page": "loggers",
      "title": "Loggers",
      "topics": [
        "logger_base",
        "logger_fn",
        "logger_message"
      ]
    },
    {
      "page": "lru_cache",
      "title": "Cache function results",
      "topics": [
        "cache",
        "disk_cache",
        "lru_cache"
      ]
    },
    {
      "page": "once",
      "title": "Run a function only once",
      "topics": [
        "once"
      ]
    },
    {
      "page": "rate_limit",
      "title": "Limit how often a function can be called",
      "topics": [
        "rate_limit"
      ]
    },
    {
      "page": "retry",
      "title": "Retry a function when it fails",
      "topics": [
        "retry"
      ]
    },
    {
      "page": "retry_conditions",
      "title": "Retry conditions",
      "topics": [
        "retry_all",
        "retry_if_error",
        "retry_if_error_message",
        "retry_if_result",
        "retry_never"
      ]
    },
    {
      "page": "stop_conditions",
      "title": "Stop conditions",
      "topics": [
        "stop_after_attempt",
        "stop_after_delay",
        "stop_all",
        "stop_any",
        "stop_before_delay",
        "stop_never"
      ]
    },
    {
      "page": "timeout",
      "title": "Bound how long a call can run",
      "topics": [
        "timeout",
        "timeout_r",
        "timeout_remaining"
      ]
    },
    {
      "page": "validate_args",
      "title": "Validate arguments and return values",
      "topics": [
        "validate_args",
        "validate_return"
      ]
    },
    {
      "page": "wait_strategies",
      "title": "Wait strategies",
      "topics": [
        "wait_chain",
        "wait_combine",
        "wait_exp",
        "wait_exp_jitter",
        "wait_fixed",
        "wait_none",
        "wait_rand"
      ]
    },
    {
      "page": "with_context",
      "title": "Run code inside a context",
      "topics": [
        "with_context"
      ]
    }
  ],
  "_pkglogo": "https://github.com/DyfanJones/fnware/raw/HEAD/man/figures/logo.png",
  "_readme": "https://github.com/DyfanJones/fnware/raw/HEAD/README.md",
  "_rundeps": [
    "adorn",
    "cachem",
    "fastmap",
    "rlang",
    "S7",
    "withr"
  ],
  "_vignettes": [
    {
      "source": "async.Rmd",
      "filename": "async.html",
      "title": "Asynchronous decorators",
      "engine": "litedown::vignette",
      "headings": [
        "Why not the blocking version?",
        "Stacking"
      ],
      "created": "2026-11-05 19:23:14",
      "modified": "2026-11-05 19:23:14",
      "commits": 1
    },
    {
      "source": "caching.Rmd",
      "filename": "caching.html",
      "title": "Caching results",
      "engine": "litedown::vignette",
      "headings": [
        "In memory",
        "What counts as the same call",
        "What is and is not cached",
        "Limiting size",
        "On disk",
        "Changing the function",
        "Choosing a file format",
        "With promises",
        "When not to cache",
        "Choosing"
      ],
      "created": "2026-10-31 01:06:12",
      "modified": "2026-11-05 12:08:26",
      "commits": 4
    },
    {
      "source": "decorators.Rmd",
      "filename": "decorators.html",
      "title": "Choosing and stacking decorators",
      "engine": "litedown::vignette",
      "headings": [
        "Which decorator do I want?",
        "Stacking order"
      ],
      "created": "2026-11-05 19:23:14",
      "modified": "2026-11-05 19:23:14",
      "commits": 1
    },
    {
      "source": "contextmanager.Rmd",
      "filename": "contextmanager.html",
      "title": "Context managers",
      "engine": "litedown::vignette",
      "headings": [
        "The problem with on.exit()",
        "What withr already does",
        "What contextmanager adds",
        "A worked comparison",
        "With withr, by hand",
        "With contextmanager",
        "When not to use it",
        "Behaviour worth knowing",
        "How it works"
      ],
      "created": "2026-10-31 01:06:12",
      "modified": "2026-11-05 12:08:26",
      "commits": 2
    },
    {
      "source": "circuitbreaker.Rmd",
      "filename": "circuitbreaker.html",
      "title": "Failing fast with a circuit breaker",
      "engine": "litedown::vignette",
      "headings": [
        "A service that is down",
        "The three states",
        "What counts as a failure",
        "Handling an open circuit",
        "Using it with retry",
        "With promises",
        "Notes"
      ],
      "created": "2026-10-31 19:03:38",
      "modified": "2026-11-05 12:08:26",
      "commits": 4
    },
    {
      "source": "fallback.Rmd",
      "filename": "fallback.html",
      "title": "Fallbacks and running once",
      "engine": "litedown::vignette",
      "headings": [
        "Returning a default",
        "Stacking with retry and the circuit breaker",
        "Promises",
        "Running once"
      ],
      "created": "2026-11-05 14:16:06",
      "modified": "2026-11-05 19:23:14",
      "commits": 2
    },
    {
      "source": "logging.Rmd",
      "filename": "logging.html",
      "title": "Logging calls",
      "engine": "litedown::vignette",
      "headings": [
        "Levels",
        "Traces",
        "Loggers",
        "Using a logging package",
        "Promises"
      ],
      "created": "2026-11-05 14:16:06",
      "modified": "2026-11-10 20:19:04",
      "commits": 4
    },
    {
      "source": "retry.Rmd",
      "filename": "retry.html",
      "title": "Retrying failing calls",
      "engine": "litedown::vignette",
      "headings": [
        "A function that fails at first",
        "Deciding when to stop",
        "Deciding how long to wait",
        "Deciding what to retry",
        "Seeing what is happening",
        "Bounding hung calls",
        "Passing the time on",
        "What it cannot stop",
        "Writing a timeout method",
        "Retrying without blocking",
        "Bounding a slow promise",
        "Writing your own strategies",
        "Putting it together",
        "Notes"
      ],
      "created": "2026-10-31 01:06:12",
      "modified": "2026-11-05 19:23:14",
      "commits": 10
    },
    {
      "source": "validation.Rmd",
      "filename": "validation.html",
      "title": "Validating arguments and results",
      "engine": "litedown::vignette",
      "headings": [
        "What counts as a validator",
        "Messages",
        "Which arguments are checked",
        "Validating the result",
        "Handling failures",
        "Combining with other decorators",
        "Promises"
      ],
      "created": "2026-10-31 16:09:56",
      "modified": "2026-11-05 19:23:14",
      "commits": 4
    }
  ],
  "_score": 4.171726453653231,
  "_indexed": true,
  "_nocasepkg": "fnware",
  "_universes": [
    "dyfanjones"
  ],
  "_binaries": [
    {
      "r": "4.6.2",
      "os": "linux",
      "version": "0.1.0",
      "date": "2026-11-11T17:20:59.000Z",
      "distro": "resolute",
      "commit": "4e5ee11f56d3c838d0b8a2bf2e2ab22d51755a05",
      "fileid": "https://r2.ropensci.org/f614974524f696918ee2394507889b2d57066976fa6807d5429ae63df9c8c215",
      "status": "success",
      "buildurl": "https://github.com/r-universe/dyfanjones/actions/runs/43065507289"
    },
    {
      "r": "4.6.0",
      "os": "wasm",
      "version": "0.1.0",
      "date": "2026-11-11T17:23:36.000Z",
      "commit": "4e5ee11f56d3c838d0b8a2bf2e2ab22d51755a05",
      "fileid": "https://r2.ropensci.org/9bba60fa11d3e3526893627ccab03eac644d81aaf4a869d13a8fb38d96b04c90",
      "status": "success",
      "buildurl": "https://github.com/r-universe/dyfanjones/actions/runs/43065507289"
    }
  ]
}