<commit_before># -*- mode: org; mode: auto-fill; -*-
#+STARTUP:	showeverything

* Org Converge
** Description

This attempts to be an experiment of using Org mode syntax to
create documentable reproducible runs, borrowing some ideas
of what is possible to do with tools like =chef-solo=,
=rake=, =foreman=, etc...

** Motivation

The Org babel syntax has proven to be flexible enough to produce
/reproducible research/ papers. Then, I believe that configuring and setting up
a server for example is something that could be also be done using
the same syntax, given that /converging/ the configuration is something
that one ought to be able to reproduce.

** Usage

To run the blocks in parallel...

#+begin_src sh
org-converge path/to/setup-file.org --runmode=parallel
#+end_src

or sequentially...

#+begin_src sh
org-converge path/to/setup-file.org --runmode=sequential
#+end_src

By including ~:after~ or ~:before~ arguments to a block,
it is possible to make the blocks depend on one another.

#+begin_src sh<commit_msg>How to install...<commit_after># -*- mode: org; mode: auto-fill; -*-
#+STARTUP:	showeverything

* Org Converge
** Description

This attempts to be an experiment of using Org mode syntax to
create documentable reproducible runs, borrowing some ideas
of what is possible to do with tools like =chef-solo=,
=rake=, =foreman=, etc...

** Installing

: gem install org-converge

** Motivation

The Org babel syntax has proven to be flexible enough to produce
/reproducible research/ papers. Then, I believe that configuring and setting up
a server for example is something that could be also be done using
the same syntax, given that /converging/ the configuration is something
that one ought to be able to reproduce.

** Usage

To run the blocks in parallel...

#+begin_src sh
org-converge path/to/setup-file.org --runmode=parallel
#+end_src

or sequentially...

#+begin_src sh
org-converge path/to/setup-file.org --runmode=sequential
#+end_src

By including ~:after~ or ~:before~ arguments to a block,
it is possible to make the blocks depend on one another.

#+begin_src sh
{'fraction_non_alphanumeric': 0.0863961813842482, 'fraction_numerical': 0.0, 'mean_word_length': 4.2531328320802, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1712021', 'n_tokens_mistral': 641, 'n_tokens_neox': 622, 'n_words': 285}