<commit_before># Ionic Native

Ionic Native comes with a curated set of Native Cordova plugins that you can use to
pretty much do any native function you need from your [Ionic](http://ionicframework.com/), Cordova, or Web View mobile apps.

# Credits

<NAME> - [@timlancina](http://twitter.com/timlancina)

<NAME> - [@maxlynch](http://twitter.com/maxlynch)

<NAME> - [@robwormald](https://twitter.com/robwormald)
<commit_msg>docs(): update README<commit_after># Ionic Native

Ionic Native is a curated set of wrappers for Cordova plugins that make adding any native functionality you need to your [Ionic](http://ionicframework.com/), Cordova, or Web View mobile app easy.

### Promises and Observables

Ionic Native wraps plugin callbacks in a Promise or [Observable](https://gist.github.com/staltz/868e7e9bc2a7b8c1f754), providing a common interface for all plugins and ensuring that native events trigger change detection in Angular 2.

```
import {Geolocation} from 'ionic-native';

Geolocation.getCurrentPosition().then(pos => { 
  console.log('lat: ' + pos.coords.latitude + ', lon: ' + pos.coords.longitude);
});

let watch = Geolocation.watchPosition();
watch.subscribe(pos => {
  console.log('lat: ' + pos.coords.latitude + ', lon: ' + pos.coords.longitude);
});

// to stop watching
watch.unsubscribe();
```

### Runtime Diagnostics

Spent way too long diagnosing an issue only to realize a plugin wasn't firing or installed? Ionic Native lets you know what the issue is and how you can resolve it.


# Credits

<NAME> - [@timlancina](http://twitter.com/timlancina)

<NAME> - [@maxlynch](http://twitter.com/maxlynch)

<NAME> - [@robwormald](https://twitter.com/robwormald)

{'fraction_non_alphanumeric': 0.1278240190249703, 'fraction_numerical': 0.0077288941736028535, 'mean_word_length': 4.763698630136986, 'pattern_counts': {'":': 0, '<': 9, '<?xml version=': 0, '>': 11, 'https://': 3, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1705819', 'n_tokens_mistral': 549, 'n_tokens_neox': 525, 'n_words': 169}