G.0 | Quick Ref#

[1] API#

API functions

API Function

Name

Purpose

rv.R (rS)

Run

Run scripts and markup

rv.I (rS)

Insert

Insert static sources

rv.V (rS)

Values

Calculate values

rv.T (rS)

Tools

Execute shell scripts and external programs

rv.D (rS)

Doc

Publish docs

rv.S;X (rS)

Skip

Skip section or exit (comments and debugging)

where rS is a rivt string. The first line of a rivt string (rS) is the header substring.

Header substrings

rv.I("""A New Section | private, doc, section

    Content text
    ...

    """)

The default privacy setting may be changed in the rivt file comment settings shown below

import rivtlib.rvapi as rv

# rv private = false ; default section parameter changed to public (true)
# rv no_tag = true ; API type is added to section number (true)
# rv set_width = true character width of text output (80

Individual sections may be set back to private in the header substring after changing the default.

Header substring defaults

API

private; public

doc; stored

section; merge

pdfpage; nopage

markup

rv.R

private

stored

section

nopage

type

rv.I

private

doc

section

nopage

NA

rv.V

private

doc

section

nopage

NA

rv.T

private

stored

merge [1]

nopage

NA

rv.D

private

stored only

NA

NA

NA

rv.S

NA

NA

NA

NA

NA

rv.X

NA

NA

NA

NA

NA

[2] Line Tags#

Format a line of text

API Scope

Line Tag

Description

rv.I

text *word word* text

italicize words

rv.I

text **word word** text

bold words

rv.I

text _[D] label, filename | text

[3] Download link

rv.I

text _[G] glossary term | text

[7] Glossary link

rv.I

text _[S] label, section | text

[8] Section link

rv.I

text _[U] label, url | text

[9] URL link

rv.I,V

