Merge branch 'release/3.4.0' into versions

CHANGELOG.md

@@ -19,8 +19,7 @@ If needed, pluralize to `Tasks`, `PRs` or `Authors` and list multiple entries se
 
 ## [Unreleased]
 ### Added
-- Added `round(fractionDigits:rule:)` & `rounded(fractionDigits:rule:)` methods to `Double` type. 
-Author: [Cihat Gündüz](https://github.com/Jeehut)
+- None.
 ### Changed
 - None.
 ### Deprecated
@@ -32,6 +31,11 @@ Author: [Cihat Gündüz](https://github.com/Jeehut)
 ### Security
 - None.
 
+## [3.4.0] - 2021-09-28
+### Added
+- Added new convenience `encrypt(key:)` and `decrypt(key:)` functions to `String` type for platforms supporting `CryptoKit`. Uses AES.GCM algorithm for encryption. 
+ Author: [Cihat Gündüz](https://github.com/Jeehut)
+
 ## [3.3.0] - 2021-01-16
 ### Added
 - Added `round(fractionDigits:rule:)` & `rounded(fractionDigits:rule:)` methods to `Double` type. 

HandySwift.podspec

@@ -1,7 +1,7 @@
 Pod::Spec.new do |s|
 
  s.name = "HandySwift"
- s.version = "3.3.0"
+ s.version = "3.4.0"
  s.summary = "Handy Swift features that didn't make it into the Swift standard library"
 
  s.description = <<-DESC

HandySwift.xcodeproj/project.pbxproj

@@ -28,6 +28,9 @@
  2E61DF7E249E1D37000AF3C5 /* WithableTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 2E61DF7D249E1D37000AF3C5 /* WithableTests.swift */; };
  2E61DF7F249E1D37000AF3C5 /* WithableTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 2E61DF7D249E1D37000AF3C5 /* WithableTests.swift */; };
  2E61DF80249E1D37000AF3C5 /* WithableTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 2E61DF7D249E1D37000AF3C5 /* WithableTests.swift */; };
+ 2E86A32025E5943800845C6D /* DataExt.swift in Sources */ = {isa = PBXBuildFile; fileRef = 2E86A31F25E5943800845C6D /* DataExt.swift */; };
+ 2E86A32125E5943800845C6D /* DataExt.swift in Sources */ = {isa = PBXBuildFile; fileRef = 2E86A31F25E5943800845C6D /* DataExt.swift */; };
+ 2E86A32225E5943800845C6D /* DataExt.swift in Sources */ = {isa = PBXBuildFile; fileRef = 2E86A31F25E5943800845C6D /* DataExt.swift */; };
  3F95C8D220F22A3C0045AFD0 /* CollectionExt.swift in Sources */ = {isa = PBXBuildFile; fileRef = 3F95C8D120F22A3C0045AFD0 /* CollectionExt.swift */; };
  3F95C8D520F22DEE0045AFD0 /* CollectionExtTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 3F95C8D320F22DC60045AFD0 /* CollectionExtTests.swift */; };
  3F95C8D620F22DEF0045AFD0 /* CollectionExtTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 3F95C8D320F22DC60045AFD0 /* CollectionExtTests.swift */; };
@@ -156,6 +159,7 @@
  2E5A375325655F55003704D0 /* StringProtocolExt.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = StringProtocolExt.swift; sourceTree = "<group>"; };
  2E61DF79249E1CA9000AF3C5 /* Withable.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Withable.swift; sourceTree = "<group>"; };
  2E61DF7D249E1D37000AF3C5 /* WithableTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = WithableTests.swift; sourceTree = "<group>"; };
+ 2E86A31F25E5943800845C6D /* DataExt.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DataExt.swift; sourceTree = "<group>"; };
  3F95C8D120F22A3C0045AFD0 /* CollectionExt.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = CollectionExt.swift; sourceTree = "<group>"; };
  3F95C8D320F22DC60045AFD0 /* CollectionExtTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = CollectionExtTests.swift; sourceTree = "<group>"; };
  63651F8F231BFF2000E022DA /* DivisibleArithmetic.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DivisibleArithmetic.swift; sourceTree = "<group>"; };
@@ -284,7 +288,9 @@
  A1F5AEEA1E05700F003D6949 /* RootFiles */,
  823B2B321C24AAB6007B3CDD /* Products */,
  );
+ indentWidth = 4;
  sourceTree = "<group>";
