infi.clickhouse_orm/scripts
2017-05-05 15:31:08 +03:00
..
docs2html.sh rename README 2017-04-28 19:45:54 +03:00
generate_all.sh Generate a class reference document 2017-05-05 15:31:08 +03:00
generate_ref.py Generate a class reference document 2017-05-05 15:31:08 +03:00
generate_toc.sh Generate a class reference document 2017-05-05 15:31:08 +03:00
html_to_markdown_toc.py Generate a class reference document 2017-05-03 08:36:47 +03:00
README.md Generate a class reference document 2017-05-05 15:31:08 +03:00
test_python3.sh need to run script under bash, otherwise virtualenv doesn't get activated 2017-04-28 18:18:04 +03:00

This directory contains various scripts for use while developing.

generate_toc

Generates the table of contents (toc.md). Requires Pandoc. Usage:

cd docs
../scripts/generate_toc.sh

html_to_markdown_toc.py

Used by generate_toc.

docs2html

Converts markdown docs to html for preview. Requires Pandoc. Usage:

cd docs
../scripts/docs2html.sh

generate_ref

Generates a class reference. Usage:

cd docs
../bin/python ../scripts/generate_ref.py > class_reference.md

generate_all

Does everything:

- Generates the class reference using generate_ref
- Generates the table of contents using generate_toc
- Converts to HTML for visual inspection using docs2html

Usage:

cd docs
../scripts/generate_all.sh

test_python3

Creates a Python 3 virtualenv, clones the project into it, and runs the tests. Usage:

./test_python3.sh