Method sort

src/core/pyproxy.ts:1942–1984

* The :js:meth:`Array.sort` method sorts the elements of a * :js:class:`PyMutableSequence` in place. * @param compareFn A function that defines the sort order. * @returns A reference to the same :js:class:`PyMutableSequence`

(compareFn?: (a: any, b: any) => number)

   * @returns A reference to the same :js:class:`PyMutableSequence`
   */
  sort(compareFn?: (a: any, b: any) => number): PyMutableSequence {
    // Copy the behavior of sort described here:
    // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort#creating_displaying_and_sorting_an_array
    // Yes JS sort is weird.

    // We need this adaptor to convert from js comparison function to Python key
    // function.
    const functools = API.public_api.pyimport("functools");
    const cmp_to_key = functools.cmp_to_key;
    let cf: (a: any, b: any) => number;
    if (compareFn) {
      cf = compareFn;
    } else {
      cf = defaultCompareFunc;
    }
    // spec says arguments to compareFunc "Will never be undefined."
    // and undefined values should get sorted to end of list.
    // Make wrapper to ensure this
    function wrapper(a: any, b: any) {
      if (a === undefined && b === undefined) {
        return 0;
      }
      if (a === undefined) {
        return 1;
      }
      if (b === undefined) {
        return -1;
      }
      return cf(a, b);
    }
    let key;
    try {
      key = cmp_to_key(wrapper);
      // @ts-ignore
      this.$sort.callKwargs({ key });
    } finally {
      key?.destroy();
      cmp_to_key.destroy();
      functools.destroy();
    }
    // @ts-ignore
    return this;
  }
  /**
   * The :js:meth:`Array.splice` method changes the contents of a
   * :js:class:`PyMutableSequence` by removing or replacing existing elements and/or