#require no-reposimplestore

  $ cat >> $HGRCPATH << EOF

  > [extensions]

  > share =

  > [format]

  > # stabilize test accross variant

  > revlog-compression=zlib

  > EOF

store and revlogv1 are required in source

  $ hg --config format.usestore=false init no-store

  $ hg -R no-store debugupgraderepo

  abort: cannot upgrade repository; requirement missing: store

  [255]

  $ hg init no-revlogv1

  $ cat > no-revlogv1/.hg/requires << EOF

  > dotencode

  > fncache

  > generaldelta

  > store

  > EOF

  $ hg -R no-revlogv1 debugupgraderepo

  abort: cannot upgrade repository; missing a revlog version

  [255]

Cannot upgrade shared repositories

  $ hg init share-parent

  $ hg -q share share-parent share-child

  $ hg -R share-child debugupgraderepo

  abort: cannot upgrade repository; unsupported source requirement: shared

  [255]

Do not yet support upgrading treemanifest repos

  $ hg --config experimental.treemanifest=true init treemanifest

  $ hg -R treemanifest debugupgraderepo

  abort: cannot upgrade repository; unsupported source requirement: treemanifest

  [255]

Cannot add treemanifest requirement during upgrade

  $ hg init disallowaddedreq

  $ hg -R disallowaddedreq --config experimental.treemanifest=true debugupgraderepo

  abort: cannot upgrade repository; do not support adding requirement: treemanifest

  [255]

