feat: add files and initial implementation

Author: h2non

.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*.{py,rst,txt}]
+indent_style = space
+trim_trailing_whitespace = true
+indent_size = 4
+end_of_line = LF
+
+[*.yml]
+indent_style = space
+indent_size = 2
+end_of_line = LF

.travis.yml

@@ -0,0 +1,21 @@
+language: python
+
+python:
+  - "2.7"
+  - "3.3"
+  - "3.4"
+  - "3.5"
+
+# command to install dependencies
+install:
+  - pip install -r requirements.txt
+  - pip install coveralls
+  # Deal with issue on Travis builders re: multiprocessing.Queue :(
+  - "sudo rm -rf /dev/shm && sudo ln -s /run/shm /dev/shm"
+  # coverage run --source=moscowdjango,meetup manage.py test
+
+script: 
+  make test
+
+after_success:
+  coveralls

Makefile

@@ -0,0 +1,41 @@
+all: check_dependencies unit functional doctest
+
+filename=filetype-`python -c 'import filetype;print filetype.version'`.tar.gz
+
+check_dependencies:
+	@echo "Checking for dependencies to run tests ..."
+	@for dependency in `echo $$LETTUCE_DEPENDENCIES`; do \
+		python -c "import $$dependency" 2>/dev/null || (echo "You must install $$dependency in order to run filetype's tests" && exit 3) ; \
+		done
+
+unit: clean lint
+	@echo "Running unit tests ..."
+	@nosetests -s --verbosity=2 --with-coverage --cover-erase --cover-inclusive tests/unit --cover-package=filetype
+
+doctest: clean
+	@cd docs && make doctest
+
+documentation:
+	@cd docs && make html
+
+clean:
+	@printf "Cleaning up files that are already in .gitignore... "
+	@for pattern in `cat .gitignore`; do find . -name "$$pattern" -delete; done
+	@echo "OK!"
+
+deploy-documentation: documentation
+	@printf 'Deploying documentation ...'
+	@echo "DONE!"
+
+deploy: deploy-documentation
+
+release: clean doctest deploy-documentation publish
+	@printf "Exporting to $(filename)... "
+	@tar czf $(filename) filetype setup.py README.md LICENSE
+	@echo "DONE!"
+
+lint:
+	@flake8 .
+
+publish:
+	@python setup.py sdist register upload

examples/image.py

@@ -0,0 +1,15 @@
+import filetype
+
+
+def main():
+    kind = filetype.guess_type('tests/fixtures/sample.jpg')
+    if kind is None:
+        print('Cannot guess file type!')
+        return
+
+    print('File extension: %s' % kind.extension)
+    print('File MIME type: %s' % kind.mime)
+
+
+if __name__ == '__main__':
+    main()

filetype/__init__.py

@@ -0,0 +1 @@
+from .filetype import *  # noqa

filetype/cmd.py

@@ -0,0 +1 @@
+# -*- coding: utf-8 -*-

filetype/filetype.py

@@ -0,0 +1,67 @@
+# -*- coding: utf-8 -*-
+
+from filetype.match import match
+from filetype.utils import get_signature_bytes
+
+
+def guess_type(obj):
+    """
+    Infers the type of the given input.
+
+    Function is overloaded to accept multiple types in input
+    and peform the needed type inference based on it.
+
+    :param obj str/list/bytes
+    :rtype Type
+    """
+    if not obj:
+        return None
+
+    buf = None
+    if type(obj) is bytes:
+        buf = obj
+
+    if type(obj) == str:
+        buf = get_signature_bytes(obj)
+
+    return match(buf)
+
+
+def guess_mime(obj):
+    """
+    Infers the file type of the given input
+    and returns its MIME type.
+
+    :param obj str/list/bytes
+    :rtype str
+    """
+    kind = guess_type(obj)
+    return kind.mime if kind else kind
+
+
+def guess_extension(obj):
+    """
+    Infers the file type of the given input
+    and returns its RFC file extension.
+
+    :param obj str/list/bytes
+    :rtype str
+    """
+    kind = guess_type(obj)
+    return kind.extension if kind else kind
+
+
+def is_extension_supported(ext):
+    return None
+
+
+def is_extension_equals(ext):
+    return None
+
+
+def is_mime_supported(mime):
+    return None
+
+
+def is_mime_equals(mime):
+    return None

filetype/match.py

@@ -0,0 +1,18 @@
+# -*- coding: utf-8 -*-
+
+from filetype.types import types
+
+
+def match(buf):
+    """
+    Performs bytes matching comparison agains the
+    available type matchers.
+
+    :param buf list
+    :rtype bool
+    """
+    for matcher in types:
+        if matcher.match(buf):
+            return matcher
+
+    return None

filetype/types/__init__.py

@@ -0,0 +1,82 @@
+# -*- coding: utf-8 -*-
+
+from filetype.types import image
+from filetype.types import video
+from filetype.types import audio
+from filetype.types import font
+from filetype.types import archive
+
+# Supported image types
+image_types = (
+    image.Jpeg(),
+    image.Png(),
+    image.Gif(),
+    image.Webp(),
+    image.Cr2(),
+    image.Tiff(),
+    image.Bmp(),
+    image.Jxr(),
+    image.Psd(),
+    image.Ico(),
+)
+
+# Supported video types
+video_types = (
+    video.Mp4(),
+    video.M4v(),
+    video.Mkv(),
+    video.Mov(),
+    video.Avi(),
+    video.Wmv(),
+    video.Mpeg(),
+)
+
+# Supported audio types
+audio_types = (
+    audio.Midi(),
+    audio.Mp3(),
+    audio.M4a(),
+    audio.Ogg(),
+    audio.Flac(),
+    audio.Wav(),
+    audio.Amr(),
+)
+
+# Supported archive container types
+archive_types = (
+    archive.Epub(),
+    archive.Zip(),
+    archive.Tar(),
+    archive.Rar(),
+    archive.Gz(),
+    archive.Bz2(),
+    archive.SevenZ(),
+    archive.Pdf(),
+    archive.Exe(),
+    archive.Swf(),
+    archive.Rtf(),
+    archive.Nes(),
+    archive.Crx(),
+    archive.Cab(),
+    archive.Eot(),
+    archive.Ps(),
+    archive.Xz(),
+    archive.Sqlite(),
+    archive.Deb(),
+    archive.Ar(),
+    archive.Z(),
+    archive.Lz(),
+)
+
+# Supported archive container types
+font_types = (
+    font.Woff(),
+    font.Woff2(),
+    font.Ttf(),
+    font.Otf(),
+)
+
+# Expose supported type matchers
+types = list(image_types + audio_types +
+        font_types + video_types +
+        archive_types)