Skip to main content

SSV stands for separator separated values.

Project description

Python Separator Separated Values Package

https://img.shields.io/pypi/v/ssv.svg https://img.shields.io/travis/sfischer13/python-ssv.svg

Summary

SSV stands for separator-separated values. It sounds like a joke, but it can actually be useful.

Description

SSV is a format for saving tabular data (flat-file databases) as delimiter-separated values in a plain text file. In contrast to other formats, e.g. CSV or TSV, delimiter collision is virtually impossible. Instead of using commas (CSV), tabs (TSV) and newlines, SSV relies on the record separator RS and the unit separator US for data structuring, which should not occur at all in textual data.

The format is an example of ASCII delimited text. As there is no official standard, SSV makes decisions that might be considered controversial. In general, simplicity and ease of implementation are preferred to other considerations. For example, SSV does not support escaping of RS and US.

Format

SSV files can be formally described by the following W3C EBNF:

SSV      ::= Record (RS Record)*
Record   ::= Unit (US Unit)*
Unit     ::= UnitChar*

UnitChar ::= Char - (RS | US)
Char     ::= /* see http://www.w3.org/TR/xml#NT-Char */
RS       ::= #x1E
US       ::= #x1F

Table records (rows) are separated by the record separator RS. Each record contains one or more units (fields), which are separated by the unit separator US. A unit may contain zero or more characters, excluding RS and US. As a consequence, an empty file is a valid SSV file and represents a 1-by-1 table containing a single empty field.

API Example

import ssv

# simple table
table = [['A1', 'B1', 'C1'],
         ['A2', 'B2', 'C2']]

# encode table as SSV string
ssv.dumps(table)  # 'A1\x1fB1\x1fC1\x1eA2\x1fB2\x1fC2'

# write table to SSV file
ssv.dumpf(table, 'data.ssv')
# load table from SSV file
new_table = ssv.loadf('data.ssv')
assert table == new_table

History

0.1.1 (2016-05-29)

  • Improve documentation.

0.1.0 (2016-05-29)

  • First release on PyPI.

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

ssv-0.1.1.tar.gz (5.2 kB view details)

Uploaded Source

Built Distribution

ssv-0.1.1-py3-none-any.whl (6.8 kB view details)

Uploaded Python 3

File details

Details for the file ssv-0.1.1.tar.gz.

File metadata

  • Download URL: ssv-0.1.1.tar.gz
  • Upload date:
  • Size: 5.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for ssv-0.1.1.tar.gz
Algorithm Hash digest
SHA256 8eed40bd37312516d619efd681603a1b29ee50d796c424ed7d6e64c1e8689454
MD5 2208baab8069a843bf65aa96a684659e
BLAKE2b-256 b58c0ff5ebc89e2d01c3fb0806e9aa27f18fd7ef71f36a7e5f8ab9dba3a40330

See more details on using hashes here.

File details

Details for the file ssv-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for ssv-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 66062f95f42bfcc3378580c5171b1497335dc4179e7255b4ff8fa85acce44871
MD5 90e689bc9228d3e718479ab6d86d53c2
BLAKE2b-256 3a3ba12b18448711355d6ef172d5c9cf28d19570d7fbf7272214b840f1bb36c9

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