An upgrade of a repository created with recommended settings only suggests optimizations

  $ hg init empty

  $ cd empty

  $ hg debugformat

  format-variant     repo

  fncache:            yes

  dirstate-v2:         no

  dotencode:          yes

  generaldelta:       yes

  share-safe:          no

  sparserevlog:       yes

  persistent-nodemap:  no (no-rust !)

  persistent-nodemap: yes (rust !)

  copies-sdc:          no

  revlog-v2:           no

  changelog-v2:        no

  plain-cl-delta:     yes

  compression:        zlib

  compression-level:  default

  $ hg debugformat --verbose

  format-variant     repo config default

  fncache:            yes    yes     yes

  dirstate-v2:         no     no      no

  dotencode:          yes    yes     yes

  generaldelta:       yes    yes     yes

  share-safe:          no     no      no

  sparserevlog:       yes    yes     yes

  persistent-nodemap:  no     no      no (no-rust !)

  persistent-nodemap: yes    yes      no (rust !)

  copies-sdc:          no     no      no

  revlog-v2:           no     no      no

  changelog-v2:        no     no      no

  plain-cl-delta:     yes    yes     yes

  compression:        zlib   zlib    zlib (no-zstd !)

  compression:        zlib   zlib    zstd (zstd !)

  compression-level:  default default default

  $ hg debugformat --verbose --config format.usefncache=no

  format-variant     repo config default

  fncache:            yes     no     yes

  dirstate-v2:         no     no      no

  dotencode:          yes     no     yes

  generaldelta:       yes    yes     yes

  share-safe:          no     no      no

  sparserevlog:       yes    yes     yes

  persistent-nodemap:  no     no      no (no-rust !)

  persistent-nodemap: yes    yes      no (rust !)

  copies-sdc:          no     no      no

  revlog-v2:           no     no      no

  changelog-v2:        no     no      no

  plain-cl-delta:     yes    yes     yes

  compression:        zlib   zlib    zlib (no-zstd !)

  compression:        zlib   zlib    zstd (zstd !)

  compression-level:  default default default

  $ hg debugformat --verbose --config format.usefncache=no --color=debug

  format-variant     repo config default

  [formatvariant.name.mismatchconfig|fncache:           ][formatvariant.repo.mismatchconfig| yes][formatvariant.config.special|     no][formatvariant.default|     yes]

  [formatvariant.name.uptodate|dirstate-v2:       ][formatvariant.repo.uptodate|  no][formatvariant.config.default|     no][formatvariant.default|      no]

  [formatvariant.name.mismatchconfig|dotencode:         ][formatvariant.repo.mismatchconfig| yes][formatvariant.config.special|     no][formatvariant.default|     yes]

  [formatvariant.name.uptodate|generaldelta:      ][formatvariant.repo.uptodate| yes][formatvariant.config.default|    yes][formatvariant.default|     yes]

  [formatvariant.name.uptodate|share-safe:        ][formatvariant.repo.uptodate|  no][formatvariant.config.default|     no][formatvariant.default|      no]

  [formatvariant.name.uptodate|sparserevlog:      ][formatvariant.repo.uptodate| yes][formatvariant.config.default|    yes][formatvariant.default|     yes]

  [formatvariant.name.uptodate|persistent-nodemap:][formatvariant.repo.uptodate|  no][formatvariant.config.default|     no][formatvariant.default|      no] (no-rust !)

  [formatvariant.name.mismatchdefault|persistent-nodemap:][formatvariant.repo.mismatchdefault| yes][formatvariant.config.special|    yes][formatvariant.default|      no] (rust !)

  [formatvariant.name.uptodate|copies-sdc:        ][formatvariant.repo.uptodate|  no][formatvariant.config.default|     no][formatvariant.default|      no]

  [formatvariant.name.uptodate|revlog-v2:         ][formatvariant.repo.uptodate|  no][formatvariant.config.default|     no][formatvariant.default|      no]

  [formatvariant.name.uptodate|changelog-v2:      ][formatvariant.repo.uptodate|  no][formatvariant.config.default|     no][formatvariant.default|      no]

  [formatvariant.name.uptodate|plain-cl-delta:    ][formatvariant.repo.uptodate| yes][formatvariant.config.default|    yes][formatvariant.default|     yes]

  [formatvariant.name.uptodate|compression:       ][formatvariant.repo.uptodate| zlib][formatvariant.config.default|   zlib][formatvariant.default|    zlib] (no-zstd !)

  [formatvariant.name.mismatchdefault|compression:       ][formatvariant.repo.mismatchdefault| zlib][formatvariant.config.special|   zlib][formatvariant.default|    zstd] (zstd !)

  [formatvariant.name.uptodate|compression-level: ][formatvariant.repo.uptodate| default][formatvariant.config.default| default][formatvariant.default| default]

  $ hg debugformat -Tjson

  [

   {

    "config": true,

    "default": true,

    "name": "fncache",

    "repo": true

   },

   {

    "config": false,

    "default": false,

    "name": "dirstate-v2",

    "repo": false

   },

   {

    "config": true,

    "default": true,

    "name": "dotencode",

    "repo": true

   },

   {

    "config": true,

    "default": true,

    "name": "generaldelta",

    "repo": true

   },

   {

    "config": false,

    "default": false,

    "name": "share-safe",

    "repo": false

   },

   {

    "config": true,

    "default": true,

    "name": "sparserevlog",

    "repo": true

   },

   {

    "config": false, (no-rust !)

    "config": true, (rust !)

    "default": false,

    "name": "persistent-nodemap",

    "repo": false (no-rust !)

    "repo": true (rust !)

   },

   {

    "config": false,

    "default": false,

    "name": "copies-sdc",

    "repo": false

   },

   {

    "config": false,

    "default": false,

    "name": "revlog-v2",

    "repo": false

   },

   {

    "config": false,

    "default": false,

    "name": "changelog-v2",

    "repo": false

   },

   {

    "config": true,

    "default": true,

    "name": "plain-cl-delta",

    "repo": true

   },

   {

    "config": "zlib",

    "default": "zlib", (no-zstd !)

    "default": "zstd", (zstd !)

    "name": "compression",

    "repo": "zlib"

   },

   {

    "config": "default",

    "default": "default",

    "name": "compression-level",

    "repo": "default"

   }

  ]

  $ hg debugupgraderepo

  (no format upgrades found in existing repository)

  performing an upgrade with "--run" will make the following changes:

  requirements

     preserved: dotencode, fncache, generaldelta, revlogv1, sparserevlog, store (no-rust !)

     preserved: dotencode, fncache, generaldelta, persistent-nodemap, revlogv1, sparserevlog, store (rust !)

  no revlogs to process

  additional optimizations are available by specifying "--optimize <name>":

  re-delta-parent

     deltas within internal storage will be recalculated to choose an optimal base revision where this was not already done; the size of the repository may shrink and various operations may become faster; the first time this optimization is performed could slow down upgrade execution considerably; subsequent invocations should not run noticeably slower

  re-delta-multibase

     deltas within internal storage will be recalculated against multiple base revision and the smallest difference will be used; the size of the repository may shrink significantly when there are many merges; this optimization will slow down execution in proportion to the number of merges in the repository and the amount of files in the repository; this slow down should not be significant unless there are tens of thousands of files and thousands of merges

  re-delta-all

     deltas within internal storage will always be recalculated without reusing prior deltas; this will likely make execution run several times slower; this optimization is typically not needed

  re-delta-fulladd

     every revision will be re-added as if it was new content. It will go through the full storage mechanism giving extensions a chance to process it (eg. lfs). This is similar to "re-delta-all" but even slower since more logic is involved.

  $ hg debugupgraderepo --quiet

  requirements

     preserved: dotencode, fncache, generaldelta, revlogv1, sparserevlog, store (no-rust !)

     preserved: dotencode, fncache, generaldelta, persistent-nodemap, revlogv1, sparserevlog, store (rust !)

  no revlogs to process