text _[#] text

[6] Endnote number

rv.I,V

text _[R]

[2] Right justify text

rv.I,V

text _[B]

[2] Bold text

rv.I,V

text _[C]

[2] Bold center text

rv.I,V

title _[T]

[11] Table number

rv.I,V

ASCII text math _[M] description

[4] Text math

rv.I,V

LaTeX math _[L] description

[5] LaTeX math

rv.I,V

text _[V] var_name | text

[10] Substitute value

all

## text

nonprinting comment

[3] Block Tags#

Format or run blocks of text or scripts

API Scope

Block Tag

Description

rv.I

_[[TOPIC]] topic

[1] Topic

rv.I,V

_[[TEXT]] type

[2] Text block

rv.I,V

_[[TABLE]] label

[3] Table Block

rv.V

_[[ARGS]] arg dict name

[4] Argument block

rv.T

_[[WRITE]] var name

[5] Write

rv.T

_[[SHELL]] os, wait;nowait

[6] Shell script

rv.D

_[[METADATA]] label

[7] Metadata

all

_[[END]]

[8] End block

[4] Commands#

Commands format files and equations

API Scope

Command

Description

rv.I, V

| TABLE | rel path | title,width,head;nohead,num;non

[4] Table file

rv.I, V

| IMAGE | rel path | caption, scale, num;non, time;not

[5] Image file

rv.I, V

| IMAGE2 | rel path1, rel path2 | c1,c2,s1,s2,n1,n2

[6] Adjacent images

rv.V

| PYTHON | rel path | rivt;namespace

[12] Python file

rv.V

| VALTABLE | rel path | title, width, num;non

[7] Valtable file

rv.V

a ==: 1*IN | unit1, unit2, decimal | label

[8] Define value

rv.V

c <=: expression | unit1, unit2, decimal | label

[9] Assign value

rv.V

c :=: func(x,y) | unit1, unit2, decimal | label

[10] Inline function

rv.V

a < c | unit, decimal, text1, text2 | label

[11] Compare values

rv.V

| FUNCTION | function, arg, var, type | label

[13] Function

rv.T

| COPY | abs src path | abs dest path | file pattern

[14] Copy Files

rv.T

| SHELL | abs path | os, wait

[2] Shell file

rv.D

| ATTACHPDF | rel path | front;back, title

[15] Attach PDF

rv.D

| PUBLISH | doc title | type

[16] Publish doc

Parent Paths for Commands

See here for the folder structure.

Command

Parent Path [1]

R/W

| SHELL |

rivt-report/

R

| IMAGE |

rivt-report/

R

| IMAGE2 |

rivt-report/

R

| TABLE |

rivt-report/

R

| VALTABLE |

rivt-report/ [2]

R

| VALTABLE |

rivt-report/ [3]

R

| PYTHON |

rivt-report/

R

| MARKUP |

rivt-report/

R

| ATTACHPDF |

rivt-report/

R

| PUBLISH |

/_published/ [4]

W

[1} file paths begin with rvsrc/ and may include subdirectories [2] values are read from rvsrc/ and its subdirectories [3] values written by rivt are read from rv_stor/vals [4] docs are written to subdirectories of _published

[5] Folders#

[rivt-]Report-Label/             rivt Folder
    ├── .vscode/                      optional VSCode settings
    ├── README.txt                    rivt-generated text report
    ├── [_rivt-public]/               rivt-generated public files
        ├── rvsrc/                        author source files
        ├── rv-101-filename1.py           public rivt file
        ├── rv-102-filename2.py           public rivt file
        ├── rv-201-filename3.py           public rivt file
         ...
    ├── [rivt-report]/                 report folder
        ├── [rivt-report]-1.py            report generating script
        ├── [rv101-]filename1.py          rivt file
        ├── [rv102-]filename2.py          rivt file
        ├── [rv201-]filename3.py          rivt file
            ...
        ├── [rvsrc]/                      author provided files and folders
            ├── [downloads]/                    files to download
                └── conc-vals.txt
            ├── [page]/                          page layout images
                ├── favicon.png
                ├── covlogo1.png
                └── runlogo1.png
            ├── data/                            tables
                └── steel-vals.csv
            ├── tools/                           OS shell commands
                └── opensees.sh
            ├── fig1.png
            └── fig2.jpg
        ├── [rv_stor]/                    rivt-generated source files
            ├── [logs]/                          log files
                ├── rv101-log.txt
                └── rv102-log.txt
            ├── [sect]/                          sections not printed
                ├── rv202-5d.txt
                ├── rv103-4t.txt
                └── rv301-2r.txt
            ├── [temp]/                          temp files
                └── rv101-label3.tex
            ├── output.dat
            ├── v101-2.csv
            └── v102-3.csv
        ├── [_published]/                 rivt-published docs and reports
            ├── [docs]/                          html docs
                ├── html auxiliary folders
                ├── index.html
                ├── rv101-filename1.html
                ├── rv102-filename2.html
                ├── rv201-filename3.html
                    ...
            ├── [pdfdocs]/                       pdf docs
                ├── pdf auxiliary folders
                ├── report-title.pdf
                ├── rv101-filename1.pdf
                ├── rv102-filename1.pdf
                ├── rv201-filename3.pdf
                    ...
            └── [txtdocs]/                       text docs
                ├── report-title.txt
                ├── rv101-filename1.txt
                ├── rv102-filename1.txt
                ├── rv201-filename3.txt
                    ...
        └── [_rstdocs]/                     rivt-generated rst files
            ├── _downloads/
            ├── _static/
            ├── rv101-filename1.rst
            ├── rv102-filename2.rst
            ├── rv201-filename3.rst
                ...

[6] Python Requirements#

The minimum Python version is 3.14. rivt project packages include the following categories:

  • formatting

  • numerical analysis

  • symbolic processing

  • visualization

  • IDE

Dependency

description

“pyzo>=4.20.0”

a lightweight IDE

“pyside6>=6.10.1”

QT bindings

“fastcore>=1.8.16”

code simplification

“tabulate>=0.9.0”

format tables

“pillow>=11.2.1”

image processing

“matplotlib>=3.10.1”

data visualization

“sympy>=1.13.3”

symbolic analysis

“numpy>=2.2.5”

numerical processing

“scipy>=1.16.3”

numerical analysis

“pandas>=2.2.3”

data analysis

“docutils>=0.21.2”

reStructuredText processing

“ipython>=8.16.2”

interactive Python shell

“ipykernel>=6.28.1”

Jupyter kernel for Python

“reportlab>=4.4.0”

PDF document generation

“rst2pdf>=0.103.1”

PDF document generation

“pypdf>=1.0.3”

PDF document manipulation

“Sphinx>=8.2.3”

HTML document generation

“pydata-sphinx-theme>=0.16.1”

HTML document generation

“sphinx-copybutton>=0.5.2”

HTML document generation

“sphinx_design>=0.6.1”

HTML document generation

“sphinx-favicon>=1.0.1”

HTML document generation

“sphinx-togglebutton>=0.3.2”

HTML document generation

“sphinxcontrib-applehelp>=2.0.0”

HTML document generation

“sphinxcontrib-devhelp>=2.0.0”

HTML document generation

“sphinxcontrib-email>=0.3.6”

HTML document generation

“sphinxcontrib-htmlhelp>=2.1.0”

HTML document generation

“sphinxcontrib-jquery>=4.1”

HTML document generation

“sphinxcontrib-jsmath>=1.0.1”

HTML document generation

“sphinxcontrib-qthelp>=2.0.0”

HTML document generation

“sphinxcontrib-serializinghtml>=2.0.0”

HTML document generation

[7] VSCode Settings#

Workspace extension and other settings are stored in the .vscode folder and should be included as part of a rivt folder. Settings that affect the rivt editing and execution environment incldue:

  • rivt.code-snippets

  • settings.json (extension settings)

  • tasks.json

  • launch.json

Global settings can be exported and imported using VSCode Profiles. VSCode rivt extensions and settings may be installed from this link.

Extension

description

BUTTONS

—

tombonnike.vscode-status-bar-format-toggle

format button

gsppvo.vscode-commandbar

command buttons

AdamAnand.adamstool

command buttons

nanlei.save-all

save all button

Ho-Wan.setting-toggle

toggle settings

yasukotelin.toggle-panel

toggle panel

fabiospampinato.vscode-commands

user command buttons

jerrygoyal.shortcut-menu-bar

menu bar

EDITING

—

henryclayton.context-menu-toggle-comments

toggle comments

TroelsDamgaard.reflow-paragraph

wrap paragraph

streetsidesoftware.code-spell-checker

spell check

jmviz.quote-list

quote elements in a list

njpwerner.autodocstring

insert doc string

oijaz.unicode-latex

unicode symbols from latex

jsynowiec.vscode-insertdatestring

insert date string

janisdd.vscode-edit-csv

csv editor

VIEWS

—

GrapeCity.gc-excelviewer

excel viewer

SimonSiefke.svg-preview

svg viewer

tomoki1207.pdf

pdf viewer

RandomFractalsInc.vscode-data-preview

data viewing tools

Fr43nk.seito-openfile

open file from path

vikyd.vscode-fold-level

line folding tool

file-icons.file-icons

icon library

tintinweb.vscode-inline-bookmarks

inline bookmarks

MANAGEMENT

—

alefragnani.project-manager

folder, project management

Anjali.clipboard-history

clipboard history

dionmunk.vscode-notes

notepad

hbenl.vscode-test-explorer

test explorer

mightycoco.fsdeploy

save file to second location

lyzerk.linecounter

count lines in files

sandcastle.vscode-open

open files in default app

zjffun.snippetsmanager

snippet manager

spmeesseman.vscode-taskexplorer

task explorer

GITHUB

—

GitHub.codespaces

run files in codespaces

GitHub.remotehub

run remote files

ettoreciprian.vscode-websearch

search github within VSCode

donjayamanne.githistory

git history

MichaelCurrin.auto-commit-msg

git auto commit message

github.vscode-github-actions

github actions

GitHub.vscode-pull-request-github

github pull request

k9982874.github-gist-explorer

gist explorer

vsls-contrib.gistfs

gist tools

PYTHON

—

ms-python.autopep8

python pep8 formatting

ms-python.isort

python sort imports

donjayamanne.python-environment-manager

python library list

ms-python.python

python tools

ms-python.vscode-pylance

python language server

ms-toolsai.jupyter

jupyter tools

ms-toolsai.jupyter-keymap

jupyter tools

ms-toolsai.jupyter-renderers

jupyter tools

ms-toolsai.vscode-jupyter-cell-tags

jupyter tools

ms-toolsai.vscode-jupyter-slideshow

jupyter tools

LANGUAGES

—

qwtel.sqlite-viewer

sqlite tools

RDebugger.r-debugger

R tools

REditorSupport.r

R tools

ms-vscode-remote.remote-wsl

windows linux tools

James-Yu.latex-workshop

latex tools

lextudio.restructuredtext

restructured text tools

trond-snekvik.simple-rst

restructured syntax

yzane.markdown-pdf

markdown to pdf

yzhang.markdown-all-in-one

markdown tools

Snippets and extensions

Keystrokes

Description

api

insert import statement for API

rvr

API Run

rvi

API Insert

rvv

API Values

rvt

API Tools

rvd

API Docs
at

attach command
im

image command
i2

side by side image command
pu

publish command
ta

table command
va

value command
va

value table command

_ce

center bold line of text

_ma

utf-8 text math

_la

LaTeX math

_ta

number table

_ur

URL link

_gl

glossary term link

_se

section link

_en

endnote link

_do

download link

_[m

markup block

_[p

python block

_[e

end block

alt+ctrl+c

insert cell marker with label above API function

alt+q

rewrap paragraph with hard line feeds (80 default)

alt+p

open file under cursor

alt+.

select correct spelling under cursor

alt+8

insert date

alt+9

insert time

ctl+1

focus on first editor

ctl+2

focus on next editor

ctl+3

focus on previous editor

ctl+8

focus on explorer pane

ctl+9

focus on github pane

ctl+alt+x

reload window

ctl+alt+[

reload window

ctl+alt+]

unfold all code

ctl+alt+u

unfold all code

ctl+alt+f

fold code level 2 (rivt sections visible)

ctl+alt+a

fold code - all levels

ctl+alt+t

toggle local fold

ctl+alt+e

toggle explorer sort order

ctl+alt+s

toggle spell check

ctl+alt+g

next editor group

ctl+shift+u

open URL under cursor in browser

ctl+shift+s

open GitHub README search for rivt

ctl+shift+a

commit all

ctl+shift+z

commit the current editor

ctl+shift+x

post to remote

Modified Keyboard Shortcuts

Keystroke

Description

alt+q

rewrap paragraph with hard line feeds (80 default)

alt+p

open file under cursor

alt+.

select correct spelling under cursor

alt+8

insert date

alt+9

insert time

ctl+1

focus on first editor

ctl+2

focus on next editor

ctl+3

focus on previous editor

ctl+8

focus on explorer pane

ctl+9

focus on github pane

ctl+alt+x

reload window

ctl+alt+u

unfold all code

ctl+alt+f

fold code level 2 (rivt sections visible)

ctl+alt+a

fold code - all levels

ctl+alt+t

toggle local fold

ctl+alt+e

toggle explorer sort order

ctl+alt+s

toggle spell check

ctl+alt+g

next editor group

ctl+shift+u

open URL under cursor in browser

ctl+shift+s

open GitHub rivt README search

ctl+shift+a

commit all

ctl+shift+z

commit current editor

ctl+shift+x

post to remote