https://github.com/krasoffski/lsgbc
Command line interface for couponsfromchina.com.
https://github.com/krasoffski/lsgbc
cli couponsfromchina gearbest golang
Last synced: 6 months ago
JSON representation
Command line interface for couponsfromchina.com.
- Host: GitHub
- URL: https://github.com/krasoffski/lsgbc
- Owner: krasoffski
- License: mit
- Created: 2017-11-18T17:05:30.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2021-06-17T14:21:56.000Z (about 5 years ago)
- Last Synced: 2024-06-20T14:28:05.871Z (about 2 years ago)
- Topics: cli, couponsfromchina, gearbest, golang
- Language: Go
- Homepage: https://couponsfromchina.com/
- Size: 3.73 MB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
> # Source site `https://couponsfromchina.com` might be down. That is why parser is not able to fetch required information.
# lsgbc - List GearBest Coupons
[](https://travis-ci.org/krasoffski/lsgbc)
[](https://codeclimate.com/github/krasoffski/lsgbc)
[](https://saythanks.io/to/krasoffski)
## Objectivity
In short words, `lsgbs` is a command line interface for
https://couponsfromchina.com/ which allows you to sort, include or exclude
different types of items for the best deal look up.
## Installation
There are compiled binaries for `amd64` architecture for linux, windows and
darwin platforms with name like `lsgbc-linux-amd64`. Please, find these files in
the release menu of the project.
### Manual installation
For creating binaries you need `Git` and `Golang` compiler with version equal
or bigger than `1.8` installed. Please, make sure you have properly configured
`GOPATH` and system path variables:
- Add `$GOROOT/bin` to system path.
- Add `$GOPATH/bin` to system path.
#### Using `go get`
```bash
$ go get github.com/krasoffski/lsgbc
```
#### From sources
Before all, please clone this repository with command:
```bash
$ git clone https://github.com/krasoffski/lsgbc
```
Or download archive with source code.
```bash
$ wget https://github.com/krasoffski/lsgbc/archive/master.zip
$ unzip master.zip
```
And change working directory to cloned repository: `cd lsgbc`
#### Using `make all` target
Installation with `make all` target performs following steps (requires `make`):
- Removes `bin` directory in the root of repository if any.
- Creates binary with name `lsgbc` by default for host platform with in `bin`
directory.
#### Using `make release` target
Installation with `make release` target performs following steps (requires
`make`, `zip`, `md5sum`):
- Removes `bin` directory in the root of repository if any.
- Creates binaries with names like `lsgbc-windows-amd64` for each platform
(windows, linux, darwin).
- Pack each binary to zip archive with names like
`lsgbc-v0.0.6-windows-amd64.zip`
- Create file `md5sum.txt` for archived zip files.
```bash
$ ls -S -1 ./bin/
lsgbc-darwin-amd64
lsgbc-linux-amd64
lsgbc-windows-amd64.exe
lsgbc-v0.0.6-darwin-amd64.zip
lsgbc-v0.0.6-linux-amd64.zip
lsgbc-v0.0.6-windows-amd64.zip
md5sum.txt
```
#### Without `make` utility
If you get stuck with `make` command, e.g. on `windows` platform, you can
perform all steps manually:
- Build executable file for your platform from root directory of repository.
```
$ go build
```
- Check created binary.
```
$ ./lsgbc -h
Usage of ./lsgbc:
-B, --best=false: show only best deals
-C, --compact=false: use compact table representation
-F, --flash-sale=false: show only flash sale deals
-l, --list="flashlight": used coupons list, one from: 3d,...,xiaomi
-M, --max-price=1000: maximum discount price
-m, --min-price=0: minimal discount price
-n, --names="*": comma separated list of names (case insensitive), e.g. 'xx,y*,zz'
-S, --sort-by="price": sort table by column, 'price' or 'discount'
-V, --version=false: show version and exit
```
## Usage
For example, you would like to know current price with coupon for `Jetbeam` and
`Eagle Eye` flashlights with price less than `20 ye`. To sort out names you can
specify beginning of name like `-n jet`, this is equivalent of `-n "Jet*"`.
> __Note:__ by default rows are sorted by ascending the `PRICE`.
This can be achieved with following command:
```
$ ./lsgbc -M 20 -n jet,eagle
NU | NAME | PRICE, $ | DISCOUNT, % | LOWEST, $
+-----+----------------------------------------+----------+-------------+-----------+
155 | Jetbeam JET-u Flashlight | 10.9 | - | 7.0
108 | Eagle Eye X6 HOST Flashlight | 14.1 | 10.0 | 11.0
156 | JETBeam JET-UV Flashlight | 14.9 | - | 11.6
152 | Jetbeam JET-I MK Flashlight | 15.0 | - | 10.0
150 | JETBeam i4 PRO Battery Charger EU Plug | 15.9 | 10.0 | 11.7
102 | Eagle Eye X2R 6000-6500K Flashlight | 16.5 | 10.0 | 14.0
103 | Eagle Eye X2R NW Flashlight | 16.9 | 10.0 | 12.5
+-----+----------------------------------------+----------+-------------+-----------+
ITEMS | 7
+-------------+-----------+
```
There are following fields:
- `NO`: number of product in the corresponding table.
- `NAME`: product name from table.
- `PRICE`: product price with applied coupon.
- `DISCOUNT`: discount in percents comparing with regular price without coupon.
- `LOWEST`: lowest price for this product during monitoring.
### Compact representation
When you get familiar with column names, you might want to use compact mode
`-C/--compact` on small terminals.
```
$ ./lsgbc -M 20 -n Jet,Eagle --compact
# | N | P, $ | D, % | L, $
+-----+----------------------------------------+------+------+------+
155 | Jetbeam JET-u Flashlight | 10.9 | - | 7.0
108 | Eagle Eye X6 HOST Flashlight | 14.1 | 10.0 | 11.0
156 | JETBeam JET-UV Flashlight | 14.9 | - | 11.6
152 | Jetbeam JET-I MK Flashlight | 15.0 | - | 10.0
150 | JETBeam i4 PRO Battery Charger EU Plug | 15.9 | 10.0 | 11.7
102 | Eagle Eye X2R 6000-6500K Flashlight | 16.5 | 10.0 | 14.0
103 | Eagle Eye X2R NW Flashlight | 16.9 | 10.0 | 12.5
+-----+----------------------------------------+------+------+------+
7
+------+
```
### Flash sale and history
Attentive users might have noticed that some items do not have corresponding
`DISCOUNT` percent or `LOWEST` price values. Instead, this value might be
replaced with `-` char.
Dash `-` character as value has following meanings:
- `DISCOUNT`: you can buy this item without using of coupon (flash sale).
- `LOWEST`: there is no information about the lowest price for this item.
### The best deal
`lsgbc` allows to distinguish "best" deals with option `-B/--best`. This filter
shows only items with current `PRICE` equal or less than `LOWEST*1.1`.
For example:
```
$ ./lsgbc --max-price=15 --names=convoy --best
NU | NAME | PRICE, $ | DISCOUNT, % | LOWEST, $
+----+---------------------------------+----------+-------------+-----------+
70 | Convoy S2+ CW Flashlight [GW4] | 12.0 | 11.8 | 11.0
62 | Convoy S2 V2-1A Flashlight | 12.3 | - | 12.3
60 | Convoy S2 U6-3A Grey Flashlight | 12.7 | - | 12.0
61 | Convoy S2 U6-4B Flashlight | 12.8 | - | 12.6
+----+---------------------------------+----------+-------------+-----------+
ITEMS | 4
+-------------+-----------+
```
This table contains only deals for:
- Maximum `PRICE` is `$15`.
- `CATEGORY` equals to `led-flashlights`.
- `PRICE` is around of `LOWEST`.
- Items sorted by ascending the `PRICE`.
E.g. the `PRICE` of `Lumintop Tool Nichia 219BT Flashlight` is `$10` and this
less than `LOWEST` price multiply by `1.1` (10.0 < 10.01=9.1*1.1).
### Sorting items
You can sort items by `PRICE` or by `DISCOUNT`. This can be done using option
`-S/--sort-by` with value `discount` or `d` for shortness to sort by decreasing
of `DISCOUNT` percents.
```
$ ./lsgbc -C -M 30 -c led -n Lumintop -S d
# | N | P, $ | D, % | L, $
+-----+------------------------------------------------+------+------+------+
184 | Lumintop Copper Tool AAA XP-G2 R5 Flashlight | 21.0 | 30.0 | 20.0
188 | Lumintop IYP365 CW Flashlight | 10.0 | 20.7 | 10.0
183 | Lumintop Copper Tool AAA Nichia 219 Flashlight | 20.0 | - | 20.0
189 | Lumintop IYP365 NW Flashlight | 12.0 | - | 12.0
197 | Lumintop Tool LED Keychain Flashlight | 10.0 | - | 9.0
198 | Lumintop Tool Nichia 219BT Flashlight | 10.0 | - | 9.1
+-----+------------------------------------------------+------+------+------+
6
+------+
```
Items with flash sale has empty discount field. As result, discount for these
items is replaced with `-` and shown at the end of the table (zero discount).