{"id":13530044,"url":"https://github.com/precurse/internet_data_usage","last_synced_at":"2025-04-01T17:31:44.092Z","repository":{"id":147765737,"uuid":"44850738","full_name":"precurse/internet_data_usage","owner":"precurse","description":"Python based application to pull data plan usage for different carriers such as Telus and Koodo","archived":false,"fork":false,"pushed_at":"2015-11-20T06:46:42.000Z","size":0,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-11-02T16:35:51.175Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/precurse.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-10-24T03:30:55.000Z","updated_at":"2017-10-16T21:14:01.000Z","dependencies_parsed_at":"2023-04-13T07:36:13.034Z","dependency_job_id":null,"html_url":"https://github.com/precurse/internet_data_usage","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/precurse%2Finternet_data_usage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/precurse%2Finternet_data_usage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/precurse%2Finternet_data_usage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/precurse%2Finternet_data_usage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/precurse","download_url":"https://codeload.github.com/precurse/internet_data_usage/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246680340,"owners_count":20816679,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T07:00:42.543Z","updated_at":"2025-04-01T17:31:43.828Z","avatar_url":"https://github.com/precurse.png","language":"Python","readme":"Provides an interface to pull carrier data plan usage from a simple command line.\n\nWas originally intended to be a method to graph usage in Zabbix, but evolved into a full command line tool.\n\nCurrently supports the following carriers:\n- Telus Wireline\n- Koodo Mobile\n\nAdditional carriers can easily be added if requested.\n\nInstallation\n------\nInstall `internet_data_usage` from [Github](http://www.github.com) using git:\n\n    git clone https://github.com/precurse/internet_data_usage.git\n\nInstall module requirements using [pip](http://www.pip-installer.org/en/latest/), a\npackage manager for Python.\n\n    pip install -r requirements.txt\n\nNeed pip? Try installing it by running the following from the command\nline:\n\n    $ curl https://raw.github.com/pypa/pip/master/contrib/get-pip.py | python\n\n\nCommand Line Usage\n------\n\n        $ ./internet_data_usage.py -h\n        usage: internet_data_usage.py [-h] {term,zabbix,influxdb} ...\n\n        internet_data_usage 0.2-HEAD Copyright (c) 2015 Andrew Klaus\n        (andrewklaus@gmail.com)\n\n        optional arguments:\n          -h, --help            show this help message and exit\n\n        subcommands:\n          {term,zabbix,influxdb}\n                                valid subcommands\n            term                all output will echo in a terminal\n            zabbix              all output will be sent to a Zabbix server\n            influxdb            all output will be sent to an influxdb database\n\n\nTerminal Usage\n------\n\n        $ ./internet_data_usage.py term -h\n        usage: internet_data_usage.py term [-h] [-p PASSWORD]\n                                           [-c {telus_wireline,koodo_mobile}]\n                                           [-a HTTP_USER_AGENT] [-v]\n                                           username\n\n        positional arguments:\n          username              Username for account access\n\n        optional arguments:\n          -h, --help            show this help message and exit\n          -p PASSWORD, --password PASSWORD\n                                Carrier password for account access (will prompt if\n                                not specified)\n          -c {telus_wireline,koodo_mobile}, --carrier {telus_wireline,koodo_mobile}\n                                Carrier to query from (default=telus_wireline)\n          -a HTTP_USER_AGENT, --http_user_agent HTTP_USER_AGENT\n                                Defaults to 'Mozilla/5.0 (X11; Linux x86_64)'\n          -v, --verbose\n\n\nZabbix/Monitoring Usage\n------\n\n        $ ./internet_data_usage.py zabbix -h\n        usage: internet_data_usage.py zabbix [-h]\n                                             [-i {data_usage,data_use_unit,data_plan_total,plan}]\n                                             [-c {telus_wireline,koodo_mobile}]\n                                             [-a HTTP_USER_AGENT] [-v]\n                                             username password\n\n        positional arguments:\n          username              Username for account access\n          password              Carrier password for account access\n\n        optional arguments:\n          -h, --help            show this help message and exit\n          -i {data_usage,data_use_unit,data_plan_total,plan}, --item {data_usage,data_use_unit,data_plan_total,plan}\n                                Item to request (default=data_usage)\n          -c {telus_wireline,koodo_mobile}, --carrier {telus_wireline,koodo_mobile}\n                                Carrier to query from (default=telus_wireline)\n          -a HTTP_USER_AGENT, --http_user_agent HTTP_USER_AGENT\n                                Defaults to 'Mozilla/5.0 (X11; Linux x86_64)'\n          -v, --verbose\n./internet_data_usage.py  -h\nusage: internet_data_usage.py [-h] {term,zabbix,influxdb} ...\n\ninternet_data_usage 0.2-HEAD Copyright (c) 2015 Andrew Klaus\n(andrewklaus@gmail.com)\n\noptional arguments:\n  -h, --help            show this help message and exit\n\nsubcommands:\n  {term,zabbix,influxdb}\n                        valid subcommands\n    term                all output will echo in a terminal\n    zabbix              all output will be sent to a Zabbix server\n    influxdb            all output will be sent to an influxdb database\n\n\nInfluxdb Usage\n------\n\n        $ ./internet_data_usage.py influxdb -h\n        usage: internet_data_usage.py influxdb [-h] [-p PORT]\n                                               [-c {telus_wireline,koodo_mobile}]\n                                               [-a HTTP_USER_AGENT] [-v]\n                                               username password i_user i_pass i_host\n                                               i_db\n\n        positional arguments:\n          username              Username for account access\n          password              Carrier password for account access\n          i_user                Influxdb username\n          i_pass                Influxdb password\n          i_host                Influxdb hostname\n          i_db                  Influxdb database\n\n        optional arguments:\n          -h, --help            show this help message and exit\n          -p PORT, --port PORT  Port for influxdb access (default=8086)\n          -c {telus_wireline,koodo_mobile}, --carrier {telus_wireline,koodo_mobile}\n                                Carrier to query from (default=telus_wireline)\n          -a HTTP_USER_AGENT, --http_user_agent HTTP_USER_AGENT\n                                Defaults to 'Mozilla/5.0 (X11; Linux x86_64)'\n          -v, --verbose\n\n\nCommand line output:\n------\n\nTerminal:\n\n        $ ./internet_data_usage.py term -c telus_wireline user@example.com\n        Carrier password (will not echo): \u003cpassword\u003e \u003center\u003e\n        TelusWireline Plan: TELUS Internet 50\n        Usage: 49/400 GB\n\nZabbix:\n\n        $ ./internet_data_usage.py zabbix -i data_usage user@example.com password\n        49\n\nInfluxdb:\n\n        $ ./internet_data_usage.py influxdb user@example.com mypass root root localhost internet_usage\n\n","funding_links":[],"categories":["Collecting data into InfluxDB"],"sub_categories":["Projects"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprecurse%2Finternet_data_usage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprecurse%2Finternet_data_usage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprecurse%2Finternet_data_usage/lists"}