Possible fix of the encoding and/or downlaod issue(s)

[funilrys]

Hello, to all member of this community!

After a long time of commenting, watching, reading and learning from issues posted here it's time for me to propose the following patches/commits.

It's been a long time since I wanted to search a possible solution to this recurrent issue and here's my proposition.

Basically, since I consider that many encoding issues are because upstream maintainer does not convert/encode the domains which rely on IDN homograph attack, I decided to read all line and convert/encode all domain using str.encode('IDNA') (I do not change original structure).

Because my main objective was to fix @notDavid's protocol which is the only one I was able to reproduce, I introduced BeautifulSoup() to do the decoding of the downloaded data before we read each line and encode/decode.

About the tests

Before anything, sorry for adding the fix tests issues commits but I wanted to fix those before submitting my PR. You can find the tests I used as the reference to committing those change at https://travis-ci.org/funilrys/hosts.

Please note that I have to submit an issue to upstream but if you see the following or related when runing the tests under Python >= 3 it's not a local issue.

/home/travis/miniconda3/envs/hosts/lib/python3.5/site-packages/bs4/builder/_lxml.py:250: DeprecationWarning: inspect.getargspec() is deprecated, use inspect.signature() instead

About requirements*.txt

This submission also introduces requirements.txt files which I generally use to install dependencies with pip install -r requirements.txt (I'm almost everytime under virtualenv).

As I did not get an answer (cf) I took the initiative to includes them anyway.

Please note that the requirements*.txt files were generated by pipreqs.

So to quote my commit message

Please note that this patch also introduces domain_to_idna()
which is in charge of converting a domain in a line into
IDNA and/or UTF-8 format.

Also, note the introduction of BeautifulSoup() which helps
us to decode data from the downloaded URL.

Fixes (issue(s)/protocol(s) I was able to reproduce):

• CANNOT using someonewhocares.org cause ENCODING or DOWNLOAD issue #514 (comment)

Possible fix of (issue(s)/protocol(s) I wasn't able to reproduce):

• CANNOT using someonewhocares.org cause ENCODING or DOWNLOAD issue #514 (comment)
• [Python3] UnicodeDecodeError: 'ascii' codec can't decode byte 0xe2 in position 27: ordinal not in range(128) #494 (comment)
• UnicodeDecodeError #420 (comment)
• updateHostsFile.py fails to download from KADhosts under Python 2.7 #372 (comment)
• Error Updating KADHosts (Windows 10 / Python 2.7) #382 (comment)

Footnote(s)

Sorry for the typo or bad English structure in my commits, code or this description but English is still a language I learn.

So I'm open to any pieces of advice and others around my English, coding style or other 😸

Cheers,
Nissar.

[welcome]

Thank you for submitting this pull request! We’ll get back to you as soon as we can!

[StevenBlack]

@funilrys what is the significance of # noqa: F401 here?

[funilrys]

@StevenBlack noqa is a tag to tell flake8 to ignore error in that line (more info here)

If you remove that comments, flake8 produce https://travis-ci.org/funilrys/hosts/jobs/347500695#L598

./updateHostsFile.py:27:1: F401 'lxml' imported but unused

Explanation from 079d5dd :

Please also note that I introduced that patch because
we do not directly use lxml but it is required by
BeautifulSup() to parse the HTML.

[StevenBlack]

@funilrys I'm getting crashes when I issue

pip install -r requirements.txt

and

pip install -r requirements_python2.txt

In the first case:

$ pip install -r requirements.txt
Collecting lxml==4.1.1 (from -r requirements.txt (line 1))
  Downloading lxml-4.1.1-cp27-cp27m-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.whl (8.7MB)
    100% |████████████████████████████████| 8.7MB 196kB/s
Collecting beautifulsoup4==4.6.0 (from -r requirements.txt (line 2))
  Downloading beautifulsoup4-4.6.0-py2-none-any.whl (86kB)
    100% |████████████████████████████████| 92kB 7.9MB/s
Collecting mock==2.0.0 (from -r requirements.txt (line 3))
  Downloading mock-2.0.0-py2.py3-none-any.whl (56kB)
    100% |████████████████████████████████| 61kB 6.8MB/s
Collecting pbr>=0.11 (from mock==2.0.0->-r requirements.txt (line 3))
  Downloading pbr-3.1.1-py2.py3-none-any.whl (99kB)
    100% |████████████████████████████████| 102kB 10.6MB/s
Collecting funcsigs>=1; python_version < "3.3" (from mock==2.0.0->-r requirements.txt (line 3))
  Downloading funcsigs-1.0.2-py2.py3-none-any.whl
Collecting six>=1.9 (from mock==2.0.0->-r requirements.txt (line 3))
  Downloading six-1.11.0-py2.py3-none-any.whl
Installing collected packages: lxml, beautifulsoup4, pbr, funcsigs, six, mock
Exception:
Traceback (most recent call last):
  File "/Library/Python/2.7/site-packages/pip/basecommand.py", line 215, in main
    status = self.run(options, args)
  File "/Library/Python/2.7/site-packages/pip/commands/install.py", line 342, in run
    prefix=options.prefix_path,
  File "/Library/Python/2.7/site-packages/pip/req/req_set.py", line 784, in install
    **kwargs
  File "/Library/Python/2.7/site-packages/pip/req/req_install.py", line 851, in install
    self.move_wheel_files(self.source_dir, root=root, prefix=prefix)
  File "/Library/Python/2.7/site-packages/pip/req/req_install.py", line 1064, in move_wheel_files
    isolated=self.isolated,
  File "/Library/Python/2.7/site-packages/pip/wheel.py", line 345, in move_wheel_files
    clobber(source, lib_dir, True)
  File "/Library/Python/2.7/site-packages/pip/wheel.py", line 316, in clobber
    ensure_dir(destdir)
  File "/Library/Python/2.7/site-packages/pip/utils/__init__.py", line 83, in ensure_dir
    os.makedirs(path)
  File "/System/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/os.py", line 157, in makedirs
    mkdir(name, mode)
OSError: [Errno 13] Permission denied: '/Library/Python/2.7/site-packages/lxml-4.1.1.dist-info'

In the second case:

$ pip install -r requirements_python2.txt
Collecting mock==2.0.0 (from -r requirements_python2.txt (line 1))
  Using cached mock-2.0.0-py2.py3-none-any.whl
Collecting lxml==4.1.1 (from -r requirements_python2.txt (line 2))
  Using cached lxml-4.1.1-cp27-cp27m-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.whl
Collecting beautifulsoup4==4.6.0 (from -r requirements_python2.txt (line 3))
  Using cached beautifulsoup4-4.6.0-py2-none-any.whl
Collecting pbr>=0.11 (from mock==2.0.0->-r requirements_python2.txt (line 1))
  Using cached pbr-3.1.1-py2.py3-none-any.whl
Collecting funcsigs>=1; python_version < "3.3" (from mock==2.0.0->-r requirements_python2.txt (line 1))
  Using cached funcsigs-1.0.2-py2.py3-none-any.whl
Collecting six>=1.9 (from mock==2.0.0->-r requirements_python2.txt (line 1))
  Using cached six-1.11.0-py2.py3-none-any.whl
Installing collected packages: pbr, funcsigs, six, mock, lxml, beautifulsoup4
Exception:
Traceback (most recent call last):
  File "/Library/Python/2.7/site-packages/pip/basecommand.py", line 215, in main
    status = self.run(options, args)
  File "/Library/Python/2.7/site-packages/pip/commands/install.py", line 342, in run
    prefix=options.prefix_path,
  File "/Library/Python/2.7/site-packages/pip/req/req_set.py", line 784, in install
    **kwargs
  File "/Library/Python/2.7/site-packages/pip/req/req_install.py", line 851, in install
    self.move_wheel_files(self.source_dir, root=root, prefix=prefix)
  File "/Library/Python/2.7/site-packages/pip/req/req_install.py", line 1064, in move_wheel_files
    isolated=self.isolated,
  File "/Library/Python/2.7/site-packages/pip/wheel.py", line 345, in move_wheel_files
    clobber(source, lib_dir, True)
  File "/Library/Python/2.7/site-packages/pip/wheel.py", line 316, in clobber
    ensure_dir(destdir)
  File "/Library/Python/2.7/site-packages/pip/utils/__init__.py", line 83, in ensure_dir
    os.makedirs(path)
  File "/System/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/os.py", line 157, in makedirs
    mkdir(name, mode)
OSError: [Errno 13] Permission denied: '/Library/Python/2.7/site-packages/pbr-3.1.1.dist-info'

Take note that sudo does not help in either case.

[StevenBlack]

@funilrys some more feedback: Since pip install -r requirements... is a prerequisite, that should be documented in the readme_template.md file in the Generate your own unified hosts file section.

[FadeMind]

Working like a charm. @funilrys Thanks!!

[funilrys]

Hello Steven @StevenBlack,

Before anything please avoid sudo pip as it may damage the python package(s) infrastructure of your system.

I thought that we all assume that virtualenv is always a good practice as you use a virtual environment (conda environment) to launch the tests.

So to fix such issue we have 3 possibilities:

Install dependencies from your package manager

For ubuntu

$ apt-get install python-lxml python3-lxml python-bs4 python3-bs4

For Arch Linux (the only one I use)

$ pacman -Syyu python-lxml python2-lxml python-beautifulsoup4 python2-beautifulsoup4

Then you simply run

$ python updateHostsFile.py -a

Install with pip along with --user (without virtualenv)

This method is always preferred over sudo pip for the reason I mentioned before.
To quote pip documentation :

--user:
Install to the Python user install directory for your platform. Typically ~/.local/, or %APPDATA%Python on Windows. (See the Python documentation for site.USER_BASE for full details.)

$ pip3 install -r requirements.txt --user
$ pip2 install -r requirements_python2.txt --user
$ python updateHostsFile.py -a

Use virtualenv

To quote Kenneth Reitz (Python Overlord at Heroku and Director at the PSF):

virtualenv is a tool to create isolated Python environments. virtualenv creates a folder which contains all the necessary executables to use the packages that a Python project would need.

Here's the procedure:

$ virtualenv venv
$ source venv/bin/activate
$ pip install -r requirements.txt
$ python updateHostsFile.py -a
$ deactivate # to exit virtualenv

Now before I or we edit the readme_template.md you have to make a choice ... which one do we recommend to users?

[rautamiekka]

Before anything please avoid sudo pip as it may damage the python package(s) infrastructure of your system.

Not much of a choice when you need newer packages.

[funilrys]

@rautamiekka sorry but no ... I proposed 3 alternatives to sudo pip ...

[funilrys]

Unless you are as root into a server or a container you should absolutely avoid such things.. Unless you like to break your system to learn like me sometimes...

A recent example of why you should not run sudo combined with command you think you can trust is this and its detail here.

[StevenBlack]

@funilrys we need a solution that works on MacOS and the recent versions of Windows too.

[funilrys]

We then have those two solutions:

• Install with pip along with --user (without virtualenv)
• Use virtualenv

[gfyoung]

@funilrys :

1. sudo pip is not that too scary IMO, so @StevenBlack , I think that's acceptable.

2. Add unittests for your added function.

[funilrys]

@gfyoung sudo npm was not too scary too ...

Will add unit tests once I'm back home.

[gfyoung]

sudo npm was not too scary too ...

It isn't when you can remove things from your package.json 😄

[notDavid]

Hi there, this works for me too on macOS 👍

One minor issue though, i was curious what hostnames were causing the problem, and i notice that with #520 line 147886 in https://hosts-file.net/psh.txt :

www.hualañe.cl
is being downloaded/converted to
www.xn--hualae-0wa.cl

so basically this host is not being blocked...
(don't shoot the messenger... 🤷🏼‍♂️ 😁)

Probably obvious, but you can reproduce this by doing this, + apply this pull request, and then in step 8 instead of mv psh.txt hosts do cp psh.txt hosts.
Then after running step9, compare file psh.txt with hosts.

[funilrys]

@notDavid www.xn--hualae-0wa.cl == www.hualañe.cl we are talking about the same domain...

Please read more about Punycode. You can also verify with Punycoder.

[notDavid]

@funilrys Ahhhhhh i see!

[StevenBlack]

Nissar @funilrys this is an excellent PR. Just those doc changes and we'll merge!

[funilrys]

Steven @StevenBlack What I see here is another problem! Some OS have python2 as python or python3 as python so as pip2 and pip3 exists I'll put them instead of pip as pip2 as you may have suggested :)

[funilrys]

@StevenBlack Can you confirm the existence of pip2 on macOS? Because I can't consider what I said previously (as an Arch Linux user) as granted for every OS...

[StevenBlack]

Nissar @funilrys yup, it looks native. In my case, on the office iMac:

$ which pip2
/usr/local/bin/pip2

$ which pip
/usr/local/homebrew/bin/pip

$ which pip3
/usr/local/homebrew/bin/pip3

[funilrys]

Okay Steven @StevenBlack then I'm going to edit readme_template.md as follow:

Note if you are using Python 3, please install the dependencies with:

  pip3 install --user -r requirements.txt

Note if you are using Python 2, please install the dependencies with:

  pip2 install --user -r requirements_python2.txt

I do prefer to recommend with --user and let the user know more about that --user with the following as note (please correct my grammar or complete sentence if needed):

As we prefer not to break your system, we recommend the usage of --user which install the required dependencies at the user level. More information about it can be found on pip documentation.

[FadeMind]

@StevenBlack Manjaro Linux:

[fademind@manjaro ~]$ which pip
/usr/bin/pip
[fademind@manjaro ~]$ which pip2
/usr/bin/pip2
[fademind@manjaro ~]$ which pip3
/usr/bin/pip3

[fademind@manjaro ~]$ export LANG=C;pacman -Qo /usr/bin/pip /usr/bin/pip2 /usr/bin/pip3
/usr/bin/pip is owned by python-pip 9.0.1-3
/usr/bin/pip2 is owned by python2-pip 9.0.1-3
/usr/bin/pip3 is owned by python-pip 9.0.1-3

Aaand packages:

[fademind@manjaro ~]$ pacman -Q|grep python
python 3.6.4-2
python-appdirs 1.4.3-1
python-beautifulsoup4 4.6.0-1
python-cairo 1.16.2-1
python-chardet 3.0.4-1
python-dbus 1.2.6-1
python-dbus-common 1.2.6-1
python-docopt 0.6.2-4
python-gobject 3.26.1-1
python-idna 2.6-1
python-jade-application-kit 0.a34-1
python-jinja 2.10-1
python-keyutils 0.5-1
python-lxml 4.1.1-1
python-lxml-docs 4.1.1-1
python-markupsafe 1.0-1
python-mock 2.0.0-2
python-npyscreen 4.10.5-1
python-olefile 0.45.1-1
python-packaging 16.8-2
python-pbr 3.1.1-1
python-pillow 5.0.0-1
python-pip 9.0.1-3
python-pycups 1.9.73-3
python-pycurl 7.43.0.1-1
python-pygments 2.2.0-1
python-pyparsing 2.2.0-1
python-pyqt5 5.10-3
python-pysmbc 1.0.15.8-1
python-reportlab 3.4.0-1
python-requests 2.18.4-1
python-setuptools 1:38.5.1-1
python-sip 4.19.7-1
python-six 1.11.0-1
python-urllib3 1.22-1
python-yaml 3.12-3
python2 2.7.14-2
python2-appdirs 1.4.3-1
python2-beautifulsoup4 4.6.0-1
python2-cairo 1.16.2-1
python2-funcsigs 1.0.2-1
python2-gobject2 2.28.7-1
python2-lxml 4.1.1-1
python2-mock 2.0.0-2
python2-packaging 16.8-2
python2-pbr 3.1.1-1
python2-pip 9.0.1-3
python2-pyparsing 2.2.0-1
python2-setuptools 1:38.5.1-1
python2-six 1.11.0-1

[StevenBlack]

Nissar @funilrys perfect!

[StevenBlack]

@funilrys a small suggestion.

We recommend the --user flag which installs the required dependencies at the user level. More information about it can be found on pip documentation.

[StevenBlack]

Nissar @funilrys still missing one thing: To run unit tests, in the top level directory, just run:... should come after installing the requirements since latest tests will fail without the requirements.

[funilrys]

That's logical sorry ...

[StevenBlack]

Merging. Thanks so much Nissar @funilrys and everyone who provided input on this!

[welcome]

Congratulations on merging your first pull request! 🎉🎉🎉

[ScriptTiger]

Perhaps a note of some kind should also be added in a different PR for those installing the dependencies manually for whatever reason. Beautiful Soup (which goes to version 3 and only supports Python 2) is actually a different package from Beautiful Soup 4 (the bs4 packages for Python 2 and 3). It might be different depending on how the repositories manage them, but that at least seems to be the author's intent and what I have seen in the repos I use. So if they install the latest Beautiful Soup package and don't know why it's throwing an error when it can't find the bs4 module, that's why.