https://github.com/grindsa/o2_scrap
python library to access the web portal of Telefonica O2 Germany
https://github.com/grindsa/o2_scrap
Last synced: 10 months ago
JSON representation
python library to access the web portal of Telefonica O2 Germany
- Host: GitHub
- URL: https://github.com/grindsa/o2_scrap
- Owner: grindsa
- License: gpl-3.0
- Created: 2018-02-09T07:51:27.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2020-10-17T04:49:30.000Z (over 5 years ago)
- Last Synced: 2025-02-16T09:43:45.864Z (over 1 year ago)
- Language: Python
- Size: 145 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# o2_scrap
o2_scrap is a python library to access the web portal of Telefonica O2 Germany to fetch
- mobile data-usage of the phone numbers under a specific contract
- the mobile plan details
- the last 6 bills
## Getting Started
These instructions will get you a copy of the project up and running on your local machine.
### Prerequisites
To run o2_scrap on your system you need
- [Python](https://www.python.org)
- [Selenium](https://pypi.python.org/pypi/selenium) - Selenium Python Bindigs
- [geckodriver](https://github.com/mozilla/geckodriver) - Proxy for using W3C WebDriver-compatible clients to interact with Gecko-based browsers.
- [Beautiful Soup](https://www.crummy.com/software/BeautifulSoup/) - a Python library for pulling data out of HTML and XML files.
Please make sure python and all the above modules had been installed successfully before you start any kind of testing.
### Installing
#### via Pypi
```bash
> pip install o2_scrap
```
#### manually for all users
1. download the archive and unpack it
2. enter the directory and run the setup script
```bash
> python setup.py install
```
#### manually for a single user
1. download the archive and unpack it
2. move the "o2_scrap" subfolder into the directory your script is located
### Usage
#### for mobile contracts
you need to import o2_scrap into your script
```python
> from o2_scrap import O2mobile
```
create a new o2_scrap context handler and login to web portal portal to
```python
> with O2mobile(USER, PASSWORD, DEBUG, HEADLESS) as O2M:
```
- USER: User-account for o2-online.de
- PASSWORD: Password for the above user-account
- DEBUG: True/False - Debug-mode shows more messages and takes screenshots
- HEADLESS: True/Fals - Turn headless mode on/off (usefull for debugging)
The method get_numbers() can be used to get the list of mobile numbers under the same contract
```python
> numbers = O2M.get_numbers()
```
The method returns a dictionary containing the mobile numbers and tariff name
```python
> from pprint import pprint
> pprint(numbers)
{u'0176-1234567': u'O2 Blue Data S',
u'0176-101010101': u'O2 Free M',
u'0176-87654321': u'O2 Blue Basic',
u'0176-12312345' Blue All-in L (2015)',
u'0179-5513345': u'O2 Blue All-in S (2015)'}
```
To get the mobile data-usage and further plan details use the get_overview() method
```python
> data_dict = O2M.get_overview()
```
- mobile-number: phone number to be queried (format must be as obtained via get_numbers() method)
The method returns a dictionary in the following format
```python
> from pprint import pprint
> pprint(data_dict)
{'data-usage': {'autoadjust': u'Datenautomatik deaktiviert',
'current': '122 MB',
'limit': u'2 GB',
'estimation': u'2,35 GB'},
'plan-data': {u'K\xfcndigungsfrist:': u'3 Monat(e) zum Vertragsende',
u'Verl\xe4ngerbar ab:': u'15.12.2017',
u'Vertragsbeginn:': u'16.08.2016',
u'Vertragsende:': u'15.08.2017',
'price': u'19,99 \u20ac\nmonatlich',
u'sp\xe4tester K\xfcndigungstermin:': u'15.05.2018',
'tariff': u'O2 Blue All-in S (2015)'}}
```
To get the latest bills the method get_bills() must be used.
```python
bill_list = O2M.get_bills()
```
The method returns a list of bills in the following format
```python
> from pprint import pprint
> pprint(bill_list)
[{'download': u'https://www.o2online.de/ecare/?0-1.ILinkListener-selfcarePanel-content-contentContainer-content-tabContent-content-mainBills-content-list-0-billDownloadPanel-billDocumentParts-0-downloadLink&intcmp=epo2p_quick-links-teaser_mein-o2-mein-verbrauch',
'price': u'23,13€',
'text': u'Aktuelle Rechnung vom 03.01.18'},
{'download': u'https://www.o2online.de/ecare/?0-1.ILinkListener-selfcarePanel-content-contentContainer-content-tabContent-content-mainBills-content-list-1-billDownloadPanel-billDocumentParts-0-downloadLink&intcmp=epo2p_quick-links-teaser_mein-o2-mein-verbrauch',
'price': u'56,95€',
'text': u'Rechnung vom 03.12.17'},
{'download': u'https://www.o2online.de/ecare/?0-1.ILinkListener-selfcarePanel-content-contentContainer-content-tabContent-content-mainBills-content-list-2-billDownloadPanel-billDocumentParts-0-downloadLink&intcmp=epo2p_quick-links-teaser_mein-o2-mein-verbrauch',
'price': u'45,95€',
'text': u'Rechnung vom 03.11.17'},
{'download': u'https://www.o2online.de/ecare/?0-1.ILinkListener-selfcarePanel-content-contentContainer-content-tabContent-content-mainBills-content-list-3-billDownloadPanel-billDocumentParts-0-downloadLink&intcmp=epo2p_quick-links-teaser_mein-o2-mein-verbrauch',
'price': u'23,39€',
'text': u'Rechnung vom 04.10.17'},
{'download': u'https://www.o2online.de/ecare/?0-1.ILinkListener-selfcarePanel-content-contentContainer-content-tabContent-content-mainBills-content-list-4-billDownloadPanel-billDocumentParts-0-downloadLink&intcmp=epo2p_quick-links-teaser_mein-o2-mein-verbrauch',
'price': u'67,44€',
'text': u'Rechnung vom 05.09.17'}]
```
to close the browser instance and end the session use the logout() methods
```python
> O2M.logout(o2b)
```
#### for DSL contracts
create a new context handler and login to web portal portal to
```python
> with O2dsl(USER, PASSWORD, DEBUG) as O2D:
```
DSL usage statistics can be obtained by using the get_overview() method
```python
> data_usage = O2D.get_overview()
```
the method will return a dictionary containing
- the actual data usage
- the monthly limit
- the prognosed data usage by end of the period
- the remaining time till period ends
- a dictionary with the data consumption of the last 6 months
```python
> from pprint import pprint
> pprint(data_usage)
{'history': [{'from': u'15.08.', 'to': u'15.09.', 'usage': 213},
{'from': u'15.09.', 'to': u'15.10.', 'usage': 271},
{'from': u'15.10.', 'to': u'15.11.', 'usage': 326},
{'from': u'15.11.', 'to': u'15.12.', 'usage': 123},
{'from': u'15.12.', 'to': u'15.01.', 'usage': 89},
{'from': u'15.01.', 'to': u'15.02.', 'usage': 472}],
'limit': 300,
'prognosed': 169,
'remaining': u'Noch 25 Tage im Rechnungsmonat',
'since': u'Verbrauchte Daten seit 15.02.2018',
'used': 66}
```
## Further documentation
Please check the [doc](https://github.com/grindsa/o2_scrap/tree/master/doc) folder of the project. You will find further documentation and an example scripts of all methods there.
## Contributing
Please read [CONTRIBUTING.md](https://github.com/grindsa/o2_scrap/blob/master/CONTRIBUTING.md) for details on my code of conduct, and the process for submitting pull requests.
Please note that I have a life besides programming. Thus, expect a delay in answering.
## Versioning
I use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/grindsa/dkb-robo/tags).
## License
This project is licensed under the GPLv3 - see the [LICENSE.md](https://github.com/grindsa/o2_scrap/blob/master/LICENSE) file for details