Skip to main content

Tool to generates TOC for GitHub markdown

Project description

Table of Contents

Description

Generates very simple TOC (Table of Contents) for GitHub markdown language documents.

Example Usage

$ gittoc -f README.md

Installation From PyPI (preferred)

This application is released with PyPI so you can use pip to install it on your host.

$ pip install git-toc --upgrade

Installation From Sources

$ git clone https://github.com/PrzemekWirkus/git-toc.git
$ cd git-toc
$ python setup.py install

Usage

Below command will print on the screen TOC extracted from file specified with switch -f which you can embed to TOC section of your README.md document.

$ gittoc -f <file-name>

Example

$ gittoc.exe -f TESTING.md
  * [Mbed SDK automated test suite](#mbed-sdk-automated-test-suite)
    * [Introduction](#introduction)
    * [What is host test?](#what-is-host-test)
    * [Test suite core: singletest.py script](#test-suite-core-singletestpy-script)
      * [Parameters of singletest.py](#parameters-of-singletestpy)
        * [MUTs Specification](#muts-specification)
        * [Peripherals testing](#peripherals-testing)
        * [Additional MUTs configuration file settings](#additional-muts-configuration-file-settings)
        * [Run your tests](#run-your-tests)
      * [Exmple of device configuration (one device connected to host computer)](#exmple-of-device-configuration-one-device-connected-to-host-computer)
  * [CppUTest unit test library support](#cpputest-unit-test-library-support)
    * [CppUTest in Mbed SDK testing introduction](#cpputest-in-mbed-sdk-testing-introduction)
    * [From where you can get more help about CppUTest library and unit testing](#from-where-you-can-get-more-help-about-cpputest-library-and-unit-testing)
    * [How to add CppUTest to your current Mbed SDK installation](#how-to-add-cpputest-to-your-current-mbed-sdk-installation)
      * [Do I need CppUTest port for Mbed SDK?](#do-i-need-cpputest-port-for-mbed-sdk)
      * [Prerequisites](#prerequisites)
      * [How / where to install](#how--where-to-install)
    * [New off-line mbed SDK project with CppUTest support](#new-offline-mbed-sdk-project-with-cpputest-support)
    * [CppUTest with mbed port ](#cpputest-with-mbed-port-)
    * [Unit test location](#unit-test-location)
    * [Define unit tests in mbed SDK test suite structure](#define-unit-tests-in-mbed-sdk-test-suite-structure)
      * [Tests are now divided into two types:](#tests-are-now-divided-into-two-types)
        * ['Hello world' tests ](#hello-world-tests-)
        * ['Unit test' test cases](#unit-test-test-cases)
    * [Example](#example)
      * [Example configuration](#example-configuration)
      * [Execute tests](#execute-tests)

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

git_toc-1.0.2.tar.gz (8.3 kB view details)

Uploaded Source

Built Distribution

git_toc-1.0.2-py3-none-any.whl (8.8 kB view details)

Uploaded Python 3

File details

Details for the file git_toc-1.0.2.tar.gz.

File metadata

  • Download URL: git_toc-1.0.2.tar.gz
  • Upload date:
  • Size: 8.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.5

File hashes

Hashes for git_toc-1.0.2.tar.gz
Algorithm Hash digest
SHA256 151b03264d97ee23d0121d60d5ac88886cce1974ad237539d0be024076be4676
MD5 bef072f1b4e81b6a62130021f22ab597
BLAKE2b-256 c3aa113030ab6ed296c6bee4ad3a5114c478b2001701851f4b5b12f8d11e206c

See more details on using hashes here.

File details

Details for the file git_toc-1.0.2-py3-none-any.whl.

File metadata

  • Download URL: git_toc-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 8.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.5

File hashes

Hashes for git_toc-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 2e8672429b361be4abe65d7e48276d612998d7c35cbe677119a9b8e962620b35
MD5 fb5158fe9267c2518c00f5eec8bfe67c
BLAKE2b-256 facc1056c8290ff5896317de3d88832c7255d071145239a1d81b011161fe007e

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