iOS · macOS · watchOS · tvOS
A pure Swift library that allows you to easily convert Countries to Country Codes and Country Codes to Countries.
There is also support for other types. Currently all supported types are Countries, Alpha2Codes, Alpha3Codes and Numerics.
This project is created and maintained by Novem.
Installation
Swift Package Manager
You can use The Swift Package Manager (SPM) to install NVMRegion by adding the following description to your Package.swift file:
import PackageDescription
let package = Package(
name: "YOUR_PROJECT_NAME",
dependencies: [
.package(url: "https://github.com/NVMNovem/NVMRegion", from: "1.0.0"),
]
)
Then run swift build.
You can also install using SPM in your Xcode project by going to "Project->NameOfYourProject->Swift Packages" and placing "https://github.com/NVMNovem/NVMRegion" in the search field. Then select the option that is most suited for your needs.
Usage Guide
Code
To use NVMRegion, there is no initalizing required. If you want to add custom Country Aliases, you need to add the in the initalizing of your app. Example use case for a custom country name for Belgium. The example will allow the translated version "België" to be converted to a Country: "Belgium".
@main
struct MyApp: App {
init() {
NVMRegion.implementCountryAliases(["België" : .Belgium])
}
var body: some Scene {
WindowGroup {
ContentView()
}
}
}
This will make it possible to create a Country() object from "België". This is not required for default country names. NVMRegion also tries to find the most fitted country for each given string.
Country("België")
This will return a valid Country() object
(
Belgium
Continent: Europe
Alpha2 Code: BE
Alpha3 Code: BEL
Numeric: N056
)
24 Nov 11, 2021
0 Feb 27, 2022
2 May 9, 2022
243 Dec 8, 2022
183 Dec 5, 2022
241 Dec 13, 2022
643 Sep 8, 2022
851 Dec 17, 2022
223 Dec 2, 2022
380 Dec 6, 2022
7 May 13, 2022
125 Jan 13, 2022
21 Sep 25, 2022
27 Jun 3, 2021
125 Dec 13, 2022
432 Jan 3, 2023
5.5k Dec 22, 2022
24 Nov 11, 2021
0 Feb 27, 2022
243 Dec 8, 2022
207 Dec 22, 2022
459 Dec 27, 2022
71 Jul 11, 2022
90 Mar 27, 2021
0 Nov 6, 2021
59 Dec 29, 2022
0 Jan 8, 2022