File Manager

✏️ t/values.py

import os
from threading import Lock
from typing import Callable, List
import warnings

from .mmap_dict import mmap_key, MmapedDict

_multi_process_cleanups: List[Callable[[], None]] = []

def close_all_multiprocess_files():
    for cleanup in _multi_process_cleanups:
        cleanup()
    _multi_process_cleanups.clear()

class MutexValue:
    """A float protected by a mutex."""

_multiprocess = False

def __init__(self, typ, metric_name, name, labelnames, labelvalues, help_text, **kwargs):
        self._value = 0.0
        self._exemplar = None
        self._lock = Lock()

def inc(self, amount):
        with self._lock:
            self._value += amount

def set(self, value, timestamp=None):
        with self._lock:
            self._value = value

def set_exemplar(self, exemplar):
        with self._lock:
            self._exemplar = exemplar

def get(self):
        with self._lock:
            return self._value

def get_exemplar(self):
        with self._lock:
            return self._exemplar

def MultiProcessValue(process_identifier=os.getpid):
    """Returns a MmapedValue class based on a process_identifier function.

The 'process_identifier' function MUST comply with this simple rule:
    when called in simultaneously running processes it MUST return distinct values.

Using a different function than the default 'os.getpid' is at your own risk.
    """
    files = {}
    values = []
    pid = {'value': process_identifier()}
    # Use a single global lock when in multi-processing mode
    # as we presume this means there is no threading going on.
    # This avoids the need to also have mutexes in __MmapDict.
    lock = Lock()

def cleanup():
        for f in files.values():
            f.close()
        files.clear()
        values.clear()
    _multi_process_cleanups.append(cleanup)

class MmapedValue:
        """A float protected by a mutex backed by a per-process mmaped file."""

_multiprocess = True

def __init__(self, typ, metric_name, name, labelnames, labelvalues, help_text, multiprocess_mode='', **kwargs):
            self._params = typ, metric_name, name, labelnames, labelvalues, help_text, multiprocess_mode
            # This deprecation warning can go away in a few releases when removing the compatibility
            if 'prometheus_multiproc_dir' in os.environ and 'PROMETHEUS_MULTIPROC_DIR' not in os.environ:
                os.environ['PROMETHEUS_MULTIPROC_DIR'] = os.environ['prometheus_multiproc_dir']
                warnings.warn("prometheus_multiproc_dir variable has been deprecated in favor of the upper case naming PROMETHEUS_MULTIPROC_DIR", DeprecationWarning)
            with lock:
                self.__check_for_pid_change()
                self.__reset()
                values.append(self)

def __reset(self):
            typ, metric_name, name, labelnames, labelvalues, help_text, multiprocess_mode = self._params
            if typ == 'gauge':
                file_prefix = typ + '_' + multiprocess_mode
            else:
                file_prefix = typ
            if file_prefix not in files:
                filename = os.path.join(
                    os.environ.get('PROMETHEUS_MULTIPROC_DIR'),
                    '{}_{}.db'.format(file_prefix, pid['value']))

files[file_prefix] = MmapedDict(filename)
            self._file = files[file_prefix]
            self._key = mmap_key(metric_name, name, labelnames, labelvalues, help_text)
            self._value, self._timestamp = self._file.read_value(self._key)

def __check_for_pid_change(self):
            actual_pid = process_identifier()
            if pid['value'] != actual_pid:
                pid['value'] = actual_pid
                # There has been a fork(), reset all the values.
                for f in files.values():
                    f.close()
                files.clear()
                for value in values:
                    value.__reset()

def inc(self, amount):
            with lock:
                self.__check_for_pid_change()
                self._value += amount
                self._timestamp = 0.0
                self._file.write_value(self._key, self._value, self._timestamp)

def set(self, value, timestamp=None):
            with lock:
                self.__check_for_pid_change()
                self._value = value
                self._timestamp = timestamp or 0.0
                self._file.write_value(self._key, self._value, self._timestamp)

def set_exemplar(self, exemplar):
            # TODO: Implement exemplars for multiprocess mode.
            return

def get(self):
            with lock:
                self.__check_for_pid_change()
                return self._value

def get_exemplar(self):
            # TODO: Implement exemplars for multiprocess mode.
            return None

@classmethod
        def close_all_files(cls):
            with lock:
                for f in files.values():
                    f.close()
                files.clear()
                values.clear()

return MmapedValue

def get_value_class():
    # Should we enable multi-process mode?
    # This needs to be chosen before the first metric is constructed,
    # and as that may be in some arbitrary library the user/admin has
    # no control over we use an environment variable.
    if 'prometheus_multiproc_dir' in os.environ or 'PROMETHEUS_MULTIPROC_DIR' in os.environ:
        return MultiProcessValue()
    else:
        return MutexValue

ValueClass = get_value_class()

Batal

⬅ site-packages 26 item

Nama	Tipe	Ukuran	Diubah	Aksi
📁__pycache__	dir	—	2026-07-29 13:48	📂 Buka
📁aiohttp	dir	—	2026-07-29 13:48	📂 Buka
📁bridge	dir	—	2026-07-29 13:48	📂 Buka
📁django	dir	—	2026-07-29 13:48	📂 Buka
📁openmetrics	dir	—	2026-07-29 13:48	📂 Buka
📁twisted	dir	—	2026-07-29 13:48	📂 Buka
🐍__init__.py	py	1.9 KB	2026-07-29 13:48	✏️ 👁️
🐍asgi.py	py	1.6 KB	2026-07-29 13:48	✏️ 👁️
🐍context_managers.py	py	2.3 KB	2026-07-29 13:48	✏️ 👁️
🐍core.py	py	978 B	2026-07-29 13:48	✏️ 👁️
🐍decorator.py	py	15.4 KB	2026-07-29 13:48	✏️ 👁️
🐍exposition.py	py	32.2 KB	2026-07-29 13:48	✏️ 👁️
🐍gc_collector.py	py	1.5 KB	2026-07-29 13:48	✏️ 👁️
🐍metrics.py	py	28.9 KB	2026-07-29 13:48	✏️ 👁️
🐍metrics_core.py	py	15.2 KB	2026-07-29 13:48	✏️ 👁️
🐍mmap_dict.py	py	5.3 KB	2026-07-29 13:48	✏️ 👁️
🐍multiprocess.py	py	7.9 KB	2026-07-29 13:48	✏️ 👁️
🐍parser.py	py	12.3 KB	2026-07-29 13:48	✏️ 👁️
🐍platform_collector.py	py	1.8 KB	2026-07-29 13:48	✏️ 👁️
🐍process_collector.py	py	3.8 KB	2026-07-29 13:48	✏️ 👁️
📄py.typed	typed	0 B	2026-07-29 13:48	✏️ 👁️
🐍registry.py	py	6.6 KB	2026-07-29 13:48	✏️ 👁️
🐍samples.py	py	2.3 KB	2026-07-29 13:48	✏️ 👁️
🐍utils.py	py	910 B	2026-07-29 13:48	✏️ 👁️
🐍validation.py	py	4.1 KB	2026-07-29 13:48	✏️ 👁️
🐍values.py	py	5.5 KB	2026-07-29 13:48	✏️ 👁️

✏️ Rename