--optimize can be used to add optimizations

  $ hg debugupgrade --optimize 're-delta-parent'

  (no format upgrades found in existing repository)

  performing an upgrade with "--run" will make the following changes:

  requirements

     preserved: dotencode, fncache, generaldelta, revlogv1, sparserevlog, store (no-rust !)

     preserved: dotencode, fncache, generaldelta, persistent-nodemap, revlogv1, sparserevlog, store (rust !)

  optimisations: re-delta-parent

  re-delta-parent

     deltas within internal storage will choose a new base revision if needed

  processed revlogs:

    - all-filelogs

    - changelog

    - manifest

  additional optimizations are available by specifying "--optimize <name>":

  re-delta-multibase

     deltas within internal storage will be recalculated against multiple base revision and the smallest difference will be used; the size of the repository may shrink significantly when there are many merges; this optimization will slow down execution in proportion to the number of merges in the repository and the amount of files in the repository; this slow down should not be significant unless there are tens of thousands of files and thousands of merges

  re-delta-all

     deltas within internal storage will always be recalculated without reusing prior deltas; this will likely make execution run several times slower; this optimization is typically not needed

  re-delta-fulladd

     every revision will be re-added as if it was new content. It will go through the full storage mechanism giving extensions a chance to process it (eg. lfs). This is similar to "re-delta-all" but even slower since more logic is involved.

modern form of the option

  $ hg debugupgrade --optimize re-delta-parent

  (no format upgrades found in existing repository)

  performing an upgrade with "--run" will make the following changes:

  requirements

     preserved: dotencode, fncache, generaldelta, revlogv1, sparserevlog, store (no-rust !)

     preserved: dotencode, fncache, generaldelta, persistent-nodemap, revlogv1, sparserevlog, store (rust !)

  optimisations: re-delta-parent

  re-delta-parent

     deltas within internal storage will choose a new base revision if needed

  processed revlogs:

    - all-filelogs

    - changelog

    - manifest

  additional optimizations are available by specifying "--optimize <name>":

  re-delta-multibase

     deltas within internal storage will be recalculated against multiple base revision and the smallest difference will be used; the size of the repository may shrink significantly when there are many merges; this optimization will slow down execution in proportion to the number of merges in the repository and the amount of files in the repository; this slow down should not be significant unless there are tens of thousands of files and thousands of merges

  re-delta-all

     deltas within internal storage will always be recalculated without reusing prior deltas; this will likely make execution run several times slower; this optimization is typically not needed

  re-delta-fulladd

     every revision will be re-added as if it was new content. It will go through the full storage mechanism giving extensions a chance to process it (eg. lfs). This is similar to "re-delta-all" but even slower since more logic is involved.

  $ hg debugupgrade --optimize re-delta-parent --quiet

  requirements

     preserved: dotencode, fncache, generaldelta, revlogv1, sparserevlog, store (no-rust !)

     preserved: dotencode, fncache, generaldelta, persistent-nodemap, revlogv1, sparserevlog, store (rust !)

  optimisations: re-delta-parent

  processed revlogs:

    - all-filelogs

    - changelog

    - manifest

unknown optimization:

  $ hg debugupgrade --optimize foobar

  abort: unknown optimization action requested: foobar

  (run without arguments to see valid optimizations)

  [255]

Various sub-optimal detections work

  $ cat > .hg/requires << EOF

  > revlogv1

  > store

  > EOF

  $ hg debugformat