wevah / idna-cocoa Goto Github PK

View Code? Open in Web Editor NEW

59.0 4.0 16.0 6.02 MB

Simple interface for IDNA on String and NSString

License: Other

Objective-C 10.39% Ruby 2.12% Swift 87.48%

punycode idna macos ios url

idna-cocoa's Introduction

IDNA Cocoa

v2.0b4 (2021) by Nate Weaver (Wevah)
https://derailer.org/
https://github.com/Wevah/Punycode-Cocoa

An IDNA String extension and NSString overlay, based on UTS #46. Currently implents the full conversion table and joiner validation.

Use this to convert internationalized domain names (IDN) between Unicode and ASCII.

To use in your own projects, this repository can be imported as a Swift package.

Alternatively, the files can be manually included: Everything in Sources/IDNA:

UTS46.swift
UTS46+Loading.swift
Data+Extensions.swift
Scanner+Extensions.swift
String+Punycode.swift

If your project needs to call from Objective-C make sure to include NSString+IDNA.swift for the NSString overlays.

(UTS46+Conversion.swift is for importing text files containing UTS #46 mappings and exporting to the binary format used by UTS46+Loading.swift, and isn't necessary if you just want to use the encoding/decoding routines.)

Note that these API currently don't do homograph detection.

Interface

String/NSString

Swift:

var idnaEncoded: String? { get }

Objective-C:

@property (readonly, copy, nullable) NSString *IDNAEncodedString;

If self contains non-ASCII, encodes the string's domain components as Punycode and prepends xn-- to the transformed components.

Swift:

var idnaDecoded: String? { get }

Objective-C:

@property (readonly, copy, nullable) NSString *IDNADecodedString;

Decodes a string returned by idnaEncoded/-IDNAEncodedString.

Swift:

var encodedURLString: String? { get }
var decodedURLString: String? { get }

Objective-C:

@property (readonly, copy, nullable) NSString *encodedURLString;
@property (readonly, copy, nullable) NSString *decodedURLString;

Performs Punycode encode/decode operations on each appropriate part (the domain bits) of an URL string, and URL encodes/decodes the path/query/fragment.

URL/NSURL

Swift:

init?(unicodeString: String)

Objective-C:

+ (nullable instancetype)URLWithUnicodeString:(NSString *)URLString;

Convenience initializer equivalent to URL(string: unicodeString.encodedURLString)/ [NSURL URLWithString:URLString.encodedURLString].

Swift:

var decodedURLString: String? { get }

Objective-C:

@property (readonly, copy, nullable) NSString *decodedURLString;

Convenience property equivalent to someURL.absoluteString.decodedURLString.

Swift:

init?(unicodeString: String, relativeTo url: URL?) {

Objective-C:

+ (nullable instancetype)URLWithUnicodeString:(NSString *)URLString relativeToURL:(nullable NSURL *)baseURL;

Convenience initializer for creating a URL from a Unicode string, relative to another URL.

idna-cocoa's People

Contributors

Stargazers

Watchers

Forkers

hjzc theodorosd orkoden ladieschris jbrayton kurebio kolyvan zalexej jhammer croquiscom mint43 ryotofujii kakao-landon-kim

idna-cocoa's Issues

Can't compile for iOS 9.3

This might be toolchain bug, but I figured I'd mention it here just in case you have any ideas.

I can no longer build my app that targets iOS 9.3, where I used to be able to

URL+Encode.swift:2:8: error build: Compiling for iOS 9.3, but module 'IDNA' has a minimum deployment target of iOS 11.0: <>/Build/Products/Debug-iphoneos/IDNA.swiftmodule/arm64-apple-ios.swiftmodule

I'm pinned to commit 3f769fd, but also tried 1f18874.

I see that the package specifically supports iOS 9 in the Package.swift file.

Support carthage

@Wevah Hello, do you have any plan to support carthage?

Xcode 4.5 Warnings

NSStringPunycodeAdditions.m:119:25: Format specifies type 'unsigned short' but the argument has type 'UTF32Char' (aka 'unsigned long')
NSStringPunycodeAdditions.m:128:24: Format specifies type 'unsigned short' but the argument has type 'int'
NSStringPunycodeAdditions.m:159:27: Format specifies type 'unsigned short' but the argument has type 'char'
NSStringPunycodeAdditions.m:163:26: Format specifies type 'unsigned short' but the argument has type 'char'

Write a pure Obj-C client implementation

So I can update the pod and not break people's expectations.

Incorrect punycodes for emoji?

I'm trying to encode emoji like 😀 and ⬛️ to punycode.

I noticed that Safari (and this converter) encode some emoji differently than the library. Is this a bug causing something extra to get appended or is it just a disparity in encodings?

Emoji	Safari	Punycode-Cocoa
😀	`xn--e28h`	`xn--e28h`
⬛️	`xn--w5i`	`xn--w5ix313e`
▪️	`xn--30h`	`xn--30h0620f`

URLParts -> NSURLComponents

I think you'll have slightly less janky code if you use NSURLComponents to digest a particular url into its components rather than scanning through strings for separator characters.

decodedURLString rus

http://президент.рф

encodedURLString = http://xn--d1abbgf6aiiy.xn--p1ai/ - it's ok.
decodedURLString = http://сзжмонддд.фр/ - issue

NSLog(@"[%@] [%@] [%@]", url.text, [ url.text encodedURLString ], [ [ url.text encodedURLString ] decodedURLString ]);

output = [президент.рф] [xn--d1abbgf6aiiy.xn--p1ai] [сзжмонддд.фр]

Convert to a full UTS #46 implementation

Its's almost there already.

Remove unneeded ICU headers

Using with Swift 3.0

Any suggestion how I can use this with Swift 3.0 via pod?

Use URLComponents on Ventura+

URLComponents on Ventura and up properly encode the host using Punycode (Monterey and under incorrectly percent-encode/decode the host parts).

Note: URL on Sonoma and up (will) directly support Punycoding also, but IDNA-Cocoa already tries URL first, so no changes need to be made there.

File rearranging broke pod

Missing tag 2.0 for Punycode-Cocoa.podspec

The podspec for v2.0 was released earlier, but there is no "2.0" tagged commit.
So I can't use v2.0 Punycode-Cocoa.
And v1.3.1 is the latest version release of CocoaPod.

I would expect v2.0 to be available on a cocoapod or to be resolved tagging problem.

I have been using punycode-ccocoa well and it is very much appreciated.

Swift package

With the ability to add resources to Swift packages, this is now possible.

Xcode 9 Warning

Xcode 9 warns about Possible misuse of comma operator here:

NSStringPunycodeAdditions.m on line 206:

++delta, ++n;

encodedURLString issue

Hello again!

http://music.sogou.com/singer/89/detailAlbum_%BA%E9%D7%BF%C1%A2!!grown%20up.html?w=02015000

encoded to

http://music.sogou.com(null)

becouse stringByReplacingPercentEscapesUsingEncoding:NSUTF8StringEncoding return nil in encodedURLString.
For what need:

NSString *path = [[[urlParts objectForKey:@"path"] stringByReplacingPercentEscapesUsingEncoding:NSUTF8StringEncoding] stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];

instead:

NSString *path = [urlParts objectForKey:@"path"];

But if I put in https://www.google.co.jp/webhp?<stuff>#q=渋谷 into Punycode-Cocoa's + (NSURL *)URLWithUnicodeString:(NSString *)URLString;, it will return nil.

This can easily be solved by just URL encoding the fragment here.

What do you think, would there be any problem with other URLs by adding this?

wevah / idna-cocoa Goto Github PK

idna-cocoa's Introduction

IDNA Cocoa

Interface

String/NSString

Swift:

Objective-C:

Swift:

Objective-C:

Swift:

Objective-C:

URL/NSURL

Swift:

Objective-C:

Swift:

Objective-C:

Swift:

Objective-C:

idna-cocoa's People

Contributors

Stargazers

Watchers

Forkers

idna-cocoa's Issues

Recommend Projects

Recommend Topics

Recommend Org