v2kit 0.4__tar.gz → 0.5__tar.gz

{v2kit-0.4 → v2kit-0.5}/CHANGELOG.md

@@ -5,6 +5,21 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+## [0.5] - 2026-07-31
+### Added
+- `encoded_label` property
+- `uri_label` property
+### Changed
+- `encode_subscription` function modified
+- `parse` function modified
+- `extra` property modified
+- `update_extra` method modified
+- `to_uri` method modified
+- `to_dict` method modified
+- `Protocol` enum updated
+- Scheme bug fixed
+- VMESS parser bug fixed
+- Test system modified
 ## [0.4] - 2026-07-02
 ### Added
 - `HttpConfig` class
@@ -50,7 +65,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - `encode_subscription` function
 - `decode_subscription` function
 
-[Unreleased]: https://github.com/sepandhaghighi/v2kit/compare/v0.4...dev
+[Unreleased]: https://github.com/sepandhaghighi/v2kit/compare/v0.5...dev
+[0.5]: https://github.com/sepandhaghighi/v2kit/compare/v0.4...v0.5
 [0.4]: https://github.com/sepandhaghighi/v2kit/compare/v0.3...v0.4
 [0.3]: https://github.com/sepandhaghighi/v2kit/compare/v0.2...v0.3
 [0.2]: https://github.com/sepandhaghighi/v2kit/compare/v0.1...v0.2

{v2kit-0.4 → v2kit-0.5}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: v2kit
-Version: 0.4
+Version: 0.5
 Summary: V2Kit: A Lightweight Toolkit for V2Ray Config Manipulation
 Home-page: https://github.com/sepandhaghighi/v2kit
-Download-URL: https://github.com/sepandhaghighi/v2kit/tarball/v0.4
+Download-URL: https://github.com/sepandhaghighi/v2kit/tarball/v0.5
 Author: Sepand Haghighi
 Author-email: me@sepand.tech
 License: MIT
@@ -96,13 +96,13 @@ V2Kit is a lightweight and extensible Python toolkit for working with V2Ray prox
 ## Installation		
 
 ### Source Code
