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)
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 151b03264d97ee23d0121d60d5ac88886cce1974ad237539d0be024076be4676 |
|
MD5 | bef072f1b4e81b6a62130021f22ab597 |
|
BLAKE2b-256 | c3aa113030ab6ed296c6bee4ad3a5114c478b2001701851f4b5b12f8d11e206c |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2e8672429b361be4abe65d7e48276d612998d7c35cbe677119a9b8e962620b35 |
|
MD5 | fb5158fe9267c2518c00f5eec8bfe67c |
|
BLAKE2b-256 | facc1056c8290ff5896317de3d88832c7255d071145239a1d81b011161fe007e |