yandex-market-language

Yandex Market Language (YML)
============================

> 🇺🇸 Your own Yandex Market Language (YML) generator from JSON, with blackjack and validation
>
> 🇷🇺 Твой собственный генератор Yandex Market Language (YML) из JSON, с блэкджэком и валидацией


How to use

Install with NPM

``shell
npm install yandex-market-language
`

Validate input

`js
const yml = require('yandex-market-language')

const YML = yml({
name: 'BestSeller',
...
})
`

Create XML

`js
YML.create()
`

Print to string

`JS
YML.end({ pretty: true })
`

Finally, write to file

`js
const { writeFile } = require('fs')

writeFile('yandex-market.yml', YML, (err) => {
if (err) throw err
console.log('YML has been saved!')
})
`

API

$3

Accepts input and validates it

* input: object — JSON which will be validated and used to generate YML.

Object has to be fully formed before passing to yml and confront schema format, otherwise it will throw validation error.

Examples of possible valid inputs can be seen here.

If for some strange reason you need to generate wrong YML bypassing the validation, use options.validate: false.

* options?: object — Lib options

* options.validate?: boolean — validate or not input. By default true. You do not want to set it to false.
* options.date?: string — fixed date for YML date attribute, which should represent time of YML update. If not defined, will fallback to current date. Should be in RFC2822 or ISO format.

Returns library methods create and end

`js
const yml = require('yandex-market-language')
const YML = yml({...VALID_INPUT...})
`

$3

Creates from JSON XML object with all necessary nodes formed and in place.

Returns xmlbuilder XMLElement. Since it is xmlbuilder entity, all builder's methods can be used on it. But nobody will ever use them...

`js
const yml = require('yandex-market-language')
const YML = yml({...VALID_INPUT...}).create()
// => XMLElement { ... }
`

$3

Creates XML object and immediately prints it as a final YML in form of the string.

* options?: object — Any options you'd normally pass to xmlbuilder end() method.

`js
const yml = require('yandex-market-language')
const YML = yml({...VALID_INPUT...}).end({ pretty: true })
// => ...
`

FAQ

$3

Yeap

$3

That lib is small thing doing big work. It doesn't need to be more complicated than that. Also, it has feeling too, ya know...

$3

Built-in validation closely replicates Yandex specs and should be in sync.

As for now, it has some unfinished parts. Just search code for @todo to see them all.

It supports only two types of offers: Simplified and Free. Other types are rarely used, but still planned for some distant and dark future.

Finally, some things can be validated only by Yandex or too specific to write a programmable validation. Nothing can be done about it, sorry world.

$3

We are very sorry (no, we are not). Let us know in issues.

$3

Nope. Just use Node's fs.writeFile` method (see example above). If you can not use that method, most likely you are in environment, where writing files is a futile attempt.

License

Copyright 2014 LotusTM. Licensed under the Apache 2.0 license.