Ensure that command line tools use LF line endings to work on Linux/OS X

[orangain]

Problem

Command line tools, pdf2txt.py and dumppdf.py, does not work when installed via pip on Linux/OS X.

$ pip install pdfminer.six
Downloading/unpacking pdfminer.six
...
Successfully installed pdfminer.six six chardet
Cleaning up...
$ pdf2txt.py
env: python\r: No such file or directory
$ dumppdf.py
env: python\r: No such file or directory

This is because tools/pdf2txt.py and tools/dumppdf.py uploaded on the PyPI contain CRLF line endings. The line endings should be LF to work on Linux/OS X.

Note that installing by python setup.py install does not cause this issue because setuptools generates a wrapper script for pdf2txt.py and dumppdf.py which have LF line endings. However I believe PDFMiner.six should be installable via pip because pip is a de facto standard package manager in Python community today.

Changes

This PR add .gitattributes to ensure that *.py files are always checked out with LF line endings regardless of individual's git settings even on Windows. I believe the PR will fix the problem and prevent future regression. After adding .gitattributes, you may need to reset all files to get LF line endings by:

$ git rm --cached -r .
$ git reset --hard

See also:

Dealing with line endings - User Documentation
https://help.github.com/articles/dealing-with-line-endings/

[goulu]

Thanks a lot !

[orangain]

@goulu Thank you for merging. I tried to install the new version 20160202 on the PyPI and run pdf2txt.py, but I found that there still remains the same problem.

(venv) $ pip install pdfminer.six
Downloading/unpacking pdfminer.six
  Downloading pdfminer.six-20160202.zip (9.7MB): 9.7MB downloaded
  ...
Successfully installed pdfminer.six six chardet
Cleaning up...
(venv) $ pip freeze
chardet==2.3.0
pdfminer.six==20160202
six==1.10.0
(venv) $ pdf2txt.py
env: python\r: No such file or directory

Could you please make sure that *.py files have the LF line endings on your machine where you create the zip archive to be uploaded to the PyPI?

[jt-wang]

This problem still happens with the latest version of pdfminer.six on pip today.