-- Download [Version 0.4](https://github.com/sepandhaghighi/v2kit/archive/v0.4.zip) or [Latest Source](https://github.com/sepandhaghighi/v2kit/archive/dev.zip)
+- Download [Version 0.5](https://github.com/sepandhaghighi/v2kit/archive/v0.5.zip) or [Latest Source](https://github.com/sepandhaghighi/v2kit/archive/dev.zip)
 - `pip install .`				
 
 ### PyPI
 
 - Check [Python Packaging User Guide](https://packaging.python.org/installing/)     
-- `pip install v2kit==0.4`						
+- `pip install v2kit==0.5`						
 
 ## Supported Protocols
 
@@ -211,6 +211,21 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+## [0.5] - 2026-07-31
+### Added
+- `encoded_label` property
+- `uri_label` property
+### Changed
+- `encode_subscription` function modified
+- `parse` function modified
+- `extra` property modified
+- `update_extra` method modified
+- `to_uri` method modified
+- `to_dict` method modified
+- `Protocol` enum updated
+- Scheme bug fixed
+- VMESS parser bug fixed
+- Test system modified
 ## [0.4] - 2026-07-02
 ### Added
 - `HttpConfig` class
@@ -256,7 +271,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - `encode_subscription` function
 - `decode_subscription` function
 
-[Unreleased]: https://github.com/sepandhaghighi/v2kit/compare/v0.4...dev
+[Unreleased]: https://github.com/sepandhaghighi/v2kit/compare/v0.5...dev
+[0.5]: https://github.com/sepandhaghighi/v2kit/compare/v0.4...v0.5
 [0.4]: https://github.com/sepandhaghighi/v2kit/compare/v0.3...v0.4
 [0.3]: https://github.com/sepandhaghighi/v2kit/compare/v0.2...v0.3
 [0.2]: https://github.com/sepandhaghighi/v2kit/compare/v0.1...v0.2

{v2kit-0.4 → v2kit-0.5}/README.md

@@ -51,13 +51,13 @@ V2Kit is a lightweight and extensible Python toolkit for working with V2Ray prox
 ## Installation		
 
 ### Source Code
-- Download [Version 0.4](https://github.com/sepandhaghighi/v2kit/archive/v0.4.zip) or [Latest Source](https://github.com/sepandhaghighi/v2kit/archive/dev.zip)
+- Download [Version 0.5](https://github.com/sepandhaghighi/v2kit/archive/v0.5.zip) or [Latest Source](https://github.com/sepandhaghighi/v2kit/archive/dev.zip)
 - `pip install .`				
 
 ### PyPI
 
 - Check [Python Packaging User Guide](https://packaging.python.org/installing/)     
-- `pip install v2kit==0.4`						
+- `pip install v2kit==0.5`						
 
 ## Supported Protocols
 

{v2kit-0.4 → v2kit-0.5}/SECURITY.md

@@ -4,8 +4,8 @@
 
 | Version       | Supported          |
 | ------------- | ------------------ |
-| 0.4           | :white_check_mark: |
-| < 0.4         | :x:                |
+| 0.5           | :white_check_mark: |
+| < 0.5         | :x:                |
 
 ## Reporting a Vulnerability
 

{v2kit-0.4 → v2kit-0.5}/setup.py

@@ -23,7 +23,7 @@ def read_description() -> str:
 setup(
     name='v2kit',
     packages=['v2kit', 'v2kit.models'],
-    version='0.4',
+    version='0.5',
     description='V2Kit: A Lightweight Toolkit for V2Ray Config Manipulation',
     long_description=read_description(),
     long_description_content_type='text/markdown',
@@ -31,7 +31,7 @@ setup(
     author='Sepand Haghighi',
     author_email='me@sepand.tech',
     url='https://github.com/sepandhaghighi/v2kit',
-    download_url='https://github.com/sepandhaghighi/v2kit/tarball/v0.4',
+    download_url='https://github.com/sepandhaghighi/v2kit/tarball/v0.5',
     keywords='v2ray v2ray-config v2ray-tools vmess vless trojan shadowsocks proxy subscription network',
     project_urls={
         'Source': 'https://github.com/sepandhaghighi/v2kit'},

{v2kit-0.4 → v2kit-0.5}/tests/test_http.py

@@ -137,6 +137,21 @@ def test_to_uri_roundtrip():
     assert parsed == config
 
 
+def test_encoded_label():
+    config = HttpConfig(
+        address="example.com",
+        port=1080,
+        username="user",
+        password="password",
+        label="test 1 2",
+    )
+
+    parsed = parse(config.to_uri())
+    assert parsed == config
+    assert config.label == "test 1 2"
+    assert config.encoded_label == "test%201%202"
+
+
 def test_equality():
     config1 = HttpConfig(
         address="example.com",

{v2kit-0.4 → v2kit-0.5}/tests/test_shadowsocks.py

@@ -113,6 +113,21 @@ def test_to_uri_roundtrip():
     assert parsed == config
 
 
+def test_encoded_label():
+    config = ShadowsocksConfig(
+        encryption="aes-256-gcm",
+        password="password",
+        address="example.com",
+        port=8388,
+        label="test 1 2",
+    )
+
+    parsed = parse(config.to_uri())
+    assert parsed == config
+    assert config.label == "test 1 2"
+    assert config.encoded_label == "test%201%202"
+
+
 def test_equality():
     config1 = ShadowsocksConfig(
         encryption="aes-256-gcm",
@@ -150,7 +165,7 @@ def test_repr():
 
     assert repr(config) == (
         "ShadowsocksConfig(protocol=<Protocol.SHADOWSOCKS: "
-        "'ss'>, label=None)"
+        "'shadowsocks'>, label=None)"
     )
 
 

{v2kit-0.4 → v2kit-0.5}/tests/test_socks.py

@@ -135,6 +135,21 @@ def test_to_uri_roundtrip():
     assert parsed == config
 
 
+def test_encoded_label():
+    config = SocksConfig(
+        address="example.com",
+        port=1080,
+        username="user",
+        password="password",
+        label="test 1 2",
+    )
+
+    parsed = parse(config.to_uri())
+    assert parsed == config
+    assert config.label == "test 1 2"
+    assert config.encoded_label == "test%201%202"
+
+
 def test_equality():
     config1 = SocksConfig(
         address="example.com",

{v2kit-0.4 → v2kit-0.5}/tests/test_trojan.py

@@ -131,6 +131,20 @@ def test_to_uri_roundtrip():
     assert parsed == config
 
 
+def test_encoded_label():
+    config = TrojanConfig(
+        password="password",
+        address="example.com",
+        port=443,
+        label="test 1 2",
+    )
+
+    parsed = parse(config.to_uri())
+    assert parsed == config
+    assert config.label == "test 1 2"
+    assert config.encoded_label == "test%201%202"
+
+
 def test_update_extra():
     config = TrojanConfig(
         password="password",

{v2kit-0.4 → v2kit-0.5}/tests/test_vless.py

@@ -105,6 +105,21 @@ def test_to_uri_roundtrip():
     assert parsed == config
 
 
+def test_encoded_label():
+    config = VLESSConfig(
+        uuid="1c4b4bca-e3ff-4ca8-a062-6f399ad3cf45",
+        address="example.com",
+        port=443,
+        label="test 1 2",
+        extra={"security": "tls"},
+    )
+
+    parsed = parse(config.to_uri())
+    assert parsed == config
+    assert config.label == "test 1 2"
+    assert config.encoded_label == "test%201%202"
+
+
 def test_equality():
     config1 = VLESSConfig(
         uuid="1c4b4bca-e3ff-4ca8-a062-6f399ad3cf45",

{v2kit-0.4 → v2kit-0.5}/tests/test_vmess.py

@@ -147,6 +147,20 @@ def test_to_uri_roundtrip():
     assert parsed == config
 
 
+def test_encoded_label():
+    config = VMESSConfig(
+        uuid="1c4b4bca-e3ff-4ca8-a062-6f399ad3cf45",
+        address="example.com",
+        port=443,
+        label="test 1 2",
+    )
+
+    parsed = parse(config.to_uri())
+    assert parsed == config
+    assert config.label == "test 1 2"
+    assert config.encoded_label == "test%201%202"
+
+
 def test_update_methods():
     config = VMESSConfig(
         uuid="1c4b4bca-e3ff-4ca8-a062-6f399ad3cf45",

{v2kit-0.4 → v2kit-0.5}/v2kit/functions.py

@@ -91,33 +91,20 @@ def encode_subscription(
     uri_list = []
 
     for item in entries:
-        if isinstance(
-            item,
-            BaseConfig,
-        ):
-            uri_list.append(
-                item.to_uri()
-            )
-
-            continue
-
-        if isinstance(item, str):
+        if isinstance(item, BaseConfig):
+            uri = item.to_uri()
+        elif isinstance(item, str):
+            uri = item
             if validate:
-                parse(item)
+                parse(uri)
+        else:
+            raise V2kitValidationError(INVALID_ITEMS_MESSAGE)
 
-            uri_list.append(item)
+        uri_list.append(uri)
 
-            continue
+    subscription = "\n".join(uri_list)
 
-        raise V2kitValidationError(INVALID_ITEMS_MESSAGE)
-
-    subscription = "\n".join(
-        uri_list
-    )
-
-    return _encode_base64(
-        subscription
-    )
+    return _encode_base64(subscription)
 
 
 def decode_subscription(

{v2kit-0.4 → v2kit-0.5}/v2kit/models/base.py

@@ -2,6 +2,7 @@
 """Base config model."""
 
 from abc import ABC, abstractmethod
+from urllib.parse import quote
 from typing import Dict, Optional
 from ..params import Protocol
 from ..validators import _validate_label, _validate_dict
@@ -30,6 +31,7 @@ class BaseConfig(ABC):
         """
         self._protocol = protocol
         self._label = None
+        self._encoded_label = None
         self._extra = {}
 
         self.update_extra(extra or {})
@@ -45,10 +47,24 @@ class BaseConfig(ABC):
         """Get the config label."""
         return self._label
 
+    @property
+    def encoded_label(self) -> Optional[str]:
+        """Get the config percent-encoded label."""
+        return self._encoded_label
+
     @property
     def extra(self) -> Dict[str, object]:
         """Get extra data."""
-        return self._extra
+        return self._extra.copy()
+    
+    @property
+    def uri_label(self) -> str:
+        """Get URI label."""
+        return (
+            f"#{self.encoded_label}"
+            if self.encoded_label
+            else ""
+        )
 
     def update_label(
         self,
@@ -62,6 +78,7 @@ class BaseConfig(ABC):
         _validate_label(label)
 
         self._label = label
+        self._encoded_label = quote(label) if label else None
 
         return self
 
@@ -79,7 +96,7 @@ class BaseConfig(ABC):
             "Extra",
         )
 
-        self._extra = extra
+        self._extra = extra.copy()
 
         return self
 

{v2kit-0.4 → v2kit-0.5}/v2kit/models/http.py

@@ -5,7 +5,7 @@ from urllib.parse import urlencode
 from typing import Dict, Optional
 
 from .base import BaseConfig
-from ..params import Protocol
+from ..params import Protocol, PROTOCOL_SCHEMES
 from ..validators import (
     _validate_address,
     _validate_port,
@@ -128,7 +128,7 @@ class HttpConfig(BaseConfig):
     def to_dict(self) -> dict:
         """Convert HTTP config to dictionary."""
         return {
-            "protocol": "http",
+            "protocol": self.protocol.value,
             "address": self.address,
             "port": self.port,
             "username": self.username,
@@ -153,14 +153,9 @@ class HttpConfig(BaseConfig):
             f"?{urlencode(self.extra)}"
             if self.extra else ""
         )
-
-        label = (
-            f"#{self.label}"
-            if self.label else ""
-        )
-
+        scheme = PROTOCOL_SCHEMES[self.protocol]
         return (
-            f"http://{auth}"
+            f"{scheme}://{auth}"
             f"{self.address}:{self.port}"
-            f"{query}{label}"
+            f"{query}{self.uri_label}"
         )

{v2kit-0.4 → v2kit-0.5}/v2kit/models/shadowsocks.py

@@ -3,7 +3,7 @@
 
 from typing import Dict, Optional
 from .base import BaseConfig
-from ..params import Protocol
+from ..params import Protocol, PROTOCOL_SCHEMES
 from ..validators import (
     _validate_port,
     _validate_address,
@@ -140,7 +140,7 @@ class ShadowsocksConfig(BaseConfig):
     def to_dict(self) -> dict:
         """Convert Shadowsocks config to dictionary."""
         return {
-            "protocol": "shadowsocks",
+            "protocol": self.protocol.value,
             "encryption": self.encryption,
             "password": self.password,
             "address": self.address,
@@ -158,11 +158,9 @@ class ShadowsocksConfig(BaseConfig):
         encoded = _encode_base64(
             userinfo
         )
-
-        label = f"#{self.label}" if self.label else ""
-
+        scheme = PROTOCOL_SCHEMES[self.protocol]
         return (
-            f"ss://{encoded}@"
+            f"{scheme}://{encoded}@"
             f"{self.address}:{self.port}"
-            f"{label}"
+            f"{self.uri_label}"
         )

{v2kit-0.4 → v2kit-0.5}/v2kit/models/socks.py

@@ -4,7 +4,7 @@
 from urllib.parse import urlencode
 from typing import Dict, Optional
 from .base import BaseConfig
-from ..params import Protocol
+from ..params import Protocol, PROTOCOL_SCHEMES
 from ..validators import (
     _validate_port,
     _validate_address,
@@ -133,7 +133,7 @@ class SocksConfig(BaseConfig):
     def to_dict(self) -> dict:
         """Convert SOCKS config to dictionary."""
         return {
-            "protocol": "socks",
+            "protocol": self.protocol.value,
             "address": self.address,
             "port": self.port,
             "username": self.username,
@@ -148,12 +148,6 @@ class SocksConfig(BaseConfig):
             f"?{urlencode(self.extra)}"
             if self.extra else ""
         )
-
-        label = (
-            f"#{self.label}"
-            if self.label else ""
-        )
-
         auth = ""
 
         if self.username:
@@ -163,10 +157,10 @@ class SocksConfig(BaseConfig):
                 auth += f":{self.password}"
 
             auth += "@"
-
+        scheme = PROTOCOL_SCHEMES[self.protocol]
         return (
-            f"socks://"
+            f"{scheme}://"
             f"{auth}"
             f"{self.address}:{self.port}"
-            f"{query}{label}"
+            f"{query}{self.uri_label}"
         )

{v2kit-0.4 → v2kit-0.5}/v2kit/models/trojan.py

@@ -4,7 +4,7 @@
 from urllib.parse import urlencode
 from typing import Dict, Optional
 from .base import BaseConfig
-from ..params import Protocol
+from ..params import Protocol, PROTOCOL_SCHEMES
 from ..validators import (
     _validate_port,
     _validate_address,
@@ -113,7 +113,7 @@ class TrojanConfig(BaseConfig):
     def to_dict(self) -> dict:
         """Convert Trojan config to dictionary."""
         return {
-            "protocol": "trojan",
+            "protocol": self.protocol.value,
             "password": self.password,
             "address": self.address,
             "port": self.port,
@@ -127,14 +127,9 @@ class TrojanConfig(BaseConfig):
             f"?{urlencode(self.extra)}"
             if self.extra else ""
         )
-
-        label = (
-            f"#{self.label}"
-            if self.label else ""
-        )
-
+        scheme = PROTOCOL_SCHEMES[self.protocol]
         return (
-            f"trojan://{self.password}@"
+            f"{scheme}://{self.password}@"
             f"{self.address}:{self.port}"
-            f"{query}{label}"
+            f"{query}{self.uri_label}"
         )

{v2kit-0.4 → v2kit-0.5}/v2kit/models/vless.py

@@ -4,7 +4,7 @@
 from urllib.parse import urlencode
 from typing import Dict, Optional
 from .base import BaseConfig
-from ..params import Protocol
+from ..params import Protocol, PROTOCOL_SCHEMES
 from ..validators import (
     _validate_uuid,
     _validate_port,
@@ -114,7 +114,7 @@ class VLESSConfig(BaseConfig):
     def to_dict(self) -> dict:
         """Convert VLESS config to dictionary."""
         return {
-            "protocol": "vless",
+            "protocol": self.protocol.value,
             "uuid": self.uuid,
             "address": self.address,
             "port": self.port,
@@ -128,14 +128,9 @@ class VLESSConfig(BaseConfig):
             f"?{urlencode(self.extra)}"
             if self.extra else ""
         )
-
-        label = (
-            f"#{self.label}"
-            if self.label else ""
-        )
-
+        scheme = PROTOCOL_SCHEMES[self.protocol]
         return (
-            f"vless://{self.uuid}@"
+            f"{scheme}://{self.uuid}@"
             f"{self.address}:{self.port}"
-            f"{query}{label}"
+            f"{query}{self.uri_label}"
         )

{v2kit-0.4 → v2kit-0.5}/v2kit/models/vmess.py

@@ -4,7 +4,7 @@
 import json
 from typing import Dict, Optional
 from .base import BaseConfig
-from ..params import Protocol
+from ..params import Protocol, PROTOCOL_SCHEMES
 from ..validators import (
     _validate_uuid,
     _validate_port,
@@ -213,5 +213,5 @@ class VMESSConfig(BaseConfig):
                 ensure_ascii=False,
             )
         )
-
-        return f"vmess://{encoded}"
+        scheme = PROTOCOL_SCHEMES[self.protocol]
+        return f"{scheme}://{encoded}"

{v2kit-0.4 → v2kit-0.5}/v2kit/params.py

@@ -2,7 +2,7 @@
 """v2kit params."""
 from enum import Enum
 
-V2KIT_VERSION = "0.4"
+V2KIT_VERSION = "0.5"
 
 
 class Protocol(str, Enum):
@@ -11,12 +11,24 @@ class Protocol(str, Enum):
     VMESS = "vmess"
     VLESS = "vless"
     TROJAN = "trojan"
-    SHADOWSOCKS = "ss"
+    SHADOWSOCKS = "shadowsocks"
     SOCKS = "socks"
     HTTP = "http"
 
 
-SUPPORTED_PROTOCOLS = {item.value for item in Protocol}
+PROTOCOL_SCHEMES = {
+    Protocol.VMESS: "vmess",
+    Protocol.VLESS: "vless",
+    Protocol.TROJAN: "trojan",
+    Protocol.SHADOWSOCKS: "ss",
+    Protocol.SOCKS: "socks",
+    Protocol.HTTP: "http",
+}
+
+SCHEME_TO_PROTOCOL = {value: key for key, value in PROTOCOL_SCHEMES.items()}
+
+
+SUPPORTED_PROTOCOLS = set(PROTOCOL_SCHEMES.values())
 
 DEFAULT_ENCODING = "utf-8"
 

{v2kit-0.4 → v2kit-0.5}/v2kit/parsers.py

@@ -3,54 +3,15 @@
 
 from typing import Union
 import json
-from urllib.parse import urlparse, parse_qsl
+from urllib.parse import urlparse, parse_qsl, unquote
 from .errors import V2kitParseError
-from .params import Protocol
+from .params import Protocol, SCHEME_TO_PROTOCOL
 from .params import INVALID_URI_FORMAT_MESSAGE, UNSUPPORTED_PROTOCOL_MESSAGE
 from .validators import _validate_non_empty_string
 from .models import VMESSConfig, VLESSConfig, TrojanConfig, ShadowsocksConfig, SocksConfig, HttpConfig
 from .utils import _decode_base64
 
 
-def parse(uri: str) -> Union[VMESSConfig, VLESSConfig, TrojanConfig, ShadowsocksConfig, SocksConfig, HttpConfig]:
-    """
-    Parse V2Ray URI.
-
-    :param uri: V2Ray URI.
-    """
-    _validate_non_empty_string(uri, "URI")
-
-    if "://" not in uri:
-        raise V2kitParseError(INVALID_URI_FORMAT_MESSAGE)
-
-    parsed = urlparse(uri)
-
-    try:
-        protocol = Protocol(
-            parsed.scheme
-        )
-
-    except Exception as exc:
-        raise V2kitParseError(UNSUPPORTED_PROTOCOL_MESSAGE.format(protocol=parsed.scheme)) from exc
-
-    if protocol == Protocol.VMESS:
-        return _parse_vmess(uri)
-
-    if protocol == Protocol.VLESS:
-        return _parse_vless(uri)
-
-    if protocol == Protocol.TROJAN:
-        return _parse_trojan(uri)
-
-    if protocol == Protocol.SHADOWSOCKS:
-        return _parse_shadowsocks(uri)
-
-    if protocol == Protocol.SOCKS:
-        return _parse_socks(uri)
-    if protocol == Protocol.HTTP:
-        return _parse_http(uri)
-
-
 def _parse_vmess(uri: str) -> VMESSConfig:
     """
     Parse VMESS URI.
@@ -67,17 +28,11 @@ def _parse_vmess(uri: str) -> VMESSConfig:
         "tls",
     }
     try:
-        _, encoded = uri.split(
-            "://",
-            1,
-        )
-
-        decoded = _decode_base64(
-            encoded
-        )
-
+        _, encoded = uri.split("://", 1)
+        decoded = _decode_base64(encoded)
         data = json.loads(decoded)
-
+        port = int(data.get("port", 0))
+        alter_id = int(data.get("aid", 0))
     except Exception as exc:
         raise V2kitParseError(INVALID_URI_FORMAT_MESSAGE) from exc
 
@@ -89,21 +44,11 @@ def _parse_vmess(uri: str) -> VMESSConfig:
     return VMESSConfig(
         uuid=data.get("id", ""),
         address=data.get("add", ""),
-        port=int(
-            data.get("port", 0)
-        ),
+        port=port,
         label=data.get("ps"),
-        alter_id=int(
-            data.get("aid", 0)
-        ),
-        network=data.get(
-            "net",
-            "tcp",
-        ),
-        tls=data.get(
-            "tls",
-            "",
-        ),
+        alter_id=alter_id,
+        network=data.get("net", "tcp"),
+        tls=data.get("tls", ""),
         extra=extra,
     )
 
@@ -119,7 +64,7 @@ def _parse_vless(uri: str) -> VLESSConfig:
         uuid=parsed.username or "",
         address=parsed.hostname or "",
         port=parsed.port or 0,
-        label=parsed.fragment or None,
+        label=unquote(parsed.fragment) or None,
         extra=dict(parse_qsl(parsed.query)),
     )
 
@@ -135,7 +80,7 @@ def _parse_trojan(uri: str) -> TrojanConfig:
         password=parsed.username or "",
         address=parsed.hostname or "",
         port=parsed.port or 0,
-        label=parsed.fragment or None,
+        label=unquote(parsed.fragment) or None,
         extra=dict(parse_qsl(parsed.query)),
     )
 
@@ -148,16 +93,8 @@ def _parse_shadowsocks(uri: str) -> ShadowsocksConfig:
     """
     parsed = urlparse(uri)
     try:
-        userinfo = _decode_base64(
-            parsed.username
-        )
-
-        encryption, password = (
-            userinfo.split(
-                ":",
-                1,
-            )
-        )
+        userinfo = _decode_base64(parsed.username)
+        encryption, password = (userinfo.split(":", 1))
 
     except Exception as exc:
         raise V2kitParseError(INVALID_URI_FORMAT_MESSAGE) from exc
@@ -167,7 +104,7 @@ def _parse_shadowsocks(uri: str) -> ShadowsocksConfig:
         password=password,
         address=parsed.hostname or "",
         port=parsed.port or 0,
-        label=parsed.fragment or None,
+        label=unquote(parsed.fragment) or None,
         extra=dict(parse_qsl(parsed.query)),
     )
 
@@ -185,7 +122,7 @@ def _parse_socks(uri: str) -> SocksConfig:
         port=parsed.port or 0,
         username=parsed.username or None,
         password=parsed.password or None,
-        label=parsed.fragment or None,
+        label=unquote(parsed.fragment) or None,
         extra=dict(parse_qsl(parsed.query)),
     )
 
@@ -203,6 +140,37 @@ def _parse_http(uri: str) -> HttpConfig:
         port=parsed.port or 0,
         username=parsed.username or None,
         password=parsed.password or None,
-        label=parsed.fragment or None,
+        label=unquote(parsed.fragment) or None,
         extra=dict(parse_qsl(parsed.query)),
     )
+
+
+PARSERS = {
+    Protocol.VMESS: _parse_vmess,
+    Protocol.VLESS: _parse_vless,
+    Protocol.TROJAN: _parse_trojan,
+    Protocol.SHADOWSOCKS: _parse_shadowsocks,
+    Protocol.SOCKS: _parse_socks,
+    Protocol.HTTP: _parse_http,
+}
+
+
+def parse(uri: str) -> Union[VMESSConfig, VLESSConfig, TrojanConfig, ShadowsocksConfig, SocksConfig, HttpConfig]:
+    """
+    Parse V2Ray URI.
+
+    :param uri: V2Ray URI.
+    """
+    _validate_non_empty_string(uri, "URI")
+
+    if "://" not in uri:
+        raise V2kitParseError(INVALID_URI_FORMAT_MESSAGE)
+
+    parsed = urlparse(uri)
+
+    try:
+        protocol = SCHEME_TO_PROTOCOL[parsed.scheme]
+    except Exception as exc:
+        raise V2kitParseError(UNSUPPORTED_PROTOCOL_MESSAGE.format(protocol=parsed.scheme)) from exc
+
+    return PARSERS[protocol](uri)

{v2kit-0.4 → v2kit-0.5}/v2kit/utils.py

@@ -4,7 +4,7 @@ import base64
 from .errors import V2kitParseError
 from .validators import _validate_uri
 from .params import DEFAULT_ENCODING
-from .params import Protocol
+from .params import Protocol, SCHEME_TO_PROTOCOL
 
 
 def _encode_base64(data: str) -> str:
@@ -48,9 +48,9 @@ def _get_protocol(uri: str) -> Protocol:
     """
     _validate_uri(uri)
 
-    protocol = uri.split("://", 1)[0]
+    scheme = uri.split("://", 1)[0]
 
-    return Protocol(protocol)
+    return SCHEME_TO_PROTOCOL[scheme]
 
 
 def _is_protocol(uri: str, protocol: Protocol) -> bool:

{v2kit-0.4 → v2kit-0.5}/v2kit/validators.py

@@ -6,7 +6,7 @@ import base64
 import uuid
 from urllib.parse import urlparse
 from .errors import V2kitValidationError, V2kitParseError
-from .params import Protocol, DEFAULT_ENCODING
+from .params import Protocol, SCHEME_TO_PROTOCOL, DEFAULT_ENCODING
 from .params import INVALID_TYPE_MESSAGE, INVALID_ALTER_ID_MESSAGE, INVALID_EMPTY_STRING_MESSAGE
 from .params import INVALID_UUID_MESSAGE, INVALID_PORT_MESSAGE, INVALID_URI_FORMAT_MESSAGE
 from .params import UNSUPPORTED_PROTOCOL_MESSAGE
@@ -166,10 +166,10 @@ def _validate_uri(uri: str) -> None:
         raise V2kitParseError(INVALID_URI_FORMAT_MESSAGE)
     parsed = urlparse(uri)
     try:
-        Protocol(parsed.scheme)
+        SCHEME_TO_PROTOCOL[parsed.scheme]
     except Exception as exc:
         raise V2kitParseError(UNSUPPORTED_PROTOCOL_MESSAGE.format(protocol=parsed.scheme)) from exc
-    if parsed.scheme == Protocol.VMESS.value:
+    if SCHEME_TO_PROTOCOL[parsed.scheme] == Protocol.VMESS:
         try:
             _, encoded = uri.split("://", 1)
             encoded += "=" * (-len(encoded) % 4)

{v2kit-0.4 → v2kit-0.5}/v2kit.egg-info/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: v2kit
-Version: 0.4
+Version: 0.5
 Summary: V2Kit: A Lightweight Toolkit for V2Ray Config Manipulation
 Home-page: https://github.com/sepandhaghighi/v2kit
-Download-URL: https://github.com/sepandhaghighi/v2kit/tarball/v0.4
+Download-URL: https://github.com/sepandhaghighi/v2kit/tarball/v0.5
 Author: Sepand Haghighi
 Author-email: me@sepand.tech
 License: MIT
@@ -96,13 +96,13 @@ V2Kit is a lightweight and extensible Python toolkit for working with V2Ray prox
 ## Installation		
 
 ### Source Code
-- Download [Version 0.4](https://github.com/sepandhaghighi/v2kit/archive/v0.4.zip) or [Latest Source](https://github.com/sepandhaghighi/v2kit/archive/dev.zip)
+- Download [Version 0.5](https://github.com/sepandhaghighi/v2kit/archive/v0.5.zip) or [Latest Source](https://github.com/sepandhaghighi/v2kit/archive/dev.zip)
 - `pip install .`				
 
 ### PyPI
 
 - Check [Python Packaging User Guide](https://packaging.python.org/installing/)     
-- `pip install v2kit==0.4`						
+- `pip install v2kit==0.5`						
 
 ## Supported Protocols
 
@@ -211,6 +211,21 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+## [0.5] - 2026-07-31
+### Added
+- `encoded_label` property
+- `uri_label` property
+### Changed
+- `encode_subscription` function modified
+- `parse` function modified
+- `extra` property modified
+- `update_extra` method modified
+- `to_uri` method modified
+- `to_dict` method modified
+- `Protocol` enum updated
+- Scheme bug fixed
+- VMESS parser bug fixed
+- Test system modified
 ## [0.4] - 2026-07-02
 ### Added
 - `HttpConfig` class
@@ -256,7 +271,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - `encode_subscription` function
 - `decode_subscription` function
 
-[Unreleased]: https://github.com/sepandhaghighi/v2kit/compare/v0.4...dev
+[Unreleased]: https://github.com/sepandhaghighi/v2kit/compare/v0.5...dev
+[0.5]: https://github.com/sepandhaghighi/v2kit/compare/v0.4...v0.5
 [0.4]: https://github.com/sepandhaghighi/v2kit/compare/v0.3...v0.4
 [0.3]: https://github.com/sepandhaghighi/v2kit/compare/v0.2...v0.3
 [0.2]: https://github.com/sepandhaghighi/v2kit/compare/v0.1...v0.2