Metadata-Version: 2.1
Name: pylibgen
Version: 2.0.2
Summary: Python interface to Library Genesis.
Home-page: https://github.com/JoshuaRLi/pylibgen
Author: Joshua Li
Author-email: josh@jrl.ninja
Maintainer: Joshua Li
Maintainer-email: josh@jrl.ninja
License: MIT
Download-URL: https://github.com/JoshuaRLi/pylibgen/archive/v2.0.2.tar.gz
Description: # pylibgen
        
        [![PyPI](https://img.shields.io/pypi/v/pylibgen.svg)](https://pypi.org/project/pylibgen/)
        [![Travis CI](https://travis-ci.org/JoshuaRLi/pylibgen.svg?branch=master)](https://travis-ci.org/JoshuaRLi/pylibgen)
        [![License MIT](https://img.shields.io/github/license/mashape/apistatus.svg)](https://github.com/JoshuaRLi/pylibgen/blob/master/LICENSE)
        
        Python interface to Library Genesis. Only the LibGen/Sci-Tech database is supported.
        
        **This project is largely unmaintained as of the 2.0.2 release.** I am willing to make or accept pull requests for small maintenance releases if they are trivial, but any changes required due to major/breaking changes with libgen's internals will not be implemented.
        
        
        ## Installation
        
        pylibgen is well-tested on Python 3.6 - 3.7, and can be installed via `pip install pylibgen`.
        
        
        ## Usage
        
        ```python
        >>> 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`](https://github.com/pyenv/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\!
        
Keywords: libgen,library,genesis,search,download,books,ebooks,textbooks
Platform: UNKNOWN
Classifier: Development Status :: 7 - Inactive
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: dev
