This is an archive of the discontinued Mercurial Phabricator instance.

Differential D7383

state: add a pytype annotation
ClosedPublic

Authored by durin42 on Nov 13 2019, 10:51 PM.

Details

Reviewers
dlax
indygreg
Group Reviewers
hg-reviewers
Commits
rHG127d46468a45: state: add a pytype annotation

Diff Detail

Repository
rHG Mercurial
Lint
Automatic diff as part of commit; lint not applicable.
Unit
Automatic diff as part of commit; unit tests not applicable.

Revision Contents
Changeset List

PathPackages
Mmercurial/state.py (10 lines)

Diff 18225

mercurial/state.py

from .i18n import _ from .i18n import _
from . import ( from . import (
error, error,
util, util,
) )
from .utils import cborutil from .utils import cborutil
if not globals():
from typing import (
Any,
Dict,
)
for t in (Any, Dict):
assert t
class cmdstate(object): class cmdstate(object):
"""a wrapper class to store the state of commands like `rebase`, `graft`, """a wrapper class to store the state of commands like `rebase`, `graft`,
`histedit`, `shelve` etc. Extensions can also use this to write state files. `histedit`, `shelve` etc. Extensions can also use this to write state files.
All the data for the state is stored in the form of key-value pairs in a All the data for the state is stored in the form of key-value pairs in a
dictionary. dictionary.
The class object can write all the data to a file in .hg/ directory and The class object can write all the data to a file in .hg/ directory and
can populate the object data reading that file. can populate the object data reading that file.
Uses cbor to serialize and deserialize data while writing and reading from Uses cbor to serialize and deserialize data while writing and reading from
disk. disk.
""" """
def __init__(self, repo, fname): def __init__(self, repo, fname):
""" repo is the repo object """ repo is the repo object
fname is the file name in which data should be stored in .hg directory fname is the file name in which data should be stored in .hg directory
""" """
self._repo = repo self._repo = repo
self.fname = fname self.fname = fname
def read(self): def read(self):
# type: () -> Dict[bytes, Any]
"""read the existing state file and return a dict of data stored""" """read the existing state file and return a dict of data stored"""
return self._read() return self._read()
def save(self, version, data): def save(self, version, data):
"""write all the state data stored to .hg/<filename> file """write all the state data stored to .hg/<filename> file
we use third-party library cbor to serialize data to write in the file. we use third-party library cbor to serialize data to write in the file.
""" """