+ tabWidth = 4;
  };
  823B2B321C24AAB6007B3CDD /* Products */ = {
  isa = PBXGroup;
@@ -305,6 +311,7 @@
  82CAE2951C2EE64900F934A7 /* ArrayExt.swift */,
  3F95C8D120F22A3C0045AFD0 /* CollectionExt.swift */,
  CC66E046228199A0007ABF61 /* ComparableExt.swift */,
+ 2E86A31F25E5943800845C6D /* DataExt.swift */,
  8280D7DB1C4A6EC9001172EF /* DictionaryExt.swift */,
  A1F221631E3CC05100419B06 /* DispatchTimeIntervalExt.swift */,
  2E18AD592531DD3D00D44748 /* DoubleExt.swift */,
@@ -783,6 +790,7 @@
  CC120CC2205FDB9300C37D7C /* Regex.swift in Sources */,
  826F69AC1C3895A300B2CC6B /* FrequencyTable.swift in Sources */,
  2E18B292242DECCA000C7776 /* NSObjectExt.swift in Sources */,
+ 2E86A32025E5943800845C6D /* DataExt.swift in Sources */,
  A1F221641E3CC05100419B06 /* DispatchTimeIntervalExt.swift in Sources */,
  8218E4D62211D193007AAAF3 /* NSRangeExt.swift in Sources */,
  3F95C8D220F22A3C0045AFD0 /* CollectionExt.swift in Sources */,
@@ -833,6 +841,7 @@
  CC120CC3205FDC4C00C37D7C /* Regex.swift in Sources */,
  C5CFB6AD20B0A70300830511 /* Unowned.swift in Sources */,
  2E18B293242DECCA000C7776 /* NSObjectExt.swift in Sources */,
+ 2E86A32125E5943800845C6D /* DataExt.swift in Sources */,
  826F69AD1C3895A300B2CC6B /* FrequencyTable.swift in Sources */,
  8218E4D72211D193007AAAF3 /* NSRangeExt.swift in Sources */,
  825EFE051C33358400558497 /* StringExt.swift in Sources */,
@@ -883,6 +892,7 @@
  CC120CC4205FDC4D00C37D7C /* Regex.swift in Sources */,
  C5CFB6AE20B0A70300830511 /* Unowned.swift in Sources */,
  2E18B294242DECCA000C7776 /* NSObjectExt.swift in Sources */,
+ 2E86A32225E5943800845C6D /* DataExt.swift in Sources */,
  826F69AE1C3895A300B2CC6B /* FrequencyTable.swift in Sources */,
  8218E4D82211D193007AAAF3 /* NSRangeExt.swift in Sources */,
  825EFE0B1C33358500558497 /* StringExt.swift in Sources */,

Package.swift

@@ -2,19 +2,12 @@
 import PackageDescription
 
 let package = Package(
- name: "HandySwift",
- products: [
- .library(name: "HandySwift", targets: ["HandySwift"])
- ],
- targets: [
- .target(
- name: "HandySwift",
- exclude: ["Sources/SupportingFiles"]
- ),
- .testTarget(
- name: "HandySwiftTests",
- dependencies: ["HandySwift"],
- exclude: ["Tests/SupportingFiles"]
- )
- ]
+ name: "HandySwift",
+ products: [
+ .library(name: "HandySwift", targets: ["HandySwift"])
+ ],
+ targets: [
+ .target(name: "HandySwift"),
+ .testTarget(name: "HandySwiftTests", dependencies: ["HandySwift"])
+ ]
 )

README.md

@@ -13,8 +13,8 @@
   alt="Coverage"/>
  </a>
  <a href="https://github.com/Flinesoft/HandySwift/releases">
-  <img src="https://img.shields.io/badge/Version-3.3.0-blue.svg"
-  alt="Version: 3.3.0">
+  <img src="https://img.shields.io/badge/Version-3.4.0-blue.svg"
+  alt="Version: 3.4.0">
  </a>
  <img src="https://img.shields.io/badge/Swift-5.1-FFAC45.svg" alt="Swift: 5.1">
  <img src="https://img.shields.io/badge/Platforms-iOS%20%7C%20tvOS%20%7C%20macOS%20%7C%20Linux-FF69B4.svg"
@@ -232,6 +232,28 @@ let unicodeString = "Hello composed unicode symbols! 👨‍👩‍👧‍👦
 unicodeString[unicodeString.fullRange] // => same string
 ```
 
+#### .encrypted(key:)
+
+Encrypts this plain text `String` with the given key using AES.GCM and returns a base64 encoded representation of the encrypted data.
+`@available(macOS 10.15, iOS 13, watchOS 6, tvOS 13, *)`
+
+``` Swift
+let key = SymmetricKey(size: .bits256)
+
+let plainText = "Harry Potter is a 🧙"
+let encryptedString = try plainText.encrypted(key: key) // => "nz9LDkTNUEFj16Hrqvs4oCYeuIgV+nSP4OSqahkbtH62eJHHW664wC8NeFAMBPq7ZsY="
+```
+
+#### .decrypted(key:)
+
+Decrypts this base64 encoded representation of encrypted data with the given key using AES.GCM and returns the decrypted plain text `String`.
+`@available(macOS 10.15, iOS 13, watchOS 6, tvOS 13, *)`
+
+``` Swift
+encryptedString.decrypt(key: key) // => "Harry Potter is a 🧙"
+```
+
+
 ### NSRangeExtension
 
 #### init(_:in:)
@@ -608,7 +630,7 @@ foo2.isEasy // => true
 
 ## Donation
 
-BartyCrouch was brought to you by [Cihat Gündüz](https://github.com/Jeehut) in his free time. If you want to thank me and support the development of this project, please **make a small donation on [PayPal](https://paypal.me/Dschee/5EUR)**. In case you also like my other [open source contributions](https://github.com/Flinesoft) and [articles](https://medium.com/@Jeehut), please consider motivating me by **becoming a sponsor on [GitHub](https://github.com/sponsors/Jeehut)** or a **patron on [Patreon](https://www.patreon.com/Jeehut)**.
+HandySwift was brought to you by [Cihat Gündüz](https://github.com/Jeehut) in his free time. If you want to thank me and support the development of this project, please **make a small donation on [PayPal](https://paypal.me/Dschee/5EUR)**. In case you also like my other [open source contributions](https://github.com/Flinesoft) and [articles](https://medium.com/@Jeehut), please consider motivating me by **becoming a sponsor on [GitHub](https://github.com/sponsors/Jeehut)** or a **patron on [Patreon](https://www.patreon.com/Jeehut)**.
 
 Thank you very much for any donation, it really helps out a lot! 💯