Contributing

Contributing to Oreilly downloader is simple with little dependencies.

Workflow/Tools

GitHub Action for CD
pre-commit hooks for linting and formatting
Nix and Docker for environment management

Requirements

Docker Daemon running on machine
Nix >= 2.3.12
direnv >= 2.28.0

Getting Started

Clone this repository
Allow direnv to install necessary binaries using Nix

dirnev allow

Use pls tool to see what commands you can run (build tool)

pls --list

Edit Dockerfile

Building images

You can build an image simply by running pls build

Testing download

You can test download using the method similar to users

Username/Password Logins

Obtain Book ID, eg 9780321635754
Run pls command:

(pls run -- login <book id> <email:password>) > "<name of your file>.epub"

SSO

Obtain Book ID, eg 9780321635754
Obtain SSH credentials (as described in README.MD )
Run pls command:

(cat <cookie json file> | pls run -- sso <book id>) > "<name of your file>.epub"