127 introduce within.qenv

[chlebowa]

Closes #127

Added an S3 within method for class qenv.
Usage: within(data, expr, code, ...).

• argument data is qenv, this is handled by S3 dispatch
• argument expr is for literal code
• argument code is for variables holding code (call, list of calls, expression, list of expressions) or literal character strings

Code passed in any form is converted into list of (single) calls, which are evaluated sequentially.
The whole code is appended to the @code slot. Currently this is stored as expression but following #146 the slot will hold a single string, which will enable keeping comments.
Characters (vectors or strings) passed to code are stored as single strings, combined with paste(..., collapse = "\n").
Language (calls or lists of calls, expressions or lists of expressions) passed to code are deparsed and combined likewise.

[github-actions]

Code Coverage Summary

Filename                 Stmts    Miss  Cover    Missing
---------------------  -------  ------  -------  ---------
R/include_css_js.R           7       7  0.00%    12-20
R/qenv-concat.R             10       0  100.00%
R/qenv-constructor.R        12       0  100.00%
R/qenv-eval_code.R          48       2  95.83%   91, 100
R/qenv-get_code.R           18       0  100.00%
R/qenv-get_var.R            19       0  100.00%
R/qenv-get_warnings.R       24       0  100.00%
R/qenv-join.R               46       0  100.00%
R/qenv-show.R                1       1  0.00%    16
R/qenv-within.R             95      95  0.00%    3-150
R/utils.R                   19       0  100.00%
TOTAL                      299     105  64.88%

Diff against main

Filename           Stmts    Miss  Cover
---------------  -------  ------  --------
R/qenv-within.R      +95     +95  +100.00%
TOTAL                +95     +95  -30.22%

Results for commit: 260ae9f

Minimum allowed coverage is 80%

♻️ This comment has been updated with latest results

[github-actions]

Unit Tests Summary

    1 files      8 suites   2s ⏱️
  66 tests   66 ✔️ 0 💤 0 ❌
144 runs  144 ✔️ 0 💤 0 ❌

Results for commit 94f6647.

[chlebowa]

Since we want to store code as is, it becomes an issue to perform substitution properly. Code coming in (whether it's through expr or code) is stored in the @code slot and only then converted into single calls which are substituted with values from ... and evaluated.

[chlebowa]

A solution has been proposed 👍