upstream/mercurial-mirror Files · hgext/strip.py

configitems: declare items in a TOML file...

configitems: declare items in a TOML file Mercurial ships with Rust code that also needs to read from the config. Having a way of presenting `configitems` to both Python and Rust is needed to prevent duplication, drift, and have the appropriate devel warnings. Abstracting away from Python means choosing a config format. No single format is perfect, and I have yet to come across a developer that doesn't hate all of them in some way. Since we have a strict no-dependencies policy for Mercurial, we either need to use whatever comes with Python, vendor a library, or implement a custom format ourselves. Python stdlib means using JSON, which doesn't support comments and isn't great for humans, or `configparser` which is an obscure, untyped format that nobody uses and doesn't have a commonplace Rust parser. Implementing a custom format is error-prone, tedious and subject to the same issues as picking an existing format. Vendoring opens us to the vast array of common config formats. The ones being picked for most modern software are YAML and TOML. YAML is older and common in the Python community, but TOML is much simpler and less error-prone. I would much rather be responsible for the <1000 lines of `tomli`, on top of TOML being the choice of the Rust community, with robust crates for reading it. The structure of `configitems.toml` is explained inline.

Gregory Szorc - - Load All Authors

File last commit:

r49730:6000f5b2 default


                r51655:c51b178b

default

Download file

             strip.py
        
                    21 lines
            
             | 914 B
            
                | text/x-python
            
             |
                PythonLexer
            
             / hgext / strip.py
          
                    History
                
                 |
                  Source
                 | Raw
                 |Copy content
                 |Copy permalink

        Valentin Gatien-Baron
    
strip: move into core...

              r46477
            
      """strip changesets and their descendants from history (DEPRECATED)

      The functionality of this extension has been included in core Mercurial

      since version 5.7. Please use :hg:`debugstrip ...` instead.

        Pierre-Yves David
    
mq: extract strip function as its standalone extension (issue3824)...

              r19826
            
        Javi Merino
    
strip: fix spelling: "allows to" -> "allows you to"

              r19945
            
      This extension allows you to strip changesets and all their descendants from the

        Pierre-Yves David
    
mq: extract strip function as its standalone extension (issue3824)...

              r19826
            
      repository. See the command help for details.

      """

        timeless
    
strip: use absolute_import

              r28377
            
        Valentin Gatien-Baron
    
strip: move into core...

              r46477
            
      from mercurial import commands

        Augie Fackler
    
formatting: blacken the codebase...

              r43346
            
        Augie Fackler
    
extensions: change magic "shipped with hg" string...

              r29841
            
      # Note for extension authors: ONLY specify testedwith = 'ships-with-hg-core' for

        Augie Fackler
    
extensions: document that `testedwith = 'internal'` is special...

              r25186
            
      # extensions which SHIP WITH MERCURIAL. Non-mainline extensions should

      # be specifying the version(s) of Mercurial they are tested with, or

      # leave the attribute unspecified.

        Augie Fackler
    
formatting: byteify all mercurial/ and hgext/ string literals...

              r43347
            
      testedwith = b'ships-with-hg-core'

        Pierre-Yves David
    
strip: move checksubstate from mq to strip...

              r19823
            
        Valentin Gatien-Baron
    
strip: move into core...

              r46477
            
      # This is a bit ugly, but a uisetup function that defines strip as an

      # alias for debugstrip would override any user alias for strip,

      # including aliases like "strip = strip --no-backup".

      commands.command.rename(old=b'debugstrip', new=b'debugstrip|strip')

	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

Valentin Gatien-Baron strip: move into core...	r46477	"""strip changesets and their descendants from history (DEPRECATED)

		The functionality of this extension has been included in core Mercurial
		since version 5.7. Please use :hg:`debugstrip ...` instead.
Pierre-Yves David mq: extract strip function as its standalone extension (issue3824)...	r19826
Javi Merino strip: fix spelling: "allows to" -> "allows you to"	r19945	This extension allows you to strip changesets and all their descendants from the
Pierre-Yves David mq: extract strip function as its standalone extension (issue3824)...	r19826	repository. See the command help for details.
		"""
timeless strip: use absolute_import	r28377
Valentin Gatien-Baron strip: move into core...	r46477	from mercurial import commands
Augie Fackler formatting: blacken the codebase...	r43346
Augie Fackler extensions: change magic "shipped with hg" string...	r29841	# Note for extension authors: ONLY specify testedwith = 'ships-with-hg-core' for
Augie Fackler extensions: document that `testedwith = 'internal'` is special...	r25186	# extensions which SHIP WITH MERCURIAL. Non-mainline extensions should
		# be specifying the version(s) of Mercurial they are tested with, or
		# leave the attribute unspecified.
Augie Fackler formatting: byteify all mercurial/ and hgext/ string literals...	r43347	testedwith = b'ships-with-hg-core'
Pierre-Yves David strip: move checksubstate from mq to strip...	r19823
Valentin Gatien-Baron strip: move into core...	r46477	# This is a bit ugly, but a uisetup function that defines strip as an
		# alias for debugstrip would override any user alias for strip,
		# including aliases like "strip = strip --no-backup".
		commands.command.rename(old=b'debugstrip', new=b'debugstrip\|strip')