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.
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.
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.
$ go get github.com/krasoffski/lsgbc
Before all, please clone this repository with command:
$ git clone https://github.com/krasoffski/lsgbc
Or download archive with source code.
$ wget https://github.com/krasoffski/lsgbc/archive/master.zip
$ unzip master.zip
And change working directory to cloned repository: cd lsgbc
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 inbin
directory.
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.
$ 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
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
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.
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
+------+
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.
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 toled-flashlights
.PRICE
is around ofLOWEST
.- 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).
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).