Skip to main content

Read it without Internet

Project description

Save the category of site offline

Books library restyle


Maintainability Build Status Coverage Status Platform Python_versions GitHub wemake-python-styleguide

The program downloads from books in text format and their covers. The following information is also downloaded to the json file:

  • title;
  • author;
  • image path;
  • book path;
  • comments;
  • genres.

After downloading the necessary data, the offline version of the site will be generated (you can see an example here).

Table of content


Install using pip:

pip install tululu-offline

How to use

tululu-offline [OPTIONS]


  • category_url - the category url;
  • --start_page - which page to start downloading;
  • --end_page - on which page to finish downloading;
  • --dest_folder - path to the directory with parsing results: pictures, books, JSON;
  • --skip_txt - do not download books;
  • --skip_imgs - do not download images;
  • --json_path - specify your path to *.json file with results;
  • --number_of_books_per_page - number of books per page.

Example run

Run the script with the necessary parameters. For example:

tululu-offline --start_page 1 --end_page 3 --skip_txt true --skip_imgs true --number_of_books_per_page 15

The first page of the library will be available at pages/index1.html.

For developers

How to install with dev dependencies

Install using poetry:

git clone
cd tululu-offline
make install_dev

How to run:

poetry run python3 tululu_offline/ [OPTIONS]

Example of running a script

poetry run python3 tululu_offline/ --start_page 1 --end_page 5 --skip_txt true --skip_imgs true --number_of_books_per_page 10

Start render website

Run the file with the following options:

  • category_url - the category url;
  • --dest_folder - path to the directory with parsing results: pictures, books, JSON;
  • --json_path - specify your path to *.json file with results;
  • --number_of_books_per_page - number of books per page.


poetry run python3 tululu_offline/ --number_of_books_per_page 10 --json_path result/books.json --dest_folder result

How to run lint files

make lint

How to run tests

make test


Tululu-offline is licensed under the MIT License. See LICENSE for more information.

Project goal

The code is written for educational purposes in an online course for web developers

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for tululu-offline, version 1.0.6
Filename, size File type Python version Upload date Hashes
Filename, size tululu_offline-1.0.6-py3-none-any.whl (414.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size tululu-offline-1.0.6.tar.gz (413.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page