Skip to main content

Create R markdown files from markdown files and scripts.

Project description

The catren python package

Using catren you can create and render R markdown files in

The catren python package consists of 4 functions:

  • catrmd, which concatenates input files to output an R Markdown (Rmd) file.
  • render, which calls rmarkdown::render to create various output files (e.g. HTML documents).
  • catren, which combines the functionality of catrmd and render.
  • rmdtor, which uses knitr::purl to convert an Rmd into an R script.

All of the above function work for Python and R code, except rmdtor which skips Python chunks.

To run Rmd files that include R and Python code, you will need the reticulate R package.

The functions that begin with r (render and rmdtor) rely on the rmarkdown and knitr, R packages written by Yihui Xie. The catrmd function has no dependencies beyond Python, all other functions (render, catren, and rmdtor) require R.


pip install catren

or clone the repo, e.g. git clone and either use locally, e.g. python header.yml notes.txt or install using, e.g. python install.

Basic usage: terminal

Creating an R markdown file with catrmd in the terminal

The catrmd functions works like nbuild. Provide all of the source files as arguments, e.g.

catrmd header.yml letters.R notes.txt

The default output filename for catrmd is cat.Rmd. By default, input and output files are located in the current directory ('./').

You can provide a more descriptive filename for the unrendered Rmd (-u) and set different input (-i) and output (-o) filepaths:

catrmd header.yml letters.R notes.txt --unrendered raw.Rmd --output_path rmarkdown/
# Or
catrmd header.yml letters.R notes.txt -u raw.Rmd -o rmarkdown/

If want to later output an R notebook using RStudio, your YAML header should include html_notebook as an output type (Hint: press ctrl/cmd+Shift+K).

title: "Untitled"
output: html_notebook

The render function from the rmarkdown R package allows you to specify the output type on the fly with the output_format argument.

Basic usage: python environment

# You can import any or all of the functions from the catren package.

# You can also import each function individually
from catren import catrmd
from catren import render
from catren import catren
from catren import rmdtor

# The above imports all 4 functions
# This can also be done with either of the two lines below.
from catren import nbuild, nbexec, nbless, catrmd
from catren import *

# Another alternative is to import the package and use it as a namespace.
import catren as cr

# Use individually

# To make an Rmd file, use catrmd
catrmd(["header.yml", "", "letters.R", "", "notes.txt"], output_path="rmarkdown/")

# catrmd will also work with Python scripts.
catrmd(["header.yml", "", "", "notes.txt"], output_path="notebooks/")

# Or to run both catrmd and render at once, use catren
catren["", "", "notes.txt"], nbexec_path="notebooks/")

# Use nbless as a namespace
cr.catrmd(["header.yml", "", "letters.R", "", "notes.txt"], output_path="rmarkdown/")

You can also run the catren functions in an R environment using the reticulate R package.

Missing a dependency?

If you installed Python and R with Anaconda, you should already have all of the dependencies (python and r-essentials).

If not, or if you have Miniconda installed, run

conda install -yc r r-essentials

Too many file names to type out?

You can use the ls command to assign all of the relevant names in the current directory to a variable and pass this variable as an argument to

To preserve the order and differentiate files that should be incorporated into the notebook, I recommend left padding your file names with zeros (e.g.,

Consider the example below:

touch {01..09}.py
name_list=`ls 0*.py`
python `echo $name_list`

In a python environment, I recommend os.listdir to obtain a list of all files:

from os import listdir
from os.path import isfile, join
onlyfiles = [f for f in listdir(mypath) if isfile(join(mypath, f))]

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for catren, version 0.0.1
Filename, size File type Python version Upload date Hashes
Filename, size catren-0.0.1-py3-none-any.whl (3.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size catren-0.0.1.tar.gz (3.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page