pycpufreq 1.0.0__tar.gz

pycpufreq-1.0.0/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: pycpufreq
+Version: 1.0.0
+Summary: Python library and CLI tool to manage and monitor CPU frequencies and turbo state
+Author: turulomio
+Author-email: turulomio <turulomio@yahoo.es>
+License-Expression: GPL-3.0-or-later
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+
+# pycpufreq
+
+<p align="center">
+  <a href="https://github.com/turulomio/pycpufreq/actions/workflows/ci.yml">
+    <img src="https://github.com/turulomio/pycpufreq/actions/workflows/ci.yml/badge.svg" alt="CI Status" />
+  </a>
+  <a href="https://pypi.org/project/pycpufreq/">
+    <img src="https://img.shields.io/pypi/v/pycpufreq.svg" alt="PyPI version" />
+  </a>
+  <a href="https://pypi.org/project/pycpufreq/">
+    <img src="https://img.shields.io/pypi/pyversions/pycpufreq.svg" alt="Python Versions" />
+  </a>
+  <a href="https://github.com/turulomio/pycpufreq/blob/main/LICENSE">
+    <img src="https://img.shields.io/github/license/turulomio/pycpufreq.svg" alt="License" />
+  </a>
+  <a href="https://github.com/astral-sh/uv">
+    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json" alt="uv" />
+  </a>
+</p>
+
+---
+
+**pycpufreq** is a modern Python library and CLI utility to monitor and configure CPU scaling frequencies and Intel Turbo Boost via Linux `sysfs` (`/sys/devices/system/cpu`).
+
+## ✨ Key Features
+
+- **Query CPU Frequencies**: Retrieve minimum, maximum, current, and scaling CPU frequencies.
+- **Multicore Scaling Configuration**: Safely set scaling maximum frequency across all present CPU cores (`cpu0`, `cpu1`, ...).
+- **Intel Turbo Boost Toggle**: Enable or disable turbo state on Intel processors through `intel_pstate/no_turbo`.
+- **Target Frequency Validation**: CLI validates custom frequencies against real hardware bounds ($f_{min} \le f_{target} \le f_{max}$).
+- **Standard Internationalization (`gettext`)**: Multi-language support (English, Spanish, French, Romanian, Russian, Chinese, Hindi).
+- **Modern Packaging with `uv` & `poethepoet`**: High-performance task runner, dependency management and zero-dependency runtime.
+
+---
+
+## 📦 Installation
+
+Install with `uv`:
+
+```bash
+uv add pycpufreq
+```
+
+Or using `pip`:
+
+```bash
+pip install pycpufreq
+```
+
+---
+
+## 🚀 Quick Start
+
+### Python Library
+
+```python
+from pycpufreq import (
+    is_cpufreq_configured,
+    sys_get_cpu_max_freq,
+    sys_get_cpu_min_freq,
+    sys_get_cpu_current_freq,
+    sys_set_cpu_max_scaling_freq,
+    sys_set_cpu_turbo,
+)
+
+if is_cpufreq_configured():
+    print(f"Max Frequency:     {sys_get_cpu_max_freq()} kHz")
+    print(f"Min Frequency:     {sys_get_cpu_min_freq()} kHz")
+    print(f"Current Frequency: {sys_get_cpu_current_freq()} kHz")
+
+    # Set scaling frequency (requires write permissions to sysfs):
+    # sys_set_cpu_max_scaling_freq(2400000)
+
+    # Enable or disable Turbo boost:
+    # sys_set_cpu_turbo(True)
+```
+
+### Command Line Interface (CLI)
+
+Run the CLI directly:
+
+```bash
+# Display CPU stats, run dynamic scaling test and restore maximum frequency:
+pycpufreq
+
+# Run and leave CPU at a validated target frequency (e.g. 2400000 kHz):
+pycpufreq 2400000
+
+# Show help & options:
+pycpufreq --help
+```
+
+Or via `uv`:
+
+```bash
+uv run pycpufreq
+```
+
+---
+
+## 🛠️ Development & Tasks
+
+This project uses [`poethepoet`](https://github.com/nat-n/poethepoet) to streamline development tasks.
+
+### Run Tests
+
+```bash
+poe test
+# or directly:
+uv run pytest
+```
+
+### Update Translations
+
+Extract translatable strings, update catalogs and compile binary `.mo` files:
+
+```bash
+poe translate
+```
+
+### Release Checklist
+
+Print release steps and commands for tag, build and publish:
+
+```bash
+poe release
+```
+
+---
+
+## 📄 License
+
+Distributed under the terms of the [GNU General Public License v3 or later (GPL-3.0-or-later)](LICENSE).

pycpufreq-1.0.0/README.md

@@ -0,0 +1,133 @@
+# pycpufreq
+
+<p align="center">
+  <a href="https://github.com/turulomio/pycpufreq/actions/workflows/ci.yml">
+    <img src="https://github.com/turulomio/pycpufreq/actions/workflows/ci.yml/badge.svg" alt="CI Status" />
+  </a>
+  <a href="https://pypi.org/project/pycpufreq/">
+    <img src="https://img.shields.io/pypi/v/pycpufreq.svg" alt="PyPI version" />
+  </a>
+  <a href="https://pypi.org/project/pycpufreq/">
+    <img src="https://img.shields.io/pypi/pyversions/pycpufreq.svg" alt="Python Versions" />
+  </a>
+  <a href="https://github.com/turulomio/pycpufreq/blob/main/LICENSE">
+    <img src="https://img.shields.io/github/license/turulomio/pycpufreq.svg" alt="License" />
+  </a>
+  <a href="https://github.com/astral-sh/uv">
+    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json" alt="uv" />
+  </a>
+</p>
+
+---
+
+**pycpufreq** is a modern Python library and CLI utility to monitor and configure CPU scaling frequencies and Intel Turbo Boost via Linux `sysfs` (`/sys/devices/system/cpu`).
+
+## ✨ Key Features
+
+- **Query CPU Frequencies**: Retrieve minimum, maximum, current, and scaling CPU frequencies.
+- **Multicore Scaling Configuration**: Safely set scaling maximum frequency across all present CPU cores (`cpu0`, `cpu1`, ...).
+- **Intel Turbo Boost Toggle**: Enable or disable turbo state on Intel processors through `intel_pstate/no_turbo`.
+- **Target Frequency Validation**: CLI validates custom frequencies against real hardware bounds ($f_{min} \le f_{target} \le f_{max}$).
+- **Standard Internationalization (`gettext`)**: Multi-language support (English, Spanish, French, Romanian, Russian, Chinese, Hindi).
+- **Modern Packaging with `uv` & `poethepoet`**: High-performance task runner, dependency management and zero-dependency runtime.
+
+---
+
+## 📦 Installation
+
+Install with `uv`:
+
+```bash
+uv add pycpufreq
+```
+
+Or using `pip`:
+
+```bash
+pip install pycpufreq
+```
+
+---
+
+## 🚀 Quick Start
+
+### Python Library
+
+```python
+from pycpufreq import (
+    is_cpufreq_configured,
+    sys_get_cpu_max_freq,
+    sys_get_cpu_min_freq,
+    sys_get_cpu_current_freq,
+    sys_set_cpu_max_scaling_freq,
+    sys_set_cpu_turbo,
+)
+
+if is_cpufreq_configured():
+    print(f"Max Frequency:     {sys_get_cpu_max_freq()} kHz")
+    print(f"Min Frequency:     {sys_get_cpu_min_freq()} kHz")
+    print(f"Current Frequency: {sys_get_cpu_current_freq()} kHz")
+
+    # Set scaling frequency (requires write permissions to sysfs):
+    # sys_set_cpu_max_scaling_freq(2400000)
+
+    # Enable or disable Turbo boost:
+    # sys_set_cpu_turbo(True)
+```
+
+### Command Line Interface (CLI)
+
+Run the CLI directly:
+
+```bash
+# Display CPU stats, run dynamic scaling test and restore maximum frequency:
+pycpufreq
+
+# Run and leave CPU at a validated target frequency (e.g. 2400000 kHz):
+pycpufreq 2400000
+
+# Show help & options:
+pycpufreq --help
+```
+
+Or via `uv`:
+
+```bash
+uv run pycpufreq
+```
+
+---
+
+## 🛠️ Development & Tasks
+
+This project uses [`poethepoet`](https://github.com/nat-n/poethepoet) to streamline development tasks.
+
+### Run Tests
+
+```bash
+poe test
+# or directly:
+uv run pytest
+```
+
+### Update Translations
+
+Extract translatable strings, update catalogs and compile binary `.mo` files:
+
+```bash
+poe translate
+```
+
+### Release Checklist
+
+Print release steps and commands for tag, build and publish:
+
+```bash
+poe release
+```
+
+---
+
+## 📄 License
+
+Distributed under the terms of the [GNU General Public License v3 or later (GPL-3.0-or-later)](LICENSE).

pycpufreq-1.0.0/pyproject.toml

@@ -0,0 +1,34 @@
+[project]
+name = "pycpufreq"
+version = "1.0.0"
+description = "Python library and CLI tool to manage and monitor CPU frequencies and turbo state"
+readme = "README.md"
+license = "GPL-3.0-or-later"
+requires-python = ">=3.14"
+dependencies = []
+
+[[project.authors]]
+name = "turulomio"
+email = "turulomio@yahoo.es"
+
+[project.scripts]
+pycpufreq = "pycpufreq.commands:main"
+
+[build-system]
+requires = ["uv_build>=0.12.17,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = ["pytest>=9.2.0"]
+
+[tool.poe.tasks.translate]
+script = "pycpufreq.poethepoet:translate"
+help = "Extract, update and compile gettext catalogs"
+
+[tool.poe.tasks.test]
+cmd = "pytest"
+help = "Run test suite"
+
+[tool.poe.tasks.release]
+script = "pycpufreq.poethepoet:release"
+help = "Print instructions for releasing a new version"

pycpufreq-1.0.0/pyproject.toml.orig

@@ -0,0 +1,30 @@
+[project]
+name = "pycpufreq"
+version = "1.0.0"
+description = "Python library and CLI tool to manage and monitor CPU frequencies and turbo state"
+readme = "README.md"
+license = "GPL-3.0-or-later"
+authors = [
+    { name = "turulomio", email = "turulomio@yahoo.es" }
+]
+requires-python = ">=3.14"
+dependencies = []
+
+[project.scripts]
+pycpufreq = "pycpufreq.commands:main"
+
+[build-system]
+requires = ["uv_build>=0.12.17,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.2.0",
+]
+
+[tool.poe.tasks]
+translate = { script = "pycpufreq.poethepoet:translate", help = "Extract, update and compile gettext catalogs" }
+test = { cmd = "pytest", help = "Run test suite" }
+release = { script = "pycpufreq.poethepoet:release", help = "Print instructions for releasing a new version" }
+
+

pycpufreq-1.0.0/src/pycpufreq/__init__.py

@@ -0,0 +1,31 @@
+"""pycpufreq package."""
+
+from pycpufreq.version import __version__, __version_date__, __version_datetime__
+from pycpufreq.i18n import LOCALE_DIR, _, translation
+from pycpufreq.core import (
+    FAIL_FREQUENCY,
+    is_cpufreq_configured,
+    sys_get_cpu_max_freq,
+    sys_get_cpu_min_freq,
+    sys_get_cpu_current_freq,
+    sys_get_cpu_max_scaling_freq,
+    sys_set_cpu_max_scaling_freq,
+    sys_set_cpu_turbo,
+)
+
+__all__ = [
+    "__version__",
+    "__version_date__",
+    "__version_datetime__",
+    "LOCALE_DIR",
+    "_",
+    "translation",
+    "FAIL_FREQUENCY",
+    "is_cpufreq_configured",
+    "sys_get_cpu_max_freq",
+    "sys_get_cpu_min_freq",
+    "sys_get_cpu_current_freq",
+    "sys_get_cpu_max_scaling_freq",
+    "sys_set_cpu_max_scaling_freq",
+    "sys_set_cpu_turbo",
+]

pycpufreq-1.0.0/src/pycpufreq/commands.py

@@ -0,0 +1,97 @@
+"""CLI commands entrypoint for pycpufreq."""
+
+import argparse
+import sys
+from time import sleep
+from pycpufreq.i18n import _
+from pycpufreq.version import __version__
+from pycpufreq.core import (
+    is_cpufreq_configured,
+    sys_get_cpu_max_freq,
+    sys_get_cpu_min_freq,
+    sys_get_cpu_current_freq,
+    sys_get_cpu_max_scaling_freq,
+    sys_set_cpu_max_scaling_freq,
+    sys_set_cpu_turbo,
+)
+
+
+def main(args: list[str] | None = None) -> int:
+    """Main CLI entrypoint demonstrating cpufreq features and leaving final frequency."""
+    parser = argparse.ArgumentParser(
+        prog="pycpufreq",
+        description=_("Manage and monitor CPU frequencies and turbo state."),
+    )
+    parser.add_argument(
+        "-v", "--version",
+        action="version",
+        version=f"%(prog)s {__version__}",
+    )
+    parser.add_argument(
+        "frequency",
+        nargs="?",
+        type=int,
+        default=None,
+        help=_("Target final CPU scaling frequency (in kHz). If omitted, maximum frequency is used."),
+    )
+
+    parsed = parser.parse_args(args)
+    sleeptime = 2
+
+    print(_("Is kernel cpufreq configured?:"), is_cpufreq_configured())
+
+    if not is_cpufreq_configured():
+        return 1
+
+    max_freq = int(sys_get_cpu_max_freq())
+    min_freq = int(sys_get_cpu_min_freq())
+
+    # Validate target frequency if supplied
+    target_freq = parsed.frequency
+    if target_freq is not None:
+        if target_freq < min_freq or target_freq > max_freq:
+            print(
+                _("Invalid frequency: {}. It must be between {} and {} kHz.").format(
+                    target_freq, min_freq, max_freq
+                ),
+                file=sys.stderr,
+            )
+            return 2
+    else:
+        target_freq = max_freq
+
+    print(_("Max cpu freq is {}").format(max_freq))
+    print(_("Min cpu freq is {}").format(min_freq))
+    print(_("Current cpu freq is {}").format(sys_get_cpu_current_freq()))
+
+    print(_("Changing cpu to maximum scaling freq"))
+    sys_set_cpu_max_scaling_freq(max_freq)
+    sleep(sleeptime)
+    print(_("Current cpu max scaling freq is {}").format(sys_get_cpu_max_scaling_freq()))
+
+    print(_("Disabling turbo"))
+    sys_set_cpu_turbo(False)
+    sleep(sleeptime)
+    print(_("Current cpu max scaling freq is {}").format(sys_get_cpu_max_scaling_freq()))
+
+    print(_("Enabling turbo"))
+    sys_set_cpu_turbo(True)
+    sleep(sleeptime)
+    print(_("Current cpu max scaling freq is {}").format(sys_get_cpu_max_scaling_freq()))
+
+    print(_("Changing cpu to minimum scaling freq"))
+    sys_set_cpu_max_scaling_freq(min_freq)
+    sleep(sleeptime)
+    print(_("Current cpu max scaling freq is {}").format(sys_get_cpu_max_scaling_freq()))
+
+    # Leave the CPU configured with target frequency at the end
+    print(_("Leaving CPU frequency at {}").format(target_freq))
+    sys_set_cpu_max_scaling_freq(target_freq)
+    sleep(sleeptime)
+    print(_("Current cpu max scaling freq is {}").format(sys_get_cpu_max_scaling_freq()))
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

pycpufreq-1.0.0/src/pycpufreq/core.py

@@ -0,0 +1,119 @@
+"""Core functionality for CPU frequency management."""
+
+from pathlib import Path
+from pycpufreq.i18n import _
+
+FAIL_FREQUENCY = 400000
+
+
+def _resolve_path(base_path: str | Path) -> Path:
+    """Helper to convert base_path to Path instance."""
+    return Path(base_path)
+
+
+def is_cpufreq_configured(base_path: str | Path = "/sys/devices/system/cpu") -> bool:
+    """Check if cpufreq and intel_pstate sysfs nodes exist."""
+    base = _resolve_path(base_path)
+    return (
+        (base / "cpu0" / "cpufreq").exists()
+        and (base / "cpu0" / "cpufreq" / "cpuinfo_max_freq").exists()
+        and (base / "cpu0" / "cpufreq" / "cpuinfo_min_freq").exists()
+        and (base / "cpu0" / "cpufreq" / "scaling_cur_freq").exists()
+        and (base / "cpu0" / "cpufreq" / "scaling_max_freq").exists()
+        and (base / "intel_pstate" / "no_turbo").exists()
+    )
+
+
+def sys_get_cpu_max_freq(base_path: str | Path = "/sys/devices/system/cpu") -> str | int:
+    """Get maximum cpu frequency supported by cpu0."""
+    base = _resolve_path(base_path)
+    if is_cpufreq_configured(base):
+        try:
+            return (base / "cpu0" / "cpufreq" / "cpuinfo_max_freq").read_text().strip()
+        except OSError:
+            return FAIL_FREQUENCY
+    return FAIL_FREQUENCY
+
+
+def sys_get_cpu_min_freq(base_path: str | Path = "/sys/devices/system/cpu") -> str | int:
+    """Get minimum cpu frequency supported by cpu0."""
+    base = _resolve_path(base_path)
+    if is_cpufreq_configured(base):
+        try:
+            return (base / "cpu0" / "cpufreq" / "cpuinfo_min_freq").read_text().strip()
+        except OSError:
+            return FAIL_FREQUENCY
+    return FAIL_FREQUENCY
+
+
+def sys_get_cpu_current_freq(base_path: str | Path = "/sys/devices/system/cpu") -> str | int:
+    """Get current operating cpu frequency of cpu0."""
+    base = _resolve_path(base_path)
+    if is_cpufreq_configured(base):
+        try:
+            return (base / "cpu0" / "cpufreq" / "scaling_cur_freq").read_text().strip()
+        except OSError:
+            return FAIL_FREQUENCY
+    return FAIL_FREQUENCY
+
+
+def sys_get_cpu_max_scaling_freq(base_path: str | Path = "/sys/devices/system/cpu") -> str | int:
+    """Get maximum scaling frequency of cpu0."""
+    base = _resolve_path(base_path)
+    if is_cpufreq_configured(base):
+        try:
+            return (base / "cpu0" / "cpufreq" / "scaling_max_freq").read_text().strip()
+        except OSError:
+            return FAIL_FREQUENCY
+    return FAIL_FREQUENCY
+
+
+def sys_set_cpu_max_scaling_freq(freq: str | int, base_path: str | Path = "/sys/devices/system/cpu") -> bool:
+    """Set maximum scaling frequency for all available CPUs."""
+    base = _resolve_path(base_path)
+    # Security validation: Ensure freq is numeric to avoid invalid writes
+    try:
+        val = int(freq)
+        if val <= 0:
+            raise ValueError()
+        str_val = str(val)
+    except (ValueError, TypeError):
+        print(_("Error setting sys_set_cpu_max_scaling_freq"))
+        return False
+
+    if is_cpufreq_configured(base):
+        i = 0
+        written_any = False
+        try:
+            while True:
+                freq_path = base / f"cpu{i}" / "cpufreq" / "scaling_max_freq"
+                if freq_path.exists():
+                    freq_path.write_text(str_val)
+                    written_any = True
+                    i += 1
+                else:
+                    break
+            return written_any
+        except OSError:
+            print(_("Error setting sys_set_cpu_max_scaling_freq"))
+            return False
+    else:
+        print(_("Error setting sys_set_cpu_max_scaling_freq"))
+        return False
+
+
+def sys_set_cpu_turbo(boolean: bool, base_path: str | Path = "/sys/devices/system/cpu") -> bool:
+    """Enable or disable CPU turbo via intel_pstate."""
+    base = _resolve_path(base_path)
+    if is_cpufreq_configured(base):
+        s = "0" if boolean else "1"
+        target_path = base / "intel_pstate" / "no_turbo"
+        try:
+            target_path.write_text(s)
+            return True
+        except OSError:
+            print(_("Error setting sys_set_cpu_turbo"))
+            return False
+    else:
+        print(_("Error setting sys_set_cpu_turbo"))
+        return False

pycpufreq-1.0.0/src/pycpufreq/i18n.py

@@ -0,0 +1,6 @@
+import gettext
+from pathlib import Path
+
+LOCALE_DIR = Path(__file__).resolve().parent / "locale"
+translation = gettext.translation("pycpufreq", localedir=str(LOCALE_DIR), fallback=True)
+_ = translation.gettext

pycpufreq-1.0.0/src/pycpufreq/locale/es.po

@@ -0,0 +1,62 @@
+# Spanish translations for pycpufreq package.
+# Copyright (C) 2026 turulomio
+# This file is distributed under the same license as the pycpufreq package.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: pycpufreq 0.1.0\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2026-10-31 09:26+0100\n"
+"PO-Revision-Date: 2026-10-31 09:25+0100\n"
+"Last-Translator: turulomio <turulomio@yahoo.es>\n"
+"Language-Team: Spanish <turulomio@yahoo.es>\n"
+"Language: es\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+
+msgid "Error setting sys_set_cpu_max_scaling_freq"
+msgstr "Error al establecer sys_set_cpu_max_scaling_freq"
+
+msgid "Error setting sys_set_cpu_turbo"
+msgstr "Error al establecer sys_set_cpu_turbo"
+
+msgid "Manage and monitor CPU frequencies and turbo state."
+msgstr "Gestiona y monitoriza frecuencias de CPU y el estado de Turbo."
+
+msgid "Target final CPU scaling frequency (in kHz). If omitted, maximum frequency is used."
+msgstr "Frecuencia final objetivo de escalado de CPU (en kHz). Si se omite, se utiliza la frecuencia máxima."
+
+msgid "Is kernel cpufreq configured?:"
+msgstr "¿Está cpufreq del kernel configurado?:"
+
+msgid "Invalid frequency: {}. It must be between {} and {} kHz."
+msgstr "Frecuencia no válida: {}. Debe estar entre {} y {} kHz."
+
+msgid "Max cpu freq is {}"
+msgstr "La frecuencia máxima de cpu es {}"
+
+msgid "Min cpu freq is {}"
+msgstr "La frecuencia mínima de cpu es {}"
+
+msgid "Current cpu freq is {}"
+msgstr "La frecuencia actual de cpu es {}"
+
+msgid "Changing cpu to maximum scaling freq"
+msgstr "Cambiando la cpu a la frecuencia máxima de escalado"
+
+msgid "Current cpu max scaling freq is {}"
+msgstr "La frecuencia máxima actual de escalado de la cpu es {}"
+
+msgid "Disabling turbo"
+msgstr "Desactivando turbo"
+
+msgid "Enabling turbo"
+msgstr "Activando turbo"
+
+msgid "Changing cpu to minimum scaling freq"
+msgstr "Cambiando la cpu a la frecuencia mínima de escalado"
+
+msgid "Leaving CPU frequency at {}"
+msgstr "Dejando la frecuencia de CPU en {}"

pycpufreq-1.0.0/src/pycpufreq/locale/fr.po

@@ -0,0 +1,62 @@
+# French translations for pycpufreq package.
+# Copyright (C) 2026 turulomio
+# This file is distributed under the same license as the pycpufreq package.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: pycpufreq 0.1.0\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2026-10-31 09:26+0100\n"
+"PO-Revision-Date: 2026-10-31 09:25+0100\n"
+"Last-Translator: turulomio <turulomio@yahoo.es>\n"
+"Language-Team: French <turulomio@yahoo.es>\n"
+"Language: fr\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+
+msgid "Error setting sys_set_cpu_max_scaling_freq"
+msgstr "Erreur lors de la définition de sys_set_cpu_max_scaling_freq"
+
+msgid "Error setting sys_set_cpu_turbo"
+msgstr "Erreur lors de la définition de sys_set_cpu_turbo"
+
+msgid "Manage and monitor CPU frequencies and turbo state."
+msgstr "Gérer et surveiller les fréquences du processeur et l'état turbo."
+
+msgid "Target final CPU scaling frequency (in kHz). If omitted, maximum frequency is used."
+msgstr "Fréquence finale cible d'échelle du processeur (en kHz). Si omise, la fréquence maximale est utilisée."
+
+msgid "Is kernel cpufreq configured?:"
+msgstr "Le cpufreq du noyau est-il configuré ? :"
+
+msgid "Invalid frequency: {}. It must be between {} and {} kHz."
+msgstr "Fréquence non valide : {}. Elle doit être comprise entre {} et {} kHz."
+
+msgid "Max cpu freq is {}"
+msgstr "La fréquence maximale du processeur est {}"
+
+msgid "Min cpu freq is {}"
+msgstr "La fréquence minimale du processeur est {}"
+
+msgid "Current cpu freq is {}"
+msgstr "La fréquence actuelle du processeur est {}"
+
+msgid "Changing cpu to maximum scaling freq"
+msgstr "Changement du processeur vers la fréquence d'échelle maximale"
+
+msgid "Current cpu max scaling freq is {}"
+msgstr "La fréquence d'échelle maximale actuelle du processeur est {}"
+
+msgid "Disabling turbo"
+msgstr "Désactivation du turbo"
+
+msgid "Enabling turbo"
+msgstr "Activation du turbo"
+
+msgid "Changing cpu to minimum scaling freq"
+msgstr "Changement du processeur vers la fréquence d'échelle minimale"
+
+msgid "Leaving CPU frequency at {}"
+msgstr "Maintien de la fréquence du processeur à {}"

pycpufreq-1.0.0/src/pycpufreq/locale/hi.po

@@ -0,0 +1,62 @@
+# Hindi translations for pycpufreq package.
+# Copyright (C) 2026 turulomio
+# This file is distributed under the same license as the pycpufreq package.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: pycpufreq 0.1.0\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2026-10-31 09:26+0100\n"
+"PO-Revision-Date: 2026-10-31 09:25+0100\n"
+"Last-Translator: turulomio <turulomio@yahoo.es>\n"
+"Language-Team: Hindi <turulomio@yahoo.es>\n"
+"Language: hi\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+
+msgid "Error setting sys_set_cpu_max_scaling_freq"
+msgstr "sys_set_cpu_max_scaling_freq सेट करने में त्रुटि"
+
+msgid "Error setting sys_set_cpu_turbo"
+msgstr "sys_set_cpu_turbo सेट करने में त्रुटि"
+
+msgid "Manage and monitor CPU frequencies and turbo state."
+msgstr "सीपीयू आवृत्तियों और टर्बो स्थिति का प्रबंधन और निगरानी करें।"
+
+msgid "Target final CPU scaling frequency (in kHz). If omitted, maximum frequency is used."
+msgstr "लक्ष्य अंतिम सीपीयू स्केलिंग आवृत्ति (kHz में)। यदि छोड़ दिया जाए, तो अधिकतम आवृत्ति का उपयोग किया जाता है।"
+
+msgid "Is kernel cpufreq configured?:"
+msgstr "क्या कर्नेल cpufreq कॉन्फ़िगर किया गया है?:"
+
+msgid "Invalid frequency: {}. It must be between {} and {} kHz."
+msgstr "अमान्य आवृत्ति: {}। यह {} और {} kHz के बीच होनी चाहिए।"
+
+msgid "Max cpu freq is {}"
+msgstr "अधिकतम सीपीयू आवृत्ति {} है"
+
+msgid "Min cpu freq is {}"
+msgstr "न्यूनतम सीपीयू आवृत्ति {} है"
+
+msgid "Current cpu freq is {}"
+msgstr "वर्तमान सीपीयू आवृत्ति {} है"
+
+msgid "Changing cpu to maximum scaling freq"
+msgstr "सीपीयू को अधिकतम स्केलिंग आवृत्ति में बदला जा रहा है"
+
+msgid "Current cpu max scaling freq is {}"
+msgstr "वर्तमान सीपीयू अधिकतम स्केलिंग आवृत्ति {} है"
+
+msgid "Disabling turbo"
+msgstr "टर्बो अक्षम किया जा रहा है"
+
+msgid "Enabling turbo"
+msgstr "टर्बो सक्षम किया जा रहा है"
+
+msgid "Changing cpu to minimum scaling freq"
+msgstr "सीपीयू को न्यूनतम स्केलिंग आवृत्ति में बदला जा रहा है"
+
+msgid "Leaving CPU frequency at {}"
+msgstr "सीपीयू आवृत्ति {} पर छोड़ी जा रही है"

pycpufreq-1.0.0/src/pycpufreq/locale/pycpufreq.pot

@@ -0,0 +1,63 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
+# This file is distributed under the same license as the PACKAGE package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2026-10-31 09:45+0100\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=CHARSET\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+msgid "Error setting sys_set_cpu_max_scaling_freq"
+msgstr ""
+
+msgid "Error setting sys_set_cpu_turbo"
+msgstr ""
+
+msgid "Manage and monitor CPU frequencies and turbo state."
+msgstr ""
+
+msgid "Target final CPU scaling frequency (in kHz). If omitted, maximum frequency is used."
+msgstr ""
+
+msgid "Is kernel cpufreq configured?:"
+msgstr ""
+
+msgid "Invalid frequency: {}. It must be between {} and {} kHz."
+msgstr ""
+
+msgid "Max cpu freq is {}"
+msgstr ""
+
+msgid "Min cpu freq is {}"
+msgstr ""
+
+msgid "Current cpu freq is {}"
+msgstr ""
+
+msgid "Changing cpu to maximum scaling freq"
+msgstr ""
+
+msgid "Current cpu max scaling freq is {}"
+msgstr ""
+
+msgid "Disabling turbo"
+msgstr ""
+
+msgid "Enabling turbo"
+msgstr ""
+
+msgid "Changing cpu to minimum scaling freq"
+msgstr ""
+
+msgid "Leaving CPU frequency at {}"
+msgstr ""

pycpufreq-1.0.0/src/pycpufreq/locale/ro.po

@@ -0,0 +1,62 @@
+# Romanian translations for pycpufreq package.
+# Copyright (C) 2026 turulomio
+# This file is distributed under the same license as the pycpufreq package.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: pycpufreq 0.1.0\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2026-10-31 09:26+0100\n"
+"PO-Revision-Date: 2026-10-31 09:25+0100\n"
+"Last-Translator: turulomio <turulomio@yahoo.es>\n"
+"Language-Team: Romanian <turulomio@yahoo.es>\n"
+"Language: ro\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1?0:(((n%100>19)||((n%100==0)&&(n!=0)))?2:1));\n"
+
+msgid "Error setting sys_set_cpu_max_scaling_freq"
+msgstr "Eroare la setarea sys_set_cpu_max_scaling_freq"
+
+msgid "Error setting sys_set_cpu_turbo"
+msgstr "Eroare la setarea sys_set_cpu_turbo"
+
+msgid "Manage and monitor CPU frequencies and turbo state."
+msgstr "Gestionați și monitorizați frecvențele procesorului și starea turbo."
+
+msgid "Target final CPU scaling frequency (in kHz). If omitted, maximum frequency is used."
+msgstr "Frecvența finală țintă de scalare a procesorului (în kHz). Dacă este omisă, se utilizează frecvența maximă."
+
+msgid "Is kernel cpufreq configured?:"
+msgstr "Este configurat cpufreq în nucleu?:"
+
+msgid "Invalid frequency: {}. It must be between {} and {} kHz."
+msgstr "Frecvență nevalidă: {}. Trebuie să fie între {} și {} kHz."
+
+msgid "Max cpu freq is {}"
+msgstr "Frecvența maximă a procesorului este {}"
+
+msgid "Min cpu freq is {}"
+msgstr "Frecvența minimă a procesorului este {}"
+
+msgid "Current cpu freq is {}"
+msgstr "Frecvența curentă a procesorului este {}"
+
+msgid "Changing cpu to maximum scaling freq"
+msgstr "Se schimbă procesorul la frecvența maximă de scalare"
+
+msgid "Current cpu max scaling freq is {}"
+msgstr "Frecvența maximă curentă de scalare a procesorului este {}"
+
+msgid "Disabling turbo"
+msgstr "Se dezactivează turbo"
+
+msgid "Enabling turbo"
+msgstr "Se activează turbo"
+
+msgid "Changing cpu to minimum scaling freq"
+msgstr "Se schimbă procesorul la frecvența minimă de scalare"
+
+msgid "Leaving CPU frequency at {}"
+msgstr "Se lasă frecvența procesorului la {}"

pycpufreq-1.0.0/src/pycpufreq/locale/ru.po

@@ -0,0 +1,62 @@
+# Russian translations for pycpufreq package.
+# Copyright (C) 2026 turulomio
+# This file is distributed under the same license as the pycpufreq package.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: pycpufreq 0.1.0\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2026-10-31 09:26+0100\n"
+"PO-Revision-Date: 2026-10-31 09:25+0100\n"
+"Last-Translator: turulomio <turulomio@yahoo.es>\n"
+"Language-Team: Russian <turulomio@yahoo.es>\n"
+"Language: ru\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n"
+
+msgid "Error setting sys_set_cpu_max_scaling_freq"
+msgstr "Ошибка при установке sys_set_cpu_max_scaling_freq"
+
+msgid "Error setting sys_set_cpu_turbo"
+msgstr "Ошибка при установке sys_set_cpu_turbo"
+
+msgid "Manage and monitor CPU frequencies and turbo state."
+msgstr "Управление и мониторинг частот процессора и состояния турбо."
+
+msgid "Target final CPU scaling frequency (in kHz). If omitted, maximum frequency is used."
+msgstr "Целевая конечная частота масштабирования процессора (в кГц). Если не указана, используется максимальная частота."
+
+msgid "Is kernel cpufreq configured?:"
+msgstr "Настроен ли cpufreq ядра?:"
+
+msgid "Invalid frequency: {}. It must be between {} and {} kHz."
+msgstr "Недопустимая частота: {}. Она должна быть в диапазоне от {} до {} кГц."
+
+msgid "Max cpu freq is {}"
+msgstr "Максимальная частота процессора: {}"
+
+msgid "Min cpu freq is {}"
+msgstr "Минимальная частота процессора: {}"
+
+msgid "Current cpu freq is {}"
+msgstr "Текущая частота процессора: {}"
+
+msgid "Changing cpu to maximum scaling freq"
+msgstr "Переключение процессора на максимальную частоту масштабирования"
+
+msgid "Current cpu max scaling freq is {}"
+msgstr "Текущая максимальная частота масштабирования процессора: {}"
+
+msgid "Disabling turbo"
+msgstr "Отключение турбо"
+
+msgid "Enabling turbo"
+msgstr "Включение турбо"
+
+msgid "Changing cpu to minimum scaling freq"
+msgstr "Переключение процессора на минимальную частоту масштабирования"
+
+msgid "Leaving CPU frequency at {}"
+msgstr "Установка частоты процессора на уровне {}"

pycpufreq-1.0.0/src/pycpufreq/locale/zh.po

@@ -0,0 +1,62 @@
+# Chinese translations for pycpufreq package.
+# Copyright (C) 2026 turulomio
+# This file is distributed under the same license as the pycpufreq package.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: pycpufreq 0.1.0\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2026-10-31 09:26+0100\n"
+"PO-Revision-Date: 2026-10-31 09:25+0100\n"
+"Last-Translator: turulomio <turulomio@yahoo.es>\n"
+"Language-Team: Chinese <turulomio@yahoo.es>\n"
+"Language: zh\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=1; plural=0;\n"
+
+msgid "Error setting sys_set_cpu_max_scaling_freq"
+msgstr "设置 sys_set_cpu_max_scaling_freq 时出错"
+
+msgid "Error setting sys_set_cpu_turbo"
+msgstr "设置 sys_set_cpu_turbo 时出错"
+
+msgid "Manage and monitor CPU frequencies and turbo state."
+msgstr "管理和监控 CPU 频率以及 Turbo 状态。"
+
+msgid "Target final CPU scaling frequency (in kHz). If omitted, maximum frequency is used."
+msgstr "目标最终 CPU 调节频率（单位 kHz）。若省略，则使用最大频率。"
+
+msgid "Is kernel cpufreq configured?:"
+msgstr "内核 cpufreq 是否已配置？:"
+
+msgid "Invalid frequency: {}. It must be between {} and {} kHz."
+msgstr "无效频率：{}。必须介于 {} 和 {} kHz 之间。"
+
+msgid "Max cpu freq is {}"
+msgstr "CPU 最大频率为 {}"
+
+msgid "Min cpu freq is {}"
+msgstr "CPU 最小频率为 {}"
+
+msgid "Current cpu freq is {}"
+msgstr "CPU 当前频率为 {}"
+
+msgid "Changing cpu to maximum scaling freq"
+msgstr "正在将 CPU 更改为最大调节频率"
+
+msgid "Current cpu max scaling freq is {}"
+msgstr "当前 CPU 最大调节频率为 {}"
+
+msgid "Disabling turbo"
+msgstr "正在禁用 Turbo"
+
+msgid "Enabling turbo"
+msgstr "正在启用 Turbo"
+
+msgid "Changing cpu to minimum scaling freq"
+msgstr "正在将 CPU 更改为最小调节频率"
+
+msgid "Leaving CPU frequency at {}"
+msgstr "将 CPU 频率保持在 {}"

pycpufreq-1.0.0/src/pycpufreq/poethepoet.py

@@ -0,0 +1,70 @@
+from pathlib import Path
+import subprocess
+from pycpufreq.version import __version__
+from pycpufreq.i18n import _
+
+LANGUAGES = ["es", "fr", "ro", "ru", "zh", "hi"]
+PACKAGE_DIR = Path(__file__).resolve().parent
+LOCALE_DIR = PACKAGE_DIR / "locale"
+POT_FILE = LOCALE_DIR / "pycpufreq.pot"
+
+
+def translate() -> None:
+    """Extract translatable strings, update PO catalogs, and compile MO binary files."""
+    LOCALE_DIR.mkdir(parents=True, exist_ok=True)
+    python_files = [str(p) for p in PACKAGE_DIR.glob("*.py") if p.name != "poethepoet.py"]
+
+    subprocess.run(
+        [
+            "xgettext",
+            "-L", "Python",
+            "--no-wrap",
+            "--no-location",
+            "--from-code=UTF-8",
+            "-o", str(POT_FILE),
+            *python_files,
+        ],
+        check=True,
+    )
+
+    for lang in LANGUAGES:
+        lang_dir = LOCALE_DIR / lang / "LC_MESSAGES"
+        lang_dir.mkdir(parents=True, exist_ok=True)
+        po_file = LOCALE_DIR / f"{lang}.po"
+
+        if not po_file.exists():
+            res = subprocess.run(
+                ["msginit", "--no-translator", "-l", f"{lang}.UTF-8", "-i", str(POT_FILE), "-o", str(po_file)],
+                capture_output=True,
+            )
+            if res.returncode != 0:
+                po_file.write_bytes(POT_FILE.read_bytes())
+
+        subprocess.run(
+            ["msgmerge", "-N", "--no-wrap", "-U", str(po_file), str(POT_FILE)],
+            check=True,
+        )
+        mo_file = lang_dir / "pycpufreq.mo"
+        subprocess.run(
+            ["msgfmt", "-cv", "-o", str(mo_file), str(po_file)],
+            check=True,
+        )
+
+
+def release() -> None:
+    """Print the step-by-step checklist for publishing a new release."""
+    print(_("New Release:"))
+    print(_("  * Change version and date in src/pycpufreq/version.py"))
+    print(_("  * Change version in pyproject.toml"))
+    print(_("  * Edit Changelog in README.md"))
+    print("  * poe translate")
+    print("  * mcedit src/pycpufreq/locale/es.po")
+    print("  * poe translate")
+    print("  * poe test")
+    print(f"  * git commit -a -m 'pycpufreq-{__version__}'")
+    print("  * git push")
+    print(_("  * Make a new tag in github"))
+    print("  * uv build")
+    print("  * uv publish")
+    print(_("  * Create a new gentoo ebuild with the new version"))
+    print(_("  * Upload to portage repository"))

pycpufreq-1.0.0/src/pycpufreq/version.py

@@ -0,0 +1,5 @@
+from datetime import datetime
+
+__version__ = "1.0.0"
+__version_datetime__ = datetime(2026, 10, 31, 9, 45, 0)
+__version_date__ = __version_datetime__.date()