KOLANICH-libs / NoSuspend.py

A library to prevent the system from entering powersaving mode. !!! Migrated to Codeberg 🏔️ !!!

NoSuspend.py

wheel (GitLab) wheel (GHA via nightly.link)

We have moved to https://codeberg.org/KOLANICH-libs/NoSuspend.py, grab new versions there.

Under the disguise of "better security" Micro$oft-owned GitHub has discriminated users of 1FA passwords while having commercial interest in success and wide adoption of FIDO 1FA specifications and Windows Hello implementation which it promotes as a replacement for passwords. It will result in dire consequencies and is competely inacceptable, read why.

If you don't want to participate in harming yourself, it is recommended to follow the lead and migrate somewhere away of GitHub and Micro$oft. Here is the list of alternatives and rationales to do it. If they delete the discussion, there are certain well-known places where you can get a copy of it. Read why you should also leave GitHub.

---

This is a library to prevent the system from entering powersaving mode such as ACPI S1-4.

Requirements

• For Linux you need python3-dbus and some programms providing the used D-Bus interfaces.

Tutorial

• A very basic cross-platform way.
• Import the lib:

from NoSuspend import *

• Use the context manager:

with NoSuspend():
	doLongWork()

• You can provide additional arguments depending on platform:

• on Windows you can provide additional parameters, for example to keep the screen enabled

with NoSuspend(suspend=True, display=True, hidden=False, inherit=True):
	doLongWork()

• on Linux (with desktop environment) you can provide your application name and the reason

with NoSuspend(suspend=True, display=False, hidden=False, appName="MySuperApp", reason="doing long work..."):
	doLongWork()

• You can retrieve the state when used context manager:

with NoSuspend() as state:
	print(state)

on Windows you can just retrieve it using

print(NoSuspend.getCurrentState())

• The state is nested, the default state on Windows is EXECUTION_STATE.CONTINUOUS | EXECUTION_STATE.SYSTEM_REQUIRED ( coresponds to suspend=True ) as expected. There are 2 inherit modes:

print(NoSuspend.getCurrentState())
with NoSuspend() as state1:
	print(state1, NoSuspend.getCurrentState())
	with NoSuspend(display=True, inherit=False) as state2: # the default one, replaces the state
		print(state2, NoSuspend.getCurrentState())
	print(NoSuspend.getCurrentState())

print(NoSuspend.getCurrentState())
with NoSuspend() as state1:
	print(state1, NoSuspend.getCurrentState())
	with NoSuspend(EXECUTION_STATE.DISPLAY_REQUIRED, inherit=True) as state2: # adds flags to the state
		print(state2, NoSuspend.getCurrentState())
	print(NoSuspend.getCurrentState())

Also a console interface is available

python3 -m NoSuspend echo a
NoSuspend echo a
caffeinate echo a