Skip to content
This repository has been archived by the owner on Dec 30, 2019. It is now read-only.
/ pylibgen Public archive

Python interface to Library Genesis. DEAD/UNMAINTAINED.

License

Notifications You must be signed in to change notification settings

joshuarli/pylibgen

Repository files navigation

pylibgen

PyPI Travis CI License MIT

Python interface to Library Genesis. Only the LibGen/Sci-Tech database is supported.

This project is unmaintained as of the 2.0.2 release. Feel free to maintain a public fork, or just patch my existing code in any way you see fit, privately.

Installation

pylibgen is well-tested on Python 3.6 - 3.7, and can be installed via pip install pylibgen.

Usage

>>> from pylibgen import Library
>>> l = Library()
>>> ids = l.search('stallman essays')
>>> ids
['112887', '310297', '688326', '1594161', '1610379']
>>> book1, book2, *_ = l.lookup(ids)
>>> book1.__dict__
{'id': '112887', 'title': 'Free software, free society: selected essays of Richard M. Stallman', 'author': 'Richard M. Stallman, Lawrence Lessig, Joshua Gay, Laurence Lessig', 'year': '2002', 'edition': 'First Printing, First Edition', 'pages': '230', 'identifier': '9781882114986,1882114981', 'extension': 'pdf', 'filesize': '2210323', 'md5': '861C055B960E7F36D95164CAB34E0E97'}
>>> book2.__dict__
{'id': '310297', 'title': 'Free Software Free Society: Selected Essays of Richard Stallman', 'author': 'Richard Stallman', 'year': '2010', 'edition': '2nd Edition', 'pages': '278', 'identifier': '0983159203,9780983159209', 'extension': 'pdf', 'filesize': '1597349', 'md5': '6C3C2593BBB5D77154D50DFDDC0EA669'}
>>> book1.get_url(filehost='b-ok.org')
'http://b-ok.org/md5/861C055B960E7F36D95164CAB34E0E97'

Support Library Genesis!

Book.get_url(filehost='...') will return the standard filehost gateway url.

There is no functionality to bypass any intermediate advertisement pages, and this behavior is intended because Library Genesis is a service worth supporting.

Development Setup

You'll need python 3.6, python 3.7, and tox. It's recommended to use pyenv to install + manage python versions and executable modules. An example:

$ pyenv install 3.6.8
$ pyenv install 3.7.3
$ pyenv global 3.7.3 3.6.8  # puts both pyenv-managed python3.6 and python3.7 on the PATH for tox
$ python3.7 -m pip install tox  # python will be resolved to 3.7.3 by pyenv's shim, this is just being explicit

To run pre-commit hooks and tests for all supported python versions (make sure you're not in a virtualenv before running this):

$ tox

To enter the version-specific virtualenv created above (you'll need this to commit with pre-commit hooks):

$ source .tox/py37/bin/activate

To only create the tox virtualenvs without running any (test) commands:

$ tox --notest

Disclaimer

Use pylibgen responsibly and at your own risk. The author(s) are not responsible or liable for any piracy, copyright infringement, or other offences committed by anyone using this software. Please consider supporting your favorite authors by purchasing their works!