simpleidn 0.2.3 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bc28e3f1151e0c2355f2e74c9d86c2a4d3df9a3154ceec4b6e5d40c59e47f9a3
-  data.tar.gz: 294aeff28e2d897eb97e311d5758449ea474ad82d08ef421ddd5276464379e51
+  metadata.gz: 8da67fb828aa058412a4960c2597150bc1b0398f09105233503f365180ed2943
+  data.tar.gz: dd94de768681589e3ab0f60dccbb0666c4a1668e9ebdd334e25c1cfc24c5f9ff
 SHA512:
-  metadata.gz: 688866028bccaeb4a80d863a020f7c0604575a60532c8fd2dc99780e6a3b9e7a1213dad7f2cab2533e8c78a947ce6ae029570b9394fbe30d9a1970779b074f35
-  data.tar.gz: a105c8a6ecd3f25fe3253c789896011c487567a9ed4fabf529f6080f7ef648343e0592fd4440d6edbe9423d0263ee30d0aa9a602d3618b83f1b67a3a1656fa66
+  metadata.gz: cb81fc35814b5d7f0f273736ab9e849e45799ed04917d6629d794f2c35af41fd8a30066c0d709dea47e6f8849b657f45b0f77b8d0a830251e5d5f84a94eda324
+  data.tar.gz: fff721ec7eaa0831a8852525bd5ab292f8caacef97b58e737cf874b5755902c88b2b76f542909ef19128ef4d593ed70611548db14d61fa09cb0273fe52978cc4

data/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+## 0.3.0 (2026-09-01)
+
+- Update the UTS #46 / IDNA mapping table to Unicode 17.0.0 (was 15.1.0).
+- `to_unicode` now raises `SimpleIDN::ConversionError` when an `xn--` label decodes to an empty or all-ASCII string. UTS #46 (Processing step 4.2) requires this, and it closes a spoofing loophole.
+- Move CI from Travis to GitHub Actions. Test on Ruby 2.7–3.5, JRuby, and TruffleRuby, plus Windows and macOS.
+- Reduce the packaged gem size. The gem no longer ships the raw `IdnaMappingTable.txt` source data.
+- Add gemspec metadata (source code, changelog, bug tracker URIs) and require MFA for gem pushes.
+- Convert the README to Markdown and expand the documentation.
+- Add edge-case specs: encodings, frozen strings, emoji, transitional mode, alternative label separators, and the new error cases.
+
+## 0.2.3 (2024-05-22)
+
+- Update the UTS #46 / IDNA mapping table to Unicode 15.1.
+- Drop the `unf` runtime dependency. The gem now has no runtime dependencies.
+
+## 0.2.2 (2024-04-26)
+
+- Fix file permissions in the packaged gem.
+
+## 0.2.1 (2021-01-14)
+
+- Punycode and UTS #46 mapping fixes.
+
+Earlier releases are not documented here. See the git history.

data/LICENCE

@@ -1,21 +1,21 @@
-The MIT License
-
-Copyright (c) 2011-2024 Morten Møller Riis
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-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 OR COPYRIGHT HOLDERS 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.
+The MIT License
+
+Copyright (c) 2011-2024 Morten Møller Riis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+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 OR COPYRIGHT HOLDERS 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.

data/README.md

