Multiline strings in metadata

I am attempting to add a multiline string to a document, but I’m getting syntax that breaks my pandoc processing. Is there a way to save the multi line strings using yaml block syntax?

---

Test case

import frontmatter

doc = frontmatter.loads(
    '\n'.join([
        '---',
        'title: multiline test',
        '---',
        '# multiline test',
    ])
)

doc['multiline'] = '\n'.join([
    'this is a',
    'multiline',
    'string',
])

print(frontmatter.dumps(doc))

Expected (desired) output

---
multiline: |
  this is a
  multiline
  string
title: multiline test
---

# multiline test

Actual output

---
multiline: 'this is a

  multiline

  string'
title: multiline test
---

# multiline test

[JonEllis]

Yes, it is indeed the SafeDumper. Excellent suggestion. Makes sense as I’m now wrapping a string in an object. It seems that if I add the new representer to the SafeDumper itself, then I can continue to dump this document safely.

So this is the working version:

import frontmatter
import yaml

class literal_str(str): pass

def literal_str_representer(dumper, data):
    return dumper.represent_scalar('tag:yaml.org,2002:str', data, style='|')

yaml.SafeDumper.add_representer(literal_str, literal_str_representer)


doc = frontmatter.loads(
    '\n'.join([
        '---',
        'title: multiline test',
        '---',
        '# multiline test',
    ])
)

doc['multiline'] = literal_str('\n'.join([
    'this is a',
    'multiline',
    'string',
]))

print(frontmatter.dumps(doc))

Which outputs:

---
multiline: |-
  this is a
  multiline
  string
title: multiline test
---

# multiline test

[eyeseast]

Any **kwargs you pass when you run frontmatter.dumps will get passed through to yaml.dump, so you might try that. Here’s the relevant code: https://github.com/eyeseast/python-frontmatter/blob/master/frontmatter/default_handlers.py#L240-L249

It uses PyYaml’s SafeDumper class by default, which might be the issue. But if you can make it work with yaml.dump, you should be able to get it working with frontmatter.dumps.