python-frontmatter 1.2.0__tar.gz → 1.3.0__tar.gz

{python_frontmatter-1.2.0/python_frontmatter.egg-info → python_frontmatter-1.3.0}/PKG-INFO

@@ -1,50 +1,41 @@
 Metadata-Version: 2.4
 Name: python-frontmatter
-Version: 1.2.0
+Version: 1.3.0
 Summary: Parse and manage posts with YAML (or other) frontmatter
-Home-page: https://github.com/eyeseast/python-frontmatter
-Author: Chris Amico
-Author-email: eyeseast@gmail.com
-License: MIT
 Keywords: frontmatter
+Author: Chris Amico
+Author-email: Chris Amico <eyeseast@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: PyYAML
-Provides-Extra: test
-Requires-Dist: pytest; extra == "test"
-Requires-Dist: toml; extra == "test"
-Requires-Dist: pyaml; extra == "test"
-Requires-Dist: mypy; extra == "test"
-Requires-Dist: types-PyYAML; extra == "test"
-Requires-Dist: types-toml; extra == "test"
+Requires-Dist: pyyaml
+Requires-Dist: sphinx ; extra == 'docs'
+Requires-Dist: pytest ; extra == 'test'
+Requires-Dist: toml ; extra == 'test'
+Requires-Dist: pyaml ; extra == 'test'
+Requires-Dist: mypy ; extra == 'test'
+Requires-Dist: types-pyyaml ; extra == 'test'
+Requires-Dist: types-toml ; extra == 'test'
+Requires-Dist: toml ; extra == 'toml'
+Requires-Python: >=3.10
+Project-URL: repository, https://github.com/eyeseast/python-frontmatter
+Project-URL: issues, https://github.com/eyeseast/python-frontmatter/issues
+Project-URL: documentation, http://python-frontmatter.rtfd.io
 Provides-Extra: docs
-Requires-Dist: sphinx; extra == "docs"
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license
-Dynamic: license-file
-Dynamic: provides-extra
-Dynamic: requires-dist
-Dynamic: summary
+Provides-Extra: test
+Provides-Extra: toml
+Description-Content-Type: text/markdown
 
 # Python Frontmatter
 
