`, etc.) that has more than one element. Defaults to 1 (for ``).
+ getTopLevel: function($scope) {
+ for (var i = 1; i <= 6; i++) {
+ var $headings = this.findOrFilter($scope, 'h' + i);
+ if ($headings.length > 1) {
+ return i;
+ }
+ }
+
+ return 1;
+ },
+
+ // returns the elements for the top level, and the next below it
+ getHeadings: function($scope, topLevel) {
+ var topSelector = 'h' + topLevel;
+
+ var secondaryLevel = topLevel + 1;
+ var secondarySelector = 'h' + secondaryLevel;
+
+ return this.findOrFilter($scope, topSelector + ',' + secondarySelector);
+ },
+
+ getNavLevel: function(el) {
+ return parseInt(el.tagName.charAt(1), 10);
+ },
+
+ populateNav: function($topContext, topLevel, $headings) {
+ var $context = $topContext;
+ var $prevNav;
+
+ var helpers = this;
+ $headings.each(function(i, el) {
+ var $newNav = helpers.generateNavItem(el);
+ var navLevel = helpers.getNavLevel(el);
+
+ // determine the proper $context
+ if (navLevel === topLevel) {
+ // use top level
+ $context = $topContext;
+ } else if ($prevNav && $context === $topContext) {
+ // create a new level of the tree and switch to it
+ $context = helpers.createChildNavList($prevNav);
+ } // else use the current $context
+
+ $context.append($newNav);
+
+ $prevNav = $newNav;
+ });
+ },
+
+ parseOps: function(arg) {
+ var opts;
+ if (arg.jquery) {
+ opts = {
+ $nav: arg
+ };
+ } else {
+ opts = arg;
+ }
+ opts.$scope = opts.$scope || $(document.body);
+ return opts;
+ }
+ },
+
+ // accepts a jQuery object, or an options object
+ init: function(opts) {
+ opts = this.helpers.parseOps(opts);
+
+ // ensure that the data attribute is in place for styling
+ opts.$nav.attr('data-toggle', 'toc');
+
+ var $topContext = this.helpers.createChildNavList(opts.$nav);
+ var topLevel = this.helpers.getTopLevel(opts.$scope);
+ var $headings = this.helpers.getHeadings(opts.$scope, topLevel);
+ this.helpers.populateNav($topContext, topLevel, $headings);
+ }
+ };
+
+ $(function() {
+ $('nav[data-toggle="toc"]').each(function(i, el) {
+ var $nav = $(el);
+ Toc.init($nav);
+ });
+ });
+})();
diff --git a/docs/docsearch.css b/docs/docsearch.css
new file mode 100644
index 0000000..e5f1fe1
--- /dev/null
+++ b/docs/docsearch.css
@@ -0,0 +1,148 @@
+/* Docsearch -------------------------------------------------------------- */
+/*
+ Source: https://github.com/algolia/docsearch/
+ License: MIT
+*/
+
+.algolia-autocomplete {
+ display: block;
+ -webkit-box-flex: 1;
+ -ms-flex: 1;
+ flex: 1
+}
+
+.algolia-autocomplete .ds-dropdown-menu {
+ width: 100%;
+ min-width: none;
+ max-width: none;
+ padding: .75rem 0;
+ background-color: #fff;
+ background-clip: padding-box;
+ border: 1px solid rgba(0, 0, 0, .1);
+ box-shadow: 0 .5rem 1rem rgba(0, 0, 0, .175);
+}
+
+@media (min-width:768px) {
+ .algolia-autocomplete .ds-dropdown-menu {
+ width: 175%
+ }
+}
+
+.algolia-autocomplete .ds-dropdown-menu::before {
+ display: none
+}
+
+.algolia-autocomplete .ds-dropdown-menu [class^=ds-dataset-] {
+ padding: 0;
+ background-color: rgb(255,255,255);
+ border: 0;
+ max-height: 80vh;
+}
+
+.algolia-autocomplete .ds-dropdown-menu .ds-suggestions {
+ margin-top: 0
+}
+
+.algolia-autocomplete .algolia-docsearch-suggestion {
+ padding: 0;
+ overflow: visible
+}
+
+.algolia-autocomplete .algolia-docsearch-suggestion--category-header {
+ padding: .125rem 1rem;
+ margin-top: 0;
+ font-size: 1.3em;
+ font-weight: 500;
+ color: #00008B;
+ border-bottom: 0
+}
+
+.algolia-autocomplete .algolia-docsearch-suggestion--wrapper {
+ float: none;
+ padding-top: 0
+}
+
+.algolia-autocomplete .algolia-docsearch-suggestion--subcategory-column {
+ float: none;
+ width: auto;
+ padding: 0;
+ text-align: left
+}
+
+.algolia-autocomplete .algolia-docsearch-suggestion--content {
+ float: none;
+ width: auto;
+ padding: 0
+}
+
+.algolia-autocomplete .algolia-docsearch-suggestion--content::before {
+ display: none
+}
+
+.algolia-autocomplete .ds-suggestion:not(:first-child) .algolia-docsearch-suggestion--category-header {
+ padding-top: .75rem;
+ margin-top: .75rem;
+ border-top: 1px solid rgba(0, 0, 0, .1)
+}
+
+.algolia-autocomplete .ds-suggestion .algolia-docsearch-suggestion--subcategory-column {
+ display: block;
+ padding: .1rem 1rem;
+ margin-bottom: 0.1;
+ font-size: 1.0em;
+ font-weight: 400
+ /* display: none */
+}
+
+.algolia-autocomplete .algolia-docsearch-suggestion--title {
+ display: block;
+ padding: .25rem 1rem;
+ margin-bottom: 0;
+ font-size: 0.9em;
+ font-weight: 400
+}
+
+.algolia-autocomplete .algolia-docsearch-suggestion--text {
+ padding: 0 1rem .5rem;
+ margin-top: -.25rem;
+ font-size: 0.8em;
+ font-weight: 400;
+ line-height: 1.25
+}
+
+.algolia-autocomplete .algolia-docsearch-footer {
+ width: 110px;
+ height: 20px;
+ z-index: 3;
+ margin-top: 10.66667px;
+ float: right;
+ font-size: 0;
+ line-height: 0;
+}
+
+.algolia-autocomplete .algolia-docsearch-footer--logo {
+ background-image: url("data:image/svg+xml;utf8,");
+ background-repeat: no-repeat;
+ background-position: 50%;
+ background-size: 100%;
+ overflow: hidden;
+ text-indent: -9000px;
+ width: 100%;
+ height: 100%;
+ display: block;
+ transform: translate(-8px);
+}
+
+.algolia-autocomplete .algolia-docsearch-suggestion--highlight {
+ color: #FF8C00;
+ background: rgba(232, 189, 54, 0.1)
+}
+
+
+.algolia-autocomplete .algolia-docsearch-suggestion--text .algolia-docsearch-suggestion--highlight {
+ box-shadow: inset 0 -2px 0 0 rgba(105, 105, 105, .5)
+}
+
+.algolia-autocomplete .ds-suggestion.ds-cursor .algolia-docsearch-suggestion--content {
+ background-color: rgba(192, 192, 192, .15)
+}
diff --git a/docs/docsearch.js b/docs/docsearch.js
new file mode 100644
index 0000000..b35504c
--- /dev/null
+++ b/docs/docsearch.js
@@ -0,0 +1,85 @@
+$(function() {
+
+ // register a handler to move the focus to the search bar
+ // upon pressing shift + "/" (i.e. "?")
+ $(document).on('keydown', function(e) {
+ if (e.shiftKey && e.keyCode == 191) {
+ e.preventDefault();
+ $("#search-input").focus();
+ }
+ });
+
+ $(document).ready(function() {
+ // do keyword highlighting
+ /* modified from https://jsfiddle.net/julmot/bL6bb5oo/ */
+ var mark = function() {
+
+ var referrer = document.URL ;
+ var paramKey = "q" ;
+
+ if (referrer.indexOf("?") !== -1) {
+ var qs = referrer.substr(referrer.indexOf('?') + 1);
+ var qs_noanchor = qs.split('#')[0];
+ var qsa = qs_noanchor.split('&');
+ var keyword = "";
+
+ for (var i = 0; i < qsa.length; i++) {
+ var currentParam = qsa[i].split('=');
+
+ if (currentParam.length !== 2) {
+ continue;
+ }
+
+ if (currentParam[0] == paramKey) {
+ keyword = decodeURIComponent(currentParam[1].replace(/\+/g, "%20"));
+ }
+ }
+
+ if (keyword !== "") {
+ $(".contents").unmark({
+ done: function() {
+ $(".contents").mark(keyword);
+ }
+ });
+ }
+ }
+ };
+
+ mark();
+ });
+});
+
+/* Search term highlighting ------------------------------*/
+
+function matchedWords(hit) {
+ var words = [];
+
+ var hierarchy = hit._highlightResult.hierarchy;
+ // loop to fetch from lvl0, lvl1, etc.
+ for (var idx in hierarchy) {
+ words = words.concat(hierarchy[idx].matchedWords);
+ }
+
+ var content = hit._highlightResult.content;
+ if (content) {
+ words = words.concat(content.matchedWords);
+ }
+
+ // return unique words
+ var words_uniq = [...new Set(words)];
+ return words_uniq;
+}
+
+function updateHitURL(hit) {
+
+ var words = matchedWords(hit);
+ var url = "";
+
+ if (hit.anchor) {
+ url = hit.url_without_anchor + '?q=' + escape(words.join(" ")) + '#' + hit.anchor;
+ } else {
+ url = hit.url + '?q=' + escape(words.join(" "));
+ }
+
+ return url;
+}
diff --git a/docs/favicon-96x96.png b/docs/favicon-96x96.png
new file mode 100644
index 0000000..76f9467
Binary files /dev/null and b/docs/favicon-96x96.png differ
diff --git a/docs/favicon.ico b/docs/favicon.ico
new file mode 100644
index 0000000..bbe3706
Binary files /dev/null and b/docs/favicon.ico differ
diff --git a/docs/favicon.svg b/docs/favicon.svg
new file mode 100644
index 0000000..dfc546e
--- /dev/null
+++ b/docs/favicon.svg
@@ -0,0 +1,3 @@
+
\ No newline at end of file
diff --git a/docs/index.html b/docs/index.html
new file mode 100644
index 0000000..950089d
--- /dev/null
+++ b/docs/index.html
@@ -0,0 +1,623 @@
+
+
+
+
+
+
+
+Bioinformatics Library for Integrated Tools • blit
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+The goal of blit is to make it easy to execute command line tool from R.
+
+Installation
+
+You can install blit from CRAN using:
+
+install.packages("blit")
+Alternatively, install the development version from GitHub with:
+
+# install.packages("remotes")
+remotes::install_github("WangLabCSU/blit")
+
+
+Example
+
+
+
+Execute command
+
+To build a command, simply use exec. The first argument is the command name, and you can also provide the full path. After that, pass the command parameters. This will create a command object:
+
+exec("echo", "$PATH")
+#> <Execute: echo>
+To run the command, just pass the command object to the cmd_run() (Note: stdout = "|" is always used in the vignette to ensure that the standard output can be captured by knitr.)
+
+Sys.setenv(TEST = "blit is awesome")
+exec("echo", "$TEST") |> cmd_run(stdout = "|")
+#> Running command (2025-04-08 05:58:19): echo $TEST
+#>
+#> blit is awesome
+#> Running scheduled exit task
+#> Command process finished
+#> System command succeed
+Alternatively, you can run it in the background. In this case, a process object will be returned. For more information, refer to the official site:
+
+proc <- exec("echo", "$TEST") |> cmd_background(stdout = "")
+proc$kill()
+Sys.unsetenv("TEST")
+
+We use some tricks to capture the output from the background process. The actual implementation in the README.Rmd differs, but the output remains the same.
+
+
+cmd_background() is provided for completeness. Instead of using this function, we recommend using cmd_parallel(), which can run multiple commands in the background while ensuring that all processes are properly cleaned up when the process exits.
+
+# ip address are copied from quora <What are some famous IP addresses?>: https://qr.ae/pYlnbQ
+address <- c("localhost", "208.67.222.222", "8.8.8.8", "8.8.4.4")
+cmd_parallel(
+ !!!lapply(address, function(ip) exec("ping", ip)),
+ stdouts = TRUE,
+ stdout_callbacks = lapply(
+ seq_len(4),
+ function(i) {
+ force(i)
+ function(text, proc) {
+ sprintf("Connection %d: %s", i, text)
+ }
+ }
+ ),
+ timeouts = 4, # terminate after 4s
+ threads = 4
+)
+#> Running command (2025-04-08 05:58:19): ping localhost
+#> Running command (2025-04-08 05:58:19): ping 208.67.222.222
+#> Running command (2025-04-08 05:58:19): ping 8.8.8.8
+#> Running command (2025-04-08 05:58:19): ping 8.8.4.4
+#>
+#> Connection 1: PING localhost (::1) 56 data bytes
+#> Connection 1: 64 bytes from localhost (::1): icmp_seq=1 ttl=64 time=0.017 ms
+#> ⠙ 0/4 [0/s] [elapsed in 76ms] @ 2025-04-08 05:58:19
+#> ⠹ 0/4 [0/s] [elapsed in 290ms] @ 2025-04-08 05:58:20
+#> ⠸ 0/4 [0/s] [elapsed in 500ms] @ 2025-04-08 05:58:20
+#> ⠼ 0/4 [0/s] [elapsed in 710ms] @ 2025-04-08 05:58:20
+#> ⠴ 0/4 [0/s] [elapsed in 929ms] @ 2025-04-08 05:58:20
+#> ⠦ 0/4 [0/s] [elapsed in 1.1s] @ 2025-04-08 05:58:20
+#> ⠧ 0/4 [0/s] [elapsed in 1.4s] @ 2025-04-08 05:58:21
+#> ⠇ 0/4 [0/s] [elapsed in 1.6s] @ 2025-04-08 05:58:21
+#> Connection 1: 64 bytes from localhost (::1): icmp_seq=2 ttl=64 time=0.042 ms
+#> ⠏ 0/4 [0/s] [elapsed in 1.6s] @ 2025-04-08 05:58:21
+#> ⠋ 0/4 [0/s] [elapsed in 1.8s] @ 2025-04-08 05:58:21
+#> ⠙ 0/4 [0/s] [elapsed in 2s] @ 2025-04-08 05:58:21
+#> ⠹ 0/4 [0/s] [elapsed in 2.2s] @ 2025-04-08 05:58:22
+#> Connection 1: 64 bytes from localhost (::1): icmp_seq=3 ttl=64 time=0.040 ms
+#> ⠸ 0/4 [0/s] [elapsed in 2.2s] @ 2025-04-08 05:58:22
+#> ⠼ 0/4 [0/s] [elapsed in 2.4s] @ 2025-04-08 05:58:22
+#> ⠴ 0/4 [0/s] [elapsed in 2.6s] @ 2025-04-08 05:58:22
+#> ⠦ 0/4 [0/s] [elapsed in 2.8s] @ 2025-04-08 05:58:22
+#> ⠧ 0/4 [0/s] [elapsed in 3s] @ 2025-04-08 05:58:22
+#> ⠇ 0/4 [0/s] [elapsed in 3.3s] @ 2025-04-08 05:58:23
+#> ⠏ 0/4 [0/s] [elapsed in 3.5s] @ 2025-04-08 05:58:23
+#> ⠋ 0/4 [0/s] [elapsed in 3.7s] @ 2025-04-08 05:58:23
+#> Connection 1: 64 bytes from localhost (::1): icmp_seq=4 ttl=64 time=0.039 ms
+#> ⠙ 0/4 [0/s] [elapsed in 3.7s] @ 2025-04-08 05:58:23
+#> ⠹ 0/4 [0/s] [elapsed in 3.9s] @ 2025-04-08 05:58:23
+#> ⠸ 0/4 [0/s] [elapsed in 4.1s] @ 2025-04-08 05:58:23
+#> ⠼ 0/4 [0/s] [elapsed in 4.1s] @ 2025-04-08 05:58:23
+#> Running scheduled exit task
+#> Command process finished
+#> Running scheduled exit task
+#> Command process finished
+#> Running scheduled exit task
+#> Command process finished
+#> Running scheduled exit task
+#> Command process finished
+#> ⠼ 4/4 [0.96/s] [elapsed in 4.2s] @ 2025-04-08 05:58:23
+#> Warning: [Command: 1] System command timed out in 4 secs (status: -9)
+#> Warning: [Command: 2] System command timed out in 4.1 secs (status: -9)
+#> Warning: [Command: 3] System command timed out in 4.1 secs (status: -9)
+#> Warning: [Command: 4] System command timed out in 4.1 secs (status: -9)
+
+
+Environment context
+
+The blit package provides several functions to manage and control the environment context:
+
+-
+
cmd_wd: define the working directory.
+-
+
cmd_envvar: define the environment variables.
+-
+
cmd_envpath: define the PATH-like environment variables.
+-
+
cmd_condaenv: define the PATH environment variables with conda environment.
+
+
+exec("echo", "$(pwd)") |>
+ cmd_wd(tempdir()) |>
+ cmd_run(stdout = "|")
+#> Working Directory: '/tmp/Rtmp2bxDJx'
+#> Running command (2025-04-08 05:58:24): echo $(pwd)
+#>
+#> /tmp/Rtmp2bxDJx
+#> Running scheduled exit task
+#> Command process finished
+#> System command succeed
+
+exec("echo", "$TEST") |>
+ cmd_envvar(TEST = "blit is very awesome") |>
+ cmd_run(stdout = "|")
+#> Setting environment variables: TEST
+#> Running command (2025-04-08 05:58:24): echo $TEST
+#>
+#> blit is very awesome
+#> Running scheduled exit task
+#> Command process finished
+#> System command succeed
+
+exec("echo", "$PATH") |>
+ cmd_envpath("PATH_IS_HERE", action = "replace") |>
+ cmd_run(stdout = "|")
+#> Setting environment variables: PATH
+#> Running command (2025-04-08 05:58:24): echo $PATH
+#>
+#> PATH_IS_HERE
+#> Running scheduled exit task
+#> Command process finished
+#> System command succeed
+
+Note: echo is a built-in command of the linux shell, so it remains available even after modifying the PATH environment variable.
+
+cmd_condaenv() can add conda/mamba environment prefix to the PATH environment variable.
+Conda/mamba are open-source package and environment management systems that facilitate the installation of multiple software versions and their dependencies. They allow easy switching between environments and are compatible with Linux, macOS, and Windows.
+cmd_condaenv() function accepts multiple conda/mamba environment prefixes and an optional root argument specifying the path to the conda/mamba root prefix. If root is not provided, the function searches for the root in the following order:
+
+- the option:
blit.conda.root.
+- the environment variable:
BLIT_CONDA_ROOT.
+- the root prefix of [
appmamba()] (Please see the Software management section for details).
+
+The cmd_condaenv() function searches for the specified environment prefix within the provided root path.
+
+
+Software management
+
+The blit package integrates with micromamba, a lightweight version of the mamba package manager, for efficient software environment management.
+You can install micromamba with install_appmamba().
+
+install_appmamba()
+#> Installing appmamba
+#> Downloading from 'https://micro.mamba.pm/api/micromamba/linux-64/latest'
+#> Install appmamba successfully!
+The appmamba() function executes specified micromamba commands. Running it without arguments shows the help document:
+
+appmamba()
+#> Running command (2025-04-08 05:58:27):
+#> /home/runner/.local/share/R/blit/apps/appmamba/bin/micromamba --root-prefix
+#> /home/runner/.local/share/R/blit/appmamba --help
+To create a new environment named samtools and install samtools from Bioconda, use:
+
+appmamba("create", "--yes", "--name samtools", "bioconda::samtools")
+#> Running command (2025-04-08 05:58:27):
+#> /home/runner/.local/share/R/blit/apps/appmamba/bin/micromamba --root-prefix
+#> /home/runner/.local/share/R/blit/appmamba create --yes --name samtools
+#> bioconda::samtools
+Once the environment is created, you can execute commands within it. The following example locates the samtools binary within the specified environment:
+
+exec("which", "samtools") |>
+ cmd_condaenv("samtools") |>
+ cmd_run()
+#> Setting environment variables: PATH
+#> Running command (2025-04-08 05:58:39): which samtools
+#> Running scheduled exit task
+#> Command process finished
+#> System command succeed
+You may want to clean the created environment-samtools.
+
+appmamba("env", "remove", "--yes", "--name samtools")
+#> Running command (2025-04-08 05:58:39):
+#> /home/runner/.local/share/R/blit/apps/appmamba/bin/micromamba --root-prefix
+#> /home/runner/.local/share/R/blit/appmamba env remove --yes --name samtools
+For more details, please see https://mamba.readthedocs.io/en/latest/user_guide/micromamba.html.
+
+
+Schedule expressions
+
+Several functions allow you to schedule expressions:
+
+-
+
cmd_on_start/cmd_on_exit: define the startup, or exit code of the command.
+-
+
cmd_on_succeed/cmd_on_fail: define the code to be run when command succeed or fail.
+
+
+file <- tempfile()
+file.create(file)
+#> [1] TRUE
+file.exists(file)
+#> [1] TRUE
+exec("ping", "localhost") |>
+ cmd_on_exit(file.remove(file)) |>
+ cmd_run(timeout = 5, stdout = "|") # terminate it after 5s
+#> Running command (2025-04-08 05:58:40): ping localhost
+#>
+#> PING localhost (::1) 56 data bytes
+#> 64 bytes from localhost (::1): icmp_seq=1 ttl=64 time=0.016 ms
+#> 64 bytes from localhost (::1): icmp_seq=2 ttl=64 time=0.028 ms
+#> 64 bytes from localhost (::1): icmp_seq=3 ttl=64 time=0.029 ms
+#> 64 bytes from localhost (::1): icmp_seq=4 ttl=64 time=0.030 ms
+#> 64 bytes from localhost (::1): icmp_seq=5 ttl=64 time=0.030 ms
+#> Running scheduled exit task
+#> Command process finished
+#> Warning: System command timed out in 5 secs (status: -9)
+file.exists(file)
+#> [1] FALSE
+We can also register code for succeessful or failure command respectively (Timeout means command fail):
+
+file <- tempfile()
+file.create(file)
+#> [1] TRUE
+file.exists(file)
+#> [1] TRUE
+exec("ping", "localhost") |>
+ cmd_on_fail(file.remove(file)) |>
+ cmd_run(timeout = 5, stdout = "|") # terminate it after 5s
+#> Running command (2025-04-08 05:58:45): ping localhost
+#>
+#> PING localhost (::1) 56 data bytes
+#> 64 bytes from localhost (::1): icmp_seq=1 ttl=64 time=0.017 ms
+#> 64 bytes from localhost (::1): icmp_seq=2 ttl=64 time=0.029 ms
+#> 64 bytes from localhost (::1): icmp_seq=3 ttl=64 time=0.030 ms
+#> 64 bytes from localhost (::1): icmp_seq=4 ttl=64 time=0.035 ms
+#> 64 bytes from localhost (::1): icmp_seq=5 ttl=64 time=0.027 ms
+#> Running the scheduled failed task
+#> Running scheduled exit task
+#> Command process finished
+#> Warning: System command timed out in 5 secs (status: -9)
+file.exists(file)
+#> [1] FALSE
+
+file <- tempfile()
+file.create(file)
+#> [1] TRUE
+file.exists(file)
+#> [1] TRUE
+exec("ping", "localhost") |>
+ cmd_on_succeed(file.remove(file)) |>
+ cmd_run(timeout = 5, stdout = "|") # terminate it after 5s
+#> Running command (2025-04-08 05:58:50): ping localhost
+#>
+#> PING localhost (::1) 56 data bytes
+#> 64 bytes from localhost (::1): icmp_seq=1 ttl=64 time=0.017 ms
+#> 64 bytes from localhost (::1): icmp_seq=2 ttl=64 time=0.029 ms
+#> 64 bytes from localhost (::1): icmp_seq=3 ttl=64 time=0.029 ms
+#> 64 bytes from localhost (::1): icmp_seq=4 ttl=64 time=0.034 ms
+#> 64 bytes from localhost (::1): icmp_seq=5 ttl=64 time=0.029 ms
+#> Running scheduled exit task
+#> Command process finished
+#> Warning: System command timed out in 5 secs (status: -9)
+file.exists(file) # file remain exist as timeout means command failed
+#> [1] TRUE
+file.remove(file)
+#> [1] TRUE
+
+
+Built-in commands
+
+blit provides several built-in functions for directly executing specific commands., these include: samtools, alleleCounter, cellranger, fastq_pair, gistic2, KrakenTools, kraken2, perl, pySCENIC, python, seqkit, trust4.
+For these commands, you can also use cmd_help() to print the help document.
+
+python() |> cmd_help(stdout = "|")
+#> Running command (2025-04-08 05:58:55): /usr/bin/python --help
+#>
+#> usage: /usr/bin/python [option] ... [-c cmd | -m mod | file | -] [arg] ...
+#> Options (and corresponding environment variables):
+#> -b : issue warnings about converting bytes/bytearray to str and comparing
+#> bytes/bytearray with str or bytes with int. (-bb: issue errors)
+#> -B : don't write .pyc files on import; also PYTHONDONTWRITEBYTECODE=x
+#> -c cmd : program passed in as string (terminates option list)
+#> -d : turn on parser debugging output (for experts only, only works on
+#> debug builds); also PYTHONDEBUG=x
+#> -E : ignore PYTHON* environment variables (such as PYTHONPATH)
+#> -h : print this help message and exit (also -? or --help)
+#> -i : inspect interactively after running script; forces a prompt even
+#> if stdin does not appear to be a terminal; also PYTHONINSPECT=x
+#> -I : isolate Python from the user's environment (implies -E and -s)
+#> -m mod : run library module as a script (terminates option list)
+#> -O : remove assert and __debug__-dependent statements; add .opt-1 before
+#> .pyc extension; also PYTHONOPTIMIZE=x
+#> -OO : do -O changes and also discard docstrings; add .opt-2 before
+#> .pyc extension
+#> -P : don't prepend a potentially unsafe path to sys.path; also
+#> PYTHONSAFEPATH
+#> -q : don't print version and copyright messages on interactive startup
+#> -s : don't add user site directory to sys.path; also PYTHONNOUSERSITE=x
+#> -S : don't imply 'import site' on initialization
+#> -u : force the stdout and stderr streams to be unbuffered;
+#> this option has no effect on stdin; also PYTHONUNBUFFERED=x
+#> -v : verbose (trace import statements); also PYTHONVERBOSE=x
+#> can be supplied multiple times to increase verbosity
+#> -V : print the Python version number and exit (also --version)
+#> when given twice, print more information about the build
+#> -W arg : warning control; arg is action:message:category:module:lineno
+#> also PYTHONWARNINGS=arg
+#> -x : skip first line of source, allowing use of non-Unix forms of #!cmd
+#> -X opt : set implementation-specific option
+#> --check-hash-based-pycs always|default|never:
+#> control how Python invalidates hash-based .pyc files
+#> --help-env: print help about Python environment variables and exit
+#> --help-xoptions: print help about implementation-specific -X options and exit
+#> --help-all: print complete help information and exit
+#>
+#> Arguments:
+#> file : program read from script file
+#> - : program read from stdin (default; interactive mode if a tty)
+#> arg ...: arguments passed to program in sys.argv[1:]
+#> Running scheduled exit task
+#> Command process finished
+
+perl() |> cmd_help(stdout = "|")
+#> Running command (2025-04-08 05:58:55): /usr/bin/perl --help
+#>
+#>
+#> Usage: /usr/bin/perl [switches] [--] [programfile] [arguments]
+#> -0[octal/hexadecimal] specify record separator (\0, if no argument)
+#> -a autosplit mode with -n or -p (splits $_ into @F)
+#> -C[number/list] enables the listed Unicode features
+#> -c check syntax only (runs BEGIN and CHECK blocks)
+#> -d[t][:MOD] run program under debugger or module Devel::MOD
+#> -D[number/letters] set debugging flags (argument is a bit mask or alphabets)
+#> -e commandline one line of program (several -e's allowed, omit programfile)
+#> -E commandline like -e, but enables all optional features
+#> -f don't do $sitelib/sitecustomize.pl at startup
+#> -F/pattern/ split() pattern for -a switch (//'s are optional)
+#> -g read all input in one go (slurp), rather than line-by-line (alias for -0777)
+#> -i[extension] edit <> files in place (makes backup if extension supplied)
+#> -Idirectory specify @INC/#include directory (several -I's allowed)
+#> -l[octnum] enable line ending processing, specifies line terminator
+#> -[mM][-]module execute "use/no module..." before executing program
+#> -n assume "while (<>) { ... }" loop around program
+#> -p assume loop like -n but print line also, like sed
+#> -s enable rudimentary parsing for switches after programfile
+#> -S look for programfile using PATH environment variable
+#> -t enable tainting warnings
+#> -T enable tainting checks
+#> -u dump core after parsing program
+#> -U allow unsafe operations
+#> -v print version, patchlevel and license
+#> -V[:configvar] print configuration summary (or a single Config.pm variable)
+#> -w enable many useful warnings
+#> -W enable all warnings
+#> -x[directory] ignore text before #!perl line (optionally cd to directory)
+#> -X disable all warnings
+#>
+#> Run 'perldoc perl' for more help with Perl.
+#> Running scheduled exit task
+#> Command process finished
+And it is very easily to extend for other commands.
+
+
+Pipe
+
+One of the great features of blit is its ability to translate the R pipe (%>% or |>) into the Linux pipe (|). All functions used to create a command object can accept another command object. The internal will capture the first unnamed input value. If it is a command object, it will be removed from the call and saved. When the command object is run, the saved command will be passed through the pipe (|) to the command. Here we take the gzip command as an example (assuming you’re using a Linux system).
+
+tmpdir <- tempdir()
+file <- tempfile(tmpdir = tmpdir)
+writeLines(letters, con = file)
+file2 <- tempfile()
+exec("gzip", "-c", file) |>
+ exec("gzip", "-d", ">", file2) |>
+ cmd_run(stdout = "|")
+#> Running command (2025-04-08 05:58:55): gzip -c /tmp/Rtmp2bxDJx/file1db163a56a5d
+#> | gzip -d > /tmp/Rtmp2bxDJx/file1db14f8f6795
+#> Running scheduled exit task
+#> Command process finished
+#> System command succeed
+identical(readLines(file), readLines(file2))
+#> [1] TRUE
+In the last we clean the temporary files.
+
+file.remove(file)
+#> [1] TRUE
+file.remove(file2)
+#> [1] TRUE
+
+
+
+Development
+
+To add a new command, use the make_command function. This helper function is designed to assist developers in creating functions that initialize new command objects. A command object is a bundle of multiple Command R6 objects (note the uppercase "C" in Command, which distinguishes it from the command object) and the associated running environment (including the working directory and environment variables).
+The make_command function accepts a function that initializes a new Command object and, when necessary, validates the input arguments. The core purpose is to create a new Command R6 object, so familiarity with the R6 class system is essential.
+There are several private methods or fields you may want to override when creating a new Command R6 object. The first method is command_locate, which determines how to locate the command path. By default, it will attempt to use the cmd argument provided by the user. If no cmd argument is supplied, it will try to locate the command using the alias method. In most cases, you will only need to provide values for the alias method, rather than overriding the command_locate method.
+For example, consider the ping command. Here is how you can define it:
+
+Ping <- R6::R6Class(
+ "Ping",
+ inherit = Command,
+ private = list(alias = function() "ping")
+)
+ping <- make_command("ping", function(..., ping = NULL) {
+ Ping$new(cmd = ping, ...)
+})
+ping("8.8.8.8") |> cmd_run(timeout = 5, stdout = "|") # terminate it after 5s
+#> Running command (2025-04-08 05:58:55): /usr/bin/ping 8.8.8.8
+#> Running scheduled exit task
+#> Command process finished
+#> Warning: System command timed out in 5 secs (status: -9)
+For command-line tools, the input parameters should always be characters. The core principle of the Command object is to convert all R objects (such as data frames) into characters—typically file paths of R objects that have been saved to disk.
+
+
+Session Informations
+
+
+sessionInfo()
+#> R version 4.4.3 (2025-02-28)
+#> Platform: x86_64-pc-linux-gnu
+#> Running under: Ubuntu 24.04.2 LTS
+#>
+#> Matrix products: default
+#> BLAS: /usr/lib/x86_64-linux-gnu/openblas-pthread/libblas.so.3
+#> LAPACK: /usr/lib/x86_64-linux-gnu/openblas-pthread/libopenblasp-r0.3.26.so; LAPACK version 3.12.0
+#>
+#> locale:
+#> [1] LC_CTYPE=C.UTF-8 LC_NUMERIC=C LC_TIME=C.UTF-8
+#> [4] LC_COLLATE=C.UTF-8 LC_MONETARY=C.UTF-8 LC_MESSAGES=C.UTF-8
+#> [7] LC_PAPER=C.UTF-8 LC_NAME=C LC_ADDRESS=C
+#> [10] LC_TELEPHONE=C LC_MEASUREMENT=C.UTF-8 LC_IDENTIFICATION=C
+#>
+#> time zone: UTC
+#> tzcode source: system (glibc)
+#>
+#> attached base packages:
+#> [1] stats graphics grDevices utils datasets methods base
+#>
+#> other attached packages:
+#> [1] blit_0.2.0.9000
+#>
+#> loaded via a namespace (and not attached):
+#> [1] digest_0.6.37 R6_2.6.1 fastmap_1.2.0 xfun_0.52
+#> [5] knitr_1.50 parallel_4.4.3 htmltools_0.5.8.1 rmarkdown_2.29
+#> [9] ps_1.9.0 cli_3.6.4 processx_3.8.6 data.table_1.17.0
+#> [13] compiler_4.4.3 tools_4.4.3 evaluate_1.0.3 yaml_2.3.10
+#> [17] rlang_1.1.5
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/link.svg b/docs/link.svg
new file mode 100644
index 0000000..88ad827
--- /dev/null
+++ b/docs/link.svg
@@ -0,0 +1,12 @@
+
+
+
diff --git a/docs/logo.png b/docs/logo.png
new file mode 100644
index 0000000..70dcf01
Binary files /dev/null and b/docs/logo.png differ
diff --git a/docs/news/index.html b/docs/news/index.html
new file mode 100644
index 0000000..d383910
--- /dev/null
+++ b/docs/news/index.html
@@ -0,0 +1,98 @@
+
+Changelog • blit
+
+
+
+
+
+
+
+
+
+
+ Changelog
+ Source: NEWS.md
+
+
+
+
+blit 0.2.02025-03-29
+
+New features
+new function cmd_conda to define the PATH environment variables with conda environment.
new function appmamba to install software and manage Environment with micromamba.
new function cmd_on_fail to define the expression to be evaluated when the command failed.
new function cmd_on_succeedto define the expression to be evaluated when the command succeeded.
new function cmd_on_start() to define the expressions which will be run when command started
new function cmd_on_exit() to define the expressions which will be run when command finished
new command samtools
new function cmd_parallel() to run multiple commands meanwhile
use processx package to execute the command and remove the sys and withr package from dependencies
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/pkgdown.css b/docs/pkgdown.css
new file mode 100644
index 0000000..80ea5b8
--- /dev/null
+++ b/docs/pkgdown.css
@@ -0,0 +1,384 @@
+/* Sticky footer */
+
+/**
+ * Basic idea: https://philipwalton.github.io/solved-by-flexbox/demos/sticky-footer/
+ * Details: https://github.com/philipwalton/solved-by-flexbox/blob/master/assets/css/components/site.css
+ *
+ * .Site -> body > .container
+ * .Site-content -> body > .container .row
+ * .footer -> footer
+ *
+ * Key idea seems to be to ensure that .container and __all its parents__
+ * have height set to 100%
+ *
+ */
+
+html, body {
+ height: 100%;
+}
+
+body {
+ position: relative;
+}
+
+body > .container {
+ display: flex;
+ height: 100%;
+ flex-direction: column;
+}
+
+body > .container .row {
+ flex: 1 0 auto;
+}
+
+footer {
+ margin-top: 45px;
+ padding: 35px 0 36px;
+ border-top: 1px solid #e5e5e5;
+ color: #666;
+ display: flex;
+ flex-shrink: 0;
+}
+footer p {
+ margin-bottom: 0;
+}
+footer div {
+ flex: 1;
+}
+footer .pkgdown {
+ text-align: right;
+}
+footer p {
+ margin-bottom: 0;
+}
+
+img.icon {
+ float: right;
+}
+
+/* Ensure in-page images don't run outside their container */
+.contents img {
+ max-width: 100%;
+ height: auto;
+}
+
+/* Fix bug in bootstrap (only seen in firefox) */
+summary {
+ display: list-item;
+}
+
+/* Typographic tweaking ---------------------------------*/
+
+.contents .page-header {
+ margin-top: calc(-60px + 1em);
+}
+
+dd {
+ margin-left: 3em;
+}
+
+/* Section anchors ---------------------------------*/
+
+a.anchor {
+ display: none;
+ margin-left: 5px;
+ width: 20px;
+ height: 20px;
+
+ background-image: url(./link.svg);
+ background-repeat: no-repeat;
+ background-size: 20px 20px;
+ background-position: center center;
+}
+
+h1:hover .anchor,
+h2:hover .anchor,
+h3:hover .anchor,
+h4:hover .anchor,
+h5:hover .anchor,
+h6:hover .anchor {
+ display: inline-block;
+}
+
+/* Fixes for fixed navbar --------------------------*/
+
+.contents h1, .contents h2, .contents h3, .contents h4 {
+ padding-top: 60px;
+ margin-top: -40px;
+}
+
+/* Navbar submenu --------------------------*/
+
+.dropdown-submenu {
+ position: relative;
+}
+
+.dropdown-submenu>.dropdown-menu {
+ top: 0;
+ left: 100%;
+ margin-top: -6px;
+ margin-left: -1px;
+ border-radius: 0 6px 6px 6px;
+}
+
+.dropdown-submenu:hover>.dropdown-menu {
+ display: block;
+}
+
+.dropdown-submenu>a:after {
+ display: block;
+ content: " ";
+ float: right;
+ width: 0;
+ height: 0;
+ border-color: transparent;
+ border-style: solid;
+ border-width: 5px 0 5px 5px;
+ border-left-color: #cccccc;
+ margin-top: 5px;
+ margin-right: -10px;
+}
+
+.dropdown-submenu:hover>a:after {
+ border-left-color: #ffffff;
+}
+
+.dropdown-submenu.pull-left {
+ float: none;
+}
+
+.dropdown-submenu.pull-left>.dropdown-menu {
+ left: -100%;
+ margin-left: 10px;
+ border-radius: 6px 0 6px 6px;
+}
+
+/* Sidebar --------------------------*/
+
+#pkgdown-sidebar {
+ margin-top: 30px;
+ position: -webkit-sticky;
+ position: sticky;
+ top: 70px;
+}
+
+#pkgdown-sidebar h2 {
+ font-size: 1.5em;
+ margin-top: 1em;
+}
+
+#pkgdown-sidebar h2:first-child {
+ margin-top: 0;
+}
+
+#pkgdown-sidebar .list-unstyled li {
+ margin-bottom: 0.5em;
+}
+
+/* bootstrap-toc tweaks ------------------------------------------------------*/
+
+/* All levels of nav */
+
+nav[data-toggle='toc'] .nav > li > a {
+ padding: 4px 20px 4px 6px;
+ font-size: 1.5rem;
+ font-weight: 400;
+ color: inherit;
+}
+
+nav[data-toggle='toc'] .nav > li > a:hover,
+nav[data-toggle='toc'] .nav > li > a:focus {
+ padding-left: 5px;
+ color: inherit;
+ border-left: 1px solid #878787;
+}
+
+nav[data-toggle='toc'] .nav > .active > a,
+nav[data-toggle='toc'] .nav > .active:hover > a,
+nav[data-toggle='toc'] .nav > .active:focus > a {
+ padding-left: 5px;
+ font-size: 1.5rem;
+ font-weight: 400;
+ color: inherit;
+ border-left: 2px solid #878787;
+}
+
+/* Nav: second level (shown on .active) */
+
+nav[data-toggle='toc'] .nav .nav {
+ display: none; /* Hide by default, but at >768px, show it */
+ padding-bottom: 10px;
+}
+
+nav[data-toggle='toc'] .nav .nav > li > a {
+ padding-left: 16px;
+ font-size: 1.35rem;
+}
+
+nav[data-toggle='toc'] .nav .nav > li > a:hover,
+nav[data-toggle='toc'] .nav .nav > li > a:focus {
+ padding-left: 15px;
+}
+
+nav[data-toggle='toc'] .nav .nav > .active > a,
+nav[data-toggle='toc'] .nav .nav > .active:hover > a,
+nav[data-toggle='toc'] .nav .nav > .active:focus > a {
+ padding-left: 15px;
+ font-weight: 500;
+ font-size: 1.35rem;
+}
+
+/* orcid ------------------------------------------------------------------- */
+
+.orcid {
+ font-size: 16px;
+ color: #A6CE39;
+ /* margins are required by official ORCID trademark and display guidelines */
+ margin-left:4px;
+ margin-right:4px;
+ vertical-align: middle;
+}
+
+/* Reference index & topics ----------------------------------------------- */
+
+.ref-index th {font-weight: normal;}
+
+.ref-index td {vertical-align: top; min-width: 100px}
+.ref-index .icon {width: 40px;}
+.ref-index .alias {width: 40%;}
+.ref-index-icons .alias {width: calc(40% - 40px);}
+.ref-index .title {width: 60%;}
+
+.ref-arguments th {text-align: right; padding-right: 10px;}
+.ref-arguments th, .ref-arguments td {vertical-align: top; min-width: 100px}
+.ref-arguments .name {width: 20%;}
+.ref-arguments .desc {width: 80%;}
+
+/* Nice scrolling for wide elements --------------------------------------- */
+
+table {
+ display: block;
+ overflow: auto;
+}
+
+/* Syntax highlighting ---------------------------------------------------- */
+
+pre, code, pre code {
+ background-color: #f8f8f8;
+ color: #333;
+}
+pre, pre code {
+ white-space: pre-wrap;
+ word-break: break-all;
+ overflow-wrap: break-word;
+}
+
+pre {
+ border: 1px solid #eee;
+}
+
+pre .img, pre .r-plt {
+ margin: 5px 0;
+}
+
+pre .img img, pre .r-plt img {
+ background-color: #fff;
+}
+
+code a, pre a {
+ color: #375f84;
+}
+
+a.sourceLine:hover {
+ text-decoration: none;
+}
+
+.fl {color: #1514b5;}
+.fu {color: #000000;} /* function */
+.ch,.st {color: #036a07;} /* string */
+.kw {color: #264D66;} /* keyword */
+.co {color: #888888;} /* comment */
+
+.error {font-weight: bolder;}
+.warning {font-weight: bolder;}
+
+/* Clipboard --------------------------*/
+
+.hasCopyButton {
+ position: relative;
+}
+
+.btn-copy-ex {
+ position: absolute;
+ right: 0;
+ top: 0;
+ visibility: hidden;
+}
+
+.hasCopyButton:hover button.btn-copy-ex {
+ visibility: visible;
+}
+
+/* headroom.js ------------------------ */
+
+.headroom {
+ will-change: transform;
+ transition: transform 200ms linear;
+}
+.headroom--pinned {
+ transform: translateY(0%);
+}
+.headroom--unpinned {
+ transform: translateY(-100%);
+}
+
+/* mark.js ----------------------------*/
+
+mark {
+ background-color: rgba(255, 255, 51, 0.5);
+ border-bottom: 2px solid rgba(255, 153, 51, 0.3);
+ padding: 1px;
+}
+
+/* vertical spacing after htmlwidgets */
+.html-widget {
+ margin-bottom: 10px;
+}
+
+/* fontawesome ------------------------ */
+
+.fab {
+ font-family: "Font Awesome 5 Brands" !important;
+}
+
+/* don't display links in code chunks when printing */
+/* source: https://stackoverflow.com/a/10781533 */
+@media print {
+ code a:link:after, code a:visited:after {
+ content: "";
+ }
+}
+
+/* Section anchors ---------------------------------
+ Added in pandoc 2.11: https://github.com/jgm/pandoc-templates/commit/9904bf71
+*/
+
+div.csl-bib-body { }
+div.csl-entry {
+ clear: both;
+}
+.hanging-indent div.csl-entry {
+ margin-left:2em;
+ text-indent:-2em;
+}
+div.csl-left-margin {
+ min-width:2em;
+ float:left;
+}
+div.csl-right-inline {
+ margin-left:2em;
+ padding-left:1em;
+}
+div.csl-indent {
+ margin-left: 2em;
+}
diff --git a/docs/pkgdown.js b/docs/pkgdown.js
new file mode 100644
index 0000000..6f0eee4
--- /dev/null
+++ b/docs/pkgdown.js
@@ -0,0 +1,108 @@
+/* http://gregfranko.com/blog/jquery-best-practices/ */
+(function($) {
+ $(function() {
+
+ $('.navbar-fixed-top').headroom();
+
+ $('body').css('padding-top', $('.navbar').height() + 10);
+ $(window).resize(function(){
+ $('body').css('padding-top', $('.navbar').height() + 10);
+ });
+
+ $('[data-toggle="tooltip"]').tooltip();
+
+ var cur_path = paths(location.pathname);
+ var links = $("#navbar ul li a");
+ var max_length = -1;
+ var pos = -1;
+ for (var i = 0; i < links.length; i++) {
+ if (links[i].getAttribute("href") === "#")
+ continue;
+ // Ignore external links
+ if (links[i].host !== location.host)
+ continue;
+
+ var nav_path = paths(links[i].pathname);
+
+ var length = prefix_length(nav_path, cur_path);
+ if (length > max_length) {
+ max_length = length;
+ pos = i;
+ }
+ }
+
+ // Add class to parent
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/link.svg b/docs/link.svg
new file mode 100644
index 0000000..88ad827
--- /dev/null
+++ b/docs/link.svg
@@ -0,0 +1,12 @@
+
+
+
diff --git a/docs/logo.png b/docs/logo.png
new file mode 100644
index 0000000..70dcf01
Binary files /dev/null and b/docs/logo.png differ
diff --git a/docs/news/index.html b/docs/news/index.html
new file mode 100644
index 0000000..d383910
--- /dev/null
+++ b/docs/news/index.html
@@ -0,0 +1,98 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 
The goal of blit is to make it easy to execute command line tool from R.
+
+
+
+Installation +
+You can install blit from CRAN using:
+install.packages("blit")Alternatively, install the development version from GitHub with:
+
+# install.packages("remotes")
+remotes::install_github("WangLabCSU/blit")
+
+Example +
+ +
+
+
+
+
+
+Execute command +
+To build a command, simply use exec. The first argument is the command name, and you can also provide the full path. After that, pass the command parameters. This will create a command object:
+exec("echo", "$PATH")
+#> <Execute: echo>To run the command, just pass the command object to the cmd_run() (Note: stdout = "|" is always used in the vignette to ensure that the standard output can be captured by knitr.)
+Sys.setenv(TEST = "blit is awesome")
+exec("echo", "$TEST") |> cmd_run(stdout = "|")
+#> Running command (2025-04-08 05:58:19): echo $TEST
+#>
+#> blit is awesome
+#> Running scheduled exit task
+#> Command process finished
+#> System command succeedAlternatively, you can run it in the background. In this case, a process object will be returned. For more information, refer to the official site:
+proc <- exec("echo", "$TEST") |> cmd_background(stdout = "")
+proc$kill()
+Sys.unsetenv("TEST")++ +We use some tricks to capture the output from the background process. The actual implementation in the
+README.Rmddiffers, but the output remains the same.
cmd_background() is provided for completeness. Instead of using this function, we recommend using cmd_parallel(), which can run multiple commands in the background while ensuring that all processes are properly cleaned up when the process exits.
+# ip address are copied from quora <What are some famous IP addresses?>: https://qr.ae/pYlnbQ
+address <- c("localhost", "208.67.222.222", "8.8.8.8", "8.8.4.4")
+cmd_parallel(
+ !!!lapply(address, function(ip) exec("ping", ip)),
+ stdouts = TRUE,
+ stdout_callbacks = lapply(
+ seq_len(4),
+ function(i) {
+ force(i)
+ function(text, proc) {
+ sprintf("Connection %d: %s", i, text)
+ }
+ }
+ ),
+ timeouts = 4, # terminate after 4s
+ threads = 4
+)
+#> Running command (2025-04-08 05:58:19): ping localhost
+#> Running command (2025-04-08 05:58:19): ping 208.67.222.222
+#> Running command (2025-04-08 05:58:19): ping 8.8.8.8
+#> Running command (2025-04-08 05:58:19): ping 8.8.4.4
+#>
+#> Connection 1: PING localhost (::1) 56 data bytes
+#> Connection 1: 64 bytes from localhost (::1): icmp_seq=1 ttl=64 time=0.017 ms
+#> ⠙ 0/4 [0/s] [elapsed in 76ms] @ 2025-04-08 05:58:19
+#> ⠹ 0/4 [0/s] [elapsed in 290ms] @ 2025-04-08 05:58:20
+#> ⠸ 0/4 [0/s] [elapsed in 500ms] @ 2025-04-08 05:58:20
+#> ⠼ 0/4 [0/s] [elapsed in 710ms] @ 2025-04-08 05:58:20
+#> ⠴ 0/4 [0/s] [elapsed in 929ms] @ 2025-04-08 05:58:20
+#> ⠦ 0/4 [0/s] [elapsed in 1.1s] @ 2025-04-08 05:58:20
+#> ⠧ 0/4 [0/s] [elapsed in 1.4s] @ 2025-04-08 05:58:21
+#> ⠇ 0/4 [0/s] [elapsed in 1.6s] @ 2025-04-08 05:58:21
+#> Connection 1: 64 bytes from localhost (::1): icmp_seq=2 ttl=64 time=0.042 ms
+#> ⠏ 0/4 [0/s] [elapsed in 1.6s] @ 2025-04-08 05:58:21
+#> ⠋ 0/4 [0/s] [elapsed in 1.8s] @ 2025-04-08 05:58:21
+#> ⠙ 0/4 [0/s] [elapsed in 2s] @ 2025-04-08 05:58:21
+#> ⠹ 0/4 [0/s] [elapsed in 2.2s] @ 2025-04-08 05:58:22
+#> Connection 1: 64 bytes from localhost (::1): icmp_seq=3 ttl=64 time=0.040 ms
+#> ⠸ 0/4 [0/s] [elapsed in 2.2s] @ 2025-04-08 05:58:22
+#> ⠼ 0/4 [0/s] [elapsed in 2.4s] @ 2025-04-08 05:58:22
+#> ⠴ 0/4 [0/s] [elapsed in 2.6s] @ 2025-04-08 05:58:22
+#> ⠦ 0/4 [0/s] [elapsed in 2.8s] @ 2025-04-08 05:58:22
+#> ⠧ 0/4 [0/s] [elapsed in 3s] @ 2025-04-08 05:58:22
+#> ⠇ 0/4 [0/s] [elapsed in 3.3s] @ 2025-04-08 05:58:23
+#> ⠏ 0/4 [0/s] [elapsed in 3.5s] @ 2025-04-08 05:58:23
+#> ⠋ 0/4 [0/s] [elapsed in 3.7s] @ 2025-04-08 05:58:23
+#> Connection 1: 64 bytes from localhost (::1): icmp_seq=4 ttl=64 time=0.039 ms
+#> ⠙ 0/4 [0/s] [elapsed in 3.7s] @ 2025-04-08 05:58:23
+#> ⠹ 0/4 [0/s] [elapsed in 3.9s] @ 2025-04-08 05:58:23
+#> ⠸ 0/4 [0/s] [elapsed in 4.1s] @ 2025-04-08 05:58:23
+#> ⠼ 0/4 [0/s] [elapsed in 4.1s] @ 2025-04-08 05:58:23
+#> Running scheduled exit task
+#> Command process finished
+#> Running scheduled exit task
+#> Command process finished
+#> Running scheduled exit task
+#> Command process finished
+#> Running scheduled exit task
+#> Command process finished
+#> ⠼ 4/4 [0.96/s] [elapsed in 4.2s] @ 2025-04-08 05:58:23
+#> Warning: [Command: 1] System command timed out in 4 secs (status: -9)
+#> Warning: [Command: 2] System command timed out in 4.1 secs (status: -9)
+#> Warning: [Command: 3] System command timed out in 4.1 secs (status: -9)
+#> Warning: [Command: 4] System command timed out in 4.1 secs (status: -9)
+
+
+
+
+Environment context +
+The blit package provides several functions to manage and control the environment context:
-
+
-
+
cmd_wd: define the working directory.
+ -
+
cmd_envvar: define the environment variables.
+ -
+
cmd_envpath: define thePATH-like environment variables.
+ -
+
cmd_condaenv: define thePATHenvironment variables with conda environment.
+
+exec("echo", "$(pwd)") |>
+ cmd_wd(tempdir()) |>
+ cmd_run(stdout = "|")
+#> Working Directory: '/tmp/Rtmp2bxDJx'
+#> Running command (2025-04-08 05:58:24): echo $(pwd)
+#>
+#> /tmp/Rtmp2bxDJx
+#> Running scheduled exit task
+#> Command process finished
+#> System command succeed
+exec("echo", "$TEST") |>
+ cmd_envvar(TEST = "blit is very awesome") |>
+ cmd_run(stdout = "|")
+#> Setting environment variables: TEST
+#> Running command (2025-04-08 05:58:24): echo $TEST
+#>
+#> blit is very awesome
+#> Running scheduled exit task
+#> Command process finished
+#> System command succeed
+exec("echo", "$PATH") |>
+ cmd_envpath("PATH_IS_HERE", action = "replace") |>
+ cmd_run(stdout = "|")
+#> Setting environment variables: PATH
+#> Running command (2025-04-08 05:58:24): echo $PATH
+#>
+#> PATH_IS_HERE
+#> Running scheduled exit task
+#> Command process finished
+#> System command succeed++Note:
+echois a built-in command of the linux shell, so it remains available even after modifying thePATHenvironment variable.
cmd_condaenv() can add conda/mamba environment prefix to the PATH environment variable.
Conda/mamba are open-source package and environment management systems that facilitate the installation of multiple software versions and their dependencies. They allow easy switching between environments and are compatible with Linux, macOS, and Windows.
cmd_condaenv() function accepts multiple conda/mamba environment prefixes and an optional root argument specifying the path to the conda/mamba root prefix. If root is not provided, the function searches for the root in the following order:
-
+
- the option:
blit.conda.root.
+ - the environment variable:
BLIT_CONDA_ROOT.
+ - the root prefix of [
appmamba()] (Please see theSoftware managementsection for details).
+
The cmd_condaenv() function searches for the specified environment prefix within the provided root path.
+
+
+
+
+
+
+Software management +
+The blit package integrates with micromamba, a lightweight version of the mamba package manager, for efficient software environment management.
You can install micromamba with install_appmamba().
+install_appmamba()
+#> Installing appmamba
+#> Downloading from 'https://micro.mamba.pm/api/micromamba/linux-64/latest'
+#> Install appmamba successfully!The appmamba() function executes specified micromamba commands. Running it without arguments shows the help document:
+appmamba()
+#> Running command (2025-04-08 05:58:27):
+#> /home/runner/.local/share/R/blit/apps/appmamba/bin/micromamba --root-prefix
+#> /home/runner/.local/share/R/blit/appmamba --helpTo create a new environment named samtools and install samtools from Bioconda, use:
+appmamba("create", "--yes", "--name samtools", "bioconda::samtools")
+#> Running command (2025-04-08 05:58:27):
+#> /home/runner/.local/share/R/blit/apps/appmamba/bin/micromamba --root-prefix
+#> /home/runner/.local/share/R/blit/appmamba create --yes --name samtools
+#> bioconda::samtoolsOnce the environment is created, you can execute commands within it. The following example locates the samtools binary within the specified environment:
+
+exec("which", "samtools") |>
+ cmd_condaenv("samtools") |>
+ cmd_run()
+#> Setting environment variables: PATH
+#> Running command (2025-04-08 05:58:39): which samtools
+#> Running scheduled exit task
+#> Command process finished
+#> System command succeedYou may want to clean the created environment-samtools.
+appmamba("env", "remove", "--yes", "--name samtools")
+#> Running command (2025-04-08 05:58:39):
+#> /home/runner/.local/share/R/blit/apps/appmamba/bin/micromamba --root-prefix
+#> /home/runner/.local/share/R/blit/appmamba env remove --yes --name samtoolsFor more details, please see https://mamba.readthedocs.io/en/latest/user_guide/micromamba.html.
+
+
+
+
+
+Schedule expressions +
+Several functions allow you to schedule expressions:
+-
+
-
+
cmd_on_start/cmd_on_exit: define the startup, or exit code of the command.
+ -
+
cmd_on_succeed/cmd_on_fail: define the code to be run when command succeed or fail.
+
+file <- tempfile()
+file.create(file)
+#> [1] TRUE
+file.exists(file)
+#> [1] TRUE
+exec("ping", "localhost") |>
+ cmd_on_exit(file.remove(file)) |>
+ cmd_run(timeout = 5, stdout = "|") # terminate it after 5s
+#> Running command (2025-04-08 05:58:40): ping localhost
+#>
+#> PING localhost (::1) 56 data bytes
+#> 64 bytes from localhost (::1): icmp_seq=1 ttl=64 time=0.016 ms
+#> 64 bytes from localhost (::1): icmp_seq=2 ttl=64 time=0.028 ms
+#> 64 bytes from localhost (::1): icmp_seq=3 ttl=64 time=0.029 ms
+#> 64 bytes from localhost (::1): icmp_seq=4 ttl=64 time=0.030 ms
+#> 64 bytes from localhost (::1): icmp_seq=5 ttl=64 time=0.030 ms
+#> Running scheduled exit task
+#> Command process finished
+#> Warning: System command timed out in 5 secs (status: -9)
+file.exists(file)
+#> [1] FALSEWe can also register code for succeessful or failure command respectively (Timeout means command fail):
+
+file <- tempfile()
+file.create(file)
+#> [1] TRUE
+file.exists(file)
+#> [1] TRUE
+exec("ping", "localhost") |>
+ cmd_on_fail(file.remove(file)) |>
+ cmd_run(timeout = 5, stdout = "|") # terminate it after 5s
+#> Running command (2025-04-08 05:58:45): ping localhost
+#>
+#> PING localhost (::1) 56 data bytes
+#> 64 bytes from localhost (::1): icmp_seq=1 ttl=64 time=0.017 ms
+#> 64 bytes from localhost (::1): icmp_seq=2 ttl=64 time=0.029 ms
+#> 64 bytes from localhost (::1): icmp_seq=3 ttl=64 time=0.030 ms
+#> 64 bytes from localhost (::1): icmp_seq=4 ttl=64 time=0.035 ms
+#> 64 bytes from localhost (::1): icmp_seq=5 ttl=64 time=0.027 ms
+#> Running the scheduled failed task
+#> Running scheduled exit task
+#> Command process finished
+#> Warning: System command timed out in 5 secs (status: -9)
+file.exists(file)
+#> [1] FALSE
+file <- tempfile()
+file.create(file)
+#> [1] TRUE
+file.exists(file)
+#> [1] TRUE
+exec("ping", "localhost") |>
+ cmd_on_succeed(file.remove(file)) |>
+ cmd_run(timeout = 5, stdout = "|") # terminate it after 5s
+#> Running command (2025-04-08 05:58:50): ping localhost
+#>
+#> PING localhost (::1) 56 data bytes
+#> 64 bytes from localhost (::1): icmp_seq=1 ttl=64 time=0.017 ms
+#> 64 bytes from localhost (::1): icmp_seq=2 ttl=64 time=0.029 ms
+#> 64 bytes from localhost (::1): icmp_seq=3 ttl=64 time=0.029 ms
+#> 64 bytes from localhost (::1): icmp_seq=4 ttl=64 time=0.034 ms
+#> 64 bytes from localhost (::1): icmp_seq=5 ttl=64 time=0.029 ms
+#> Running scheduled exit task
+#> Command process finished
+#> Warning: System command timed out in 5 secs (status: -9)
+file.exists(file) # file remain exist as timeout means command failed
+#> [1] TRUE
+file.remove(file)
+#> [1] TRUE
+
+
+
+Built-in commands +
+blit provides several built-in functions for directly executing specific commands., these include: samtools, alleleCounter, cellranger, fastq_pair, gistic2, KrakenTools, kraken2, perl, pySCENIC, python, seqkit, trust4.
For these commands, you can also use cmd_help() to print the help document.
+python() |> cmd_help(stdout = "|")
+#> Running command (2025-04-08 05:58:55): /usr/bin/python --help
+#>
+#> usage: /usr/bin/python [option] ... [-c cmd | -m mod | file | -] [arg] ...
+#> Options (and corresponding environment variables):
+#> -b : issue warnings about converting bytes/bytearray to str and comparing
+#> bytes/bytearray with str or bytes with int. (-bb: issue errors)
+#> -B : don't write .pyc files on import; also PYTHONDONTWRITEBYTECODE=x
+#> -c cmd : program passed in as string (terminates option list)
+#> -d : turn on parser debugging output (for experts only, only works on
+#> debug builds); also PYTHONDEBUG=x
+#> -E : ignore PYTHON* environment variables (such as PYTHONPATH)
+#> -h : print this help message and exit (also -? or --help)
+#> -i : inspect interactively after running script; forces a prompt even
+#> if stdin does not appear to be a terminal; also PYTHONINSPECT=x
+#> -I : isolate Python from the user's environment (implies -E and -s)
+#> -m mod : run library module as a script (terminates option list)
+#> -O : remove assert and __debug__-dependent statements; add .opt-1 before
+#> .pyc extension; also PYTHONOPTIMIZE=x
+#> -OO : do -O changes and also discard docstrings; add .opt-2 before
+#> .pyc extension
+#> -P : don't prepend a potentially unsafe path to sys.path; also
+#> PYTHONSAFEPATH
+#> -q : don't print version and copyright messages on interactive startup
+#> -s : don't add user site directory to sys.path; also PYTHONNOUSERSITE=x
+#> -S : don't imply 'import site' on initialization
+#> -u : force the stdout and stderr streams to be unbuffered;
+#> this option has no effect on stdin; also PYTHONUNBUFFERED=x
+#> -v : verbose (trace import statements); also PYTHONVERBOSE=x
+#> can be supplied multiple times to increase verbosity
+#> -V : print the Python version number and exit (also --version)
+#> when given twice, print more information about the build
+#> -W arg : warning control; arg is action:message:category:module:lineno
+#> also PYTHONWARNINGS=arg
+#> -x : skip first line of source, allowing use of non-Unix forms of #!cmd
+#> -X opt : set implementation-specific option
+#> --check-hash-based-pycs always|default|never:
+#> control how Python invalidates hash-based .pyc files
+#> --help-env: print help about Python environment variables and exit
+#> --help-xoptions: print help about implementation-specific -X options and exit
+#> --help-all: print complete help information and exit
+#>
+#> Arguments:
+#> file : program read from script file
+#> - : program read from stdin (default; interactive mode if a tty)
+#> arg ...: arguments passed to program in sys.argv[1:]
+#> Running scheduled exit task
+#> Command process finished
+perl() |> cmd_help(stdout = "|")
+#> Running command (2025-04-08 05:58:55): /usr/bin/perl --help
+#>
+#>
+#> Usage: /usr/bin/perl [switches] [--] [programfile] [arguments]
+#> -0[octal/hexadecimal] specify record separator (\0, if no argument)
+#> -a autosplit mode with -n or -p (splits $_ into @F)
+#> -C[number/list] enables the listed Unicode features
+#> -c check syntax only (runs BEGIN and CHECK blocks)
+#> -d[t][:MOD] run program under debugger or module Devel::MOD
+#> -D[number/letters] set debugging flags (argument is a bit mask or alphabets)
+#> -e commandline one line of program (several -e's allowed, omit programfile)
+#> -E commandline like -e, but enables all optional features
+#> -f don't do $sitelib/sitecustomize.pl at startup
+#> -F/pattern/ split() pattern for -a switch (//'s are optional)
+#> -g read all input in one go (slurp), rather than line-by-line (alias for -0777)
+#> -i[extension] edit <> files in place (makes backup if extension supplied)
+#> -Idirectory specify @INC/#include directory (several -I's allowed)
+#> -l[octnum] enable line ending processing, specifies line terminator
+#> -[mM][-]module execute "use/no module..." before executing program
+#> -n assume "while (<>) { ... }" loop around program
+#> -p assume loop like -n but print line also, like sed
+#> -s enable rudimentary parsing for switches after programfile
+#> -S look for programfile using PATH environment variable
+#> -t enable tainting warnings
+#> -T enable tainting checks
+#> -u dump core after parsing program
+#> -U allow unsafe operations
+#> -v print version, patchlevel and license
+#> -V[:configvar] print configuration summary (or a single Config.pm variable)
+#> -w enable many useful warnings
+#> -W enable all warnings
+#> -x[directory] ignore text before #!perl line (optionally cd to directory)
+#> -X disable all warnings
+#>
+#> Run 'perldoc perl' for more help with Perl.
+#> Running scheduled exit task
+#> Command process finishedAnd it is very easily to extend for other commands.
+
+
+
+
+Pipe +
+One of the great features of blit is its ability to translate the R pipe (%>% or |>) into the Linux pipe (|). All functions used to create a command object can accept another command object. The internal will capture the first unnamed input value. If it is a command object, it will be removed from the call and saved. When the command object is run, the saved command will be passed through the pipe (|) to the command. Here we take the gzip command as an example (assuming you’re using a Linux system).
+tmpdir <- tempdir()
+file <- tempfile(tmpdir = tmpdir)
+writeLines(letters, con = file)
+file2 <- tempfile()
+exec("gzip", "-c", file) |>
+ exec("gzip", "-d", ">", file2) |>
+ cmd_run(stdout = "|")
+#> Running command (2025-04-08 05:58:55): gzip -c /tmp/Rtmp2bxDJx/file1db163a56a5d
+#> | gzip -d > /tmp/Rtmp2bxDJx/file1db14f8f6795
+#> Running scheduled exit task
+#> Command process finished
+#> System command succeed
+identical(readLines(file), readLines(file2))
+#> [1] TRUEIn the last we clean the temporary files.
+
+file.remove(file)
+#> [1] TRUE
+file.remove(file2)
+#> [1] TRUE
+
+
+Development +
+To add a new command, use the make_command function. This helper function is designed to assist developers in creating functions that initialize new command objects. A command object is a bundle of multiple Command R6 objects (note the uppercase "C" in Command, which distinguishes it from the command object) and the associated running environment (including the working directory and environment variables).
The make_command function accepts a function that initializes a new Command object and, when necessary, validates the input arguments. The core purpose is to create a new Command R6 object, so familiarity with the R6 class system is essential.
There are several private methods or fields you may want to override when creating a new Command R6 object. The first method is command_locate, which determines how to locate the command path. By default, it will attempt to use the cmd argument provided by the user. If no cmd argument is supplied, it will try to locate the command using the alias method. In most cases, you will only need to provide values for the alias method, rather than overriding the command_locate method.
For example, consider the ping command. Here is how you can define it:
+Ping <- R6::R6Class(
+ "Ping",
+ inherit = Command,
+ private = list(alias = function() "ping")
+)
+ping <- make_command("ping", function(..., ping = NULL) {
+ Ping$new(cmd = ping, ...)
+})
+ping("8.8.8.8") |> cmd_run(timeout = 5, stdout = "|") # terminate it after 5s
+#> Running command (2025-04-08 05:58:55): /usr/bin/ping 8.8.8.8
+#> Running scheduled exit task
+#> Command process finished
+#> Warning: System command timed out in 5 secs (status: -9)For command-line tools, the input parameters should always be characters. The core principle of the Command object is to convert all R objects (such as data frames) into characters—typically file paths of R objects that have been saved to disk.
+
+
+Session Informations +
+
+sessionInfo()
+#> R version 4.4.3 (2025-02-28)
+#> Platform: x86_64-pc-linux-gnu
+#> Running under: Ubuntu 24.04.2 LTS
+#>
+#> Matrix products: default
+#> BLAS: /usr/lib/x86_64-linux-gnu/openblas-pthread/libblas.so.3
+#> LAPACK: /usr/lib/x86_64-linux-gnu/openblas-pthread/libopenblasp-r0.3.26.so; LAPACK version 3.12.0
+#>
+#> locale:
+#> [1] LC_CTYPE=C.UTF-8 LC_NUMERIC=C LC_TIME=C.UTF-8
+#> [4] LC_COLLATE=C.UTF-8 LC_MONETARY=C.UTF-8 LC_MESSAGES=C.UTF-8
+#> [7] LC_PAPER=C.UTF-8 LC_NAME=C LC_ADDRESS=C
+#> [10] LC_TELEPHONE=C LC_MEASUREMENT=C.UTF-8 LC_IDENTIFICATION=C
+#>
+#> time zone: UTC
+#> tzcode source: system (glibc)
+#>
+#> attached base packages:
+#> [1] stats graphics grDevices utils datasets methods base
+#>
+#> other attached packages:
+#> [1] blit_0.2.0.9000
+#>
+#> loaded via a namespace (and not attached):
+#> [1] digest_0.6.37 R6_2.6.1 fastmap_1.2.0 xfun_0.52
+#> [5] knitr_1.50 parallel_4.4.3 htmltools_0.5.8.1 rmarkdown_2.29
+#> [9] ps_1.9.0 cli_3.6.4 processx_3.8.6 data.table_1.17.0
+#> [13] compiler_4.4.3 tools_4.4.3 evaluate_1.0.3 yaml_2.3.10
+#> [17] rlang_1.1.5
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/pkgdown.css b/docs/pkgdown.css
new file mode 100644
index 0000000..80ea5b8
--- /dev/null
+++ b/docs/pkgdown.css
@@ -0,0 +1,384 @@
+/* Sticky footer */
+
+/**
+ * Basic idea: https://philipwalton.github.io/solved-by-flexbox/demos/sticky-footer/
+ * Details: https://github.com/philipwalton/solved-by-flexbox/blob/master/assets/css/components/site.css
+ *
+ * .Site -> body > .container
+ * .Site-content -> body > .container .row
+ * .footer -> footer
+ *
+ * Key idea seems to be to ensure that .container and __all its parents__
+ * have height set to 100%
+ *
+ */
+
+html, body {
+ height: 100%;
+}
+
+body {
+ position: relative;
+}
+
+body > .container {
+ display: flex;
+ height: 100%;
+ flex-direction: column;
+}
+
+body > .container .row {
+ flex: 1 0 auto;
+}
+
+footer {
+ margin-top: 45px;
+ padding: 35px 0 36px;
+ border-top: 1px solid #e5e5e5;
+ color: #666;
+ display: flex;
+ flex-shrink: 0;
+}
+footer p {
+ margin-bottom: 0;
+}
+footer div {
+ flex: 1;
+}
+footer .pkgdown {
+ text-align: right;
+}
+footer p {
+ margin-bottom: 0;
+}
+
+img.icon {
+ float: right;
+}
+
+/* Ensure in-page images don't run outside their container */
+.contents img {
+ max-width: 100%;
+ height: auto;
+}
+
+/* Fix bug in bootstrap (only seen in firefox) */
+summary {
+ display: list-item;
+}
+
+/* Typographic tweaking ---------------------------------*/
+
+.contents .page-header {
+ margin-top: calc(-60px + 1em);
+}
+
+dd {
+ margin-left: 3em;
+}
+
+/* Section anchors ---------------------------------*/
+
+a.anchor {
+ display: none;
+ margin-left: 5px;
+ width: 20px;
+ height: 20px;
+
+ background-image: url(./link.svg);
+ background-repeat: no-repeat;
+ background-size: 20px 20px;
+ background-position: center center;
+}
+
+h1:hover .anchor,
+h2:hover .anchor,
+h3:hover .anchor,
+h4:hover .anchor,
+h5:hover .anchor,
+h6:hover .anchor {
+ display: inline-block;
+}
+
+/* Fixes for fixed navbar --------------------------*/
+
+.contents h1, .contents h2, .contents h3, .contents h4 {
+ padding-top: 60px;
+ margin-top: -40px;
+}
+
+/* Navbar submenu --------------------------*/
+
+.dropdown-submenu {
+ position: relative;
+}
+
+.dropdown-submenu>.dropdown-menu {
+ top: 0;
+ left: 100%;
+ margin-top: -6px;
+ margin-left: -1px;
+ border-radius: 0 6px 6px 6px;
+}
+
+.dropdown-submenu:hover>.dropdown-menu {
+ display: block;
+}
+
+.dropdown-submenu>a:after {
+ display: block;
+ content: " ";
+ float: right;
+ width: 0;
+ height: 0;
+ border-color: transparent;
+ border-style: solid;
+ border-width: 5px 0 5px 5px;
+ border-left-color: #cccccc;
+ margin-top: 5px;
+ margin-right: -10px;
+}
+
+.dropdown-submenu:hover>a:after {
+ border-left-color: #ffffff;
+}
+
+.dropdown-submenu.pull-left {
+ float: none;
+}
+
+.dropdown-submenu.pull-left>.dropdown-menu {
+ left: -100%;
+ margin-left: 10px;
+ border-radius: 6px 0 6px 6px;
+}
+
+/* Sidebar --------------------------*/
+
+#pkgdown-sidebar {
+ margin-top: 30px;
+ position: -webkit-sticky;
+ position: sticky;
+ top: 70px;
+}
+
+#pkgdown-sidebar h2 {
+ font-size: 1.5em;
+ margin-top: 1em;
+}
+
+#pkgdown-sidebar h2:first-child {
+ margin-top: 0;
+}
+
+#pkgdown-sidebar .list-unstyled li {
+ margin-bottom: 0.5em;
+}
+
+/* bootstrap-toc tweaks ------------------------------------------------------*/
+
+/* All levels of nav */
+
+nav[data-toggle='toc'] .nav > li > a {
+ padding: 4px 20px 4px 6px;
+ font-size: 1.5rem;
+ font-weight: 400;
+ color: inherit;
+}
+
+nav[data-toggle='toc'] .nav > li > a:hover,
+nav[data-toggle='toc'] .nav > li > a:focus {
+ padding-left: 5px;
+ color: inherit;
+ border-left: 1px solid #878787;
+}
+
+nav[data-toggle='toc'] .nav > .active > a,
+nav[data-toggle='toc'] .nav > .active:hover > a,
+nav[data-toggle='toc'] .nav > .active:focus > a {
+ padding-left: 5px;
+ font-size: 1.5rem;
+ font-weight: 400;
+ color: inherit;
+ border-left: 2px solid #878787;
+}
+
+/* Nav: second level (shown on .active) */
+
+nav[data-toggle='toc'] .nav .nav {
+ display: none; /* Hide by default, but at >768px, show it */
+ padding-bottom: 10px;
+}
+
+nav[data-toggle='toc'] .nav .nav > li > a {
+ padding-left: 16px;
+ font-size: 1.35rem;
+}
+
+nav[data-toggle='toc'] .nav .nav > li > a:hover,
+nav[data-toggle='toc'] .nav .nav > li > a:focus {
+ padding-left: 15px;
+}
+
+nav[data-toggle='toc'] .nav .nav > .active > a,
+nav[data-toggle='toc'] .nav .nav > .active:hover > a,
+nav[data-toggle='toc'] .nav .nav > .active:focus > a {
+ padding-left: 15px;
+ font-weight: 500;
+ font-size: 1.35rem;
+}
+
+/* orcid ------------------------------------------------------------------- */
+
+.orcid {
+ font-size: 16px;
+ color: #A6CE39;
+ /* margins are required by official ORCID trademark and display guidelines */
+ margin-left:4px;
+ margin-right:4px;
+ vertical-align: middle;
+}
+
+/* Reference index & topics ----------------------------------------------- */
+
+.ref-index th {font-weight: normal;}
+
+.ref-index td {vertical-align: top; min-width: 100px}
+.ref-index .icon {width: 40px;}
+.ref-index .alias {width: 40%;}
+.ref-index-icons .alias {width: calc(40% - 40px);}
+.ref-index .title {width: 60%;}
+
+.ref-arguments th {text-align: right; padding-right: 10px;}
+.ref-arguments th, .ref-arguments td {vertical-align: top; min-width: 100px}
+.ref-arguments .name {width: 20%;}
+.ref-arguments .desc {width: 80%;}
+
+/* Nice scrolling for wide elements --------------------------------------- */
+
+table {
+ display: block;
+ overflow: auto;
+}
+
+/* Syntax highlighting ---------------------------------------------------- */
+
+pre, code, pre code {
+ background-color: #f8f8f8;
+ color: #333;
+}
+pre, pre code {
+ white-space: pre-wrap;
+ word-break: break-all;
+ overflow-wrap: break-word;
+}
+
+pre {
+ border: 1px solid #eee;
+}
+
+pre .img, pre .r-plt {
+ margin: 5px 0;
+}
+
+pre .img img, pre .r-plt img {
+ background-color: #fff;
+}
+
+code a, pre a {
+ color: #375f84;
+}
+
+a.sourceLine:hover {
+ text-decoration: none;
+}
+
+.fl {color: #1514b5;}
+.fu {color: #000000;} /* function */
+.ch,.st {color: #036a07;} /* string */
+.kw {color: #264D66;} /* keyword */
+.co {color: #888888;} /* comment */
+
+.error {font-weight: bolder;}
+.warning {font-weight: bolder;}
+
+/* Clipboard --------------------------*/
+
+.hasCopyButton {
+ position: relative;
+}
+
+.btn-copy-ex {
+ position: absolute;
+ right: 0;
+ top: 0;
+ visibility: hidden;
+}
+
+.hasCopyButton:hover button.btn-copy-ex {
+ visibility: visible;
+}
+
+/* headroom.js ------------------------ */
+
+.headroom {
+ will-change: transform;
+ transition: transform 200ms linear;
+}
+.headroom--pinned {
+ transform: translateY(0%);
+}
+.headroom--unpinned {
+ transform: translateY(-100%);
+}
+
+/* mark.js ----------------------------*/
+
+mark {
+ background-color: rgba(255, 255, 51, 0.5);
+ border-bottom: 2px solid rgba(255, 153, 51, 0.3);
+ padding: 1px;
+}
+
+/* vertical spacing after htmlwidgets */
+.html-widget {
+ margin-bottom: 10px;
+}
+
+/* fontawesome ------------------------ */
+
+.fab {
+ font-family: "Font Awesome 5 Brands" !important;
+}
+
+/* don't display links in code chunks when printing */
+/* source: https://stackoverflow.com/a/10781533 */
+@media print {
+ code a:link:after, code a:visited:after {
+ content: "";
+ }
+}
+
+/* Section anchors ---------------------------------
+ Added in pandoc 2.11: https://github.com/jgm/pandoc-templates/commit/9904bf71
+*/
+
+div.csl-bib-body { }
+div.csl-entry {
+ clear: both;
+}
+.hanging-indent div.csl-entry {
+ margin-left:2em;
+ text-indent:-2em;
+}
+div.csl-left-margin {
+ min-width:2em;
+ float:left;
+}
+div.csl-right-inline {
+ margin-left:2em;
+ padding-left:1em;
+}
+div.csl-indent {
+ margin-left: 2em;
+}
diff --git a/docs/pkgdown.js b/docs/pkgdown.js
new file mode 100644
index 0000000..6f0eee4
--- /dev/null
+++ b/docs/pkgdown.js
@@ -0,0 +1,108 @@
+/* http://gregfranko.com/blog/jquery-best-practices/ */
+(function($) {
+ $(function() {
+
+ $('.navbar-fixed-top').headroom();
+
+ $('body').css('padding-top', $('.navbar').height() + 10);
+ $(window).resize(function(){
+ $('body').css('padding-top', $('.navbar').height() + 10);
+ });
+
+ $('[data-toggle="tooltip"]').tooltip();
+
+ var cur_path = paths(location.pathname);
+ var links = $("#navbar ul li a");
+ var max_length = -1;
+ var pos = -1;
+ for (var i = 0; i < links.length; i++) {
+ if (links[i].getAttribute("href") === "#")
+ continue;
+ // Ignore external links
+ if (links[i].host !== location.host)
+ continue;
+
+ var nav_path = paths(links[i].pathname);
+
+ var length = prefix_length(nav_path, cur_path);
+ if (length > max_length) {
+ max_length = length;
+ pos = i;
+ }
+ }
+
+ // Add class to parent
+
+
+
+
+
+
+
+
+
+
+
+
+ Changelog
+ Source:NEWS.md
+
+
+
+ blit 0.2.02025-03-29
+
+
+New features
+new function
cmd_condato define thePATHenvironment variables with conda environment.
+new function
appmambato install software and manage Environment withmicromamba.
+new function
cmd_on_failto define the expression to be evaluated when the command failed.
+new function
cmd_on_succeedto define the expression to be evaluated when the command succeeded.
+new function
cmd_on_start()to define the expressions which will be run when command started
+new function
cmd_on_exit()to define the expressions which will be run when command finished
+new command
samtools
+new function
cmd_parallel()to run multiple commands meanwhile
+use
processxpackage to execute the command and remove thesysandwithrpackage from dependencies
+
![[Deprecated]](figures/lifecycle-deprecated.svg)