Method CheckProposedRev

db/crud.go:3662–3692

CheckProposedRev checks withether revid can be pushed without conflict.

(ctx context.Context, docid string, revid string, parentRevID string)

// CheckProposedRev checks withether revid can be pushed without conflict.
func (db *DatabaseCollectionWithUser) CheckProposedRev(ctx context.Context, docid string, revid string, parentRevID string) (status ProposedRevStatus, currentRev string) {
	if strings.HasPrefix(docid, "_design/") && db.user != nil {
		return ProposedRev_OK, "" // Users can't upload design docs, so ignore them
	}

	level := DocUnmarshalRev
	if parentRevID == "" {
		level = DocUnmarshalHistory // doc.History only needed in this case (see below)
	}
	syncData, _, err := db.GetDocSyncDataNoImport(ctx, docid, level)
	if err != nil {
		if !base.IsDocNotFoundError(err) && !base.IsXattrNotFoundError(err) {
			base.WarnfCtx(ctx, "CheckProposedRev(%q) --> %T %v", base.UD(docid), err, err)
			return ProposedRev_Error, ""
		}
		// Doc doesn't exist locally; adding it is OK (even if it has a history)
		return ProposedRev_OK_IsNew, ""
	} else if syncData.GetRevTreeID() == revid {
		// Proposed rev already exists here:
		return ProposedRev_Exists, ""
	} else if syncData.GetRevTreeID() == parentRevID {
		// Proposed rev's parent is my current revision; OK to add:
		return ProposedRev_OK, ""
	} else if parentRevID == "" && syncData.History[syncData.GetRevTreeID()].Deleted {
		// Proposed rev has no parent and doc is currently deleted; OK to add:
		return ProposedRev_OK, ""
	} else {
		// Parent revision mismatch, so this is a conflict:
		return ProposedRev_Conflict, syncData.GetRevTreeID()
	}
}

// CheckProposedVersion - given DocID and a version in string form, check whether it can be added without conflict.
// proposedVersionStr is the string representation of the proposed version's CV.