v2kit 0.5__tar.gz → 0.6__tar.gz

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

@@ -5,6 +5,19 @@ 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.6] - 2026-09-01
+### Added
+- `clear_extra` method
+- `set_extra_item` method
+- `get_extra_item` method
+- `remove_extra_item` method
+### Changed
+- `_get_protocol` function modified
+- `decode_subscription` function blank line bug fixed
+- Port validation bug fixed
+- AlterId validation bug fixed
+- Test system modified
+- Parsers updated
 ## [0.5] - 2026-07-31
 ### Added
 - `encoded_label` property
@@ -65,7 +78,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.5...dev
+[Unreleased]: https://github.com/sepandhaghighi/v2kit/compare/v0.6...dev
+[0.6]: https://github.com/sepandhaghighi/v2kit/compare/v0.5...v0.6
 [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

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

@@ -1,15 +1,15 @@
 Metadata-Version: 2.4
 Name: v2kit
-Version: 0.5
+Version: 0.6
 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.5
+Download-URL: https://github.com/sepandhaghighi/v2kit/tarball/v0.6
 Author: Sepand Haghighi
 Author-email: me@sepand.tech
 License: MIT
 Project-URL: Source, https://github.com/sepandhaghighi/v2kit
 Keywords: v2ray v2ray-config v2ray-tools vmess vless trojan shadowsocks proxy subscription network
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Natural Language :: English
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
@@ -96,13 +96,13 @@ V2Kit is a lightweight and extensible Python toolkit for working with V2Ray prox
 ## Installation		
 
 ### Source Code
-- Download [Version 0.5](https://github.com/sepandhaghighi/v2kit/archive/v0.5.zip) or [Latest Source](https://github.com/sepandhaghighi/v2kit/archive/dev.zip)
+- Download [Version 0.6](https://github.com/sepandhaghighi/v2kit/archive/v0.6.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.5`						
+- `pip install v2kit==0.6`						
 
 ## Supported Protocols
 
@@ -211,6 +211,19 @@ 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.6] - 2026-09-01
+### Added
+- `clear_extra` method
+- `set_extra_item` method
+- `get_extra_item` method
+- `remove_extra_item` method
+### Changed
+- `_get_protocol` function modified
+- `decode_subscription` function blank line bug fixed
+- Port validation bug fixed
+- AlterId validation bug fixed
+- Test system modified
+- Parsers updated
 ## [0.5] - 2026-07-31
 ### Added
 - `encoded_label` property
@@ -271,7 +284,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.5...dev
+[Unreleased]: https://github.com/sepandhaghighi/v2kit/compare/v0.6...dev
+[0.6]: https://github.com/sepandhaghighi/v2kit/compare/v0.5...v0.6
 [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

{v2kit-0.5 → v2kit-0.6}/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.5](https://github.com/sepandhaghighi/v2kit/archive/v0.5.zip) or [Latest Source](https://github.com/sepandhaghighi/v2kit/archive/dev.zip)
+- Download [Version 0.6](https://github.com/sepandhaghighi/v2kit/archive/v0.6.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.5`						
+- `pip install v2kit==0.6`						
 
 ## Supported Protocols
 

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

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

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

@@ -23,7 +23,7 @@ def read_description() -> str:
 setup(
     name='v2kit',
     packages=['v2kit', 'v2kit.models'],
-    version='0.5',
+    version='0.6',
     description='V2Kit: A Lightweight Toolkit for V2Ray Config Manipulation',
     long_description=read_description(),
     long_description_content_type='text/markdown',
@@ -31,14 +31,14 @@ setup(
     author='Sepand Haghighi',
     author_email='me@sepand.tech',
     url='https://github.com/sepandhaghighi/v2kit',
-    download_url='https://github.com/sepandhaghighi/v2kit/tarball/v0.5',
+    download_url='https://github.com/sepandhaghighi/v2kit/tarball/v0.6',
     keywords='v2ray v2ray-config v2ray-tools vmess vless trojan shadowsocks proxy subscription network',
     project_urls={
         'Source': 'https://github.com/sepandhaghighi/v2kit'},
     install_requires=[],
     python_requires='>=3.8',
     classifiers=[
-        'Development Status :: 3 - Alpha',
+        'Development Status :: 4 - Beta',
         'Natural Language :: English',
         'License :: OSI Approved :: MIT License',
         'Operating System :: OS Independent',

{v2kit-0.5 → v2kit-0.6}/tests/test_errors.py

@@ -143,7 +143,7 @@ def test_vless_invalid_uuid():
         )
 
 
-def test_vless_invalid_port():
+def test_vless_invalid_port1():
     with pytest.raises(V2kitValidationError):
         VLESSConfig(
             uuid=VALID_UUID,
@@ -152,6 +152,15 @@ def test_vless_invalid_port():
         )
 
 
+def test_vless_invalid_port2():
+    with pytest.raises(V2kitValidationError):
+        VLESSConfig(
+            uuid=VALID_UUID,
+            address="example.com",
+            port=True,
+        )
+
+
 def test_vless_empty_address():
     with pytest.raises(V2kitValidationError):
         VLESSConfig(
@@ -161,7 +170,7 @@ def test_vless_empty_address():
         )
 
 
-def test_vmess_invalid_alter_id():
+def test_vmess_invalid_alter_id1():
     with pytest.raises(V2kitValidationError):
         VMESSConfig(
             uuid=VALID_UUID,
@@ -171,6 +180,16 @@ def test_vmess_invalid_alter_id():
         )
 
 
+def test_vmess_invalid_alter_id2():
+    with pytest.raises(V2kitValidationError):
+        VMESSConfig(
+            uuid=VALID_UUID,
+            address="example.com",
+            port=443,
+            alter_id=True,
+        )
+
+
 def test_trojan_empty_password():
     with pytest.raises(V2kitValidationError):
         TrojanConfig(
@@ -190,7 +209,7 @@ def test_shadowsocks_empty_encryption():
         )
 
 
-def test_socks_invalid_port():
+def test_socks_invalid_port1():
     with pytest.raises(V2kitValidationError):
         SocksConfig(
             address="example.com",
@@ -198,6 +217,14 @@ def test_socks_invalid_port():
         )
 
 
+def test_socks_invalid_port2():
+    with pytest.raises(V2kitValidationError):
+        SocksConfig(
+            address="example.com",
+            port=False,
+        )
+
+
 def test_socks_empty_address():
     with pytest.raises(V2kitValidationError):
         SocksConfig(

{v2kit-0.5 → v2kit-0.6}/tests/test_functions.py

@@ -135,7 +135,7 @@ def test_encode_subscription():
     assert len(result) > 0
 
 
-def test_decode_subscription():
+def test_decode_subscription1():
     configs = [
         VMESS_CONFIG,
         VLESS_CONFIG,
@@ -148,6 +148,14 @@ def test_decode_subscription():
     assert result == configs
 
 
+def test_decode_subscription2():
+    subscription = "dmxlc3M6Ly8xYzRiNGJjYS1lM2ZmLTRjYTgtYTA2Mi02ZjM5OWFkM2NmNDVAZXhhbXBsZS5jb206NDQzP3NlY3VyaXR5PXRscyN2bGVzcy10ZXN0Cgp0cm9qYW46Ly9wYXNzd29yZEBleGFtcGxlLmNvbTo0NDM/c2VjdXJpdHk9dGxzI3Ryb2phbi10ZXN0CgpzczovL1lXVnpMVEkxTmkxblkyMDZjR0Z6YzNkdmNtUT1AZXhhbXBsZS5jb206ODM4OCNzcy10ZXN0Cg=="
+
+    result = decode_subscription(subscription)
+
+    assert len(result) == 3
+
+
 def test_encode_decode_subscription_roundtrip():
     configs = [
         VMESS_CONFIG,

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

@@ -79,6 +79,59 @@ def test_update_extra():
     assert config.extra["foo"] == "bar"
 
 
+def test_clear_extra():
+    config = HttpConfig(
+        address="example.com",
+        port=1080,
+        extra={"foo": "bar"},
+    )
+
+    config.clear_extra()
+
+    assert config.extra == {}
+
+
+def test_set_extra_item():
+    config = HttpConfig(
+        address="example.com",
+        port=1080,
+    )
+
+    config.set_extra_item(
+        "foo",
+        "bar",
+    )
+
+    assert config.extra["foo"] == "bar"
+
+
+def test_get_extra_item():
+    config = HttpConfig(
+        address="example.com",
+        port=1080,
+        extra={"foo": "bar"},
+    )
+
+    assert config.get_extra_item("foo") == "bar"
+    assert config.get_extra_item("missing") is None
+    assert config.get_extra_item(
+        "missing",
+        "default",
+    ) == "default"
+
+
+def test_remove_extra_item():
+    config = HttpConfig(
+        address="example.com",
+        port=1080,
+        extra={"foo": "bar"},
+    )
+
+    config.remove_extra_item("foo")
+
+    assert config.extra == {}
+
+
 def test_method_chaining():
     config = HttpConfig(
         address="example.com",
@@ -93,12 +146,18 @@ def test_method_chaining():
         "user"
     ).update_password(
         "password"
-    )
+    ).set_extra_item(
+        "foo",
+        "bar",
+    ).remove_extra_item(
+        "foo"
+    ).clear_extra()
 
     assert config.address == "example.org"
     assert config.port == 8080
     assert config.username == "user"
     assert config.password == "password"
+    assert config.extra == {}
 
 
 @pytest.mark.parametrize(

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

@@ -67,12 +67,18 @@ def test_method_chaining():
         "example.org"
     ).update_port(
         443
-    )
+    ).set_extra_item(
+        "plugin",
+        "v2ray-plugin",
+    ).remove_extra_item(
+        "plugin"
+    ).clear_extra()
 
     assert config.encryption == "chacha20-ietf-poly1305"
     assert config.password == "secret"
     assert config.address == "example.org"
     assert config.port == 443
+    assert config.extra == {}
 
 
 @pytest.mark.parametrize(
@@ -184,6 +190,71 @@ def test_update_extra():
     assert config.extra["plugin"] == "v2ray-plugin"
 
 
+def test_clear_extra():
+    config = ShadowsocksConfig(
+        encryption="aes-256-gcm",
+        password="password",
+        address="example.com",
+        port=8388,
+        extra={"plugin": "v2ray-plugin"},
+    )
+
+    config.clear_extra()
+
+    assert config.extra == {}
+
+
+def test_set_extra_item():
+    config = ShadowsocksConfig(
+        encryption="aes-256-gcm",
+        password="password",
+        address="example.com",
+        port=8388,
+    )
+
+    config.set_extra_item(
+        "plugin",
+        "v2ray-plugin",
+    )
+
+    assert config.extra["plugin"] == "v2ray-plugin"
+
+
+def test_get_extra_item():
+    config = ShadowsocksConfig(
+        encryption="aes-256-gcm",
+        password="password",
+        address="example.com",
+        port=8388,
+        extra={"plugin": "v2ray-plugin"},
+    )
+
+    assert config.get_extra_item(
+        "plugin"
+    ) == "v2ray-plugin"
+    assert config.get_extra_item("missing") is None
+    assert config.get_extra_item(
+        "missing",
+        "default",
+    ) == "default"
+
+
+def test_remove_extra_item():
+    config = ShadowsocksConfig(
+        encryption="aes-256-gcm",
+        password="password",
+        address="example.com",
+        port=8388,
+        extra={"plugin": "v2ray-plugin"},
+    )
+
+    config.remove_extra_item(
+        "plugin"
+    )
+
+    assert config.extra == {}
+
+
 def test_update_methods():
     config = ShadowsocksConfig(
         encryption="aes-256-gcm",

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

@@ -61,12 +61,18 @@ def test_method_chaining():
         "user"
     ).update_password(
         "password"
-    )
+    ).set_extra_item(
+        "version",
+        "5",
+    ).remove_extra_item(
+        "version"
+    ).clear_extra()
 
     assert config.address == "example.org"
     assert config.port == 2080
     assert config.username == "user"
     assert config.password == "password"
+    assert config.extra == {}
 
 
 @pytest.mark.parametrize(
@@ -121,6 +127,63 @@ def test_update_extra():
     assert config.extra["version"] == "5"
 
 
+def test_clear_extra():
+    config = SocksConfig(
+        address="example.com",
+        port=1080,
+        extra={"version": "5"},
+    )
+
+    config.clear_extra()
+
+    assert config.extra == {}
+
+
+def test_set_extra_item():
+    config = SocksConfig(
+        address="example.com",
+        port=1080,
+    )
+
+    config.set_extra_item(
+        "version",
+        "5",
+    )
+
+    assert config.extra["version"] == "5"
+
+
+def test_get_extra_item():
+    config = SocksConfig(
+        address="example.com",
+        port=1080,
+        extra={"version": "5"},
+    )
+
+    assert config.get_extra_item(
+        "version"
+    ) == "5"
+    assert config.get_extra_item("missing") is None
+    assert config.get_extra_item(
+        "missing",
+        "default",
+    ) == "default"
+
+
+def test_remove_extra_item():
+    config = SocksConfig(
+        address="example.com",
+        port=1080,
+        extra={"version": "5"},
+    )
+
+    config.remove_extra_item(
+        "version"
+    )
+
+    assert config.extra == {}
+
+
 def test_to_uri_roundtrip():
     config = SocksConfig(
         address="example.com",

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

@@ -55,11 +55,23 @@ def test_method_chaining():
         port=443,
     )
 
-    config.update_password("new-password").update_address("example.org").update_port(8443)
+    config.update_password(
+        "new-password"
+    ).update_address(
+        "example.org"
+    ).update_port(
+        8443
+    ).set_extra_item(
+        "security",
+        "tls",
+    ).remove_extra_item(
+        "security"
+    ).clear_extra()
 
     assert config.password == "new-password"
     assert config.address == "example.org"
     assert config.port == 8443
+    assert config.extra == {}
 
 
 @pytest.mark.parametrize(
@@ -159,6 +171,67 @@ def test_update_extra():
     assert config.extra["security"] == "tls"
 
 
+def test_clear_extra():
+    config = TrojanConfig(
+        password="password",
+        address="example.com",
+        port=443,
+        extra={"security": "tls"},
+    )
+
+    config.clear_extra()
+
+    assert config.extra == {}
+
+
+def test_set_extra_item():
+    config = TrojanConfig(
+        password="password",
+        address="example.com",
+        port=443,
+    )
+
+    config.set_extra_item(
+        "security",
+        "tls",
+    )
+
+    assert config.extra["security"] == "tls"
+
+
+def test_get_extra_item():
+    config = TrojanConfig(
+        password="password",
+        address="example.com",
+        port=443,
+        extra={"security": "tls"},
+    )
+
+    assert config.get_extra_item(
+        "security"
+    ) == "tls"
+    assert config.get_extra_item("missing") is None
+    assert config.get_extra_item(
+        "missing",
+        "default",
+    ) == "default"
+
+
+def test_remove_extra_item():
+    config = TrojanConfig(
+        password="password",
+        address="example.com",
+        port=443,
+        extra={"security": "tls"},
+    )
+
+    config.remove_extra_item(
+        "security"
+    )
+
+    assert config.extra == {}
+
+
 def test_update_methods():
     config = TrojanConfig(
         password="password",

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

@@ -61,11 +61,17 @@ def test_method_chaining():
         "example.org"
     ).update_port(
         8443
-    )
+    ).set_extra_item(
+        "security",
+        "tls",
+    ).remove_extra_item(
+        "security"
+    ).clear_extra()
 
     assert config.uuid == "2c4b4bca-e3ff-4ca8-a062-6f399ad3cf45"
     assert config.address == "example.org"
     assert config.port == 8443
+    assert config.extra == {}
 
 
 @pytest.mark.parametrize(
@@ -168,6 +174,67 @@ def test_update_extra():
     assert config.extra["security"] == "tls"
 
 
+def test_clear_extra():
+    config = VLESSConfig(
+        uuid="1c4b4bca-e3ff-4ca8-a062-6f399ad3cf45",
+        address="example.com",
+        port=443,
+        extra={"security": "tls"},
+    )
+
+    config.clear_extra()
+
+    assert config.extra == {}
+
+
+def test_set_extra_item():
+    config = VLESSConfig(
+        uuid="1c4b4bca-e3ff-4ca8-a062-6f399ad3cf45",
+        address="example.com",
+        port=443,
+    )
+
+    config.set_extra_item(
+        "security",
+        "tls",
+    )
+
+    assert config.extra["security"] == "tls"
+
+
+def test_get_extra_item():
+    config = VLESSConfig(
+        uuid="1c4b4bca-e3ff-4ca8-a062-6f399ad3cf45",
+        address="example.com",
+        port=443,
+        extra={"security": "tls"},
+    )
+
+    assert config.get_extra_item(
+        "security"
+    ) == "tls"
+    assert config.get_extra_item("missing") is None
+    assert config.get_extra_item(
+        "missing",
+        "default",
+    ) == "default"
+
+
+def test_remove_extra_item():
+    config = VLESSConfig(
+        uuid="1c4b4bca-e3ff-4ca8-a062-6f399ad3cf45",
+        address="example.com",
+        port=443,
+        extra={"security": "tls"},
+    )
+
+    config.remove_extra_item(
+        "security"
+    )
+
+    assert config.extra == {}
+
+
 def test_update_methods():
     config = VLESSConfig(
         uuid="1c4b4bca-e3ff-4ca8-a062-6f399ad3cf45",