xtlsapi-ipblacklist 3.3.2__tar.gz

xtlsapi_ipblacklist-3.3.2/Containerfile

@@ -0,0 +1,5 @@
+FROM python:3.7-alpine
+COPY . /app
+WORKDIR /app
+RUN pip install .
+CMD ["xtlsapi"]

xtlsapi_ipblacklist-3.3.2/LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <https://unlicense.org>

xtlsapi_ipblacklist-3.3.2/MANIFEST.in

@@ -0,0 +1,5 @@
+include LICENSE
+include HISTORY.md
+include Containerfile
+graft tests
+graft xtlsapi

xtlsapi_ipblacklist-3.3.2/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: xtlsapi-ipblacklist
+Version: 3.3.2
+Summary: Fork of the xtlsapi library with an ip blacklist feature
+Home-page: https://github.com/hiddify/xtlsapi/
+Author: klirii
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: grpcio
+Requires-Dist: grpcio-tools<2.0.0
+Requires-Dist: protobuf==5.29.0
+Dynamic: home-page
+Dynamic: license-file
+
+
+# xtlsapi
+
+[![codecov](https://codecov.io/gh/hiddify/xtlsapi/branch/main/graph/badge.svg?token=xtlsapi_token_here)](https://codecov.io/gh/hiddify/xtlsapi)
+[![CI](https://github.com/hiddify/xtlsapi/actions/workflows/main.yml/badge.svg)](https://github.com/hiddify/xtlsapi/actions/workflows/main.yml)
+
+
+Python library to communicate with xray core
+
+## Install it from PyPI
+
+```bash
+pip install xtlsapi
+```
+
+## Usage
+
+```py
+from xtlsapi import XrayClient, utils, exceptions
+
+xray_client = XrayClient('1.2.3.4', 1234)
+user_id = utils.generate_random_user_id()
+user_email = utils.generate_random_email()
+inbound_tag = 'inbound-tag'
+
+# Get stats
+print(utils.human_readable_bytes(xray_client.get_client_download_traffic('user-email@mail.com')))
+print(utils.human_readable_bytes(xray_client.get_client_upload_traffic('user-email@mail.com')))
+print(utils.human_readable_bytes(xray_client.get_inbound_download_traffic(inbound_tag)))
+print(utils.human_readable_bytes(xray_client.get_inbound_upload_traffic(inbound_tag)))
+
+# Add & Remove client
+user = xray_client.add_client(inbound_tag, user_id, user_email)
+if user:
+    print(user)
+    xray_client.remove_client(inbound_tag, user_email)
+
+# restart logger
+xray_client.restart_logger()
+```
+
+## Development
+
+Read the [CONTRIBUTING.md](CONTRIBUTING.md) file.

xtlsapi_ipblacklist-3.3.2/README.md

@@ -0,0 +1,44 @@
+
+# xtlsapi
+
+[![codecov](https://codecov.io/gh/hiddify/xtlsapi/branch/main/graph/badge.svg?token=xtlsapi_token_here)](https://codecov.io/gh/hiddify/xtlsapi)
+[![CI](https://github.com/hiddify/xtlsapi/actions/workflows/main.yml/badge.svg)](https://github.com/hiddify/xtlsapi/actions/workflows/main.yml)
+
+
+Python library to communicate with xray core
+
+## Install it from PyPI
+
+```bash
+pip install xtlsapi
+```
+
+## Usage
+
+```py
+from xtlsapi import XrayClient, utils, exceptions
+
+xray_client = XrayClient('1.2.3.4', 1234)
+user_id = utils.generate_random_user_id()
+user_email = utils.generate_random_email()
+inbound_tag = 'inbound-tag'
+
+# Get stats
+print(utils.human_readable_bytes(xray_client.get_client_download_traffic('user-email@mail.com')))
+print(utils.human_readable_bytes(xray_client.get_client_upload_traffic('user-email@mail.com')))
+print(utils.human_readable_bytes(xray_client.get_inbound_download_traffic(inbound_tag)))
+print(utils.human_readable_bytes(xray_client.get_inbound_upload_traffic(inbound_tag)))
+
+# Add & Remove client
+user = xray_client.add_client(inbound_tag, user_id, user_email)
+if user:
+    print(user)
+    xray_client.remove_client(inbound_tag, user_email)
+
+# restart logger
+xray_client.restart_logger()
+```
+
+## Development
+
+Read the [CONTRIBUTING.md](CONTRIBUTING.md) file.

xtlsapi_ipblacklist-3.3.2/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "xtlsapi-ipblacklist"
+version = "3.3.2"
+description = "Fork of the xtlsapi library with an ip blacklist feature"
+authors = [
+    { name="klirii" }
+]
+readme = "README.md"
+dependencies = [
+    "grpcio",
+    "grpcio-tools<2.0.0",
+    "protobuf==5.29.0"
+]
+
+[tool.setuptools.packages.find]
+where = ["."]

xtlsapi_ipblacklist-3.3.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

xtlsapi_ipblacklist-3.3.2/setup.py

@@ -0,0 +1,50 @@
+"""Python setup.py for xtlsapi package"""
+import io
+import os
+from setuptools import find_packages, setup
+
+
+def read(*paths, **kwargs):
+    """Read the contents of a text file safely.
+    >>> read("xtlsapi", "VERSION")
+    '0.1.0'
+    >>> read("README.md")
+    ...
+    """
+
+    content = ""
+    with io.open(
+        os.path.join(os.path.dirname(__file__), *paths),
+        encoding=kwargs.get("encoding", "utf8"),
+    ) as open_file:
+        content = open_file.read().strip()
+    return content
+
+
+def read_requirements(path):
+    return [
+        line.strip()
+        for line in read(path).split("\n")
+        if not line.startswith(('"', "#", "-", "git+"))
+    ]
+
+
+setup(
+    name="xtlsapi",
+    version=read("xtlsapi", "VERSION"),
+    description="Awesome xtlsapi created by hiddify",
+    url="https://github.com/hiddify/xtlsapi/",
+    long_description=read("README.md"),
+    long_description_content_type="text/markdown",
+    author="hiddify",
+    packages=find_packages(exclude=["tests", ".github"]),
+    install_requires=[
+        "grpcio",
+        "grpcio-tools<2.0.0",
+        "protobuf==5.29.0",
+    ],
+    entry_points={
+        "console_scripts": ["xtlsapi = xtlsapi.__main__:main"]
+    },
+    # extras_require={"test": read_requirements("requirements-test.txt")},
+)

xtlsapi_ipblacklist-3.3.2/tests/conftest.py

@@ -0,0 +1,14 @@
+import sys
+import pytest
+
+
+# each test runs on cwd to its temp dir
+@pytest.fixture(autouse=True)
+def go_to_tmpdir(request):
+    # Get the fixture dynamically by its name.
+    tmpdir = request.getfixturevalue("tmpdir")
+    # ensure local test created packages can be imported
+    sys.path.insert(0, str(tmpdir))
+    # Chdir only for the duration of the test.
+    with tmpdir.as_cwd():
+        yield

xtlsapi_ipblacklist-3.3.2/tests/test_base.py

@@ -0,0 +1,5 @@
+from xtlsapi.base import NAME
+
+
+def test_base():
+    assert NAME == "xtlsapi"

xtlsapi_ipblacklist-3.3.2/tests/test_block_ips.py

@@ -0,0 +1,9 @@
+import pytest
+from unittest.mock import patch
+from xtlsapi import XrayClient
+
+def test_stats_online_ip_list():
+    xray = XrayClient("127.0.0.1", 53357)
+    with patch.object(xray, 'stats_online_ip_list', return_value={'212.58.119.246': 1763418412}):
+        result = xray.stats_online_ip_list("1")
+        assert result == {'212.58.119.246': 1763418412}

xtlsapi_ipblacklist-3.3.2/tests/test_stats_online_ip_list.py

@@ -0,0 +1,14 @@
+import pytest
+from unittest.mock import patch
+from xtlsapi import XrayClient
+from xtlsapi.xray_api.app.router.command import command_pb2
+
+
+def test_stats_online_ip_list():
+    xray = XrayClient("127.0.0.1", 53357)
+    with patch.object(xray, 'block_ips', return_value=command_pb2.AddRuleResponse()):
+        xray.block_ips(
+            ips=["103.23.202.74"],
+            inbound_tag="vless-in"
+        )
+        assert xray

xtlsapi_ipblacklist-3.3.2/xtlsapi/VERSION

@@ -0,0 +1 @@
+3.3.0

xtlsapi_ipblacklist-3.3.2/xtlsapi/__init__.py

@@ -0,0 +1,4 @@
+from xtlsapi.client.XrayClient import XrayClient
+from xtlsapi.client.SingboxClient import SingboxClient
+import xtlsapi.exceptions
+from xtlsapi.ext import utils

xtlsapi_ipblacklist-3.3.2/xtlsapi/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for xtlsapi."""
+
+from .cli import main  # pragma: no cover
+
+if __name__ == "__main__":  # pragma: no cover
+    main()

xtlsapi_ipblacklist-3.3.2/xtlsapi/api_services/__init__.py

@@ -0,0 +1,8 @@
+from .stats import StatsAPIService
+from .handler import HandlerAPIService
+from .logger import LoggerAPIService
+from .router import RouterAPIService
+
+
+class APIService(StatsAPIService, HandlerAPIService, LoggerAPIService, RouterAPIService):
+    pass

xtlsapi_ipblacklist-3.3.2/xtlsapi/api_services/_base.py

@@ -0,0 +1,12 @@
+from xtlsapi.xray_api.app.log.command import config_pb2_grpc as logger_pb2_grpc
+from xtlsapi.xray_api.app.stats.command import command_pb2_grpc as stats_pb2_grpc
+from xtlsapi.xray_api.app.proxyman.command import command_pb2_grpc as handler_pb2_grpc
+from xtlsapi.xray_api.app.router.command import command_pb2_grpc as router_pb2_grpc
+
+
+class BaseService:
+    def __init__(self):
+        self.stats_stub = stats_pb2_grpc.StatsServiceStub(self._channel)
+        self.logger_stub = logger_pb2_grpc.LoggerServiceStub(self._channel)
+        self.handler_stub = handler_pb2_grpc.HandlerServiceStub(self._channel)
+        self.routing_stub = router_pb2_grpc.RoutingServiceStub(self._channel)

xtlsapi_ipblacklist-3.3.2/xtlsapi/api_services/handler/__init__.py

@@ -0,0 +1,6 @@
+from .add_client import AddClient
+from .remove_client import RemoveClient
+
+
+class HandlerAPIService(AddClient, RemoveClient):
+    pass

xtlsapi_ipblacklist-3.3.2/xtlsapi/api_services/handler/add_client.py

@@ -0,0 +1,66 @@
+from grpc._channel import _InactiveRpcError
+
+from xtlsapi.xray_api.common.protocol import user_pb2
+from xtlsapi.xray_api.app.proxyman.command import command_pb2
+from xtlsapi.ext import utils
+from .._base import BaseService
+from xtlsapi import exceptions
+
+
+class AddClient(BaseService):
+    def add_client(self, inbound_tag, user_id_or_password, email,protocol='vless', level=None, alter_id=None,flow=None,cipher=None):
+        try:
+            if protocol=='vmess':
+                from xtlsapi.xray_api.proxy.vmess import account_pb2
+                account=account_pb2.Account(id=user_id_or_password)
+            elif protocol=='vless':
+                from xtlsapi.xray_api.proxy.vless import account_pb2
+                account=account_pb2.Account(id=user_id_or_password,flow=flow,encryption="none")
+            elif protocol=='trojan':
+                from xtlsapi.xray_api.proxy.trojan import config_pb2
+                account=config_pb2.Account(password=user_id_or_password,flow=flow)
+            elif protocol=='shadowsocks':
+                from xtlsapi.xray_api.proxy.shadowsocks import config_pb2
+                cipher_map={'aes_128_gcm':config_pb2.CipherType.AES_128_GCM,
+                            'aes_256_gcm':config_pb2.CipherType.AES_256_GCM,
+                            'chacha20_poly1305':config_pb2.CipherType.CHACHA20_POLY1305,
+                            'xchacha20_poly1305':config_pb2.CipherType.XCHACHA20_POLY1305,
+                            None:config_pb2.CipherType.NONE                            
+                            }
+                account=config_pb2.Account(password=user_id_or_password,cipher_type=cipher_map.get(cipher,cipher_map[None]))
+            # elif protocol=='shadowsocks_2022':
+                # from xtlsapi.xray_api.proxy.shadowsocks import config_pb2
+                # cipher_map={'aes_128_gcm':config_pb2.CipherType.AES_128_GCM,
+                #             'aes_256_gcm':config_pb2.CipherType.AES_256_GCM,
+                #             'chacha20_poly1305':config_pb2.CipherType.CHACHA20_POLY1305,
+                #             'xchacha20_poly1305':config_pb2.CipherType.XCHACHA20_POLY1305,
+                #             None:config_pb2.CipherType.NONE                            
+                #             }
+                # account=config_pb2.Account(password=user_id_or_password,cipher_type=cipher_map.get(cipher,cipher_map[None])
+                # raise Exception("not implemented ")
+            else:
+                raise Exception("not implemented "+protocol )
+            
+            self.handler_stub.AlterInbound(
+                command_pb2.AlterInboundRequest(
+                    tag=inbound_tag,
+                    operation=utils.to_typed_message(
+                        command_pb2.AddUserOperation(
+                            user=user_pb2.User(
+                                email=email,
+                                level=level,
+                                account=utils.to_typed_message(account),
+                            )
+                        )
+                    ),
+                )
+            )
+            return user_id_or_password
+        except _InactiveRpcError as e:
+            details = e.details()
+            if details.endswith(f"User {email} already exists."):
+                raise exceptions.EmailAlreadyExists(details, email)
+            elif details.endswith(f"handler not found: {inbound_tag}"):
+                raise exceptions.InboundNotFound(details, inbound_tag)
+            else:
+                raise exceptions.XRayException(details)

xtlsapi_ipblacklist-3.3.2/xtlsapi/api_services/handler/remove_client.py

@@ -0,0 +1,27 @@
+from grpc._channel import _InactiveRpcError
+from xtlsapi.ext import utils
+from xtlsapi import exceptions
+from xtlsapi.xray_api.app.proxyman.command import command_pb2
+
+from .._base import BaseService
+
+
+class RemoveClient(BaseService):
+    def remove_client(self, inbound_tag, email):
+        try:
+            self.handler_stub.AlterInbound(
+                command_pb2.AlterInboundRequest(
+                    tag=inbound_tag,
+                    operation=utils.to_typed_message(
+                        command_pb2.RemoveUserOperation(email=email)
+                    ),
+                )
+            )
+        except _InactiveRpcError as e:
+            details = e.details()
+            if details.endswith(f"User {email} not found."):
+                raise exceptions.EmailNotFound(details, email)
+            elif details.endswith(f"handler not found: {inbound_tag}"):
+                raise exceptions.InboundNotFound(details, inbound_tag)
+            else:
+                raise exceptions.XRayException(details)

xtlsapi_ipblacklist-3.3.2/xtlsapi/api_services/logger/__init__.py

@@ -0,0 +1,5 @@
+from .restart_logger import RestartLogger
+
+
+class LoggerAPIService(RestartLogger):
+    pass

xtlsapi_ipblacklist-3.3.2/xtlsapi/api_services/logger/restart_logger.py

@@ -0,0 +1,17 @@
+from grpc._channel import _InactiveRpcError
+
+from xtlsapi import exceptions
+from xtlsapi.xray_api.app.log.command import config_pb2
+
+from .._base import BaseService
+
+
+class RestartLogger(BaseService):
+    def restart_logger(self):
+        try:
+            self.logger_stub.RestartLogger(
+                config_pb2.RestartLoggerRequest()
+            )
+        except _InactiveRpcError as e:
+            details = e.details()
+            raise exceptions.XRayException(details)

xtlsapi_ipblacklist-3.3.2/xtlsapi/api_services/router/__init__.py

@@ -0,0 +1,7 @@
+from .block_ips import RouterBlockIps
+
+
+class RouterAPIService(
+    RouterBlockIps,
+):
+    pass

xtlsapi_ipblacklist-3.3.2/xtlsapi/api_services/router/block_ips.py

@@ -0,0 +1,60 @@
+import grpc
+import ipaddress
+
+from xtlsapi.api_services._base import BaseService
+from xtlsapi.xray_api.app.router.command import command_pb2
+from xtlsapi.xray_api.common.serial import typed_message_pb2
+from xtlsapi.xray_api.app.router import config_pb2
+
+
+class RouterBlockIps(BaseService):
+
+    def block_ips(
+        self,
+        ips: list[str],
+        inbound_tag: str,
+        rule_tag: str = "sourceIpBlock",
+        outbound_tag: str = "blocked",
+    ):
+        try:
+            self.routing_stub.RemoveRule(
+                command_pb2.RemoveRuleRequest(ruleTag=rule_tag)
+            )
+
+            if not ips:
+                return None
+
+            rule = config_pb2.RoutingRule()
+            rule.rule_tag = rule_tag
+            rule.inbound_tag.extend([inbound_tag] if inbound_tag else [])
+            rule.tag = outbound_tag
+
+            for ip in ips:
+                net = ipaddress.ip_network(ip, strict=False)
+
+                cidr = config_pb2.CIDR()
+                cidr.ip = net.network_address.packed
+                cidr.prefix = net.prefixlen
+
+                geo = config_pb2.GeoIP()
+                geo.cidr.append(cidr)
+
+                rule.source_geoip.append(geo)
+
+            config = config_pb2.Config()
+            config.rule.append(rule)
+
+            typed_msg = typed_message_pb2.TypedMessage(
+                type="xray.app.router.Config",
+                value=config.SerializeToString(),
+            )
+
+            return self.routing_stub.AddRule(
+                command_pb2.AddRuleRequest(
+                    config=typed_msg,
+                    shouldAppend=True,
+                )
+            )
+
+        except grpc.RpcError as e:
+            raise e

xtlsapi_ipblacklist-3.3.2/xtlsapi/api_services/stats/__init__.py

@@ -0,0 +1,22 @@
+from .get_client_upload_traffic import GetClientUploadTraffic
+from .get_client_download_traffic import GetClientDownloadTraffic
+from .get_inbound_upload_traffic import GetInboundUploadTraffic
+from .get_inbound_download_traffic import GetInboundDownloadTraffic
+from .get_total_upload_traffic import GetTotalUploadTraffic
+from .get_total_download_traffic import GetTotalDownloadTraffic
+from .get_statsquery import StatsQuery
+from .get_statsonline import StatsOnline
+from .get_stats_online_ip_list import StatsOnlineIpList
+
+class StatsAPIService(
+    GetClientUploadTraffic,
+    GetClientDownloadTraffic,
+    GetInboundUploadTraffic,
+    GetInboundDownloadTraffic,
+    GetTotalUploadTraffic,
+    GetTotalDownloadTraffic,
+    StatsQuery,
+    StatsOnline,
+    StatsOnlineIpList
+):
+    pass

xtlsapi_ipblacklist-3.3.2/xtlsapi/api_services/stats/get_client_download_traffic.py

@@ -0,0 +1,17 @@
+import grpc
+from xtlsapi.xray_api.app.stats.command import command_pb2
+
+from .._base import BaseService
+
+
+class GetClientDownloadTraffic(BaseService):
+    def get_client_download_traffic(self, email, reset=False):
+        try:
+            return self.stats_stub.GetStats(
+                command_pb2.GetStatsRequest(
+                    name=f"user>>>{email}>>>traffic>>>downlink", reset=reset
+                )
+            ).stat.value
+        except grpc.RpcError:
+            # raise
+            return None

xtlsapi_ipblacklist-3.3.2/xtlsapi/api_services/stats/get_client_upload_traffic.py

@@ -0,0 +1,15 @@
+import grpc
+from xtlsapi.xray_api.app.stats.command import command_pb2
+from .._base import BaseService
+
+
+class GetClientUploadTraffic(BaseService):
+    def get_client_upload_traffic(self, email, reset=False):
+        try:
+            return self.stats_stub.GetStats(
+                command_pb2.GetStatsRequest(
+                    name=f"user>>>{email}>>>traffic>>>uplink", reset=reset
+                )
+            ).stat.value
+        except grpc.RpcError:
+            return None

xtlsapi_ipblacklist-3.3.2/xtlsapi/api_services/stats/get_inbound_download_traffic.py

@@ -0,0 +1,16 @@
+import grpc
+from xtlsapi.xray_api.app.stats.command import command_pb2
+from .._base import BaseService
+
+
+class GetInboundDownloadTraffic(BaseService):
+    def get_inbound_download_traffic(self, tag, reset=False):
+        try:
+            return self.stats_stub.GetStats(
+                command_pb2.GetStatsRequest(
+                    name=f"inbound>>>{tag}>>>traffic>>>downlink", reset=reset
+                )
+            ).stat.value
+        except grpc.RpcError:
+            # raise
+            return None

xtlsapi_ipblacklist-3.3.2/xtlsapi/api_services/stats/get_inbound_upload_traffic.py

@@ -0,0 +1,16 @@
+import grpc
+from xtlsapi.xray_api.app.stats.command import command_pb2
+from .._base import BaseService
+
+
+class GetInboundUploadTraffic(BaseService):
+    def get_inbound_upload_traffic(self, tag, reset=False):
+        try:
+            return self.stats_stub.GetStats(
+                command_pb2.GetStatsRequest(
+                    name=f"inbound>>>{tag}>>>traffic>>>uplink", reset=reset
+                )
+            ).stat.value
+        except grpc.RpcError:
+            # raise
+            return None

xtlsapi_ipblacklist-3.3.2/xtlsapi/api_services/stats/get_stats_online_ip_list.py

@@ -0,0 +1,28 @@
+import grpc
+from xtlsapi.xray_api.app.stats.command import command_pb2
+
+from .._base import BaseService
+
+
+class StatsOnlineIpList(BaseService):
+    def stats_online_ip_list(self, user, reset=False) -> dict:
+	"""
+	Returns a dictionary of online IPs for the given user.
+
+	Args:
+	    user: The email of the user to query.
+
+	Returns:
+	    A dictionary mapping IP addresses to last cleanup time of expired ip's.
+	"""
+
+        try:
+            return self.stats_stub.GetStatsOnlineIpList(
+                command_pb2.GetStatsRequest(
+                    name=f"user>>>{user}>>>online",
+                    reset=reset
+                )
+            ).ips
+        except grpc.RpcError:
+            raise
+            return None

xtlsapi_ipblacklist-3.3.2/xtlsapi/api_services/stats/get_statsonline.py

@@ -0,0 +1,18 @@
+import grpc
+from xtlsapi.xray_api.app.stats.command import command_pb2
+
+from .._base import BaseService
+
+
+class StatsOnline(BaseService):
+    def stats_online(self, user,reset=False):
+        try:
+            return self.stats_stub.GetStatsOnline(
+                command_pb2.GetStatsRequest(
+                    name=f"user>>>{user}>>>online",
+                    reset=reset
+                )
+            ).stat.value
+        except grpc.RpcError:
+            raise
+            return None