bgc_add_vol_pack/README.md

![mesScripts](https://sirenacorp.be/wp-content/uploads/2016/01/logo-1.png)

bgc_add_vol_pack.py
===

The unlimited volume of Belgacom/Proximus is, in fact, limited. And when this limit is reached, your connection is nearly useless because the very low speed of it.

This script help to easily add extra volume packs, with a headless mode to use it in a monthly cron by example.

Parameters
===

```
usage: bgc_add_vol_pack.py [-h] [--repeat REPEAT] [--packSize PACKSIZE]
                           [--headless HEADLESS]
                           login password

Add extra data volume pack to Belgacom Internet

positional arguments:
  login                Belgacom login email
  password             Belgacom password

optional arguments:
  -h, --help           show this help message and exit
  --repeat REPEAT      Number of volume packs to add (1 pack by default)
  --packSize PACKSIZE  Volume size of the pack to add (150 GB by default)
  --headless HEADLESS  Headless mode (enabled by default ; using xvfb)
```
Requirements
===

This script is using the following Python 3 modules :

* argparse
```sudo pip3 install argparse```
* selenium
```sudo pip3 install selenium```
* pyvirtualdisplay 
```sudo pip3 install pyvirtualdisplay```

And the following cmdline tool : 

* xvfb (Ubuntu) 
```sudo apt-get install xvfb```

Examples of use
===

Add 1 pack of 150 GB (which are default values)
```
./bgc_add_vol_pack.py my_login my_password
```

Add 3 packs of 150 GB in headless mode
```
./bgc_add_vol_pack.py my_login my_password --repeat 3 --packSize 150
```

Add 10 packs of 20 GB in headless mode disable (FireFox will be opened)
```
./bgc_add_vol_pack.py my_login my_password --repeat 10 --packSize 20 --headless 0
```

Credits
===

These scripts have been modified and improved by Francois B. (Makotosan / Shakasan) based on the initial script written by Tuxicoman (see Initial Credits And Licence below)

* Email : shakasan [at] sirenacorp.be
* Website : [Makoto no Blog](https://sirenacorp.be/)

Initial Credits ande Licence
===

Copyright (C) 2016   Tuxicoman

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later $
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more detail$
You should have received a copy of the GNU Affero General Public License along with this program.  If not, see <http://www.gnu.org/licenses/>.

Link to the post on Tuxicoman website : https://tuxicoman.jesuislibre.net/2016/05/internet-vraiment-illimite-chez-belgacomproximus.html

Improvements - Changelog
===

* Updated for Python3
* Any volume pack sizes
* WebDriverWait increased up to 20 to *try* to avoid login failures
* Headless mode added as optional parameter
* repeat and packSize parameters are optional with default value to 1 pack of 150 GB