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.

Installation

pip install catren

or clone the repo, e.g. git clone https://github.com/marskar/catren and either use locally, e.g. python catren.py header.yml README.md plot.py notes.txt or install using setup.py, e.g. python setup.py 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 intro.md letters.R notes.txt plot.py

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 intro.md letters.R notes.txt plot.py --unrendered raw.Rmd --output_path rmarkdown/
# Or
catrmd header.yml intro.md letters.R notes.txt plot.py -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", "intro.md", "letters.R", "plot.py", "notes.txt"], output_path="rmarkdown/")

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

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


# Use nbless as a namespace
cr.catrmd(["header.yml", "intro.md", "letters.R", "plot.py", "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 nbconvert.py.

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. 01_intro.md, 02_figure1.py).

Consider the example below:

touch {01..09}.py
name_list=`ls 0*.py`
python catrmd.py `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.

Source Distribution

catren-0.0.1.tar.gz (3.4 kB view details)

Uploaded Source

Built Distribution

catren-0.0.1-py3-none-any.whl (3.3 kB view details)

Uploaded Python 3

File details

Details for the file catren-0.0.1.tar.gz.

File metadata

  • Download URL: catren-0.0.1.tar.gz
  • Upload date:
  • Size: 3.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.18.4 setuptools/39.1.0 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.6.5

File hashes

Hashes for catren-0.0.1.tar.gz
Algorithm Hash digest
SHA256 1508071b87230e0534665b0f81dbe3d9f670f62fe58236dcbd5ac40a2048679a
MD5 5657a5610b07e524b62aa97ec2343a28
BLAKE2b-256 fe37eabe6fba7305f9e21cdbb2cacff771be4c730072fadb5d7b5bf64efeb04c

See more details on using hashes here.

File details

Details for the file catren-0.0.1-py3-none-any.whl.

File metadata

  • Download URL: catren-0.0.1-py3-none-any.whl
  • Upload date:
  • Size: 3.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.18.4 setuptools/39.1.0 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.6.5

File hashes

Hashes for catren-0.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4e3df8cac9f98fa5b26d57f2a2d69abc85692a0811ddb0d0c8fd01c6b5bf36f4
MD5 97b387bd6b9f2530774c43c0c70abd1f
BLAKE2b-256 118d97d2b7029076b542145c8fc19fc3e9a8811995ed8f3ed28ac24ae966555f

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page