#SushiHangover.RealmJson.Extensions

####Extension Methods for adding JSON APIs to a Realm Instance

##Current project status

| Git Branch | Xamarin.Android | Xamarin.iOS | | :------ | :------: | :------: | :------: | | master | | |

• The CI builds are generously hosted and run on ~~~

##Realm Versions

###Xamarin Realm v0.78.1

###Xamarin Realm v0.80.1

##Nuget

##Issues

###Post issues on GitHub

##Need Help

Post on StackOverflow with the tags: [XAMARIN] [REALM]

##Extension API

• A Realm Instance:
  • .CreateAllFromJson<T>(string)
  • .CreateAllFromJson<T>(Stream)
  • .CreateObjectFromJson<T>(string)
  • .CreateObjectFromJson<T>(Stream)
  • .CreateOrUpdateObjectFromJson<T>(string)
  • .CreateOrUpdateObjectFromJson<T>(Stream)

##Usage / Examples

###Single RealmObjects from Json-based Strings:

using (var theRealm = Realm.GetInstance(RealmDBTempPath()))
{
	var realmObject = theRealm.CreateObjectFromJson<StateUnique>(jsonString);
}

###Single RealmObjects from a Stream:

using (var stream = new MemoryStream(byteArray))
using (var theRealm = Realm.GetInstance(RealmDBTempPath()))
{
	var testObject = theRealm.CreateObjectFromJson<StateUnique>(stream);
}

###Json Arrays from a Android Asset Stream:

using (var theRealm = Realm.GetInstance(RealmDBTempPath()))
using (var assetStream = Application.Context.Assets.Open("States.json"))
{
	theRealm.CreateAllFromJson<State>(assetStream);
}

###Json Arrays iOS Bundled Resource Stream:

using (var theRealm = Realm.GetInstance(RealmDBTempPath()))
using (var fileStream = new FileStream("./Data/States.json", FileMode.Open, FileAccess.Read))
{
	theRealm.CreateAllFromJson<State>(fileStream);
}

Note: Consult the Unit Tests for more usage details

##Building

###xbuild or msbuild based:

xbuild /p:SolutionDir=./ /target:Clean /p:Configuration=Release   RealmJson.Extensions/RealmJson.Extensions.csproj
xbuild /p:SolutionDir=./ /target:Build /p:Configuration=Release RealmJson.Extensions/RealmJson.Extensions.csproj

##Testing / NUnitLite Automatation

###Xamarin.Android

adb shell am instrument -w RealmJson.Test.Droid/app.tests.TestInstrumentation

Ref: Automate Android Nunit Test

Ref: Issue 32005

###Xamarin.iOS

xbuild RealmJson.Test.iOS/RealmJson.Test.iOS.csproj /p:SolutionDir=~/
xcrun simctl list
open -a Simulator --args -CurrentDeviceUDID 360D3BC6-4A6D-4B7E-A899-5C7651EC2107
xcrun simctl install booted  ./RealmJson.Test.iOS/bin/iPhoneSimulator/Debug/RealmJson.Test.iOS.app
xcrun simctl launch booted com.sushihangover.realmjson-test-ios
cat ~/Library/Logs/CoreSimulator/360D3BC6-4A6D-4B7E-A899-5C7651EC2107/system.log

##Performance Testing

##License

Consult LICENSE