Skip to main content

PyPI TravisCI AppVeyorCI CodacyCoverage Codacy License

Free yourself from the tedious operation, now you can just use a one-line command to view the electricity information of your dormitory.

The data comes from the BUPT Work WeChat. But please notice that this utility tool can only query the dormitory which is located on Xitucheng Campus. The other campuses are not supported at the moment.

FEATURES

  • Get your power data easily, including surplus, voltage, current, power, etc.

  • Calculate available time.

Requirements

  • Python 3

Quick Start

Step 1: Install from PyPI

pip install buptelecmon

Step 2: Set your authorization information

This information is used to log in to the query interface. We won’t send your information to other sites.

elecinfo --set-auth

And input your student ID and your password. The password is usually the same as your Information Portal (my.bupt.edu.cn).

Student ID:
Password:

Your authorization information will be saved to ~/.elecmon/elecmon.json.

Step 3: Run it

elecinfo <dormitory-number>

The dormitory-number must be in the correct format (ApartmentNumber-DormitoryNumber, e.g 1-101).

Also, this command tool will remember the dormitory number of the last query. Next time, if you want to query the same dormitory as last query, just type:

elecinfo

Recharge

Use this tool to visit the recharge page directly.

elecinfo --recharge <dormitory-number>

Then, a QR code will be shown on your terminal. Please use your WeChat to scan the QR code and pay for it.

Advanced Usage

Full Command Line

elecinfo [ --version | --set-auth | [--loop] <dormitory-number-1> [... <dormitory-number-n>] | --recharge <dormitory-number>]

Option

Description

–version

Display the version of this tool.

–set-auth

Set your authorization information, as the Quick Start - Step 2 shows.

–loop

Repeat querying electricity information every 60 seconds.

–recharge

Display a recharge QR code.

Note: Please DO NOT query too many dormitories at the same time or query too frequently, otherwise you may receive HTTP 500 Internal Server Error s from the remote server.

APIs

We allow you to use the APIs to build your applications, for example:

import buptelecmon
em = buptelecmon.electricitymonitor.ElectricityMonitor()
em.login('student_id', 'password')
em.query(['x-xxx'])

For more information, please read the APIs Document.

Screenshot

https://user-images.githubusercontent.com/6760674/43949495-4454d694-9cc0-11e8-88c2-cfd98e2291a6.gif

Changelog

Mon, 13 Aug 2018: 1.2.2 released. Fix a bug that prevent the program from quitting when an exception raises. :bookmark:

Mon, 13 Aug 2018: 1.2.1 released. Fix documentation error. :bookmark:

Sun, 12 Aug 2018: 1.2.0 released :bookmark:

  • Added recharge mode

Sat, 11 Aug 2018: 1.1.0 released :bookmark:

  • Removed daemon mode

  • Added configuration mode - We don’t need to write json file manually anymore

  • Published to PyPI

Fri, 30 Mar 2018: First version. :tada:

License

This software is distributed under the MIT License.

Metadata

Release files for buptelecmon 1.2.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for buptelecmon 1.2.3
File Size Uploaded Provenance Actions
buptelecmon-1.2.3.tar.gz 8.3 kB Without provenance Details for buptelecmon-1.2.3.tar.gz

Release files / buptelecmon-1.2.3.tar.gz

Download URL buptelecmon-1.2.3.tar.gz
Size 8.3 kB
Tags Source
SHA-256 checksum
How to use checksums
c0372f82b2980c2300ecd1e905d55833a3cc52b583b0660f1efdb640a7d3ed13
BLAKE2b-256 checksum
How to use checksums
f08609d374214d28ee9b0444130f89e153a8b76f337b72ab6cb0b14717c16368
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.4.6

Security for buptelecmon 1.2.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page