/compr

A text compression tool & library

Primary LanguagePythonMIT LicenseMIT

CI Status Documentation Status coverage https://img.shields.io/pypi/pyversions/trenzalore.svg?style=flat-square

Pycompressor is a tool for compressing text files into smaller ones, as well as extracting compressed files back into the original content.

It can be used as a program or imported as a package module, and use the functions defined on it.

For example, in order to compress one file:

$ pycompress -c /usr/share/dict/words -d /tmp/compressed.zf

The original file, in this example has a size of ~4.8M, and the tool left the resulting file at /tmp/compressed.zf, with a size of ~2.7M.

In order to extract it:

$ pycompress -x /tmp/compressed.zf -d /tmp/original

You can specify the name of the resulting file with the -d flag. If you don't indicate a name for the resulting file, the default will be <original-file>.comp.

For the full options, run:

$ pycompress -h
pip install trenzalore

Will install the package and leave an application named pycompress for using the command line utility.

To install the package in development mode, run:

make testdeps

And run the tests with:

make test

Before submitting a pull request, run the checklist to make sure all dependencies are met (code style/linting, tests, pass, etc.). This is automated with:

make checklist

This will run the checks for the code style (make lint), as well as the tests (make test).