pymarkdownroh 0.0.2

A python package to create markdown text.

pymarkdownroh

The pymarkdownroh package contains python modules to create markdown text from python scripts.

Table of Contents

1. Introduction
2. Getting started
   1. Prerequisites
   2. Installation
3. How to use
   1. How to import
   2. Using the module
4. Releasing
5. License

Introduction

This package contains different modules which enable users to write markdown text via python objects. It implements all aspects of the official Markdown Documentation.

The intention of this package is to automatically write markdown files using scripts with templates.

Now it supports extended functionality like tables which are often used in github flavored markdown.

Getting started

Prerequisites

• Python installed
• Operatingsystem: Linux or Windows, not tested on mac
• IDE like VS Code, if you want to contribute or change the code

Installation

There are two ways to install this module depending on the way you work and the preinstalled modules:

1. pip install pymarkdownroh
2. python -m pip install pymarkdownroh

How to use

How to import

You can import the module in two ways:

    import pymarkdownroh

This will import all functions. Even the ones that are not supposed to be used (helper functions).

    from pymarkdownroh import *

This will import only the significant functions, meant for using.

Using the module

Example 1:

# Import all modules from package.
from pymarkdownroh import *

print(create_headline(1, "Document Title"))

# Output:
# 
# "# Document Title"

# Import all modules from package.
from pymarkdownroh import *

l = ["Apples", "Bananas", "Cherries"]

print(create_list(l, True, True))

# Output:
#
# 1. [] Apples
# 2. [] Bananas
# 3. [] Cherries

from pymarkdownroh import create_table

table = create_table(
    ["Name", "Age"],
    [["Alice", "23"], ["Bob", "30"]],
    alignments=["left", "right"],
)
print(table)

# Output:
#
# | Name  | Age |
# | :---- | --: |
# | Alice |  23 |
# | Bob   |  30 |

Releasing

Releases are published automatically when a tag is pushed to GitHub.

# Create release variable.
$Release = "x.x.x"
# Create commit.
git commit --allow-empty -m "Release $Release"
# Create tag.
git tag -a $Release -m "Version $Release"
# Push from original.
git push origin --tags
# Push from fork.
git push upstream --tags

License

MIT