@@ -0,0 +1,82 @@
+# SimpleIDN
+
+[![CI](https://github.com/mmriis/simpleidn/actions/workflows/ci.yml/badge.svg)](https://github.com/mmriis/simpleidn/actions/workflows/ci.yml)
+[![Gem Version](https://badge.fury.io/rb/simpleidn.svg)](https://rubygems.org/gems/simpleidn)
+
+This gem converts punycode ACE strings to unicode UTF-8 strings and vice versa. It is pure Ruby and has no runtime dependencies.
+
+The punycode conversion is based on the RFC 3492 C example implementation. It is simplified and does not preserve case. Input is first mapped with the UTS #46 (IDNA Compatible Preprocessing) mapping table. The bundled mapping table is generated from **Unicode 17.0.0**.
+
+The gem works with Ruby 2.2 and later, JRuby, and TruffleRuby.
+
+## Installation
+
+```
+gem install simpleidn
+```
+
+## Usage
+
+```ruby
+require 'simpleidn'
+
+SimpleIDN.to_unicode("xn--mllerriis-l8a.com")
+# => "møllerriis.com"
+
+SimpleIDN.to_ascii("møllerriis.com")
+# => "xn--mllerriis-l8a.com"
+```
+
+### Transitional processing
+
+`to_ascii` and `to_unicode` accept an optional second argument, `transitional` (default `false`).
+When `true`, the deviation characters `ß`, `ς`, ZWJ, and ZWNJ are mapped as in IDNA2003:
+
+```ruby
+SimpleIDN.to_ascii("faß.de")
+# => "xn--fa-hia.de"
+
+SimpleIDN.to_ascii("faß.de", true)
+# => "fass.de"
+```
+
+Unicode removed transitional processing from UTS #46 in Unicode 16.0. The argument stays for backward compatibility. Use the default (`false`) unless you must match legacy IDNA2003 behavior.
+
+### Errors
+
+Invalid input raises `SimpleIDN::ConversionError`, a subclass of `RangeError`:
+
+```ruby
+SimpleIDN.to_unicode("xn---")
+# => SimpleIDN::ConversionError
+```
+
+This includes `xn--` labels that decode to an empty or all-ASCII string, as required by UTS #46.
+
+## Scope and known issues
+
+- Case is not preserved.
+- This is not a full UTS #46 / IDNA2008 implementation. The gem maps and converts labels. It does not enforce validity rules such as bidi rules, joiner context rules, or label length limits.
+
+Please report any issues!
+
+## Development
+
+Run the tests:
+
+```
+bundle install
+bundle exec rspec
+```
+
+The test suite includes the official Unicode `IdnaTestV2.txt` conformance vectors and the JOSEFSSON test vectors.
+
+To update the UTS #46 mapping table, download the new `IdnaMappingTable.txt` and `IdnaTestV2.txt` from [unicode.org](https://www.unicode.org/Public/idna/latest/) into `tables/` and `spec/`, then regenerate:
+
+```
+ruby tables/generate_mapping_table.rb tables/IdnaMappingTable.txt > lib/simpleidn/uts46mapping.rb
+```
+
+## License
+
+MIT. See [LICENCE](LICENCE).

data/lib/simpleidn/uts46mapping.rb

@@ -1,13 +1,13 @@
 # encoding: UTF-8
 
 # IdnaMappingTable.txt
-# Date: 2023-08-10, 22:32:27 GMT
-# © 2023 Unicode®, Inc.
+# Date: 2025-07-25, 18:08:44 GMT
+# © 2025 Unicode®, Inc.
 # Unicode and the Unicode Logo are registered trademarks of Unicode, Inc. in the U.S. and other countries.
-# For terms of use, see https://www.unicode.org/terms_of_use.html
+# For terms of use and license, see https://www.unicode.org/terms_of_use.html
 #
 # Unicode IDNA Compatible Preprocessing for UTS #46
-# Version: 15.1.0
+# Version: 17.0.0
 #
 # For documentation and usage, see https://www.unicode.org/reports/tr46
 #
@@ -456,6 +456,7 @@ module SimpleIDN
     1210 => 1211,
     1212 => 1213,
     1214 => 1215,
+    1216 => 1231,
     1217 => 1218,
     1219 => 1220,
     1221 => 1222,
@@ -597,18 +598,61 @@ module SimpleIDN
     4007 => [4006, 4023],
     4012 => [4011, 4023],
     4025 => [3984, 4021],
+    4256 => 11520,
+    4257 => 11521,
+    4258 => 11522,
+    4259 => 11523,
+    4260 => 11524,
+    4261 => 11525,
+    4262 => 11526,
+    4263 => 11527,
+    4264 => 11528,
+    4265 => 11529,
+    4266 => 11530,
+    4267 => 11531,
+    4268 => 11532,
+    4269 => 11533,
+    4270 => 11534,
+    4271 => 11535,
+    4272 => 11536,
+    4273 => 11537,
+    4274 => 11538,
+    4275 => 11539,
+    4276 => 11540,
+    4277 => 11541,
+    4278 => 11542,
+    4279 => 11543,
+    4280 => 11544,
+    4281 => 11545,
+    4282 => 11546,
+    4283 => 11547,
+    4284 => 11548,
+    4285 => 11549,
+    4286 => 11550,
+    4287 => 11551,
+    4288 => 11552,
+    4289 => 11553,
+    4290 => 11554,
+    4291 => 11555,
+    4292 => 11556,
+    4293 => 11557,
     4295 => 11559,
     4301 => 11565,
     4348 => 4316,
+    4447 => [],
+    4448 => [],
     5112 => 5104,
     5113 => 5105,
     5114 => 5106,
     5115 => 5107,
     5116 => 5108,
     5117 => 5109,
+    6068 => [],
+    6069 => [],
     6155 => [],
     6156 => [],
     6157 => [],
+    6158 => [],
     6159 => [],
     7296 => 1074,
     7297 => 1076,
@@ -619,6 +663,7 @@ module SimpleIDN
     7302 => 1098,
     7303 => 1123,
     7304 => 42571,
+    7305 => 7306,
     7312 => 4304,
     7313 => 4305,
     7314 => 4306,
@@ -1073,7 +1118,16 @@ module SimpleIDN
     8279 => [8242, 8242, 8242, 8242],
     8287 => 32,
     8288 => [],
+    8289 => [],
+    8290 => [],
+    8291 => [],
     8292 => [],
+    8298 => [],
+    8299 => [],
+    8300 => [],
+    8301 => [],
+    8302 => [],
+    8303 => [],
     8304 => 48,
     8305 => 105,
     8308 => 52,
@@ -1155,6 +1209,7 @@ module SimpleIDN
     8495 => 101,
     8496 => 101,
     8497 => 102,
+    8498 => 8526,
     8499 => 109,
     8500 => 111,
     8501 => 1488,
@@ -1221,6 +1276,7 @@ module SimpleIDN
     8573 => 99,
     8574 => 100,
     8575 => 109,
+    8579 => 8580,
     8585 => [48, 8260, 51],
     8748 => [8747, 8747],
     8749 => [8747, 8747, 8747],
@@ -1748,6 +1804,7 @@ module SimpleIDN
     12641 => 4467,
     12642 => 4468,
     12643 => 4469,
+    12644 => [],
     12645 => 4372,
     12646 => 4373,
     12647 => 4551,
@@ -2425,9 +2482,17 @@ module SimpleIDN
     42950 => 7566,
     42951 => 42952,
     42953 => 42954,
+    42955 => 612,
+    42956 => 42957,
+    42958 => 42959,
     42960 => 42961,
+    42962 => 42963,
+    42964 => 42965,
     42966 => 42967,
     42968 => 42969,
+    42970 => 42971,
+    42972 => 411,
+    42993 => 115,
     42994 => 99,
     42995 => 102,
     42996 => 113,
@@ -4005,6 +4070,7 @@ module SimpleIDN
     65437 => 12531,
     65438 => 12441,
     65439 => 12442,
+    65440 => [],
     65441 => 4352,
     65442 => 4353,
     65443 => 4522,
@@ -4288,6 +4354,28 @@ module SimpleIDN
     68784 => 68848,
     68785 => 68849,
     68786 => 68850,
+    68944 => 68976,
+    68945 => 68977,
+    68946 => 68978,
+    68947 => 68979,
+    68948 => 68980,
+    68949 => 68981,
+    68950 => 68982,
+    68951 => 68983,
+    68952 => 68984,
+    68953 => 68985,
+    68954 => 68986,
+    68955 => 68987,
+    68956 => 68988,
+    68957 => 68989,
+    68958 => 68990,
+    68959 => 68991,
+    68960 => 68992,
+    68961 => 68993,
+    68962 => 68994,
+    68963 => 68995,
+    68964 => 68996,
+    68965 => 68997,
     71840 => 71872,
     71841 => 71873,
     71842 => 71874,
@@ -4352,10 +4440,71 @@ module SimpleIDN
     93789 => 93821,
     93790 => 93822,
     93791 => 93823,
+    93856 => 93883,
+    93857 => 93884,
+    93858 => 93885,
+    93859 => 93886,
+    93860 => 93887,
+    93861 => 93888,
+    93862 => 93889,
+    93863 => 93890,
+    93864 => 93891,
+    93865 => 93892,
+    93866 => 93893,
+    93867 => 93894,
+    93868 => 93895,
+    93869 => 93896,
+    93870 => 93897,
+    93871 => 93898,
+    93872 => 93899,
+    93873 => 93900,
+    93874 => 93901,
+    93875 => 93902,
+    93876 => 93903,
+    93877 => 93904,
+    93878 => 93905,
+    93879 => 93906,
+    93880 => 93907,
     113824 => [],
     113825 => [],
     113826 => [],
     113827 => [],
+    117974 => 97,
+    117975 => 98,
+    117976 => 99,
+    117977 => 100,
+    117978 => 101,
+    117979 => 102,
+    117980 => 103,
+    117981 => 104,
+    117982 => 105,
+    117983 => 106,
+    117984 => 107,
+    117985 => 108,
+    117986 => 109,
+    117987 => 110,
+    117988 => 111,
+    117989 => 112,
+    117990 => 113,
+    117991 => 114,
+    117992 => 115,
+    117993 => 116,
+    117994 => 117,
+    117995 => 118,
+    117996 => 119,
+    117997 => 120,
+    117998 => 121,
+    117999 => 122,
+    118000 => 48,
+    118001 => 49,
+    118002 => 50,
+    118003 => 51,
+    118004 => 52,
+    118005 => 53,
+    118006 => 54,
+    118007 => 55,
+    118008 => 56,
+    118009 => 57,
     119134 => [119127, 119141],
     119135 => [119128, 119141],
     119136 => [119128, 119141, 119150],
@@ -4363,6 +4512,14 @@ module SimpleIDN
     119138 => [119128, 119141, 119152],
     119139 => [119128, 119141, 119153],
     119140 => [119128, 119141, 119154],
+    119155 => [],
+    119156 => [],
+    119157 => [],
+    119158 => [],
+    119159 => [],
+    119160 => [],
+    119161 => [],
+    119162 => [],
     119227 => [119225, 119141],
     119228 => [119226, 119141],
     119229 => [119225, 119141, 119150],
@@ -5851,6 +6008,7 @@ module SimpleIDN
     194661 => 23000,
     194662 => 23142,
     194663 => 14062,
+    194664 => 14076,
     194665 => 23304,
     194666 => 23358,
     194667 => 23358,
@@ -5862,6 +6020,7 @@ module SimpleIDN
     194673 => 138008,
     194674 => 23551,
     194675 => 23558,
+    194676 => 24403,
     194677 => 23586,
     194678 => 14209,
     194679 => 23648,
@@ -6032,6 +6191,7 @@ module SimpleIDN
     194844 => 28997,
     194845 => 148067,
     194846 => 29084,
+    194847 => 148395,
     194848 => 29224,
     194849 => 29237,
     194850 => 29264,
@@ -6095,6 +6255,7 @@ module SimpleIDN
     194908 => 153980,
     194909 => 154279,
     194910 => 154279,
+    194911 => 31470,
     194912 => 16898,
     194913 => 154539,
     194914 => 31686,
@@ -6190,6 +6351,7 @@ module SimpleIDN
     195004 => 34600,
     195005 => 34667,
     195006 => 34694,
+    195007 => 17879,
     195008 => 34785,
     195009 => 34817,
     195010 => 17913,

data/lib/simpleidn/version.rb

@@ -1,3 +1,3 @@
 module SimpleIDN
-  VERSION = "0.2.3"
+  VERSION = "0.3.0"
 end