莒j8%"dZddlmZddlZddlZddlmZddlmZm Z m Z ddl m Z m Z mZddlmZmZmZmZerdd l mZgd Zd ee e fDZd*dZ d+d,dZd-d.dZd-d/dZ d+d0d!Z d+d1d"Z d+d2d'Zd3d4d(ZGd)d eZ dS)5zB Python Frontmatter: Parse and manage posts with YAML frontmatter ) annotationsN)PathLike) TYPE_CHECKINGIterableTextIO) JSONHandler TOMLHandler YAMLHandler)can_open is_readable is_writableu) BaseHandler)parseloadloadsdumpdumpsc&g|]}||SN).0Handlers BC:\Projects\DSCons\.venv\Lib\site-packages\frontmatter\__init__.py rs.    GIItextstrhandlersIterable[BaseHandler]returnBaseHandler | NonecB|D]}||r|cSdS)a Figure out which handler to use, based on metadata. Returns a handler instance or None. ``text`` should be unicode text about to be parsed. ``handlers`` is a dictionary where keys are opening delimiters and values are handler instances. N)detect)rr handlers r detect_formatr's< >>$   NNN  4rutf-8encodingr&defaultsobjecttuple[dict[str, object], str]c t||}|}|pt|t}|||fS ||\}}n#t $r||fcYSwxYw||}t|tr| |||fS)a Parse text with frontmatter, return metadata and content. Pass in optional metadata defaults as keyword args. If frontmatter is not found, returns an empty metadata dictionary (or defaults) and original text content. .. testsetup:: * >>> import frontmatter .. doctest:: >>> with open('tests/yaml/hello-world.txt') as f: ... metadata, content = frontmatter.parse(f.read()) >>> print(metadata['title']) Hello, world! ) rstripcopyr'r split ValueErrorr isinstancedictupdate)rr)r&r*metadatafmcontentfm_datas rrr1s4 T8   " " $ $D}}H6tX66G~mmD)) GG ~ ll2G'4  !   W]]__ $$sA..A?>A?fdTextIO | PathLike[str] | strboolc t|r|}nPt|r?t|d|5}|}dddn #1swxYwYndSt ||S)a Check if a file-like object or filename has a frontmatter, return True if exists, False otherwise. If it contains a frontmatter but it is empty, return True as well. .. doctest:: >>> frontmatter.check('tests/yaml/hello-world.txt') True rr)NF)r readr openchecks)r9r)rfs rcheckrCds2 wwyy " "cH - - - 6688D                u $ ! !!A''A+.A+cTt||}t|tdkS)a< Check if a text (binary or unicode) has a frontmatter, return True if exists, False otherwise. If it contains a frontmatter but it is empty, return True as well. .. doctest:: >>> with open('tests/yaml/hello-world.txt') as f: ... frontmatter.checks(f.read()) True N)rr'r )rr)s rrArAs( T8  D x ( (D 00rstr | io.IOBase | pathlib.PathPostc pt|r|}nmt|r?t|d|5}|}dddn #1swxYwYnt dt ||pt |t}t|||fi|S)a% Load and parse a file-like object or filename, return a :py:class:`post `. .. doctest:: >>> post = frontmatter.load('tests/yaml/hello-world.txt') >>> with open('tests/yaml/hello-world.txt') as f: ... post = frontmatter.load(f) r=r>N Cannot open filename using type ) r r?r r@r1typer'r r)r9r)r&r*rrBs rrrs"2Hwwyy "H "cH - - - 6688D               FDHHFFGGG6tX66G x 5 5H 5 55rDc t||}|pt|t}t|||fi|\}}t ||fi|S)z Parse text (binary or unicode) and return a :py:class:`post `. .. doctest:: >>> with open('tests/yaml/hello-world.txt') as f: ... post = frontmatter.loads(f.read()) )rr'r rrG)rr)r&r*r5r7s rrrs] T8  D6tX66GdHgBBBBHg  - -H - --rpoststr | PathLike[str] | TextIOkwargsNonec Jt||fi|}t|r||dSt|rBt |d|5}||ddddS#1swxYwYdSt dt |)aO Serialize :py:class:`post ` to a string and write to a file-like object. Text will be encoded on the way out (utf-8 by default). :: >>> from io import StringIO >>> post = frontmatter.load('tests/yaml/hello-world.txt') >>> f = StringIO() >>> frontmatter.dump(post, f) >>> print(f.getvalue()) --- layout: post title: Hello, world! --- Well, hello there, world. .. testcode:: from io import StringIO post = frontmatter.load('tests/yaml/hello-world.txt') f = StringIO() frontmatter.dump(post, f) print(f.getvalue()) .. testoutput:: --- layout: post title: Hello, world! --- Well, hello there, world. wr>NrI)rrwriter r@r1rJ)rLr9r)r&rNr7rBs rrrsXD',,V,,G2H  "H "cH - - -  GGG                     FDHHFFGGGsA99A=A=c h|t|ddp t}|J|j|fi|S)a Serialize a :py:class:`post ` to a string and return text. This always returns unicode text, which can then be encoded. Passing ``handler`` will change how metadata is turned into text. A handler passed as an argument will override ``post.handler``, with :py:class:`YAMLHandler ` used as a default. :: >>> post = frontmatter.load('tests/yaml/hello-world.txt') >>> print(frontmatter.dumps(post)) # doctest: +NORMALIZE_WHITESPACE --- layout: post title: Hello, world! --- Well, hello there, world. .. testcode:: post = frontmatter.load('tests/yaml/hello-world.txt') print(frontmatter.dumps(post)) .. testoutput:: --- layout: post title: Hello, world! --- Well, hello there, world. Nr&)getattrr format)rLr&rNs rrrsJH$ 400AKMM     7>$ ) )& ) ))rcpeZdZdZ d d!d Zd"d Zd#dZd$dZd%dZd&dZ d'dZ d d(dZ d)dZ d*dZ d+dZdS),rGa} A post contains content and metadata from Front Matter. This is what gets returned by :py:func:`load ` and :py:func:`loads `. Passing this to :py:func:`dump ` or :py:func:`dumps ` will turn it back into text. For convenience, metadata values are available as proxied item lookups. Nr7rr&r#r5r+r"rOc Jt||_||_||_dSr)rr7r5r&)selfr7r&r5s r__init__z Post.__init__2s#7||    rnamec|j|S)zGet metadata keyr5rXrZs r __getitem__zPost.__getitem__9s}T""ritemr;c||jvS)zCheck metadata contains keyr\)rXr_s r __contains__zPost.__contains__=st}$$rvaluec||j|<dS)zSet a metadata keyNr\)rXrZrbs r __setitem__zPost.__setitem__As# drc|j|=dS)zDelete a metadata keyNr\r]s r __delitem__zPost.__delitem__Es M$   rbytesc6|jdS)Nr()r7encoderXs r __bytes__zPost.__bytes__Is|""7+++rc|jSr)r7rjs r__str__z Post.__str__Ls |rkeydefaultc8|j||S)zGet a key, fallback to default)r5get)rXrnros rrqzPost.getOs}  g...r Iterable[str]c4|jS)zReturn metadata keys)r5keysrjs rrtz Post.keysSs}!!###rIterable[object]c4|jS)zReturn metadata values)r5valuesrjs rrwz Post.valuesWs}##%%%rdict[str, object]cL|j}|j|d<|S)zPost as a dict, for serializingr7)r5r/r7)rXds rto_dictz Post.to_dict[s% M   |) rr)r7rr&r#r5r+r"rO)rZrr"r+)r_r+r"r;)rZrrbr+r"rO)rZrr"rO)r"rg)r"r)rnrror+r"r+)r"rr)r"ru)r"rx)__name__ __module__ __qualname____doc__rYr^rardrfrkrmrqrtrwr{rrrrGrG(s ;?####%%%%$$$$    ,,,,/////$$$$&&&&r)rrr r!r"r#)r(N) rrr)rr&r#r*r+r"r,)r()r9r:r)rr"r;)rrr)rr"r;) r9rFr)rr&r#r*r+r"rG) rrr)rr&r#r*r+r"rG) rLrGr9rMr)rr&r#rNr+r"rOr)rLrGr&r#rNr+r"r)!r __future__riopathlibosrtypingrrrdefault_handlersr r r utilr r rrr__all__r r'rrCrArrrrr+rGrrrrs#""""" 2222222222CCCCCCCCCC777777777777.------ 6 5 5  k:   ("&0%0%0%0%0%f"""""611111("&66666B"&.....0"& 5H5H5H5H5Hp(*(*(*(*(*V77777677777r