Skip to content

Latest commit

 

History

History
65 lines (48 loc) · 2.61 KB

README.md

File metadata and controls

65 lines (48 loc) · 2.61 KB

PriceList fetcher (PLF)

This project is WIP: code is in alpha quality

A Python script that fetches information (name, brand, price...) about a product, and informs if a lower price was recorded in its price history.

Docker Build (Linux) Docker Tests (Linux)

This program's output is intended to be used by PriceList, which does not exist yet, but will in the future. It can also be used as a CLI tool.

Prerequisites

To run the Python script directly, the following packages are also required:

Many can be autoinstalled by executing pip install -r requirements.txt in the project directory.

Usage

This tool uses a command-line interface that receives the desired URL as argument and other flags. It can be executed by typing:

Linux

$ ./plf [OPTIONS] URL
or
$ python plf.py [OPTIONS] URL

in the shell of your liking.

Windows

> .\plf.exe [OPTIONS] URL
or
> python plf.py [OPTIONS] URL

in CMD or Powershell.

PLF will check the URL and return all possible attributes in the page. If binary/release version is used, the lowest price recorded in a PostgreSQL database will also be returned.

This database can be user defined in database/dbsecrets.py, but must contain the same tables.

Domains currently supported

See DOMAINS.

Contributing

See CONTRIBUTING for instructions on how to contribute to the project.

License

Licensed under GPLv3. This should be in any fork or redistribution, and should credit contributors as well. See LICENSE.