sdist-ident-mismatch.rst 954B

5 år sedan
123456789101112131415161718
  1. Error: The generated source distribution's identity is not correct
  2. ##################################################################
  3. When ``dds`` attempts to automatically generate a source distribution,
  4. especially when generating from a remote that was acquired using a catalog
  5. listing, ``dds`` expects the generated source distribution to have a matching
  6. package identity to match what was intended.
  7. This can happen if a catalog listing's package version does not match the
  8. source of the remote acquisition method. For example, if using ``git`` to clone
  9. a repository, the ``git-ref`` used to clone must match the package version of
  10. the listing. If the ``git-ref`` is a branch, it is possible that additional
  11. changes were pushed into the branch that changed the package version, thus
  12. invalidating the package. [#f1]_
  13. .. [#f1]
  14. For this reason, it is **highly recommended** to use Git *tags* to
  15. refer to remote packages *instead of branches*.