diff --git a/examples/example3/README.md b/examples/example3/README.md
new file mode 100644
index 00000000..bf668c6d
--- /dev/null
+++ b/examples/example3/README.md
@@ -0,0 +1,32 @@
+
+# Example 3
+
+This is a simple example to show how DiffSync can be used to compare and synchronize data with a remote system like via a REST API like Nautobot.
+
+For this example, we have a shared model for Region and Country defined in `models.py`.
+A Country must be associated with a Region and can be part of a Subregion too.
+
+The comparison and synchronization of dataset is done between a local JSON file and the [public instance of Nautobot](https://demo.nautobot.com).
+
+
+## Install the requirements
+
+to use this example you must have some dependencies installed, please make sure to run 
+```
+pip install -r requirements.txt
+```
+
+## Try the example
+
+The first time a lot of changes should be reported between Nautobot and the local data because by default the demo instance doesn't have the subregion define.
+After the first sync, the diff should show no difference. 
+At this point, Diffsync will be able to identify and fix all changes in Nautobot. You can try to add/update or delete any country in Nautobot and DiffSync will automatically catch it and it will fix it with running in sync mode.
+
+```
+### DIFF Compare the data between Nautobot and the local JSON file.
+main.py --diff
+
+### SYNC Update the list of country in Nautobot.
+main.py --sync
+```
+
diff --git a/examples/example3/countries.json b/examples/example3/countries.json
new file mode 100644
index 00000000..8828a0e8
--- /dev/null
+++ b/examples/example3/countries.json
@@ -0,0 +1,1626 @@
+[
+    {
+      "country": "Vatican City",
+      "pop2021": "0.8000",
+      "area": 1,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Tokelau",
+      "pop2021": "1.3730",
+      "area": 12,
+      "region": "Oceania",
+      "subregion": "Polynesia"
+    },
+    {
+      "country": "Niue",
+      "pop2021": "1.6190",
+      "area": 260,
+      "region": "Oceania",
+      "subregion": "Polynesia"
+    },
+    {
+      "country": "Falkland Islands",
+      "pop2021": "3.5330",
+      "area": 12173,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Montserrat",
+      "pop2021": "4.9770",
+      "area": 102,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Saint Pierre and Miquelon",
+      "pop2021": "5.7660",
+      "area": 242,
+      "region": "Americas",
+      "subregion": "Northern America"
+    },
+    {
+      "country": "Saint Barthelemy",
+      "pop2021": "9.9070",
+      "area": 21,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Nauru",
+      "pop2021": "10.8760",
+      "area": 21,
+      "region": "Oceania",
+      "subregion": "Micronesia"
+    },
+    {
+      "country": "Wallis and Futuna",
+      "pop2021": "11.0940",
+      "area": 142,
+      "region": "Oceania",
+      "subregion": "Polynesia"
+    },
+    {
+      "country": "Tuvalu",
+      "pop2021": "11.9310",
+      "area": 26,
+      "region": "Oceania",
+      "subregion": "Polynesia"
+    },
+    {
+      "country": "Anguilla",
+      "pop2021": "15.1170",
+      "area": 91,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Cook Islands",
+      "pop2021": "17.5650",
+      "area": 236,
+      "region": "Oceania",
+      "subregion": "Polynesia"
+    },
+    {
+      "country": "Palau",
+      "pop2021": "18.1690",
+      "area": 459,
+      "region": "Oceania",
+      "subregion": "Micronesia"
+    },
+    {
+      "country": "British Virgin Islands",
+      "pop2021": "30.4210",
+      "area": 151,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Gibraltar",
+      "pop2021": "33.6980",
+      "area": 6,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "San Marino",
+      "pop2021": "34.0170",
+      "area": 61,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Liechtenstein",
+      "pop2021": "38.2500",
+      "area": 160,
+      "region": "Europe",
+      "subregion": "Western Europe"
+    },
+    {
+      "country": "Turks and Caicos Islands",
+      "pop2021": "39.2310",
+      "area": 948,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Saint Martin",
+      "pop2021": "39.2340",
+      "area": 53,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Monaco",
+      "pop2021": "39.5110",
+      "area": 2,
+      "region": "Europe",
+      "subregion": "Western Europe"
+    },
+    {
+      "country": "Sint Maarten",
+      "pop2021": "43.4120",
+      "area": 34,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Faroe Islands",
+      "pop2021": "49.0490",
+      "area": 1393,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Saint Kitts and Nevis",
+      "pop2021": "53.5440",
+      "area": 261,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "American Samoa",
+      "pop2021": "55.1000",
+      "area": 199,
+      "region": "Oceania",
+      "subregion": "Polynesia"
+    },
+    {
+      "country": "Greenland",
+      "pop2021": "56.8770",
+      "area": 2166086,
+      "region": "Americas",
+      "subregion": "Northern America"
+    },
+    {
+      "country": "Northern Mariana Islands",
+      "pop2021": "57.9170",
+      "area": 464,
+      "region": "Oceania",
+      "subregion": "Micronesia"
+    },
+    {
+      "country": "Marshall Islands",
+      "pop2021": "59.6100",
+      "area": 181,
+      "region": "Oceania",
+      "subregion": "Micronesia"
+    },
+    {
+      "country": "Bermuda",
+      "pop2021": "62.0900",
+      "area": 54,
+      "region": "Americas",
+      "subregion": "Northern America"
+    },
+    {
+      "country": "Cayman Islands",
+      "pop2021": "66.4970",
+      "area": 264,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Dominica",
+      "pop2021": "72.1670",
+      "area": 751,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Andorra",
+      "pop2021": "77.3550",
+      "area": 468,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Isle of Man",
+      "pop2021": "85.4100",
+      "area": 572,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Antigua and Barbuda",
+      "pop2021": "98.7310",
+      "area": 442,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Seychelles",
+      "pop2021": "98.9080",
+      "area": 452,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "United States Virgin Islands",
+      "pop2021": "104.2260",
+      "area": 347,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Tonga",
+      "pop2021": "106.7600",
+      "area": 747,
+      "region": "Oceania",
+      "subregion": "Polynesia"
+    },
+    {
+      "country": "Aruba",
+      "pop2021": "107.2040",
+      "area": 180,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Saint Vincent and the Grenadines",
+      "pop2021": "111.2630",
+      "area": 389,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Grenada",
+      "pop2021": "113.0210",
+      "area": 344,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Micronesia",
+      "pop2021": "116.2540",
+      "area": 702,
+      "region": "Oceania",
+      "subregion": "Micronesia"
+    },
+    {
+      "country": "Kiribati",
+      "pop2021": "121.3920",
+      "area": 811,
+      "region": "Oceania",
+      "subregion": "Micronesia"
+    },
+    {
+      "country": "Curacao",
+      "pop2021": "164.7980",
+      "area": 444,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Guam",
+      "pop2021": "170.1790",
+      "area": 549,
+      "region": "Oceania",
+      "subregion": "Micronesia"
+    },
+    {
+      "country": "Saint Lucia",
+      "pop2021": "184.4000",
+      "area": 616,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Samoa",
+      "pop2021": "200.1490",
+      "area": 2842,
+      "region": "Oceania",
+      "subregion": "Polynesia"
+    },
+    {
+      "country": "Sao Tome and Principe",
+      "pop2021": "223.3680",
+      "area": 964,
+      "region": "Africa",
+      "subregion": "Middle Africa"
+    },
+    {
+      "country": "Mayotte",
+      "pop2021": "279.5150",
+      "area": 374,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "French Polynesia",
+      "pop2021": "282.5300",
+      "area": 4167,
+      "region": "Oceania",
+      "subregion": "Polynesia"
+    },
+    {
+      "country": "Barbados",
+      "pop2021": "287.7110",
+      "area": 430,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "New Caledonia",
+      "pop2021": "288.2180",
+      "area": 18575,
+      "region": "Oceania",
+      "subregion": "Melanesia"
+    },
+    {
+      "country": "French Guiana",
+      "pop2021": "306.4480",
+      "area": 83534,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Vanuatu",
+      "pop2021": "314.4640",
+      "area": 12189,
+      "region": "Oceania",
+      "subregion": "Melanesia"
+    },
+    {
+      "country": "Iceland",
+      "pop2021": "343.3530",
+      "area": 103000,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Martinique",
+      "pop2021": "374.7450",
+      "area": 1128,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Bahamas",
+      "pop2021": "396.9130",
+      "area": 13943,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Guadeloupe",
+      "pop2021": "400.0200",
+      "area": 1628,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Belize",
+      "pop2021": "404.9140",
+      "area": 22966,
+      "region": "Americas",
+      "subregion": "Central America"
+    },
+    {
+      "country": "Brunei",
+      "pop2021": "441.5320",
+      "area": 5765,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "Malta",
+      "pop2021": "442.7840",
+      "area": 316,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Maldives",
+      "pop2021": "543.6170",
+      "area": 300,
+      "region": "Asia",
+      "subregion": "Southern Asia"
+    },
+    {
+      "country": "Cape Verde",
+      "pop2021": "561.8980",
+      "area": 4033,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Suriname",
+      "pop2021": "591.8000",
+      "area": 163820,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Western Sahara",
+      "pop2021": "611.8750",
+      "area": 266000,
+      "region": "Africa",
+      "subregion": "Northern Africa"
+    },
+    {
+      "country": "Montenegro",
+      "pop2021": "628.0530",
+      "area": 13812,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Luxembourg",
+      "pop2021": "634.8140",
+      "area": 2586,
+      "region": "Europe",
+      "subregion": "Western Europe"
+    },
+    {
+      "country": "Macau",
+      "pop2021": "658.3940",
+      "area": 30,
+      "region": "Asia",
+      "subregion": "Eastern Asia"
+    },
+    {
+      "country": "Solomon Islands",
+      "pop2021": "703.9960",
+      "area": 28896,
+      "region": "Oceania",
+      "subregion": "Melanesia"
+    },
+    {
+      "country": "Bhutan",
+      "pop2021": "779.8980",
+      "area": 38394,
+      "region": "Asia",
+      "subregion": "Southern Asia"
+    },
+    {
+      "country": "Guyana",
+      "pop2021": "790.3260",
+      "area": 214969,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Comoros",
+      "pop2021": "888.4510",
+      "area": 1862,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Reunion",
+      "pop2021": "901.6860",
+      "area": 2511,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Fiji",
+      "pop2021": "902.9060",
+      "area": 18272,
+      "region": "Oceania",
+      "subregion": "Melanesia"
+    },
+    {
+      "country": "Djibouti",
+      "pop2021": "1002.1870",
+      "area": 23200,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Swaziland",
+      "pop2021": "1172.3620",
+      "area": 17364,
+      "region": "Africa",
+      "subregion": "Southern Africa"
+    },
+    {
+      "country": "Cyprus",
+      "pop2021": "1215.5840",
+      "area": 9251,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Mauritius",
+      "pop2021": "1273.4330",
+      "area": 2040,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Estonia",
+      "pop2021": "1325.1850",
+      "area": 45227,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Timor-Leste",
+      "pop2021": "1343.8730",
+      "area": 14874,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "Trinidad and Tobago",
+      "pop2021": "1403.3750",
+      "area": 5130,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Equatorial Guinea",
+      "pop2021": "1449.8960",
+      "area": 28051,
+      "region": "Africa",
+      "subregion": "Middle Africa"
+    },
+    {
+      "country": "Bahrain",
+      "pop2021": "1748.2960",
+      "area": 765,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Latvia",
+      "pop2021": "1866.9420",
+      "area": 64559,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Guinea-Bissau",
+      "pop2021": "2015.4940",
+      "area": 36125,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Slovenia",
+      "pop2021": "2078.7240",
+      "area": 20273,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Macedonia",
+      "pop2021": "2082.6580",
+      "area": 25713,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Lesotho",
+      "pop2021": "2159.0790",
+      "area": 30355,
+      "region": "Africa",
+      "subregion": "Southern Africa"
+    },
+    {
+      "country": "Gabon",
+      "pop2021": "2278.8250",
+      "area": 267668,
+      "region": "Africa",
+      "subregion": "Middle Africa"
+    },
+    {
+      "country": "Botswana",
+      "pop2021": "2397.2410",
+      "area": 582000,
+      "region": "Africa",
+      "subregion": "Southern Africa"
+    },
+    {
+      "country": "Gambia",
+      "pop2021": "2486.9450",
+      "area": 10689,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Namibia",
+      "pop2021": "2587.3440",
+      "area": 825615,
+      "region": "Africa",
+      "subregion": "Southern Africa"
+    },
+    {
+      "country": "Lithuania",
+      "pop2021": "2689.8620",
+      "area": 65300,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Puerto Rico",
+      "pop2021": "2828.2550",
+      "area": 8870,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Albania",
+      "pop2021": "2872.9330",
+      "area": 28748,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Qatar",
+      "pop2021": "2930.5280",
+      "area": 11586,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Armenia",
+      "pop2021": "2968.1270",
+      "area": 29743,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Jamaica",
+      "pop2021": "2973.4630",
+      "area": 10991,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Bosnia and Herzegovina",
+      "pop2021": "3263.4660",
+      "area": 51209,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Mongolia",
+      "pop2021": "3329.2890",
+      "area": 1564110,
+      "region": "Asia",
+      "subregion": "Eastern Asia"
+    },
+    {
+      "country": "Uruguay",
+      "pop2021": "3485.1510",
+      "area": 181034,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Eritrea",
+      "pop2021": "3601.4670",
+      "area": 117600,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Georgia",
+      "pop2021": "3979.7650",
+      "area": 69700,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Moldova",
+      "pop2021": "4024.0190",
+      "area": 33846,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Croatia",
+      "pop2021": "4081.6510",
+      "area": 56594,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Kuwait",
+      "pop2021": "4328.5500",
+      "area": 17818,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Panama",
+      "pop2021": "4381.5790",
+      "area": 75417,
+      "region": "Americas",
+      "subregion": "Central America"
+    },
+    {
+      "country": "Mauritania",
+      "pop2021": "4775.1190",
+      "area": 1030700,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "New Zealand",
+      "pop2021": "4860.6430",
+      "area": 270467,
+      "region": "Oceania",
+      "subregion": "Australia and New Zealand"
+    },
+    {
+      "country": "Central African Republic",
+      "pop2021": "4919.9810",
+      "area": 622984,
+      "region": "Africa",
+      "subregion": "Middle Africa"
+    },
+    {
+      "country": "Ireland",
+      "pop2021": "4982.9070",
+      "area": 70273,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Costa Rica",
+      "pop2021": "5139.0520",
+      "area": 51100,
+      "region": "Americas",
+      "subregion": "Central America"
+    },
+    {
+      "country": "Liberia",
+      "pop2021": "5180.2030",
+      "area": 111369,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Palestine",
+      "pop2021": "5222.7480",
+      "area": 6220,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Oman",
+      "pop2021": "5223.3750",
+      "area": 309500,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Slovakia",
+      "pop2021": "5460.7210",
+      "area": 49037,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Norway",
+      "pop2021": "5465.6300",
+      "area": 323802,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Finland",
+      "pop2021": "5548.3600",
+      "area": 338424,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Republic of the Congo",
+      "pop2021": "5657.0130",
+      "area": 342000,
+      "region": "Africa",
+      "subregion": "Middle Africa"
+    },
+    {
+      "country": "Denmark",
+      "pop2021": "5813.2980",
+      "area": 43094,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Singapore",
+      "pop2021": "5896.6860",
+      "area": 710,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "Turkmenistan",
+      "pop2021": "6117.9240",
+      "area": 488100,
+      "region": "Asia",
+      "subregion": "Central Asia"
+    },
+    {
+      "country": "El Salvador",
+      "pop2021": "6518.4990",
+      "area": 21041,
+      "region": "Americas",
+      "subregion": "Central America"
+    },
+    {
+      "country": "Kyrgyzstan",
+      "pop2021": "6628.3560",
+      "area": 199951,
+      "region": "Asia",
+      "subregion": "Central Asia"
+    },
+    {
+      "country": "Nicaragua",
+      "pop2021": "6702.3850",
+      "area": 130373,
+      "region": "Americas",
+      "subregion": "Central America"
+    },
+    {
+      "country": "Lebanon",
+      "pop2021": "6769.1460",
+      "area": 10452,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Bulgaria",
+      "pop2021": "6896.6630",
+      "area": 110879,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Libya",
+      "pop2021": "6958.5320",
+      "area": 1759540,
+      "region": "Africa",
+      "subregion": "Northern Africa"
+    },
+    {
+      "country": "Paraguay",
+      "pop2021": "7219.6380",
+      "area": 406752,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Laos",
+      "pop2021": "7379.3580",
+      "area": 236800,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "Hong Kong",
+      "pop2021": "7552.8100",
+      "area": 1104,
+      "region": "Asia",
+      "subregion": "Eastern Asia"
+    },
+    {
+      "country": "Sierra Leone",
+      "pop2021": "8141.3430",
+      "area": 71740,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Togo",
+      "pop2021": "8478.2500",
+      "area": 56785,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Serbia",
+      "pop2021": "8697.5500",
+      "area": 88361,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Switzerland",
+      "pop2021": "8715.4940",
+      "area": 41284,
+      "region": "Europe",
+      "subregion": "Western Europe"
+    },
+    {
+      "country": "Israel",
+      "pop2021": "8789.7740",
+      "area": 20770,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Austria",
+      "pop2021": "9043.0700",
+      "area": 83871,
+      "region": "Europe",
+      "subregion": "Western Europe"
+    },
+    {
+      "country": "Papua New Guinea",
+      "pop2021": "9119.0100",
+      "area": 462840,
+      "region": "Oceania",
+      "subregion": "Melanesia"
+    },
+    {
+      "country": "Belarus",
+      "pop2021": "9442.8620",
+      "area": 207600,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Hungary",
+      "pop2021": "9634.1640",
+      "area": 93028,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Tajikistan",
+      "pop2021": "9749.6270",
+      "area": 143100,
+      "region": "Asia",
+      "subregion": "Central Asia"
+    },
+    {
+      "country": "United Arab Emirates",
+      "pop2021": "9991.0890",
+      "area": 83600,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Honduras",
+      "pop2021": "10062.9910",
+      "area": 112492,
+      "region": "Americas",
+      "subregion": "Central America"
+    },
+    {
+      "country": "Sweden",
+      "pop2021": "10160.1690",
+      "area": 450295,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Portugal",
+      "pop2021": "10167.9250",
+      "area": 92090,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Azerbaijan",
+      "pop2021": "10223.3420",
+      "area": 86600,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Jordan",
+      "pop2021": "10269.0210",
+      "area": 89342,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Greece",
+      "pop2021": "10370.7440",
+      "area": 131990,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Czech Republic",
+      "pop2021": "10724.5550",
+      "area": 78865,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Dominican Republic",
+      "pop2021": "10953.7030",
+      "area": 48671,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Cuba",
+      "pop2021": "11317.5050",
+      "area": 109884,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "South Sudan",
+      "pop2021": "11381.3780",
+      "area": 619745,
+      "region": "Africa",
+      "subregion": "Middle Africa"
+    },
+    {
+      "country": "Haiti",
+      "pop2021": "11541.6850",
+      "area": 27750,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Belgium",
+      "pop2021": "11632.3260",
+      "area": 30528,
+      "region": "Europe",
+      "subregion": "Western Europe"
+    },
+    {
+      "country": "Bolivia",
+      "pop2021": "11832.9400",
+      "area": 1098581,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Tunisia",
+      "pop2021": "11935.7660",
+      "area": 163610,
+      "region": "Africa",
+      "subregion": "Northern Africa"
+    },
+    {
+      "country": "Burundi",
+      "pop2021": "12255.4330",
+      "area": 27834,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Benin",
+      "pop2021": "12451.0400",
+      "area": 112622,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Rwanda",
+      "pop2021": "13276.5130",
+      "area": 26338,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Guinea",
+      "pop2021": "13497.2440",
+      "area": 245857,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Zimbabwe",
+      "pop2021": "15092.1710",
+      "area": 390757,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Somalia",
+      "pop2021": "16359.5040",
+      "area": 637657,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Chad",
+      "pop2021": "16914.9850",
+      "area": 1284000,
+      "region": "Africa",
+      "subregion": "Middle Africa"
+    },
+    {
+      "country": "Cambodia",
+      "pop2021": "16946.4380",
+      "area": 181035,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "Netherlands",
+      "pop2021": "17173.0990",
+      "area": 41850,
+      "region": "Europe",
+      "subregion": "Western Europe"
+    },
+    {
+      "country": "Senegal",
+      "pop2021": "17196.3010",
+      "area": 196722,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Ecuador",
+      "pop2021": "17888.4750",
+      "area": 276841,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Guatemala",
+      "pop2021": "18249.8600",
+      "area": 108889,
+      "region": "Americas",
+      "subregion": "Central America"
+    },
+    {
+      "country": "Syria",
+      "pop2021": "18275.7020",
+      "area": 185180,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Zambia",
+      "pop2021": "18920.6510",
+      "area": 752612,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Kazakhstan",
+      "pop2021": "18994.9620",
+      "area": 2724900,
+      "region": "Asia",
+      "subregion": "Central Asia"
+    },
+    {
+      "country": "Romania",
+      "pop2021": "19127.7740",
+      "area": 238391,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Chile",
+      "pop2021": "19212.3610",
+      "area": 756102,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Malawi",
+      "pop2021": "19647.6840",
+      "area": 118484,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Mali",
+      "pop2021": "20855.7350",
+      "area": 1240192,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Burkina Faso",
+      "pop2021": "21497.0960",
+      "area": 272967,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Sri Lanka",
+      "pop2021": "21497.3100",
+      "area": 65610,
+      "region": "Asia",
+      "subregion": "Southern Asia"
+    },
+    {
+      "country": "Taiwan",
+      "pop2021": "23855.0100",
+      "area": 36193,
+      "region": "Asia",
+      "subregion": "Eastern Asia"
+    },
+    {
+      "country": "Niger",
+      "pop2021": "25130.8170",
+      "area": 1267000,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Australia",
+      "pop2021": "25788.2150",
+      "area": 7692024,
+      "region": "Oceania",
+      "subregion": "Australia and New Zealand"
+    },
+    {
+      "country": "North Korea",
+      "pop2021": "25887.0410",
+      "area": 120538,
+      "region": "Asia",
+      "subregion": "Eastern Asia"
+    },
+    {
+      "country": "Ivory Coast",
+      "pop2021": "27053.6290",
+      "area": 322463,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Cameroon",
+      "pop2021": "27224.2650",
+      "area": 475442,
+      "region": "Africa",
+      "subregion": "Middle Africa"
+    },
+    {
+      "country": "Madagascar",
+      "pop2021": "28427.3280",
+      "area": 587041,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Venezuela",
+      "pop2021": "28704.9540",
+      "area": 916445,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Nepal",
+      "pop2021": "29674.9200",
+      "area": 147181,
+      "region": "Asia",
+      "subregion": "Southern Asia"
+    },
+    {
+      "country": "Yemen",
+      "pop2021": "30490.6400",
+      "area": 527968,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Ghana",
+      "pop2021": "31732.1290",
+      "area": 238533,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Mozambique",
+      "pop2021": "32163.0470",
+      "area": 801590,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Malaysia",
+      "pop2021": "32776.1940",
+      "area": 330803,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "Peru",
+      "pop2021": "33359.4180",
+      "area": 1285216,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Angola",
+      "pop2021": "33933.6100",
+      "area": 1246700,
+      "region": "Africa",
+      "subregion": "Middle Africa"
+    },
+    {
+      "country": "Uzbekistan",
+      "pop2021": "33935.7630",
+      "area": 447400,
+      "region": "Asia",
+      "subregion": "Central Asia"
+    },
+    {
+      "country": "Saudi Arabia",
+      "pop2021": "35340.6830",
+      "area": 2149690,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Morocco",
+      "pop2021": "37344.7950",
+      "area": 446550,
+      "region": "Africa",
+      "subregion": "Northern Africa"
+    },
+    {
+      "country": "Poland",
+      "pop2021": "37797.0050",
+      "area": 312679,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Canada",
+      "pop2021": "38067.9030",
+      "area": 9984670,
+      "region": "Americas",
+      "subregion": "Northern America"
+    },
+    {
+      "country": "Afghanistan",
+      "pop2021": "39835.4280",
+      "area": 652230,
+      "region": "Asia",
+      "subregion": "Southern Asia"
+    },
+    {
+      "country": "Iraq",
+      "pop2021": "41179.3500",
+      "area": 438317,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Ukraine",
+      "pop2021": "43466.8190",
+      "area": 603500,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Algeria",
+      "pop2021": "44616.6240",
+      "area": 2381741,
+      "region": "Africa",
+      "subregion": "Northern Africa"
+    },
+    {
+      "country": "Sudan",
+      "pop2021": "44909.3530",
+      "area": 1886068,
+      "region": "Africa",
+      "subregion": "Northern Africa"
+    },
+    {
+      "country": "Argentina",
+      "pop2021": "45605.8260",
+      "area": 2780400,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Spain",
+      "pop2021": "46745.2160",
+      "area": 505992,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Uganda",
+      "pop2021": "47123.5310",
+      "area": 241550,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Colombia",
+      "pop2021": "51265.8440",
+      "area": 1141748,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "South Korea",
+      "pop2021": "51305.1860",
+      "area": 100210,
+      "region": "Asia",
+      "subregion": "Eastern Asia"
+    },
+    {
+      "country": "Myanmar",
+      "pop2021": "54806.0120",
+      "area": 676578,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "Kenya",
+      "pop2021": "54985.6980",
+      "area": 580367,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "South Africa",
+      "pop2021": "60041.9940",
+      "area": 1221037,
+      "region": "Africa",
+      "subregion": "Southern Africa"
+    },
+    {
+      "country": "Italy",
+      "pop2021": "60367.4770",
+      "area": 301336,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Tanzania",
+      "pop2021": "61498.4370",
+      "area": 945087,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "France",
+      "pop2021": "65426.1790",
+      "area": 551695,
+      "region": "Europe",
+      "subregion": "Western Europe"
+    },
+    {
+      "country": "United Kingdom",
+      "pop2021": "68207.1160",
+      "area": 242900,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Thailand",
+      "pop2021": "69950.8500",
+      "area": 513120,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "Germany",
+      "pop2021": "83900.4730",
+      "area": 357114,
+      "region": "Europe",
+      "subregion": "Western Europe"
+    },
+    {
+      "country": "Iran",
+      "pop2021": "85028.7590",
+      "area": 1648195,
+      "region": "Asia",
+      "subregion": "Southern Asia"
+    },
+    {
+      "country": "Turkey",
+      "pop2021": "85042.7380",
+      "area": 783562,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "DR Congo",
+      "pop2021": "92377.9930",
+      "area": 2344858,
+      "region": "Africa",
+      "subregion": "Middle Africa"
+    },
+    {
+      "country": "Vietnam",
+      "pop2021": "98168.8330",
+      "area": 331212,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "Egypt",
+      "pop2021": "104258.3270",
+      "area": 1002450,
+      "region": "Africa",
+      "subregion": "Northern Africa"
+    },
+    {
+      "country": "Philippines",
+      "pop2021": "111046.9130",
+      "area": 342353,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "Ethiopia",
+      "pop2021": "117876.2270",
+      "area": 1104300,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Japan",
+      "pop2021": "126050.8040",
+      "area": 377930,
+      "region": "Asia",
+      "subregion": "Eastern Asia"
+    },
+    {
+      "country": "Mexico",
+      "pop2021": "130262.2160",
+      "area": 1964375,
+      "region": "Americas",
+      "subregion": "Central America"
+    },
+    {
+      "country": "Russia",
+      "pop2021": "145912.0250",
+      "area": 17098242,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Bangladesh",
+      "pop2021": "166303.4980",
+      "area": 147570,
+      "region": "Asia",
+      "subregion": "Southern Asia"
+    },
+    {
+      "country": "Nigeria",
+      "pop2021": "211400.7080",
+      "area": 923768,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Brazil",
+      "pop2021": "213993.4370",
+      "area": 8515767,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Pakistan",
+      "pop2021": "225199.9370",
+      "area": 881912,
+      "region": "Asia",
+      "subregion": "Southern Asia"
+    },
+    {
+      "country": "Indonesia",
+      "pop2021": "276361.7830",
+      "area": 1904569,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "United States",
+      "pop2021": "332915.0730",
+      "area": 9372610,
+      "region": "Americas",
+      "subregion": "Northern America"
+    },
+    {
+      "country": "India",
+      "pop2021": "1393409.0380",
+      "area": 3287590,
+      "region": "Asia",
+      "subregion": "Southern Asia"
+    },
+    {
+      "country": "China",
+      "pop2021": "1444216.1070",
+      "area": 9706961,
+      "region": "Asia",
+      "subregion": "Eastern Asia"
+    }
+  ]
\ No newline at end of file
diff --git a/examples/example3/local_adapter.py b/examples/example3/local_adapter.py
new file mode 100644
index 00000000..961f01d6
--- /dev/null
+++ b/examples/example3/local_adapter.py
@@ -0,0 +1,55 @@
+import json
+
+from slugify import slugify
+
+from diffsync import DiffSync
+from models import Region, Country
+
+COUNTRIES_FILE = "countries.json"
+
+
+class LocalAdapter(DiffSync):
+    """DiffSync Adapter to Load the list of regions and countries from a local JSON file."""
+
+    region = Region
+    country = Country
+
+    # Since all countries are associated with a region, we don't need to list country here
+    # When doing a diff or a sync between 2 adapters,
+    #  diffsync will recursively check all models defined at the top level and their children.
+    top_level = ["region"]
+
+    # Human readable name of the Adapter,
+    # mainly used when doing a diff to indicate where each data is coming from
+    type = "Local"
+
+    def load(self, filename=COUNTRIES_FILE):
+        """Load all regions and countries from a local JSON file."""
+
+        data_file = open(filename, "r")
+        countries = json.loads(data_file.read())
+
+        # Load all regions first
+        # A Region object will be create for each region and it will be store inside the object with self.add
+        # To create a Region we are using "self.region" instead of "Region" directly to allow someone to extend this adapter without redefining everything.
+        region_names = set([country.get("region") for country in countries])
+        for region in region_names:
+            self.add(self.region(slug=slugify(region), name=region))
+
+        # Load all countries
+        # A Country object will be create for each country, it will be store inside the object with self.add
+        # and it will be linked to its parent with parent.add_child(item)
+        for country in countries:
+
+            # Retrive the parent region object from the internal cache.
+            region = self.get(obj=self.region, identifier=slugify(country.get("region")))
+
+            name = country.get("country")
+            item = self.country(
+                slug=slugify(name), name=name, subregion=country.get("subregion", None), region=region.slug
+            )
+            self.add(item)
+
+            region.add_child(item)
+
+        data_file.close()
diff --git a/examples/example3/main.py b/examples/example3/main.py
new file mode 100644
index 00000000..27d19457
--- /dev/null
+++ b/examples/example3/main.py
@@ -0,0 +1,47 @@
+#!/usr/bin/env python
+"""Main executable for DiffSync "example2"."""
+import sys
+import argparse
+import pprint
+
+from diffsync import Diff
+from diffsync.logging import enable_console_logging
+
+from local_adapter import LocalAdapter
+from nautobot_adapter import NautobotAdapter
+
+
+def main():
+    """Demonstrate DiffSync behavior using the example backends provided."""
+    parser = argparse.ArgumentParser("example1")
+    parser.add_argument("--verbosity", "-v", default=0, action="count")
+    parser.add_argument("--diff", action="store_true")
+    parser.add_argument("--sync", action="store_true")
+    args = parser.parse_args()
+    enable_console_logging(verbosity=args.verbosity)
+
+    if not args.sync and not args.diff:
+        sys.exit("please select --diff or --sync")
+
+    print("Initializing and loading Local Data ...")
+    local = LocalAdapter()
+    local.load()
+    # print(local.str())
+
+    print("Initializing and loading Nautobot Data ...")
+    nautobot = NautobotAdapter()
+    nautobot.load()
+    # print(nautobot.str())
+
+    if args.diff:
+        print("Calculating the Diff between the local adapter and Nautobot ...")
+        diff = nautobot.diff_from(local)
+        print(diff.str())
+
+    elif args.sync:
+        print("Updating the list of countries in Nautobot ...")
+        nautobot.sync_from(local)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/examples/example3/models.py b/examples/example3/models.py
new file mode 100644
index 00000000..ff48b290
--- /dev/null
+++ b/examples/example3/models.py
@@ -0,0 +1,34 @@
+from typing import List, Optional
+from diffsync import DiffSyncModel
+
+
+class Region(DiffSyncModel):
+    """Example model of a geographic region."""
+
+    _modelname = "region"
+    _identifiers = ("slug",)
+    _attributes = ("name",)
+
+    # By listing country as a child to Region
+    # DiffSync will be able to recursively compare all regions including all their children
+    _children = {"country": "countries"}
+
+    slug: str
+    name: str
+    countries: List[str] = list()
+
+
+class Country(DiffSyncModel):
+    """Example model of a Country.
+
+    A must be part of a region and can be also associated with a subregion.
+    """
+
+    _modelname = "country"
+    _identifiers = ("slug",)
+    _attributes = ("name", "region", "subregion")
+
+    slug: str
+    name: str
+    region: str
+    subregion: Optional[str]
diff --git a/examples/example3/nautobot_adapter.py b/examples/example3/nautobot_adapter.py
new file mode 100644
index 00000000..a3a891f7
--- /dev/null
+++ b/examples/example3/nautobot_adapter.py
@@ -0,0 +1,167 @@
+import os
+import pynautobot
+
+from diffsync import DiffSync
+from models import Region, Country
+
+NAUTOBOT_URL = os.getenv("NAUTOBOT_URL", "https://demo.nautobot.com")
+NAUTOBOT_TOKEN = os.getenv("NAUTOBOT_TOKEN", "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")
+
+
+class NautobotRegion(Region):
+    """Extend the Region object to store Nautobot specific information.
+
+    Region are represented in Nautobot as a dcim.region object without parent.
+    """
+
+    remote_id: str
+    """Store the nautobot uuid in the object to allow update and delete of existing object."""
+
+
+class NautobotCountry(Country):
+    """Extend the Country to manage Country in Nautobot. CREATE/UPDATE/DELETE.
+    
+    Country are represented in Nautobot as a dcim.region object as well but a country must have a parent.
+    Subregion information will be store in the description of the object in Nautobot
+    """
+
+    remote_id: str
+    """Store the nautobot uuid in the object to allow update and delete of existing object."""
+
+    @classmethod
+    def create(cls, diffsync: "DiffSync", ids: dict, attrs: dict):
+        """Create a country object in Nautobot.
+
+        Args:
+            diffsync: The master data store for other DiffSyncModel instances that we might need to reference
+            ids: Dictionary of unique-identifiers needed to create the new object
+            attrs: Dictionary of additional attributes to set on the new object
+
+        Returns:
+            NautobotCountry: DiffSync object newly created
+        """
+
+        # Retrieve the parent region in internal cache to access its UUID
+        #  because the UUID is required to associate the object to its parent region in Nautobot
+        region = diffsync.get(diffsync.region, attrs.get("region"))
+
+        # Create the new country in Nautobot and attach it to its parent
+        try:
+            country = diffsync.nautobot.dcim.regions.create(
+                slug=ids.get("slug"),
+                name=attrs.get("name"),
+                description=attrs.get("subregion", None),
+                parent=region.remote_id,
+            )
+            print(f"Created country : {ids} | {attrs} | {country.id}")
+
+        except pynautobot.core.query.RequestError as exc:
+            print(f"Unable to create country {ids} | {attrs} | {exc}")
+            return None
+
+        # Add the newly created remote_id and create the internal object for this resource.
+        attrs["remote_id"] = country.id
+        item = super().create(ids=ids, diffsync=diffsync, attrs=attrs)
+        return item
+
+    def update(self, attrs: dict):
+        """Update a country object in Nautobot.
+
+        Args:
+            attrs: Dictionary of attributes to update on the object
+
+        Returns:
+            DiffSyncModel: this instance, if all data was successfully updated.
+            None: if data updates failed in such a way that child objects of this model should not be modified.
+
+        Raises:
+            ObjectNotUpdated: if an error occurred.
+        """
+
+        # Retrive the pynautobot object from Nautobot since we only have the UUID internally
+        remote = self.diffsync.nautobot.dcim.regions.get(self.remote_id)
+
+        # Convert the internal attrs to Nautobot format
+        nautobot_attrs = {}
+        if "subregion" in attrs:
+            nautobot_attrs["description"] = attrs.get("subregion")
+        if "name" in attrs:
+            nautobot_attrs["name"] = attrs.get("name")
+
+        if nautobot_attrs:
+            remote.update(data=nautobot_attrs)
+            print(f"Updated Country {self.slug} | {attrs}")
+
+        return super().update(attrs)
+
+    def delete(self):
+        """Delete a country object in Nautobot.
+
+        Returns:
+            NautobotCountry: DiffSync object
+        """
+        # Retrieve the pynautobot object and delete the object in Nautobot
+        remote = self.diffsync.nautobot.dcim.regions.get(self.remote_id)
+        remote.delete()
+
+        super().delete()
+        return self
+
+
+class NautobotAdapter(DiffSync):
+    """Example of a DiffSync adapter implementation."""
+
+    # We are using NautobotCountry and NautobotRegion instead of Region and Country
+    # because we are using these classes to manage the logic to integrate with Nautobot
+    # NautobotRegion is just a small extension to store the UUID and do not support any CRUD operation toward Nautobot
+    # NautobotCountry support the creation, update or deletion of a country in Nautobot
+    region = NautobotRegion
+    country = NautobotCountry
+
+    # Since all countries are associated with a region, we don't need to list country here
+    # When doing a diff or a sync between 2 adapters,
+    #  diffsync will recursively check all models defined at the top level and their children.
+    top_level = ["region"]
+
+    # Human readable name of the Adapter,
+    # mainly used when doing a diff to indicate where each data is coming from
+    type = "Nautobot"
+
+    def load(self):
+        """Load all data from Nautobot into the internal cache after transformation."""
+
+        # Initialize pynautobot to interact with Nautobot and store it within the adapter
+        # to reuse it later
+        self.nautobot = pynautobot.api(url=NAUTOBOT_URL, token=NAUTOBOT_TOKEN,)
+
+        # Pull all regions from Nautobot, which includes all regions and all countries
+        regions = self.nautobot.dcim.regions.all()
+
+        # Extract Region first (top level object without parent)
+        for region in regions:
+            if region.parent:
+                continue
+
+            # We are excluding the networktocode because it's not present in the local file
+            if region.slug == "networktocode":
+                continue
+
+            item = self.region(slug=region.slug, name=region.name, remote_id=region.id)
+            self.add(item)
+
+        # Extract All countries (second level, country must have a parent)
+        for country in regions:
+            if not country.parent:
+                continue
+
+            parent = self.get(self.region, country.parent.slug)
+
+            item = self.country(
+                slug=country.slug,
+                name=country.name,
+                region=parent.slug,
+                subregion=country.description,
+                remote_id=country.id,
+            )
+            self.add(item)
+            parent.add_child(item)
diff --git a/examples/example3/requirements.txt b/examples/example3/requirements.txt
new file mode 100644
index 00000000..5fb10fc7
--- /dev/null
+++ b/examples/example3/requirements.txt
@@ -0,0 +1,2 @@
+python-slugify
+pynautobot
diff --git a/examples/example4/README.md b/examples/example4/README.md
new file mode 100644
index 00000000..8b883649
--- /dev/null
+++ b/examples/example4/README.md
@@ -0,0 +1,31 @@
+
+# Example 4
+
+This example is a prototype to see if we could implement an adapter that is not leveraging the internal datastore. For this example, we have a shared model for Region and Country defined in `models.py`.
+A Country must be associated with a Region and can be part of a Subregion too.
+
+This example is the same as Example 3 except the Nautobot adapter and models are not leverating the internal datastore and all requests are made directly to Nautobot.
+
+The comparison and synchronization of dataset is done between a local JSON file and the [public instance of Nautobot](https://demo.nautobot.com).
+
+## Install the requirements
+
+to use this example you must have some dependencies installed, please make sure to run 
+```
+pip install -r requirements.txt
+```
+
+## Try the example
+
+The first time a lot of changes should be reported between Nautobot and the local data because by default the demo instance doesn't have the subregion define.
+After the first sync, the diff should show no difference. 
+At this point, Diffsync will be able to identify and fix all changes in Nautobot. You can try to add/update or delete any country in Nautobot and DiffSync will automatically catch it and it will fix it with running in sync mode.
+
+```
+### DIFF Compare the data between Nautobot and the local JSON file.
+main.py --diff
+
+### SYNC Update the list of country in Nautobot.
+main.py --sync
+```
+
diff --git a/examples/example4/countries.json b/examples/example4/countries.json
new file mode 100644
index 00000000..8828a0e8
--- /dev/null
+++ b/examples/example4/countries.json
@@ -0,0 +1,1626 @@
+[
+    {
+      "country": "Vatican City",
+      "pop2021": "0.8000",
+      "area": 1,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Tokelau",
+      "pop2021": "1.3730",
+      "area": 12,
+      "region": "Oceania",
+      "subregion": "Polynesia"
+    },
+    {
+      "country": "Niue",
+      "pop2021": "1.6190",
+      "area": 260,
+      "region": "Oceania",
+      "subregion": "Polynesia"
+    },
+    {
+      "country": "Falkland Islands",
+      "pop2021": "3.5330",
+      "area": 12173,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Montserrat",
+      "pop2021": "4.9770",
+      "area": 102,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Saint Pierre and Miquelon",
+      "pop2021": "5.7660",
+      "area": 242,
+      "region": "Americas",
+      "subregion": "Northern America"
+    },
+    {
+      "country": "Saint Barthelemy",
+      "pop2021": "9.9070",
+      "area": 21,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Nauru",
+      "pop2021": "10.8760",
+      "area": 21,
+      "region": "Oceania",
+      "subregion": "Micronesia"
+    },
+    {
+      "country": "Wallis and Futuna",
+      "pop2021": "11.0940",
+      "area": 142,
+      "region": "Oceania",
+      "subregion": "Polynesia"
+    },
+    {
+      "country": "Tuvalu",
+      "pop2021": "11.9310",
+      "area": 26,
+      "region": "Oceania",
+      "subregion": "Polynesia"
+    },
+    {
+      "country": "Anguilla",
+      "pop2021": "15.1170",
+      "area": 91,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Cook Islands",
+      "pop2021": "17.5650",
+      "area": 236,
+      "region": "Oceania",
+      "subregion": "Polynesia"
+    },
+    {
+      "country": "Palau",
+      "pop2021": "18.1690",
+      "area": 459,
+      "region": "Oceania",
+      "subregion": "Micronesia"
+    },
+    {
+      "country": "British Virgin Islands",
+      "pop2021": "30.4210",
+      "area": 151,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Gibraltar",
+      "pop2021": "33.6980",
+      "area": 6,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "San Marino",
+      "pop2021": "34.0170",
+      "area": 61,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Liechtenstein",
+      "pop2021": "38.2500",
+      "area": 160,
+      "region": "Europe",
+      "subregion": "Western Europe"
+    },
+    {
+      "country": "Turks and Caicos Islands",
+      "pop2021": "39.2310",
+      "area": 948,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Saint Martin",
+      "pop2021": "39.2340",
+      "area": 53,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Monaco",
+      "pop2021": "39.5110",
+      "area": 2,
+      "region": "Europe",
+      "subregion": "Western Europe"
+    },
+    {
+      "country": "Sint Maarten",
+      "pop2021": "43.4120",
+      "area": 34,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Faroe Islands",
+      "pop2021": "49.0490",
+      "area": 1393,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Saint Kitts and Nevis",
+      "pop2021": "53.5440",
+      "area": 261,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "American Samoa",
+      "pop2021": "55.1000",
+      "area": 199,
+      "region": "Oceania",
+      "subregion": "Polynesia"
+    },
+    {
+      "country": "Greenland",
+      "pop2021": "56.8770",
+      "area": 2166086,
+      "region": "Americas",
+      "subregion": "Northern America"
+    },
+    {
+      "country": "Northern Mariana Islands",
+      "pop2021": "57.9170",
+      "area": 464,
+      "region": "Oceania",
+      "subregion": "Micronesia"
+    },
+    {
+      "country": "Marshall Islands",
+      "pop2021": "59.6100",
+      "area": 181,
+      "region": "Oceania",
+      "subregion": "Micronesia"
+    },
+    {
+      "country": "Bermuda",
+      "pop2021": "62.0900",
+      "area": 54,
+      "region": "Americas",
+      "subregion": "Northern America"
+    },
+    {
+      "country": "Cayman Islands",
+      "pop2021": "66.4970",
+      "area": 264,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Dominica",
+      "pop2021": "72.1670",
+      "area": 751,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Andorra",
+      "pop2021": "77.3550",
+      "area": 468,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Isle of Man",
+      "pop2021": "85.4100",
+      "area": 572,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Antigua and Barbuda",
+      "pop2021": "98.7310",
+      "area": 442,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Seychelles",
+      "pop2021": "98.9080",
+      "area": 452,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "United States Virgin Islands",
+      "pop2021": "104.2260",
+      "area": 347,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Tonga",
+      "pop2021": "106.7600",
+      "area": 747,
+      "region": "Oceania",
+      "subregion": "Polynesia"
+    },
+    {
+      "country": "Aruba",
+      "pop2021": "107.2040",
+      "area": 180,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Saint Vincent and the Grenadines",
+      "pop2021": "111.2630",
+      "area": 389,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Grenada",
+      "pop2021": "113.0210",
+      "area": 344,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Micronesia",
+      "pop2021": "116.2540",
+      "area": 702,
+      "region": "Oceania",
+      "subregion": "Micronesia"
+    },
+    {
+      "country": "Kiribati",
+      "pop2021": "121.3920",
+      "area": 811,
+      "region": "Oceania",
+      "subregion": "Micronesia"
+    },
+    {
+      "country": "Curacao",
+      "pop2021": "164.7980",
+      "area": 444,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Guam",
+      "pop2021": "170.1790",
+      "area": 549,
+      "region": "Oceania",
+      "subregion": "Micronesia"
+    },
+    {
+      "country": "Saint Lucia",
+      "pop2021": "184.4000",
+      "area": 616,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Samoa",
+      "pop2021": "200.1490",
+      "area": 2842,
+      "region": "Oceania",
+      "subregion": "Polynesia"
+    },
+    {
+      "country": "Sao Tome and Principe",
+      "pop2021": "223.3680",
+      "area": 964,
+      "region": "Africa",
+      "subregion": "Middle Africa"
+    },
+    {
+      "country": "Mayotte",
+      "pop2021": "279.5150",
+      "area": 374,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "French Polynesia",
+      "pop2021": "282.5300",
+      "area": 4167,
+      "region": "Oceania",
+      "subregion": "Polynesia"
+    },
+    {
+      "country": "Barbados",
+      "pop2021": "287.7110",
+      "area": 430,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "New Caledonia",
+      "pop2021": "288.2180",
+      "area": 18575,
+      "region": "Oceania",
+      "subregion": "Melanesia"
+    },
+    {
+      "country": "French Guiana",
+      "pop2021": "306.4480",
+      "area": 83534,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Vanuatu",
+      "pop2021": "314.4640",
+      "area": 12189,
+      "region": "Oceania",
+      "subregion": "Melanesia"
+    },
+    {
+      "country": "Iceland",
+      "pop2021": "343.3530",
+      "area": 103000,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Martinique",
+      "pop2021": "374.7450",
+      "area": 1128,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Bahamas",
+      "pop2021": "396.9130",
+      "area": 13943,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Guadeloupe",
+      "pop2021": "400.0200",
+      "area": 1628,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Belize",
+      "pop2021": "404.9140",
+      "area": 22966,
+      "region": "Americas",
+      "subregion": "Central America"
+    },
+    {
+      "country": "Brunei",
+      "pop2021": "441.5320",
+      "area": 5765,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "Malta",
+      "pop2021": "442.7840",
+      "area": 316,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Maldives",
+      "pop2021": "543.6170",
+      "area": 300,
+      "region": "Asia",
+      "subregion": "Southern Asia"
+    },
+    {
+      "country": "Cape Verde",
+      "pop2021": "561.8980",
+      "area": 4033,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Suriname",
+      "pop2021": "591.8000",
+      "area": 163820,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Western Sahara",
+      "pop2021": "611.8750",
+      "area": 266000,
+      "region": "Africa",
+      "subregion": "Northern Africa"
+    },
+    {
+      "country": "Montenegro",
+      "pop2021": "628.0530",
+      "area": 13812,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Luxembourg",
+      "pop2021": "634.8140",
+      "area": 2586,
+      "region": "Europe",
+      "subregion": "Western Europe"
+    },
+    {
+      "country": "Macau",
+      "pop2021": "658.3940",
+      "area": 30,
+      "region": "Asia",
+      "subregion": "Eastern Asia"
+    },
+    {
+      "country": "Solomon Islands",
+      "pop2021": "703.9960",
+      "area": 28896,
+      "region": "Oceania",
+      "subregion": "Melanesia"
+    },
+    {
+      "country": "Bhutan",
+      "pop2021": "779.8980",
+      "area": 38394,
+      "region": "Asia",
+      "subregion": "Southern Asia"
+    },
+    {
+      "country": "Guyana",
+      "pop2021": "790.3260",
+      "area": 214969,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Comoros",
+      "pop2021": "888.4510",
+      "area": 1862,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Reunion",
+      "pop2021": "901.6860",
+      "area": 2511,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Fiji",
+      "pop2021": "902.9060",
+      "area": 18272,
+      "region": "Oceania",
+      "subregion": "Melanesia"
+    },
+    {
+      "country": "Djibouti",
+      "pop2021": "1002.1870",
+      "area": 23200,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Swaziland",
+      "pop2021": "1172.3620",
+      "area": 17364,
+      "region": "Africa",
+      "subregion": "Southern Africa"
+    },
+    {
+      "country": "Cyprus",
+      "pop2021": "1215.5840",
+      "area": 9251,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Mauritius",
+      "pop2021": "1273.4330",
+      "area": 2040,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Estonia",
+      "pop2021": "1325.1850",
+      "area": 45227,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Timor-Leste",
+      "pop2021": "1343.8730",
+      "area": 14874,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "Trinidad and Tobago",
+      "pop2021": "1403.3750",
+      "area": 5130,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Equatorial Guinea",
+      "pop2021": "1449.8960",
+      "area": 28051,
+      "region": "Africa",
+      "subregion": "Middle Africa"
+    },
+    {
+      "country": "Bahrain",
+      "pop2021": "1748.2960",
+      "area": 765,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Latvia",
+      "pop2021": "1866.9420",
+      "area": 64559,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Guinea-Bissau",
+      "pop2021": "2015.4940",
+      "area": 36125,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Slovenia",
+      "pop2021": "2078.7240",
+      "area": 20273,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Macedonia",
+      "pop2021": "2082.6580",
+      "area": 25713,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Lesotho",
+      "pop2021": "2159.0790",
+      "area": 30355,
+      "region": "Africa",
+      "subregion": "Southern Africa"
+    },
+    {
+      "country": "Gabon",
+      "pop2021": "2278.8250",
+      "area": 267668,
+      "region": "Africa",
+      "subregion": "Middle Africa"
+    },
+    {
+      "country": "Botswana",
+      "pop2021": "2397.2410",
+      "area": 582000,
+      "region": "Africa",
+      "subregion": "Southern Africa"
+    },
+    {
+      "country": "Gambia",
+      "pop2021": "2486.9450",
+      "area": 10689,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Namibia",
+      "pop2021": "2587.3440",
+      "area": 825615,
+      "region": "Africa",
+      "subregion": "Southern Africa"
+    },
+    {
+      "country": "Lithuania",
+      "pop2021": "2689.8620",
+      "area": 65300,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Puerto Rico",
+      "pop2021": "2828.2550",
+      "area": 8870,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Albania",
+      "pop2021": "2872.9330",
+      "area": 28748,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Qatar",
+      "pop2021": "2930.5280",
+      "area": 11586,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Armenia",
+      "pop2021": "2968.1270",
+      "area": 29743,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Jamaica",
+      "pop2021": "2973.4630",
+      "area": 10991,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Bosnia and Herzegovina",
+      "pop2021": "3263.4660",
+      "area": 51209,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Mongolia",
+      "pop2021": "3329.2890",
+      "area": 1564110,
+      "region": "Asia",
+      "subregion": "Eastern Asia"
+    },
+    {
+      "country": "Uruguay",
+      "pop2021": "3485.1510",
+      "area": 181034,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Eritrea",
+      "pop2021": "3601.4670",
+      "area": 117600,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Georgia",
+      "pop2021": "3979.7650",
+      "area": 69700,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Moldova",
+      "pop2021": "4024.0190",
+      "area": 33846,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Croatia",
+      "pop2021": "4081.6510",
+      "area": 56594,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Kuwait",
+      "pop2021": "4328.5500",
+      "area": 17818,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Panama",
+      "pop2021": "4381.5790",
+      "area": 75417,
+      "region": "Americas",
+      "subregion": "Central America"
+    },
+    {
+      "country": "Mauritania",
+      "pop2021": "4775.1190",
+      "area": 1030700,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "New Zealand",
+      "pop2021": "4860.6430",
+      "area": 270467,
+      "region": "Oceania",
+      "subregion": "Australia and New Zealand"
+    },
+    {
+      "country": "Central African Republic",
+      "pop2021": "4919.9810",
+      "area": 622984,
+      "region": "Africa",
+      "subregion": "Middle Africa"
+    },
+    {
+      "country": "Ireland",
+      "pop2021": "4982.9070",
+      "area": 70273,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Costa Rica",
+      "pop2021": "5139.0520",
+      "area": 51100,
+      "region": "Americas",
+      "subregion": "Central America"
+    },
+    {
+      "country": "Liberia",
+      "pop2021": "5180.2030",
+      "area": 111369,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Palestine",
+      "pop2021": "5222.7480",
+      "area": 6220,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Oman",
+      "pop2021": "5223.3750",
+      "area": 309500,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Slovakia",
+      "pop2021": "5460.7210",
+      "area": 49037,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Norway",
+      "pop2021": "5465.6300",
+      "area": 323802,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Finland",
+      "pop2021": "5548.3600",
+      "area": 338424,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Republic of the Congo",
+      "pop2021": "5657.0130",
+      "area": 342000,
+      "region": "Africa",
+      "subregion": "Middle Africa"
+    },
+    {
+      "country": "Denmark",
+      "pop2021": "5813.2980",
+      "area": 43094,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Singapore",
+      "pop2021": "5896.6860",
+      "area": 710,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "Turkmenistan",
+      "pop2021": "6117.9240",
+      "area": 488100,
+      "region": "Asia",
+      "subregion": "Central Asia"
+    },
+    {
+      "country": "El Salvador",
+      "pop2021": "6518.4990",
+      "area": 21041,
+      "region": "Americas",
+      "subregion": "Central America"
+    },
+    {
+      "country": "Kyrgyzstan",
+      "pop2021": "6628.3560",
+      "area": 199951,
+      "region": "Asia",
+      "subregion": "Central Asia"
+    },
+    {
+      "country": "Nicaragua",
+      "pop2021": "6702.3850",
+      "area": 130373,
+      "region": "Americas",
+      "subregion": "Central America"
+    },
+    {
+      "country": "Lebanon",
+      "pop2021": "6769.1460",
+      "area": 10452,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Bulgaria",
+      "pop2021": "6896.6630",
+      "area": 110879,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Libya",
+      "pop2021": "6958.5320",
+      "area": 1759540,
+      "region": "Africa",
+      "subregion": "Northern Africa"
+    },
+    {
+      "country": "Paraguay",
+      "pop2021": "7219.6380",
+      "area": 406752,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Laos",
+      "pop2021": "7379.3580",
+      "area": 236800,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "Hong Kong",
+      "pop2021": "7552.8100",
+      "area": 1104,
+      "region": "Asia",
+      "subregion": "Eastern Asia"
+    },
+    {
+      "country": "Sierra Leone",
+      "pop2021": "8141.3430",
+      "area": 71740,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Togo",
+      "pop2021": "8478.2500",
+      "area": 56785,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Serbia",
+      "pop2021": "8697.5500",
+      "area": 88361,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Switzerland",
+      "pop2021": "8715.4940",
+      "area": 41284,
+      "region": "Europe",
+      "subregion": "Western Europe"
+    },
+    {
+      "country": "Israel",
+      "pop2021": "8789.7740",
+      "area": 20770,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Austria",
+      "pop2021": "9043.0700",
+      "area": 83871,
+      "region": "Europe",
+      "subregion": "Western Europe"
+    },
+    {
+      "country": "Papua New Guinea",
+      "pop2021": "9119.0100",
+      "area": 462840,
+      "region": "Oceania",
+      "subregion": "Melanesia"
+    },
+    {
+      "country": "Belarus",
+      "pop2021": "9442.8620",
+      "area": 207600,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Hungary",
+      "pop2021": "9634.1640",
+      "area": 93028,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Tajikistan",
+      "pop2021": "9749.6270",
+      "area": 143100,
+      "region": "Asia",
+      "subregion": "Central Asia"
+    },
+    {
+      "country": "United Arab Emirates",
+      "pop2021": "9991.0890",
+      "area": 83600,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Honduras",
+      "pop2021": "10062.9910",
+      "area": 112492,
+      "region": "Americas",
+      "subregion": "Central America"
+    },
+    {
+      "country": "Sweden",
+      "pop2021": "10160.1690",
+      "area": 450295,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Portugal",
+      "pop2021": "10167.9250",
+      "area": 92090,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Azerbaijan",
+      "pop2021": "10223.3420",
+      "area": 86600,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Jordan",
+      "pop2021": "10269.0210",
+      "area": 89342,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Greece",
+      "pop2021": "10370.7440",
+      "area": 131990,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Czech Republic",
+      "pop2021": "10724.5550",
+      "area": 78865,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Dominican Republic",
+      "pop2021": "10953.7030",
+      "area": 48671,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Cuba",
+      "pop2021": "11317.5050",
+      "area": 109884,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "South Sudan",
+      "pop2021": "11381.3780",
+      "area": 619745,
+      "region": "Africa",
+      "subregion": "Middle Africa"
+    },
+    {
+      "country": "Haiti",
+      "pop2021": "11541.6850",
+      "area": 27750,
+      "region": "Americas",
+      "subregion": "Caribbean"
+    },
+    {
+      "country": "Belgium",
+      "pop2021": "11632.3260",
+      "area": 30528,
+      "region": "Europe",
+      "subregion": "Western Europe"
+    },
+    {
+      "country": "Bolivia",
+      "pop2021": "11832.9400",
+      "area": 1098581,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Tunisia",
+      "pop2021": "11935.7660",
+      "area": 163610,
+      "region": "Africa",
+      "subregion": "Northern Africa"
+    },
+    {
+      "country": "Burundi",
+      "pop2021": "12255.4330",
+      "area": 27834,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Benin",
+      "pop2021": "12451.0400",
+      "area": 112622,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Rwanda",
+      "pop2021": "13276.5130",
+      "area": 26338,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Guinea",
+      "pop2021": "13497.2440",
+      "area": 245857,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Zimbabwe",
+      "pop2021": "15092.1710",
+      "area": 390757,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Somalia",
+      "pop2021": "16359.5040",
+      "area": 637657,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Chad",
+      "pop2021": "16914.9850",
+      "area": 1284000,
+      "region": "Africa",
+      "subregion": "Middle Africa"
+    },
+    {
+      "country": "Cambodia",
+      "pop2021": "16946.4380",
+      "area": 181035,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "Netherlands",
+      "pop2021": "17173.0990",
+      "area": 41850,
+      "region": "Europe",
+      "subregion": "Western Europe"
+    },
+    {
+      "country": "Senegal",
+      "pop2021": "17196.3010",
+      "area": 196722,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Ecuador",
+      "pop2021": "17888.4750",
+      "area": 276841,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Guatemala",
+      "pop2021": "18249.8600",
+      "area": 108889,
+      "region": "Americas",
+      "subregion": "Central America"
+    },
+    {
+      "country": "Syria",
+      "pop2021": "18275.7020",
+      "area": 185180,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Zambia",
+      "pop2021": "18920.6510",
+      "area": 752612,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Kazakhstan",
+      "pop2021": "18994.9620",
+      "area": 2724900,
+      "region": "Asia",
+      "subregion": "Central Asia"
+    },
+    {
+      "country": "Romania",
+      "pop2021": "19127.7740",
+      "area": 238391,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Chile",
+      "pop2021": "19212.3610",
+      "area": 756102,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Malawi",
+      "pop2021": "19647.6840",
+      "area": 118484,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Mali",
+      "pop2021": "20855.7350",
+      "area": 1240192,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Burkina Faso",
+      "pop2021": "21497.0960",
+      "area": 272967,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Sri Lanka",
+      "pop2021": "21497.3100",
+      "area": 65610,
+      "region": "Asia",
+      "subregion": "Southern Asia"
+    },
+    {
+      "country": "Taiwan",
+      "pop2021": "23855.0100",
+      "area": 36193,
+      "region": "Asia",
+      "subregion": "Eastern Asia"
+    },
+    {
+      "country": "Niger",
+      "pop2021": "25130.8170",
+      "area": 1267000,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Australia",
+      "pop2021": "25788.2150",
+      "area": 7692024,
+      "region": "Oceania",
+      "subregion": "Australia and New Zealand"
+    },
+    {
+      "country": "North Korea",
+      "pop2021": "25887.0410",
+      "area": 120538,
+      "region": "Asia",
+      "subregion": "Eastern Asia"
+    },
+    {
+      "country": "Ivory Coast",
+      "pop2021": "27053.6290",
+      "area": 322463,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Cameroon",
+      "pop2021": "27224.2650",
+      "area": 475442,
+      "region": "Africa",
+      "subregion": "Middle Africa"
+    },
+    {
+      "country": "Madagascar",
+      "pop2021": "28427.3280",
+      "area": 587041,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Venezuela",
+      "pop2021": "28704.9540",
+      "area": 916445,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Nepal",
+      "pop2021": "29674.9200",
+      "area": 147181,
+      "region": "Asia",
+      "subregion": "Southern Asia"
+    },
+    {
+      "country": "Yemen",
+      "pop2021": "30490.6400",
+      "area": 527968,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Ghana",
+      "pop2021": "31732.1290",
+      "area": 238533,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Mozambique",
+      "pop2021": "32163.0470",
+      "area": 801590,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Malaysia",
+      "pop2021": "32776.1940",
+      "area": 330803,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "Peru",
+      "pop2021": "33359.4180",
+      "area": 1285216,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Angola",
+      "pop2021": "33933.6100",
+      "area": 1246700,
+      "region": "Africa",
+      "subregion": "Middle Africa"
+    },
+    {
+      "country": "Uzbekistan",
+      "pop2021": "33935.7630",
+      "area": 447400,
+      "region": "Asia",
+      "subregion": "Central Asia"
+    },
+    {
+      "country": "Saudi Arabia",
+      "pop2021": "35340.6830",
+      "area": 2149690,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Morocco",
+      "pop2021": "37344.7950",
+      "area": 446550,
+      "region": "Africa",
+      "subregion": "Northern Africa"
+    },
+    {
+      "country": "Poland",
+      "pop2021": "37797.0050",
+      "area": 312679,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Canada",
+      "pop2021": "38067.9030",
+      "area": 9984670,
+      "region": "Americas",
+      "subregion": "Northern America"
+    },
+    {
+      "country": "Afghanistan",
+      "pop2021": "39835.4280",
+      "area": 652230,
+      "region": "Asia",
+      "subregion": "Southern Asia"
+    },
+    {
+      "country": "Iraq",
+      "pop2021": "41179.3500",
+      "area": 438317,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "Ukraine",
+      "pop2021": "43466.8190",
+      "area": 603500,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Algeria",
+      "pop2021": "44616.6240",
+      "area": 2381741,
+      "region": "Africa",
+      "subregion": "Northern Africa"
+    },
+    {
+      "country": "Sudan",
+      "pop2021": "44909.3530",
+      "area": 1886068,
+      "region": "Africa",
+      "subregion": "Northern Africa"
+    },
+    {
+      "country": "Argentina",
+      "pop2021": "45605.8260",
+      "area": 2780400,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Spain",
+      "pop2021": "46745.2160",
+      "area": 505992,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Uganda",
+      "pop2021": "47123.5310",
+      "area": 241550,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Colombia",
+      "pop2021": "51265.8440",
+      "area": 1141748,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "South Korea",
+      "pop2021": "51305.1860",
+      "area": 100210,
+      "region": "Asia",
+      "subregion": "Eastern Asia"
+    },
+    {
+      "country": "Myanmar",
+      "pop2021": "54806.0120",
+      "area": 676578,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "Kenya",
+      "pop2021": "54985.6980",
+      "area": 580367,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "South Africa",
+      "pop2021": "60041.9940",
+      "area": 1221037,
+      "region": "Africa",
+      "subregion": "Southern Africa"
+    },
+    {
+      "country": "Italy",
+      "pop2021": "60367.4770",
+      "area": 301336,
+      "region": "Europe",
+      "subregion": "Southern Europe"
+    },
+    {
+      "country": "Tanzania",
+      "pop2021": "61498.4370",
+      "area": 945087,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "France",
+      "pop2021": "65426.1790",
+      "area": 551695,
+      "region": "Europe",
+      "subregion": "Western Europe"
+    },
+    {
+      "country": "United Kingdom",
+      "pop2021": "68207.1160",
+      "area": 242900,
+      "region": "Europe",
+      "subregion": "Northern Europe"
+    },
+    {
+      "country": "Thailand",
+      "pop2021": "69950.8500",
+      "area": 513120,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "Germany",
+      "pop2021": "83900.4730",
+      "area": 357114,
+      "region": "Europe",
+      "subregion": "Western Europe"
+    },
+    {
+      "country": "Iran",
+      "pop2021": "85028.7590",
+      "area": 1648195,
+      "region": "Asia",
+      "subregion": "Southern Asia"
+    },
+    {
+      "country": "Turkey",
+      "pop2021": "85042.7380",
+      "area": 783562,
+      "region": "Asia",
+      "subregion": "Western Asia"
+    },
+    {
+      "country": "DR Congo",
+      "pop2021": "92377.9930",
+      "area": 2344858,
+      "region": "Africa",
+      "subregion": "Middle Africa"
+    },
+    {
+      "country": "Vietnam",
+      "pop2021": "98168.8330",
+      "area": 331212,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "Egypt",
+      "pop2021": "104258.3270",
+      "area": 1002450,
+      "region": "Africa",
+      "subregion": "Northern Africa"
+    },
+    {
+      "country": "Philippines",
+      "pop2021": "111046.9130",
+      "area": 342353,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "Ethiopia",
+      "pop2021": "117876.2270",
+      "area": 1104300,
+      "region": "Africa",
+      "subregion": "Eastern Africa"
+    },
+    {
+      "country": "Japan",
+      "pop2021": "126050.8040",
+      "area": 377930,
+      "region": "Asia",
+      "subregion": "Eastern Asia"
+    },
+    {
+      "country": "Mexico",
+      "pop2021": "130262.2160",
+      "area": 1964375,
+      "region": "Americas",
+      "subregion": "Central America"
+    },
+    {
+      "country": "Russia",
+      "pop2021": "145912.0250",
+      "area": 17098242,
+      "region": "Europe",
+      "subregion": "Eastern Europe"
+    },
+    {
+      "country": "Bangladesh",
+      "pop2021": "166303.4980",
+      "area": 147570,
+      "region": "Asia",
+      "subregion": "Southern Asia"
+    },
+    {
+      "country": "Nigeria",
+      "pop2021": "211400.7080",
+      "area": 923768,
+      "region": "Africa",
+      "subregion": "Western Africa"
+    },
+    {
+      "country": "Brazil",
+      "pop2021": "213993.4370",
+      "area": 8515767,
+      "region": "Americas",
+      "subregion": "South America"
+    },
+    {
+      "country": "Pakistan",
+      "pop2021": "225199.9370",
+      "area": 881912,
+      "region": "Asia",
+      "subregion": "Southern Asia"
+    },
+    {
+      "country": "Indonesia",
+      "pop2021": "276361.7830",
+      "area": 1904569,
+      "region": "Asia",
+      "subregion": "South-Eastern Asia"
+    },
+    {
+      "country": "United States",
+      "pop2021": "332915.0730",
+      "area": 9372610,
+      "region": "Americas",
+      "subregion": "Northern America"
+    },
+    {
+      "country": "India",
+      "pop2021": "1393409.0380",
+      "area": 3287590,
+      "region": "Asia",
+      "subregion": "Southern Asia"
+    },
+    {
+      "country": "China",
+      "pop2021": "1444216.1070",
+      "area": 9706961,
+      "region": "Asia",
+      "subregion": "Eastern Asia"
+    }
+  ]
\ No newline at end of file
diff --git a/examples/example4/local_adapter.py b/examples/example4/local_adapter.py
new file mode 100644
index 00000000..961f01d6
--- /dev/null
+++ b/examples/example4/local_adapter.py
@@ -0,0 +1,55 @@
+import json
+
+from slugify import slugify
+
+from diffsync import DiffSync
+from models import Region, Country
+
+COUNTRIES_FILE = "countries.json"
+
+
+class LocalAdapter(DiffSync):
+    """DiffSync Adapter to Load the list of regions and countries from a local JSON file."""
+
+    region = Region
+    country = Country
+
+    # Since all countries are associated with a region, we don't need to list country here
+    # When doing a diff or a sync between 2 adapters,
+    #  diffsync will recursively check all models defined at the top level and their children.
+    top_level = ["region"]
+
+    # Human readable name of the Adapter,
+    # mainly used when doing a diff to indicate where each data is coming from
+    type = "Local"
+
+    def load(self, filename=COUNTRIES_FILE):
+        """Load all regions and countries from a local JSON file."""
+
+        data_file = open(filename, "r")
+        countries = json.loads(data_file.read())
+
+        # Load all regions first
+        # A Region object will be create for each region and it will be store inside the object with self.add
+        # To create a Region we are using "self.region" instead of "Region" directly to allow someone to extend this adapter without redefining everything.
+        region_names = set([country.get("region") for country in countries])
+        for region in region_names:
+            self.add(self.region(slug=slugify(region), name=region))
+
+        # Load all countries
+        # A Country object will be create for each country, it will be store inside the object with self.add
+        # and it will be linked to its parent with parent.add_child(item)
+        for country in countries:
+
+            # Retrive the parent region object from the internal cache.
+            region = self.get(obj=self.region, identifier=slugify(country.get("region")))
+
+            name = country.get("country")
+            item = self.country(
+                slug=slugify(name), name=name, subregion=country.get("subregion", None), region=region.slug
+            )
+            self.add(item)
+
+            region.add_child(item)
+
+        data_file.close()
diff --git a/examples/example4/main.py b/examples/example4/main.py
new file mode 100644
index 00000000..7ef54157
--- /dev/null
+++ b/examples/example4/main.py
@@ -0,0 +1,45 @@
+#!/usr/bin/env python
+"""Main executable for DiffSync "example2"."""
+import sys
+import argparse
+import pprint
+
+from diffsync import Diff
+from diffsync.logging import enable_console_logging
+
+from local_adapter import LocalAdapter
+from nautobot_adapter import NautobotAdapter
+
+
+def main():
+    """Demonstrate DiffSync behavior using the example backends provided."""
+    parser = argparse.ArgumentParser("example1")
+    parser.add_argument("--verbosity", "-v", default=0, action="count")
+    parser.add_argument("--diff", action="store_true")
+    parser.add_argument("--sync", action="store_true")
+    args = parser.parse_args()
+    enable_console_logging(verbosity=args.verbosity)
+
+    if not args.sync and not args.diff:
+        sys.exit("please select --diff or --sync")
+
+    print("Initializing and loading Local Data ...")
+    local = LocalAdapter()
+    local.load()
+
+    print("Initializing and loading Nautobot Data ...")
+    nautobot = NautobotAdapter()
+    nautobot.load()
+
+    if args.diff:
+        print("Calculating the Diff between the local adapter and Nautobot ...")
+        diff = nautobot.diff_from(local)
+        print(diff.str())
+
+    elif args.sync:
+        print("Updating the list of countries in Nautobot ...")
+        nautobot.sync_from(local)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/examples/example4/models.py b/examples/example4/models.py
new file mode 100644
index 00000000..ff48b290
--- /dev/null
+++ b/examples/example4/models.py
@@ -0,0 +1,34 @@
+from typing import List, Optional
+from diffsync import DiffSyncModel
+
+
+class Region(DiffSyncModel):
+    """Example model of a geographic region."""
+
+    _modelname = "region"
+    _identifiers = ("slug",)
+    _attributes = ("name",)
+
+    # By listing country as a child to Region
+    # DiffSync will be able to recursively compare all regions including all their children
+    _children = {"country": "countries"}
+
+    slug: str
+    name: str
+    countries: List[str] = list()
+
+
+class Country(DiffSyncModel):
+    """Example model of a Country.
+
+    A must be part of a region and can be also associated with a subregion.
+    """
+
+    _modelname = "country"
+    _identifiers = ("slug",)
+    _attributes = ("name", "region", "subregion")
+
+    slug: str
+    name: str
+    region: str
+    subregion: Optional[str]
diff --git a/examples/example4/nautobot_adapter.py b/examples/example4/nautobot_adapter.py
new file mode 100644
index 00000000..8dfed795
--- /dev/null
+++ b/examples/example4/nautobot_adapter.py
@@ -0,0 +1,321 @@
+import os
+from typing import Callable, ClassVar, Dict, List, Mapping, MutableMapping, Optional, Text, Tuple, Type, Union
+
+import pynautobot
+
+from diffsync import DiffSync, DiffSyncModel
+from models import Region, Country
+
+NAUTOBOT_URL = os.getenv("NAUTOBOT_URL", "https://demo.nautobot.com")
+NAUTOBOT_TOKEN = os.getenv("NAUTOBOT_TOKEN", "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")
+
+
+class NautobotRegion(Region):
+    """Extend the Region object to store Nautobot specific information.
+
+    Region are represented in Nautobot as a dcim.region object without parent.
+    """
+
+    remote_id: str
+    """Store the nautobot uuid in the object to allow update and delete of existing object."""
+
+    @classmethod
+    def convert_from(cls, diffsync, obj):
+        """Convert a Nautobot dcim.region object to a Region Object."""
+        countries = diffsync.nautobot.dcim.regions.filter(parent_id=obj.id)
+        return cls(
+            slug=obj.slug,
+            diffsync=diffsync,
+            name=obj.name,
+            remote_id=obj.id,
+            countries=[country.slug for country in countries],
+        )
+
+    # -----------------------------------------------------
+    # Redefine the default methods to access the objects from the store to implement a storeless adapter
+    # -----------------------------------------------------
+    @classmethod
+    def get_all(cls, diffsync):
+        """Get all Region objects."""
+        regions = diffsync.nautobot.dcim.regions.all()
+        results = []
+        for region in regions:
+            if region.parent:
+                continue
+
+            if region.slug == "networktocode":
+                continue
+
+            results.append(cls.convert_from(diffsync, region))
+
+        return results
+
+    @classmethod
+    def get_by_uids(cls, diffsync, uids):
+        """Get a list of region identified by their unique identifiers."""
+        regions = diffsync.nautobot.dcim.regions.filter(slug=uids)
+        results = []
+        for region in regions:
+            results.append(cls.convert_from(diffsync, region))
+        return results
+
+    @classmethod
+    def get(cls, diffsync, identifier):
+        """Get one region identified by its unique identifier."""
+        if isinstance(identifier, str):
+            region = diffsync.nautobot.dcim.regions.get(slug=identifier)
+        elif isinstance(identifier, dict):
+            region = diffsync.nautobot.dcim.regions.get(**identifier)
+        else:
+            raise TypeError
+        return cls.convert_from(diffsync, region)
+
+
+class NautobotCountry(Country):
+    """Extend the Country to manage Country in Nautobot. CREATE/UPDATE/DELETE.
+    
+    Country are represented in Nautobot as a dcim.region object as well but a country must have a parent.
+    Subregion information will be store in the description of the object in Nautobot
+    """
+
+    remote_id: str
+    """Store the nautobot uuid in the object to allow update and delete of existing object."""
+
+    @classmethod
+    def create(cls, diffsync: "DiffSync", ids: dict, attrs: dict):
+        """Create a country object in Nautobot.
+
+        Args:
+            diffsync: The master data store for other DiffSyncModel instances that we might need to reference
+            ids: Dictionary of unique-identifiers needed to create the new object
+            attrs: Dictionary of additional attributes to set on the new object
+
+        Returns:
+            NautobotCountry: DiffSync object newly created
+        """
+
+        # Retrieve the parent region in internal cache to access its UUID
+        #  because the UUID is required to associate the object to its parent region in Nautobot
+        region = diffsync.get(diffsync.region, attrs.get("region"))
+
+        # Create the new country in Nautobot and attach it to its parent
+        try:
+            country = diffsync.nautobot.dcim.regions.create(
+                slug=ids.get("slug"),
+                name=attrs.get("name"),
+                description=attrs.get("subregion", None),
+                parent=region.remote_id,
+            )
+            print(f"Created country : {ids} | {attrs} | {country.id}")
+
+        except pynautobot.core.query.RequestError as exc:
+            print(f"Unable to create country {ids} | {attrs} | {exc}")
+            return None
+
+        # Add the newly created remote_id and create the internal object for this resource.
+        attrs["remote_id"] = country.id
+        item = super().create(ids=ids, diffsync=diffsync, attrs=attrs)
+        return item
+
+    def update(self, attrs: dict):
+        """Update a country object in Nautobot.
+
+        Args:
+            attrs: Dictionary of attributes to update on the object
+
+        Returns:
+            DiffSyncModel: this instance, if all data was successfully updated.
+            None: if data updates failed in such a way that child objects of this model should not be modified.
+
+        Raises:
+            ObjectNotUpdated: if an error occurred.
+        """
+
+        # Retrive the pynautobot object from Nautobot since we only have the UUID internally
+        remote = self.diffsync.nautobot.dcim.regions.get(self.remote_id)
+
+        # Convert the internal attrs to Nautobot format
+        nautobot_attrs = {}
+        if "subregion" in attrs:
+            nautobot_attrs["description"] = attrs.get("subregion")
+        if "name" in attrs:
+            nautobot_attrs["name"] = attrs.get("name")
+
+        if nautobot_attrs:
+            remote.update(data=nautobot_attrs)
+            print(f"Updated Country {self.slug} | {attrs}")
+
+        return super().update(attrs)
+
+    def delete(self):
+        """Delete a country object in Nautobot.
+
+        Returns:
+            NautobotCountry: DiffSync object
+        """
+        # Retrieve the pynautobot object and delete the object in Nautobot
+        remote = self.diffsync.nautobot.dcim.regions.get(self.remote_id)
+        remote.delete()
+
+        super().delete()
+        return self
+
+    @classmethod
+    def convert_from(cls, diffsync, obj):
+        """Convert a Nautobot Region object into a Country object."""
+        return cls(
+            diffsync=diffsync,
+            slug=obj.slug,
+            name=obj.name,
+            region=obj.parent.slug,
+            subregion=obj.description,
+            remote_id=obj.id,
+        )
+
+    # -----------------------------------------------------
+    # Redefine the default methods to access the objects from the store to implement a storeless adapter
+    # -----------------------------------------------------
+    @classmethod
+    def get_all(cls, diffsync):
+        """Get all Country objects from Nautobot"""
+        regions = diffsync.nautobot.dcim.regions.all()
+        results = []
+        for region in regions:
+            if not region.parent:
+                continue
+            results.append(cls.convert_from(diffsync, region))
+
+        return results
+
+    @classmethod
+    def get_by_uids(cls, diffsync, uids):
+        """Get a list of Country identified by their unique identifiers."""
+        regions = diffsync.nautobot.dcim.regions.filter(slug=uids)
+        results = []
+        for region in regions:
+            results.append(cls.convert_from(diffsync, region))
+
+        return results
+
+    @classmethod
+    def get(cls, diffsync, identifier):
+        """Return an instance of Country based on its unique identifier."""
+        if isinstance(identifier, str):
+            region = diffsync.nautobot.dcim.regions.get(slug=identifier)
+        elif isinstance(identifier, dict):
+            region = diffsync.nautobot.dcim.regions.get(**identifier)
+        else:
+            raise TypeError
+
+        return cls.convert_from(diffsync, region)
+
+
+class NautobotAdapter(DiffSync):
+    """Example of a DiffSync adapter implementation."""
+
+    # We are using NautobotCountry and NautobotRegion instead of Region and Country
+    # because we are using these classes to manage the logic to integrate with Nautobot
+    # NautobotRegion is just a small extension to store the UUID and do not support any CRUD operation toward Nautobot
+    # NautobotCountry support the creation, update or deletion of a country in Nautobot
+    region = NautobotRegion
+    country = NautobotCountry
+
+    # Since all countries are associated with a region, we don't need to list country here
+    # When doing a diff or a sync between 2 adapters,
+    #  diffsync will recursively check all models defined at the top level and their children.
+    top_level = ["region"]
+
+    # Human readable name of the Adapter,
+    # mainly used when doing a diff to indicate where each data is coming from
+    type = "Nautobot"
+
+    def load(self):
+        """Nothing to load here since this adapter is not leveraging the internal datastore."""
+
+        # Initialize pynautobot to interact with Nautobot and store it within the adapter
+        # to reuse it later
+        self.nautobot = pynautobot.api(url=NAUTOBOT_URL, token=NAUTOBOT_TOKEN,)
+
+        return
+
+    # -----------------------------------------------------
+    # Redefine the default methods to access the objects from the store to implement a storeless adapter
+    #  get / get_all / get_by_uids, add and remove are the main methods to interact with the datastore.
+    # For get / get_all / get_by_uids the adapter is acting as passthrough and it's calling the same method on the model itself
+    # -----------------------------------------------------
+    def get(
+        self, obj: Union[Text, DiffSyncModel, Type[DiffSyncModel]], identifier: Union[Text, Mapping]
+    ) -> DiffSyncModel:
+        """Get one object from the data store based on its unique id.
+
+        This method is acting as passthrough and it's calling the same method on the model itself.
+
+        Args:
+            obj: DiffSyncModel class or instance, or modelname string, that defines the type of the object to retrieve
+            identifier: Unique ID of the object to retrieve, or dict of unique identifier keys/values
+
+        Raises:
+            ValueError: if obj is a str and identifier is a dict (can't convert dict into a uid str without a model class)
+            ObjectNotFound: if the requested object is not present
+        """
+        if isinstance(obj, str):
+            obj = getattr(self, obj)
+
+        return obj.get(diffsync=self, identifier=identifier)
+
+    def get_all(self, obj: Union[Text, DiffSyncModel, Type[DiffSyncModel]]) -> List[DiffSyncModel]:
+        """Get all objects of a given type.
+
+        This method is acting as passthrough and it's calling the same method on the model itself.
+
+        Args:
+            obj: DiffSyncModel class or instance, or modelname string, that defines the type of the objects to retrieve
+        Returns:
+            List[DiffSyncModel]: List of Object
+        """
+        if isinstance(obj, str):
+            obj = getattr(self, obj)
+
+        return obj.get_all(diffsync=self)
+
+    def get_by_uids(
+        self, uids: List[Text], obj: Union[Text, DiffSyncModel, Type[DiffSyncModel]]
+    ) -> List[DiffSyncModel]:
+        """Get multiple objects from the store by their unique IDs/Keys and type.
+
+        This method is acting as passthrough and it's calling the same method on the model itself.
+
+        Args:
+            uids: List of unique id / key identifying object in the database.
+            obj: DiffSyncModel class or instance, or modelname string, that defines the type of the objects to retrieve
+        
+        Raises:
+            ObjectNotFound: if any of the requested UIDs are not found in the store
+        """
+        if isinstance(obj, str):
+            obj = getattr(self, obj)
+
+        return obj.get_by_uids(diffsync=self, uids=uids)
+
+    def add(self, obj: DiffSyncModel):
+        """Add a DiffSyncModel object to the store.
+
+        Args:
+            obj (DiffSyncModel): Object to store
+
+        Raises:
+            ObjectAlreadyExists: if an object with the same uid is already present
+        """
+        pass
+
+    def remove(self, obj: DiffSyncModel):
+        """Remove a DiffSyncModel object from the store.
+
+        Args:
+            obj (DiffSyncModel): object to remove
+            remove_children (bool): If True, also recursively remove any children of this object
+
+        Raises:
+            ObjectNotFound: if the object is not present
+        """
+        pass
diff --git a/examples/example4/requirements.txt b/examples/example4/requirements.txt
new file mode 100644
index 00000000..5fb10fc7
--- /dev/null
+++ b/examples/example4/requirements.txt
@@ -0,0 +1,2 @@
+python-slugify
+pynautobot