Skip to main content

Converter for interactive educational content.

Project description

build status coverage report Documentation Status

innoConv

Converter for interactive educational content.

Please refer to the documentation for installation and usage.

Requirements

For Tikz support:

Quickstart

# Install innoconv locally using pip
$ pip install --user innoconv
# Convert some content
$ innoconv /path/to/content

Docker

The Docker image has all dependencies bundled and works out-of-the-box. It allows you to call the innoconv command inside a container.

$ docker run innodoc/innoconv --help

For passing content into and receiving the result from the container, you can use a volume.

$ cd /path/to/content
$ docker run \
  -v $(pwd):/content \
  -u $(id -u $USER) \
  innodoc/innoconv .

Development

tox

Development for innoConv relies on tox. It handles virtualenv creation, running linters and test suites across different Python versions and is also used in the CI pipeline.

Make sure to have it installed.

Commands

For an exhaustive list of commands please have a look at tox.ini.

Using the innoconv command (dev version)

Spawn a shell in a development environment.

$ tox -e shell

Or directly start your current development version.

$ tox -e shell -- innoconv /path/to/content

Linting

Adhere to code style black and PEP8.

$ tox -e linters

Tests

Run unit and integration tests.

$ tox -e py38-unit,py38-integration

HTML coverage report

A coverage report will be created in ./htmlcov and served via HTTP.

$ tox -e py38-unit,cov-html,serve-cov

Documentation

After building you can find the documentation in docs/build/html and look at it using a browser.

$ tox -e docs,serve-docs

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

innoconv-0.1.3.tar.gz (25.6 kB view hashes)

Uploaded Source

Built Distribution

innoconv-0.1.3-py3-none-any.whl (37.5 kB view hashes)

Uploaded Python 3

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