upstream/mercurial-mirror Files · mercurial/node.py

interfaces: introduce and use a protocol class for the `base85` module...

interfaces: introduce and use a protocol class for the `base85` module See for details when this was done for the `bdiff` module. It looks like PEP-688 removed the special casing of `bytes` being a standin for any type of `ByteString`, and defines a `typing.Buffer` class (with a backport in `typing_extensions` for Python prior to 3.12). There's been a lot of churn in this area with pytype, but recent versions of pytype and PyCharm recognize this, and e.g. have `mercurial.node.hex()` defined as: from typing_extensions import Buffer def hex(data: Buffer, sep: str | bytes = ..., bytes_per_sep: int = ...) -> bytes This covers `bytes`, `bytearray`, and `memoryview` by default. Both of the C functions here use `y#` to parse the arguments, which means the arg is a byte-like object[2], so the args would appear to be better typed as `Buffer`. However, pytype has a bug that prevents using this from `typing_extensions`[3], and mypy complained `Unsupported left operand type for + ("memoryview")` in the pure module on line 37 (meaning it's only a subset of `Buffer`). So hold off on changing any of that for now. [1] https://peps.python.org/pep-0688/#no-special-meaning-for-bytes [2] https://docs.python.org/3/glossary.html#term-bytes-like-object [3] https://github.com/google/pytype/issues/1772

Matt Harbison - - Load All Authors

File last commit:

r52756:f4733654 default


                r52831:fa7059f0

default

Download file

             node.py
        
                    61 lines
            
             | 1.8 KiB
            
                | text/x-python
            
             |
                PythonLexer
            
             / mercurial / node.py
          
                    History
                
                 |
                  Annotation
                 | Raw
                 |Copy content
                 |Copy permalink

      # node.py - basic nodeid manipulation for mercurial

      #

      # Copyright 2005, 2006 Olivia Mackall <olivia@selenic.com>

      #

      # This software may be used and distributed according to the terms of the

      # GNU General Public License version 2 or any later version.

      from __future__ import annotations

      import binascii

      # This ugly style has a noticeable effect in manifest parsing

      hex = binascii.hexlify

      bin = binascii.unhexlify

      def short(node):

          return hex(node[:6])

      nullrev = -1

      # pseudo identifier for working directory

      # (experimental, so don't add too many dependencies on it)

      wdirrev = 0x7FFFFFFF

      class sha1nodeconstants:

          nodelen = 20

          # In hex, this is '0000000000000000000000000000000000000000'

          nullid = b"\0" * nodelen

          nullhex = hex(nullid)

          # Phony node value to stand-in for new files in some uses of

          # manifests.

          # In hex, this is '2121212121212121212121212121212121212121'

          newnodeid = b'!!!!!!!!!!!!!!!!!!!!'

          # In hex, this is '3030303030303030303030303030306164646564'

          addednodeid = b'000000000000000added'

          # In hex, this is '3030303030303030303030306d6f646966696564'

          modifiednodeid = b'000000000000modified'

          wdirfilenodeids = {newnodeid, addednodeid, modifiednodeid}

          # pseudo identifier for working directory

          # (experimental, so don't add too many dependencies on it)

          # In hex, this is 'ffffffffffffffffffffffffffffffffffffffff'

          wdirid = b"\xff" * nodelen

          wdirhex = hex(wdirid)

      # legacy starting point for porting modules

      nullid = sha1nodeconstants.nullid

      nullhex = sha1nodeconstants.nullhex

      newnodeid = sha1nodeconstants.newnodeid

      addednodeid = sha1nodeconstants.addednodeid

      modifiednodeid = sha1nodeconstants.modifiednodeid

      wdirfilenodeids = sha1nodeconstants.wdirfilenodeids

      wdirid = sha1nodeconstants.wdirid

      wdirhex = sha1nodeconstants.wdirhex

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

				# node.py - basic nodeid manipulation for mercurial
				#
				# Copyright 2005, 2006 Olivia Mackall <olivia@selenic.com>
				#
				# This software may be used and distributed according to the terms of the
				# GNU General Public License version 2 or any later version.

				from __future__ import annotations

				import binascii

				# This ugly style has a noticeable effect in manifest parsing
				hex = binascii.hexlify
				bin = binascii.unhexlify


				def short(node):
				return hex(node[:6])


				nullrev = -1

				# pseudo identifier for working directory
				# (experimental, so don't add too many dependencies on it)
				wdirrev = 0x7FFFFFFF


				class sha1nodeconstants:
				nodelen = 20

				# In hex, this is '0000000000000000000000000000000000000000'
				nullid = b"\0" * nodelen
				nullhex = hex(nullid)

				# Phony node value to stand-in for new files in some uses of
				# manifests.
				# In hex, this is '2121212121212121212121212121212121212121'
				newnodeid = b'!!!!!!!!!!!!!!!!!!!!'
				# In hex, this is '3030303030303030303030303030306164646564'
				addednodeid = b'000000000000000added'
				# In hex, this is '3030303030303030303030306d6f646966696564'
				modifiednodeid = b'000000000000modified'

				wdirfilenodeids = {newnodeid, addednodeid, modifiednodeid}

				# pseudo identifier for working directory
				# (experimental, so don't add too many dependencies on it)
				# In hex, this is 'ffffffffffffffffffffffffffffffffffffffff'
				wdirid = b"\xff" * nodelen
				wdirhex = hex(wdirid)


				# legacy starting point for porting modules
				nullid = sha1nodeconstants.nullid
				nullhex = sha1nodeconstants.nullhex
				newnodeid = sha1nodeconstants.newnodeid
				addednodeid = sha1nodeconstants.addednodeid
				modifiednodeid = sha1nodeconstants.modifiednodeid
				wdirfilenodeids = sha1nodeconstants.wdirfilenodeids
				wdirid = sha1nodeconstants.wdirid
				wdirhex = sha1nodeconstants.wdirhex