<commit_before>### bbcparse - Nodejs-based utilities to document and consume BBC APIs, including Nitro

[![Join the chat at https://gitter.im/Mermade/bbcparse](https://badges.gitter.im/Mermade/bbcparse.svg)](https://gitter.im/Mermade/bbcparse?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![Share on Twitter][twitter-image]][twitter-link]
[![Follow on Twitter][twitterFollow-image]][twitterFollow-link]

#### Utilities to:
* create a Swagger 2.0 definition from the Nitro API feed (parseNitroApi.js)
* show programme, brand or series information by category or searching (nitro.js)
* show genres/formats for the radio player and iPlayer (categories.js)
* show legacy programme, brand or series information by category or searching (progs.js)
* ignore programmes, brands or series by adding PIDs to a download_history file (ignore.js)
* populate a download_history from existing files (populate_download_history.js)

[twitter-image]: https://img.shields.io/twitter/url/http/PermittedSoc.svg?style=social
[twitter-link]: https://twitter.com/share?source=tweetbutton&text=BBC%20Nitro%20API%20parser%20Via%20%40PermittedSoc&url=https%3A%2F%2Fgithub.com%2FMermade%2Fbbcparse
[twitterFollow-image]: https://img.shields.io/twitter/follow/PermittedSoc.svg?style=social
[twitterFollow-link]: https://twitter.com/intent/follow?screen_name=PermittedSoc<commit_msg>Update README.md and add SDK example<commit_after>### bbcparse - Nodejs-based utilities to document and consume BBC APIs, including Nitro

[![Join the chat at https://gitter.im/Mermade/bbcparse](https://badges.gitter.im/Mermade/bbcparse.svg)](https://gitter.im/Mermade/bbcparse?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![Share on Twitter][twitter-image]][twitter-link]
[![Follow on Twitter][twitterFollow-image]][twitterFollow-link]

### Example of using nitroSdk.js

````javascript
var nitro = require('bbcparse/nitroSdk');
var api = require('bbcparse/nitroApi/api');

var host = 'programmes.api.bbc.com';
var path = api.nitroMasterbrands;
var api_key = 'INSERT_YOUR_NITRO_API_KEY_HERE';

var query = nitro.newQuery();
query.add(api.fMasterbrandsPartnerPid,'*',true);

var options = {};

nitro.make_request(host,path,api_key,query,options,function(obj){
  // process the response object
});
````

#### Utilities to:
* fetch API definitions (`fetchApis.js`)
* create a Swagger 2.0 definition from the Nitro API feed (`parseNitroApi.js`)
* create a Swagger 2.0 definition from the iBL API schema (`parseIblApi.js`)
* show programme, brand or series information by category or searching (`nitro.js`)
* show TV/radio category (genre/format) information (`nitroCategories.js`)
* show channel (masterbrand) information (`nitroChannels.js`)
* show partner (non-BBC services) information (`nitroPartners.js`)
* show linear service IDs (`nitroServices.js`)
* query the configured nitro host and return the response time (`nitroPing.js`)
* show download information for a version PID (`dlInfo.js`)
* show TV iPlayer programme, category or channels information (`ibl.js`)
* query the searchSuggest API (`searchSuggest.js`)
* show legacy programme, brand or series information by category or searching (`progs.js`)
* show legacy genres/formats for the radio player and iPlayer (`categories.js`)
* ignore programmes, brands or series by adding PIDs to a download_history file (`ignore.js`)
* populate a download_history from existing files (`populate_download_history.js`)

[twitter-image]: https://img.shields.io/twitter/url/http/PermittedSoc.svg?style=social
[twitter-link]: https://twitter.com/share?source=tweetbutton&text=BBC%20Nitro%20API%20parser%20Via%20%40PermittedSoc&url=https%3A%2F%2Fgithub.com%2FMermade%2Fbbcparse
[twitterFollow-image]: https://img.shields.io/twitter/follow/PermittedSoc.svg?style=social
[twitterFollow-link]: https://twitter.com/intent/follow?screen_name=PermittedSoc
{'fraction_non_alphanumeric': 0.1293213828425096, 'fraction_numerical': 0.010243277848911651, 'mean_word_length': 6.734653465346534, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 14, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 7, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3031169', 'n_tokens_mistral': 1313, 'n_tokens_neox': 1233, 'n_words': 298}