Skip to main content

Transactions on existing SVG documents: inject/extract/modify

Project description

svg|pipe Transactions for existing SVG documents

Note: The project is in an early stage of development. 0.x.x versions do not garantee a stable API.

inject data and SVG content into an existing document, keeping its structure intact.

extract data and SVG content from an existing document (planned).

transfer data, attributes, etc. between existing SVG elements (planned).

Motivation

Graphics applications are often picky (extremely picky) about the formatting of graphics documents. In order to have SVG files interpreted by your/everybodies favourite vector graphics application, the file structure not only needs to follow the SVG specs, but should follow a precise structure of layers, ids, and other unwritten conventions.

The project wants to facilitate transactions on existing documents for graphics-based workflows:

  • automated SVG generation (e.g. for data visualisation)
  • smooth integration with interactive vector graphics/CAD applications
  • automated data-import into complex pre-formatted graphics documents for visualisation

Philosophy

svg|pipe not only uses SVG documents for import/export of graphical content into/from some existing stock of data. SVG documents are XML documents and can serve as data structures themselves.

Requirements and Installation

Currently under development using:

  • Python 3.7
  • Pytest 5.2.2.

Install and test

pip install svgpipe

(on Windows with older pythons you may need python -m pip install svgpipe)

run tests

When in the package directory, just type:

pytest

When the package was installed via pip:

pytest --pyargs svgpipe

visual inspection of test results

To get a file output of the SVG content involved in the testing:

  • Set environment variable SVGPIPE_TEST_SVG_OUT to point to the desired output directory.
  • Make sure the directory/folder exists.

After the test run, for each svg injection test there will be three SVG files:

  • XXXX_test.svg (before the injection)
  • XXXX_result.svg (what was actually the case after the injection)
  • XXXX_expect.svg (what should be the case after the injection)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for svgpipe, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size svgpipe-0.2.0-py3-none-any.whl (12.0 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size svgpipe-0.2.0.tar.gz (11.5 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page