-[Jekyll](http://jekyllrb.com/)-style YAML front matter offers a useful way to add arbitrary, structured metadata to text documents, regardless of type.
+[Front matter](https://docs.github.com/en/contributing/writing-for-github-docs/using-yaml-frontmatter) offers a useful way to add arbitrary, structured metadata to text documents, regardless of type.
 
 This is a small package to load and parse files (or just text) with YAML (or JSON, TOML or other) front matter.
 
@@ -55,7 +46,16 @@ This is a small package to load and parse files (or just text) with YAML (or JSO
 
 ## Install:
 
-    pip install python-frontmatter
+```shell
+# with pip
+pip install python-frontmatter
+
+# or uv
+uv add python-frontmatter
+
+# local development, with uv
+uv sync
+```
 
 ## Usage:
 

{python_frontmatter-1.2.0 → python_frontmatter-1.3.0}/README.md

@@ -1,6 +1,6 @@
 # Python Frontmatter
 
-[Jekyll](http://jekyllrb.com/)-style YAML front matter offers a useful way to add arbitrary, structured metadata to text documents, regardless of type.
+[Front matter](https://docs.github.com/en/contributing/writing-for-github-docs/using-yaml-frontmatter) offers a useful way to add arbitrary, structured metadata to text documents, regardless of type.
 
 This is a small package to load and parse files (or just text) with YAML (or JSON, TOML or other) front matter.
 
@@ -11,7 +11,16 @@ This is a small package to load and parse files (or just text) with YAML (or JSO
 
 ## Install:
 
-    pip install python-frontmatter
+```shell
+# with pip
+pip install python-frontmatter
+
+# or uv
+uv add python-frontmatter
+
+# local development, with uv
+uv sync
+```
 
 ## Usage:
 

python_frontmatter-1.3.0/pyproject.toml

@@ -0,0 +1,50 @@
+[project]
+name = "python-frontmatter"
+version = "1.3.0"
+description = "Parse and manage posts with YAML (or other) frontmatter"
+readme = "README.md"
+authors = [{ name = "Chris Amico", email = "eyeseast@gmail.com" }]
+requires-python = ">=3.10"
+dependencies = ["PyYAML"]
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["frontmatter"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Natural Language :: English",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+[project.urls]
+repository = "https://github.com/eyeseast/python-frontmatter"
+issues = "https://github.com/eyeseast/python-frontmatter/issues"
+documentation = "http://python-frontmatter.rtfd.io"
+
+[project.optional-dependencies]
+test = ["pytest", "toml", "pyaml", "mypy", "types-PyYAML", "types-toml"]
+docs = ["sphinx"]
+toml = ["toml"]
+
+[dependency-groups]
+dev = [
+    "pytest",
+    "toml",
+    "pyaml",
+    "mypy",
+    "types-PyYAML",
+    "types-toml",
+    "sphinx",
+]
+
+
+[build-system]
+requires = ["uv_build>=0.11.15,<0.12"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-root = ""
+module-name = "frontmatter"

python_frontmatter-1.2.0/MANIFEST.in

@@ -1,7 +0,0 @@
-include LICENSE
-include README.md
-include frontmatter/py.typed
-
-recursive-include tests *
-
-exclude *.py[co]

python_frontmatter-1.2.0/PKG-INFO

@@ -1,170 +0,0 @@
-Metadata-Version: 2.4
-Name: python-frontmatter
-Version: 1.2.0
-Summary: Parse and manage posts with YAML (or other) frontmatter
-Home-page: https://github.com/eyeseast/python-frontmatter
-Author: Chris Amico
-Author-email: eyeseast@gmail.com
-License: MIT
-Keywords: frontmatter
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Natural Language :: English
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: PyYAML
-Provides-Extra: test
-Requires-Dist: pytest; extra == "test"
-Requires-Dist: toml; extra == "test"
-Requires-Dist: pyaml; extra == "test"
-Requires-Dist: mypy; extra == "test"
-Requires-Dist: types-PyYAML; extra == "test"
-Requires-Dist: types-toml; extra == "test"
-Provides-Extra: docs
-Requires-Dist: sphinx; extra == "docs"
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license
-Dynamic: license-file
-Dynamic: provides-extra
-Dynamic: requires-dist
-Dynamic: summary
-
-# Python Frontmatter
-
-[Jekyll](http://jekyllrb.com/)-style YAML front matter offers a useful way to add arbitrary, structured metadata to text documents, regardless of type.
-
-This is a small package to load and parse files (or just text) with YAML (or JSON, TOML or other) front matter.
-
-[![Tests](https://github.com/eyeseast/python-frontmatter/workflows/Test/badge.svg)](https://github.com/eyeseast/python-frontmatter/actions?query=workflow%3ATest)
-[![PyPI](https://img.shields.io/pypi/v/python-frontmatter.svg)](https://pypi.org/project/python-frontmatter/)
-
-**[Documentation](https://python-frontmatter.readthedocs.io/en/latest/)**
-
-## Install:
-
-    pip install python-frontmatter
-
-## Usage:
-
-```python
->>> import frontmatter
-
-```
-
-Load a post from a filename:
-
-```python
->>> post = frontmatter.load('tests/yaml/hello-world.txt')
-
-```
-
-Or a file (or file-like object):
-
-```python
->>> with open('tests/yaml/hello-world.txt') as f:
-...     post = frontmatter.load(f)
-
-```
-
-Or load from text:
-
-```python
->>> with open('tests/yaml/hello-world.txt') as f:
-...     post = frontmatter.loads(f.read())
-
-```
-
-If the file has a [Byte-Order Mark](https://en.wikipedia.org/wiki/Byte_order_mark) (BOM), strip it off first. An easy way to do this is by using the [`utf-8-sig`](https://docs.python.org/3/library/codecs.html?highlight=utf%208%20sig#module-encodings.utf_8_sig) encoding:
-
-```python
->>> with open('tests/yaml/hello-world.txt', encoding="utf-8-sig") as f:
-...     post = frontmatter.load(f)
-
-```
-
-Access content:
-
-```python
->>> print(post.content)
-Well, hello there, world.
-
-# this works, too
->>> print(post)
-Well, hello there, world.
-
-```
-
-Use metadata (metadata gets proxied as post keys):
-
-```python
->>> print(post['title'])
-Hello, world!
-
-```
-
-Metadata is a dictionary, with some handy proxies:
-
-```python
->>> sorted(post.keys())
-['layout', 'title']
-
->>> from pprint import pprint
->>> post['excerpt'] = 'tl;dr'
->>> pprint(post.metadata)
-{'excerpt': 'tl;dr', 'layout': 'post', 'title': 'Hello, world!'}
-
-```
-
-If you don't need the whole post object, just parse:
-
-```python
->>> with open('tests/yaml/hello-world.txt') as f:
-...     metadata, content = frontmatter.parse(f.read())
->>> print(metadata['title'])
-Hello, world!
-
-```
-
-Write back to plain text, too:
-
-```python
->>> print(frontmatter.dumps(post)) # doctest: +NORMALIZE_WHITESPACE
----
-excerpt: tl;dr
-layout: post
-title: Hello, world!
----
-Well, hello there, world.
-
-```
-
-Or write to a file (or file-like object):
-
-```python
->>> from io import StringIO
->>> f = StringIO()
->>> frontmatter.dump(post, f)
->>> print(f.getvalue()) # doctest: +NORMALIZE_WHITESPACE
----
-excerpt: tl;dr
-layout: post
-title: Hello, world!
----
-Well, hello there, world.
-
-```
-
-For more examples, see files in the `tests/` directory. Each sample file has a corresponding `.result.json` file showing the expected parsed output. See also the `examples/` directory, which covers more ways to customize input and output.

python_frontmatter-1.2.0/python_frontmatter.egg-info/SOURCES.txt

@@ -1,41 +0,0 @@
-LICENSE
-MANIFEST.in
-README.md
-setup.py
-frontmatter/__init__.py
-frontmatter/conftest.py
-frontmatter/default_handlers.py
-frontmatter/py.typed
-frontmatter/util.py
-python_frontmatter.egg-info/PKG-INFO
-python_frontmatter.egg-info/SOURCES.txt
-python_frontmatter.egg-info/dependency_links.txt
-python_frontmatter.egg-info/not-zip-safe
-python_frontmatter.egg-info/requires.txt
-python_frontmatter.egg-info/top_level.txt
-tests/stub_tests.py
-tests/test_docs.py
-tests/test_files.py
-tests/unit_test.py
-tests/empty/empty-frontmatter.result.json
-tests/empty/empty-frontmatter.txt
-tests/empty/no-frontmatter.result.json
-tests/empty/no-frontmatter.txt
-tests/json/hello-json.md
-tests/json/hello-json.result.json
-tests/toml/hello-toml.md
-tests/toml/hello-toml.result.json
-tests/yaml/chinese.result.json
-tests/yaml/chinese.txt
-tests/yaml/extra-dash.result.json
-tests/yaml/extra-dash.txt
-tests/yaml/extra-space.result.json
-tests/yaml/extra-space.txt
-tests/yaml/hello-markdown.md
-tests/yaml/hello-markdown.result.json
-tests/yaml/hello-world.result.json
-tests/yaml/hello-world.txt
-tests/yaml/network-diagrams.md
-tests/yaml/network-diagrams.result.json
-tests/yaml/unpretty.md
-tests/yaml/unpretty.result.json

python_frontmatter-1.2.0/python_frontmatter.egg-info/dependency_links.txt

@@ -1 +0,0 @@
-

python_frontmatter-1.2.0/python_frontmatter.egg-info/not-zip-safe

@@ -1 +0,0 @@
-

python_frontmatter-1.2.0/python_frontmatter.egg-info/requires.txt

@@ -1,12 +0,0 @@
-PyYAML
-
-[docs]
-sphinx
-
-[test]
-pytest
-toml
-pyaml
-mypy
-types-PyYAML
-types-toml

python_frontmatter-1.2.0/python_frontmatter.egg-info/top_level.txt

@@ -1 +0,0 @@
-frontmatter

python_frontmatter-1.2.0/setup.cfg

@@ -1,4 +0,0 @@
-[egg_info]
-tag_build = 
-tag_date = 0
-

python_frontmatter-1.2.0/setup.py

@@ -1,51 +0,0 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
-
-try:
-    from setuptools import setup
-except ImportError:
-    from distutils.core import setup
-
-
-with open("README.md") as f:
-    readme = f.read()
-
-
-VERSION = "1.2.0"
-
-
-setup(
-    name="python-frontmatter",
-    version=VERSION,
-    description="Parse and manage posts with YAML (or other) frontmatter",
-    long_description=readme,
-    long_description_content_type="text/markdown",
-    author="Chris Amico",
-    author_email="eyeseast@gmail.com",
-    url="https://github.com/eyeseast/python-frontmatter",
-    packages=["frontmatter"],
-    package_data={"frontmatter": ["py.typed"]},
-    include_package_data=True,
-    install_requires=["PyYAML"],
-    extras_require={
-        "test": ["pytest", "toml", "pyaml", "mypy", "types-PyYAML", "types-toml"],
-        "docs": ["sphinx"],
-    },
-    tests_require=["python-frontmatter[test]"],
-    license="MIT",
-    zip_safe=False,
-    keywords="frontmatter",
-    classifiers=[
-        "Development Status :: 5 - Production/Stable",
-        "Intended Audience :: Developers",
-        "License :: OSI Approved :: MIT License",
-        "Natural Language :: English",
-        "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.9",
-        "Programming Language :: Python :: 3.10",
-        "Programming Language :: Python :: 3.11",
-        "Programming Language :: Python :: 3.12",
-        "Programming Language :: Python :: 3.13",
-    ],
-    test_suite="test",
-)

python_frontmatter-1.2.0/tests/empty/empty-frontmatter.result.json

@@ -1,3 +0,0 @@
-{
-  "content": "I have frontmatter but no metadata."
-}

python_frontmatter-1.2.0/tests/empty/empty-frontmatter.txt

@@ -1,4 +0,0 @@
----
----
-
-I have frontmatter but no metadata.

python_frontmatter-1.2.0/tests/empty/no-frontmatter.result.json

@@ -1,3 +0,0 @@
-{
-  "content": "I have no frontmatter."
-}

python_frontmatter-1.2.0/tests/empty/no-frontmatter.txt

@@ -1 +0,0 @@
-I have no frontmatter.

python_frontmatter-1.2.0/tests/json/hello-json.md

@@ -1,18 +0,0 @@
-{
-    "test": "tester",
-    "author": "bob",
-    "something": "else"
-}
-
-Title
-=====
-
-title2
-------
-
-Hello.
-
-Just need three dashes
----
-
-And this might break.

python_frontmatter-1.2.0/tests/json/hello-json.result.json

@@ -1,6 +0,0 @@
-{
-  "test": "tester",
-  "author": "bob",
-  "something": "else",
-  "content": "Title\n=====\n\ntitle2\n------\n\nHello.\n\nJust need three dashes\n---\n\nAnd this might break."
-}

python_frontmatter-1.2.0/tests/stub_tests.py

@@ -1,21 +0,0 @@
-#!/usr/bin/env python
-"""
-Generate result files for test content. Won't overwrite any that exist.
-"""
-import json
-from pathlib import Path
-
-import frontmatter
-from test_files import files, get_result_filename
-
-
-def main():
-    for path in files():
-        result = Path(get_result_filename(path))
-        if not result.exists():
-            post = frontmatter.loads(path.read_text())
-            result.write_text(json.dumps(post.to_dict(), indent=2), "utf-8")
-
-
-if __name__ == "__main__":
-    main()

python_frontmatter-1.2.0/tests/test_docs.py

@@ -1,17 +0,0 @@
-# all the doctests here
-import doctest
-import frontmatter
-
-
-def test_readme():
-    doctest.testfile("../README.md", extraglobs={"frontmatter": frontmatter})
-
-
-def test_api_docs():
-    doctest.testmod(frontmatter, extraglobs={"frontmatter": frontmatter})
-
-
-def test_handler_docs():
-    doctest.testmod(
-        frontmatter.default_handlers, extraglobs={"frontmatter": frontmatter}
-    )

python_frontmatter-1.2.0/tests/test_files.py

@@ -1,46 +0,0 @@
-"""
-Test individual files with frontmatter against expected results.
-Files should be in a subdirectory under `tests`, usually sorted by format (yaml, toml, json).
-
-For a file called hello-world.markdown, there should be a corresponding file called hello-world.result.json
-matching the expected output.
-"""
-import os
-import json
-from itertools import chain
-from pathlib import Path
-
-import frontmatter
-import pytest
-
-
-def files():
-    tests = Path(__file__).parent
-    md = tests.glob("**/*.md")
-    txt = tests.glob("**/*.txt")
-    return chain(md, txt)
-
-
-def get_result_filename(path):
-    root, _ = os.path.splitext(path)
-    return f"{root}.result.json"
-
-
-@pytest.mark.parametrize("filename", list(files()))
-def test_can_parse(filename):
-    "Check we can load every file in our test directories without raising an error"
-    for filename in files():
-        post = frontmatter.load(filename)
-        assert isinstance(post, frontmatter.Post)
-
-
-@pytest.mark.parametrize("filename", list(files()))
-def test_file(filename):
-    result = Path(get_result_filename(filename))
-    if not result.exists():
-        pytest.fail(f"{result.name} does not exist")
-
-    post = frontmatter.load(filename)
-    result = json.loads(result.read_text())
-
-    assert post.to_dict() == result

python_frontmatter-1.2.0/tests/toml/hello-toml.md

@@ -1,18 +0,0 @@
-+++
-author = "bob"
-something = "else"
-test = "tester"
-+++
-
-Title
-=====
-
-title2
-------
-
-Hello.
-
-Just need three dashes
----
-
-And this shouldn't break.

python_frontmatter-1.2.0/tests/toml/hello-toml.result.json

@@ -1,6 +0,0 @@
-{
-  "author": "bob",
-  "something": "else",
-  "test": "tester",
-  "content": "Title\n=====\n\ntitle2\n------\n\nHello.\n\nJust need three dashes\n---\n\nAnd this shouldn't break."
-}

python_frontmatter-1.2.0/tests/unit_test.py

@@ -1,398 +0,0 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
-
-
-import codecs
-import doctest
-import glob
-import json
-import os
-import shutil
-import sys
-import tempfile
-import textwrap
-import unittest
-
-import frontmatter
-from frontmatter.default_handlers import YAMLHandler, JSONHandler, TOMLHandler
-
-try:
-    import pyaml
-except ImportError:
-    pyaml = None
-try:
-    import toml
-except ImportError:
-    toml = None
-
-
-class FrontmatterTest(unittest.TestCase):
-    """
-    Tests for parsing various kinds of content and metadata
-    """
-
-    maxDiff = None
-
-    def test_with_markdown_content(self):
-        "Parse frontmatter and only the frontmatter"
-        post = frontmatter.load("tests/yaml/hello-markdown.md")
-
-        metadata = {"author": "bob", "something": "else", "test": "tester"}
-        for k, v in metadata.items():
-            self.assertEqual(post[k], v)
-
-    def test_unicode_post(self):
-        "Ensure unicode is parsed correctly"
-        chinese = frontmatter.load("tests/yaml/chinese.txt", "utf-8")
-        output = frontmatter.dumps(chinese)
-        zh = "中文"
-
-        self.assertTrue(isinstance(chinese.content, str))
-
-        # check that we're dumping out unicode metadata, too
-        self.assertTrue(zh in output)
-
-        # this shouldn't work as ascii, because it's Hanzi
-        self.assertRaises(UnicodeEncodeError, chinese.content.encode, "ascii")
-
-    def test_check_no_frontmatter(self):
-        "Checks if a file does not have a frontmatter"
-        ret = frontmatter.check("tests/empty/no-frontmatter.txt")
-
-        self.assertEqual(ret, False)
-
-    def test_check_empty_frontmatter(self):
-        "Checks if a file has a frontmatter (empty or not)"
-        ret = frontmatter.check("tests/empty/empty-frontmatter.txt")
-
-        self.assertEqual(ret, True)
-
-    def test_no_frontmatter(self):
-        "This is not a zen exercise."
-        post = frontmatter.load("tests/empty/no-frontmatter.txt")
-        with codecs.open("tests/empty/no-frontmatter.txt", "r", "utf-8") as f:
-            content = f.read().strip()
-
-        self.assertEqual(post.metadata, {})
-        self.assertEqual(post.content, content)
-
-    def test_empty_frontmatter(self):
-        "Frontmatter, but no metadata"
-        post = frontmatter.load("tests/empty/empty-frontmatter.txt")
-        content = "I have frontmatter but no metadata."
-
-        self.assertEqual(post.metadata, {})
-        self.assertEqual(post.content, content)
-
-    def test_extra_space(self):
-        "Extra space in frontmatter delimiter"
-        post = frontmatter.load("tests/yaml/extra-space.txt")
-        content = "This file has an extra space on the opening line of the frontmatter."
-
-        self.assertEqual(post.content, content)
-        metadata = {"something": "else", "test": "tester"}
-        for k, v in metadata.items():
-            self.assertEqual(post[k], v)
-
-    def test_to_dict(self):
-        "Dump a post as a dict, for serializing"
-        post = frontmatter.load("tests/yaml/network-diagrams.md")
-        post_dict = post.to_dict()
-
-        for k, v in post.metadata.items():
-            self.assertEqual(post_dict[k], v)
-
-        self.assertEqual(post_dict["content"], post.content)
-
-    def test_to_string(self):
-        "Calling str(post) returns post.content"
-        post = frontmatter.load("tests/yaml/hello-world.txt")
-
-        # test unicode and bytes
-        text = "Well, hello there, world."
-        self.assertEqual(str(post), text)
-        self.assertEqual(bytes(post), text.encode("utf-8"))
-
-    def test_pretty_dumping(self):
-        "Use pyaml to dump nicer"
-        if pyaml is not None:
-            with codecs.open("tests/yaml/unpretty.md", "r", "utf-8") as f:
-                data = f.read()
-
-            post = frontmatter.load("tests/yaml/unpretty.md")
-            yaml = pyaml.dump(post.metadata)
-
-            # the unsafe dumper gives you nicer output, for times you want that
-            dump = frontmatter.dumps(post, Dumper=pyaml.PYAMLDumper)
-
-            self.assertTrue(yaml in dump)
-            self.assertEqual(dump, data)
-
-    def test_with_crlf_string(self):
-        markdown_bytes = b'---\r\ntitle: "my title"\r\ncontent_type: "post"\r\npublished: no\r\n---\r\n\r\nwrite your content in markdown here'
-        loaded = frontmatter.loads(markdown_bytes, "utf-8")
-        self.assertEqual(loaded["title"], "my title")
-
-    def test_dumping_with_custom_delimiters(self):
-        "dump with custom delimiters"
-        post = frontmatter.load("tests/yaml/hello-world.txt")
-        dump = frontmatter.dumps(post, start_delimiter="+++", end_delimiter="+++")
-
-        self.assertTrue("+++" in dump)
-
-    def test_dump_to_file(self):
-        "dump post to filename"
-        post = frontmatter.load("tests/yaml/hello-world.txt")
-
-        tempdir = tempfile.mkdtemp()
-        filename = os.path.join(tempdir, "hello.md")
-        frontmatter.dump(post, filename)
-
-        with open(filename) as f:
-            self.assertEqual(f.read(), frontmatter.dumps(post))
-
-        # cleanup
-        shutil.rmtree(tempdir)
-
-
-class HandlerTest(unittest.TestCase):
-    """
-    Tests for custom handlers and formatting
-    """
-
-    TEST_FILES = {
-        "tests/yaml/hello-world.txt": YAMLHandler,
-        "tests/json/hello-json.md": JSONHandler,
-        "tests/toml/hello-toml.md": TOMLHandler,
-    }
-
-    def sanity_check(self, filename, handler_type):
-        "Ensure we can load -> dump -> load"
-        post = frontmatter.load(filename)
-
-        self.assertIsInstance(post.handler, handler_type)
-
-        # dump and reload
-        repost = frontmatter.loads(frontmatter.dumps(post))
-
-        self.assertEqual(post.metadata, repost.metadata)
-        self.assertEqual(post.content, repost.content)
-        self.assertEqual(post.handler, repost.handler)
-
-    def test_detect_format(self):
-        "detect format based on default handlers"
-
-        for filename, Handler in self.TEST_FILES.items():
-            with codecs.open(filename, "r", "utf-8") as f:
-                format = frontmatter.detect_format(f.read(), frontmatter.handlers)
-                self.assertIsInstance(format, Handler)
-
-    def test_sanity_all(self):
-        "Run sanity check on all handlers"
-        for filename, Handler in self.TEST_FILES.items():
-            self.sanity_check(filename, Handler)
-
-    def test_no_handler(self):
-        "default to YAMLHandler when no handler is attached"
-        post = frontmatter.load("tests/yaml/hello-world.txt")
-        del post.handler
-
-        text = frontmatter.dumps(post)
-        self.assertIsInstance(
-            frontmatter.detect_format(text, frontmatter.handlers), YAMLHandler
-        )
-
-    def test_custom_handler(self):
-        "allow caller to specify a custom delimiter/handler"
-
-        # not including this in the regular test directory
-        # because it would/should be invalid per the defaults
-        custom = textwrap.dedent(
-            """
-        ...
-        dummy frontmatter
-        ...
-        dummy content
-        """
-        )
-
-        # and a custom handler that really doesn't do anything
-        class DummyHandler(object):
-            def load(self, fm):
-                return {"value": fm}
-
-            def split(self, text):
-                return "dummy frontmatter", "dummy content"
-
-        # but we tell frontmatter that it is the appropriate handler
-        # for the '...' delimiter
-        # frontmatter.handlers['...'] = DummyHandler()
-        post = frontmatter.loads(custom, handler=DummyHandler())
-
-        self.assertEqual(post["value"], "dummy frontmatter")
-
-    def test_toml(self):
-        "load toml frontmatter"
-        if toml is None:
-            return
-        post = frontmatter.load("tests/toml/hello-toml.md")
-        metadata = {"author": "bob", "something": "else", "test": "tester"}
-        for k, v in metadata.items():
-            self.assertEqual(post[k], v)
-
-    def test_json(self):
-        "load raw JSON frontmatter"
-        post = frontmatter.load("tests/json/hello-json.md")
-        metadata = {"author": "bob", "something": "else", "test": "tester"}
-        for k, v in metadata.items():
-            self.assertEqual(post[k], v)
-
-
-class HandlerBaseTest:
-    """
-    Tests for frontmatter.handlers
-    """
-
-    def setUp(self):
-        """
-        This method should be overridden to initalize the TestCase
-        """
-        self.handler = None
-        self.data = {
-            "filename": "tests/yaml/hello-world.txt",
-            "content": """\
-""",
-            "metadata": {},
-        }
-
-    def read_from_tests(self):
-        with open(self.data["filename"]) as f:
-            return f.read()
-
-    def test_external(self):
-        filename = self.data["filename"]
-        content = self.data["content"]
-        metadata = self.data["metadata"]
-
-        post = frontmatter.load(filename)
-
-        self.assertEqual(post.content, content.strip())
-        for k, v in metadata.items():
-            self.assertEqual(post[k], v)
-
-        # dumps and then loads to ensure round trip conversions.
-        posttext = frontmatter.dumps(post, handler=self.handler)
-        post_2 = frontmatter.loads(posttext)
-
-        for k in post.metadata:
-            self.assertEqual(post.metadata[k], post_2.metadata[k])
-
-        self.assertEqual(post.content, post_2.content)
-
-    def test_detect(self):
-        text = self.read_from_tests()
-
-        self.assertTrue(self.handler.detect(text))
-
-    def test_split_content(self):
-        text = self.read_from_tests()
-
-        fm, content = self.handler.split(text)
-
-        self.assertEqual(content, self.data["content"])
-
-    def test_split_load(self):
-        text = self.read_from_tests()
-        fm, content = self.handler.split(text)
-        fm_load = self.handler.load(fm)
-
-        # The format of the failmsg makes it easy to copy into the test.
-        any_fail = False
-        failmsg = "The following metadata did not match the test:"
-        for k in self.data["metadata"]:
-            if fm_load[k] == self.data["metadata"][k]:
-                continue
-            any_fail = True
-            failmsg += '\n"{0}": {1},'.format(k, repr(fm_load[k]))
-
-        if any_fail:
-            self.fail(failmsg)
-
-
-class YAMLHandlerTest(HandlerBaseTest, unittest.TestCase):
-    def setUp(self):
-        self.handler = YAMLHandler()
-        self.data = {
-            "filename": "tests/yaml/hello-markdown.md",
-            # TODO: YAMLHandler.split() is prepending '\n' to the content
-            "content": """\
-
-Title
-=====
-
-title2
-------
-
-Hello.
-
-Just need three dashes
----
-
-And this shouldn't break.""",
-            "metadata": {"test": "tester", "author": "bob", "something": "else"},
-        }
-
-
-class JSONHandlerTest(HandlerBaseTest, unittest.TestCase):
-    def setUp(self):
-        self.handler = JSONHandler()
-        self.data = {
-            "filename": "tests/json/hello-json.md",
-            # TODO: JSONHandler.split() is prepending '\n' to the content
-            "content": """\
-
-
-Title
-=====
-
-title2
-------
-
-Hello.
-
-Just need three dashes
----
-
-And this might break.
-""",
-            "metadata": {"test": "tester", "author": "bob", "something": "else"},
-        }
-
-
-class TOMLHandlerTest(HandlerBaseTest, unittest.TestCase):
-    def setUp(self):
-        self.handler = TOMLHandler()
-        self.data = {
-            "filename": "tests/toml/hello-toml.md",
-            # TODO: TOMLHandler.split() is prepending '\n' to the content
-            "content": """\
-
-Title
-=====
-
-title2
-------
-
-Hello.
-
-Just need three dashes
----
-
-And this shouldn't break.
-""",
-            "metadata": {"test": "tester", "author": "bob", "something": "else"},
-        }
-
-
-if __name__ == "__main__":
-    unittest.main()

python_frontmatter-1.2.0/tests/yaml/chinese.result.json

@@ -1,5 +0,0 @@
-{
-  "title": "Let's try unicode",
-  "language": "\u4e2d\u6587",
-  "content": "\u6b22\u8fce\u6765\u5230\u5927\u8fde\u6c34\u4ea7\u5b66\u9662\uff01"
-}

python_frontmatter-1.2.0/tests/yaml/chinese.txt

@@ -1,6 +0,0 @@
----
-title: "Let's try unicode"
-language: 中文
----
-
-欢迎来到大连水产学院！

python_frontmatter-1.2.0/tests/yaml/extra-dash.result.json

@@ -1,5 +0,0 @@
-{
-  "test": "bob",
-  "else": "kate",
-  "content": "Here's some content."
-}

python_frontmatter-1.2.0/tests/yaml/extra-dash.txt

@@ -1,6 +0,0 @@
-----
-test: bob
-else: kate
-----
-
-Here's some content.

python_frontmatter-1.2.0/tests/yaml/extra-space.result.json

@@ -1,5 +0,0 @@
-{
-  "test": "tester",
-  "something": "else",
-  "content": "This file has an extra space on the opening line of the frontmatter."
-}

python_frontmatter-1.2.0/tests/yaml/extra-space.txt

@@ -1,6 +0,0 @@
---- 
-test: tester
-something: else
----
-
-This file has an extra space on the opening line of the frontmatter.

python_frontmatter-1.2.0/tests/yaml/hello-markdown.md

@@ -1,18 +0,0 @@
----
-test: tester
-author: bob
-something: else
----
-
-Title
-=====
-
-title2
-------
-
-Hello.
-
-Just need three dashes
----
-
-And this shouldn't break.

python_frontmatter-1.2.0/tests/yaml/hello-markdown.result.json

@@ -1,6 +0,0 @@
-{
-  "test": "tester",
-  "author": "bob",
-  "something": "else",
-  "content": "Title\n=====\n\ntitle2\n------\n\nHello.\n\nJust need three dashes\n---\n\nAnd this shouldn't break."
-}

python_frontmatter-1.2.0/tests/yaml/hello-world.result.json

@@ -1,5 +0,0 @@
-{
-  "title": "Hello, world!",
-  "layout": "post",
-  "content": "Well, hello there, world."
-}

python_frontmatter-1.2.0/tests/yaml/hello-world.txt

@@ -1,6 +0,0 @@
----
-title: Hello, world!
-layout: post
----
-
-Well, hello there, world.

python_frontmatter-1.2.0/tests/yaml/network-diagrams.md

@@ -1,12 +0,0 @@
----
-title: "TODO: Understand Network Diagrams"
-layout: post
-published: true
-tags: [todo]
----
-
-Kim Rees, sitting in for Nathan Yau at [Flowing Data](http://flowingdata.com), has been posting examples of [network diagrams](http://flowingdata.com/category/visualization/network-visualization/) lately. I have to confess I'm stumped by most of them them. Or maybe I'm just overwhelmed. Maybe I'm [not alone](http://flowingdata.com/2012/05/28/network-diagrams-simplified/):
-
-> Network diagrams are notoriously messy. Even a small number of nodes can be overwhelmed by their chaotic placement and relationships. [Cody Dunne](http://www.cs.umd.edu/~cdunne/) of [HCIL](http://www.cs.umd.edu/hcil/) showed off [his new work in simplifying these complex structures](http://www.cs.umd.edu/localphp/hcil/tech-reports-search.php?number=2012-11). In essence, he aggregates leaf nodes into a fan glyph that describes the underlying data in its size, arc, and color. Span nodes are similarly captured into crescent glyphs. The result is an easy to read, high level look at the network. You can easily compare different sections of the network, understand areas that may have been occluded by the lines in a traditional diagram, and see relationships far more quickly.
-
-This seems like the kind of thing that could be useful for news, where we're often trying to understand and illustrate complex relationships. I'll have to find a good dataset to play with.

python_frontmatter-1.2.0/tests/yaml/network-diagrams.result.json

@@ -1,9 +0,0 @@
-{
-  "title": "TODO: Understand Network Diagrams",
-  "layout": "post",
-  "published": true,
-  "tags": [
-    "todo"
-  ],
-  "content": "Kim Rees, sitting in for Nathan Yau at [Flowing Data](http://flowingdata.com), has been posting examples of [network diagrams](http://flowingdata.com/category/visualization/network-visualization/) lately. I have to confess I'm stumped by most of them them. Or maybe I'm just overwhelmed. Maybe I'm [not alone](http://flowingdata.com/2012/05/28/network-diagrams-simplified/):\n\n> Network diagrams are notoriously messy. Even a small number of nodes can be overwhelmed by their chaotic placement and relationships. [Cody Dunne](http://www.cs.umd.edu/~cdunne/) of [HCIL](http://www.cs.umd.edu/hcil/) showed off [his new work in simplifying these complex structures](http://www.cs.umd.edu/localphp/hcil/tech-reports-search.php?number=2012-11). In essence, he aggregates leaf nodes into a fan glyph that describes the underlying data in its size, arc, and color. Span nodes are similarly captured into crescent glyphs. The result is an easy to read, high level look at the network. You can easily compare different sections of the network, understand areas that may have been occluded by the lines in a traditional diagram, and see relationships far more quickly.\n\nThis seems like the kind of thing that could be useful for news, where we're often trying to understand and illustrate complex relationships. I'll have to find a good dataset to play with."
-}

python_frontmatter-1.2.0/tests/yaml/unpretty.md

@@ -1,21 +0,0 @@
----
-destination:
-  encoding:
-    xz:
-      enabled: yes
-      min_size: 5120
-      options:
-      path_filter:
-  result:
-    append_to_file:
-    append_to_lafs_dir:
-    print_to_stdout: yes
-  url: http://localhost:3456/uri
-filter:
-  - Длинный стринг на русском
-  - Еще одна длинная строка
----
-
-This is a test of both unicode and prettier dumping. The above metadata comes from the [pretty-yaml](https://github.com/mk-fg/pretty-yaml) readme file.
-
-Metadata should be dumped in order.

python_frontmatter-1.2.0/tests/yaml/unpretty.result.json

@@ -1,23 +0,0 @@
-{
-  "destination": {
-    "encoding": {
-      "xz": {
-        "enabled": true,
-        "min_size": 5120,
-        "options": null,
-        "path_filter": null
-      }
-    },
-    "result": {
-      "append_to_file": null,
-      "append_to_lafs_dir": null,
-      "print_to_stdout": true
-    },
-    "url": "http://localhost:3456/uri"
-  },
-  "filter": [
-    "\u0414\u043b\u0438\u043d\u043d\u044b\u0439 \u0441\u0442\u0440\u0438\u043d\u0433 \u043d\u0430 \u0440\u0443\u0441\u0441\u043a\u043e\u043c",
-    "\u0415\u0449\u0435 \u043e\u0434\u043d\u0430 \u0434\u043b\u0438\u043d\u043d\u0430\u044f \u0441\u0442\u0440\u043e\u043a\u0430"
-  ],
-  "content": "This is a test of both unicode and prettier dumping. The above metadata comes from the [pretty-yaml](https://github.com/mk-fg/pretty-yaml) readme file.\n\nMetadata should be dumped in order."
-}