Skip to main content
Help us improve Python packaging – donate today!

Ultra-lightweight pure Python package to check if a file is binary or text.

Project Description

https://badge.fury.io/py/binaryornot.png https://travis-ci.org/audreyr/binaryornot.png?branch=master https://pypip.in/d/binaryornot/badge.png

Ultra-lightweight pure Python package to guess whether a file is binary or text, using a heuristic similar to Perl’s pp_fttext and its analysis by @eliben.

Status

It works, and I’m using this package in various places. But it doesn’t cover all edge cases yet.

The code could be improved. Pull requests welcome! As of now, it is based on these snippets, but that may change:

Features

Has tests for these file types:

  • Text: .css, .json, .txt, .svg
  • Binary: .eot, .otf, ttf, .woff, .png, .jpg, .tiff, .bmp

Why?

You may be thinking, “I can write this in 2 lines of code?!”

It’s actually not that easy. Here’s a great article about how perldoc’s heuristic to guess file types works: http://eli.thegreenplace.net/2011/10/19/perls-guess-if-file-is-text-or-binary-implemented-in-python/

Also, this package saves you from having to write and thoroughly test those 2 lines of code with all sorts of weird file types, cross-platform.

Credits

History

0.3.0 (2014-05-05)

  • Include tests, docs in source package. (#6) Thanks @vincentbernat.
  • Drop unnecessary shebangs and executable bits. (#8) Thanks @scop.
  • Generate string of printable extended ASCII bytes only once. (#7) Thanks @scop.
  • Make number of bytes to read parametrizable. (#7) Thanks @scop.

0.2.0 (2013-09-22)

  • Complete rewrite of everything. Thanks @ncoghlan.

0.1.1 (2013-08-17)

  • Tests pass under Python 2.6, 2.7, 3.3, PyPy.

0.1.0 (2013-08-17)

  • First release on PyPI.

Release history Release notifications

History Node

0.4.4

History Node

0.4.3

History Node

0.4.2

History Node

0.4.0

This version
History Node

0.3.0

History Node

0.2.0

History Node

0.1.1

History Node

0.1.0

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
binaryornot-0.3.0.tar.gz (217.6 kB) Copy SHA256 hash SHA256 Source None May 5, 2014

Supported by

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