timsort

KO | EN

gitlite — search

#ai #typescript #rust #react #javascript #python #nodejs #mcp #llm #mcp-server #css #developer-tools

★ 84 Open GitHub ↗

go implementation of timsort

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# timsort [![Build Status](https://api.travis-ci.com/psilva261/timsort.svg?branch=master)](https://travis-ci.com/psilva261/timsort) [![codecov](https://codecov.io/gh/psilva261/timsort/branch/master/graph/badge.svg)](https://codecov.io/gh/psilva261/timsort)

**timsort** is a Go implementation of Tim Peters' mergesort
sorting algorithm. It's stable and runs in O(n) time for presorted
inputs and O(n log n) otherwise.

For many input types it is 2-3 times faster than Go's built-in sorting.

The main drawback of this sort method is that it is not in-place (as any
mergesort), and may put extra strain on garbage collector.

This implementation was ported to Go by Mike Kroutikov
and derived from Java's TimSort object by Josh Bloch,
which, in turn, was based on the [original code by Tim Peters][listsort].

## Installation

$ go get -u github.com/psilva261/timsort/v2

## Testing

Inside the source directory, type

go test

to run test harness.

## Benchmarking

Inside the source directory, type

go test -test.bench=.*

to run benchmarks. Each combination of input type/size is presented to timsort,
and, for comparison, to the standard Go sort (sort.Sort for ints or sort.Stable otherwise).
See [BENCHMARKS.md][BENCHMARKS.md] for more info and some benchmarking results.

## Examples

### As drop-in replacement for sort.Sort

package main

import (
		"github.com/psilva261/timsort/v2"
		"fmt"
		"sort"
    )

func main() {
		l := []string{"c", "a", "b"}
		timsort.TimSort(sort.StringSlice(l)
		fmt.Printf("sorted array: %+v\n", l)
    }

### Explicit "less" function

package main

import (
		"github.com/psilva261/timsort/v2"
		"fmt"
	)

type Record struct {
		ssn  int
		name string
	}

func BySsn(a, b interface{}) bool {
		return a.(Record).ssn < b.(Record).ssn
	}

func ByName(a, b interface{}) bool {
		return a.(Record).name < b.(Record).name
	}

func main() {
		db := make([]interface{}, 3)
		db[0] = Record{123456789, "joe"}
		db[1] = Record{101765430, "sue"}
		db[2] = Record{345623452, "mary"}

// sorts array by ssn (ascending)
		timsort.Sort(db, BySsn)
		fmt.Printf("sorted by ssn: %v\n", db)

// now re-sort same array by name (ascending)
		timsort.Sort(db, ByName)
		fmt.Printf("sorted by name: %v\n", db)
	}

[listsort]: http://svn.python.org/projects/python/trunk/Objects/listsort.txt
[BENCHMARKS.md]: http://github.com/psilva261/timsort/blob/master/BENCHMARKS.md

timsort

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README