Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cosimochellini/sort-es
Blazing fast, tree-shakeable, type-safe, modern utility library to sort any type of array
https://github.com/cosimochellini/sort-es
javascript javascript-library js sort sort-es sorting-algorithms tree-shakeable ts typescript
Last synced: 16 days ago
JSON representation
Blazing fast, tree-shakeable, type-safe, modern utility library to sort any type of array
- Host: GitHub
- URL: https://github.com/cosimochellini/sort-es
- Owner: cosimochellini
- License: mit
- Created: 2020-02-16T14:58:28.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-10-17T07:06:11.000Z (about 2 months ago)
- Last Synced: 2024-11-17T17:40:18.158Z (26 days ago)
- Topics: javascript, javascript-library, js, sort, sort-es, sorting-algorithms, tree-shakeable, ts, typescript
- Language: TypeScript
- Homepage: http://sort-es.netlify.app
- Size: 1.74 MB
- Stars: 45
- Watchers: 5
- Forks: 5
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-blazingly-fast - sort-es - Blazing fast, tree-shakeable, type-safe, modern utility library to sort any type of array (TypeScript)
README
# sort-es
[](https://opensource.org/licenses/MIT)
[](https://snyk.io/test/npm/sort-es)
[](https://codecov.io/gh/cosimochellini/sort-es)
## Blazing fast, tree-shakeable, type-safe, modern utility library to sort any type of array
## Docs : https://sort-es.netlify.app/
# Getting started
## installation
The library is available as a [npm package](https://www.npmjs.com/package/sort-es).
To install the package, run:
```
npm install sort-es
# or
yarn add sort-es
```
Start using:
```typescript
import {byString} from 'sort-es'
const unsorted = ["xxx", "bbbb", "zzz", "cccc", "aaa"];
const sorted = unsorted.sort(byString());
console.log(sorted); //(5) ["aaa", "bbbb", "cccc", "xxx", "zzz"]
```
Use directly in the browser
```html
const unsorted = ["xxx", "bbbb", "zzz", "cccc", "aaa"];
const sorted = unsorted.sort(sort.byString());
console.log(sorted); //(5) ["aaa", "bbbb", "cccc", "xxx", "zzz"]
//or via browser modules
import {byString} from 'https://cdn.jsdelivr.net/npm/sort-es/dist/index.mjs'
const unsorted = ["xxx", "bbbb", "zzz", "cccc", "aaa"];
const sorted = unsorted.sort(byString());
console.log(sorted); //(5) ["aaa", "bbbb", "cccc", "xxx", "zzz"]
```
## Some mind-blowing example
**sort by a single property**
```typescript
//js or ts file
import {byValue, byNumber, byString} from 'sort-es'
const arrayUnsorted = [
{prop: "xxx", foo: 34},
{prop: "aaa", foo: 325},
{prop: "zzz", foo: 15},
{prop: "ccc", foo: 340},
{prop: "bbb", foo: 0}
];
//this sort by the foo property ascending
const sortedByFoo = arrayUnsorted.sort(byValue((i) => i.foo, byNumber()));
console.log(sortedByFoo); //(5) [{prop: "bbb", foo : 0}, {prop: "zzz", foo: 15}, .....];
//this sort by the prop property descending
const sortedByProp = arrayUnsorted.sort(byValue((i) => i.prop, byString({desc: true})));
console.log(sortedByProp); //(5) [{prop: "zzz", foo : 15}, {prop: "xxx", foo: 34}, .....];
```
**sort by a multiple property**
```javascript
//js or ts file
import {byNumber, byString, byValues} from "sort-es";
const objsToSort = [
{id: 2, name: 'teresa'},
{id: 3, name: 'roberto'},
{id: 2, name: 'roberto'}
];
//i sort by THEIR NAMES and THEN by their ids
const sortedObject = objsToSort.sort(byValues([
[(x) => x.name, byString()],
[(x) => x.id, byNumber()]
]));
console.log(sortedObject); //[{roberto, 2}, {roberto, 3}, {teresa, 2}];
//i sort by THEIR IDS and THEN by their names
const sortedObject2 = objsToSort.sort(byValues([
[(x) => x.id, byNumber()],
[(x) => x.name, byString()]
]));
console.log(sortedObject2); //[{roberto, 2}, {teresa, 2}, {roberto, 3}];
//i sort by THEIR IDS and THEN by their names DESCENDING
const sortedObject3 = objsToSort.sort(byValues([
[(x) => x.id, byNumber()],
[(x) => x.name, byString({desc: true})],
]));
console.log(sortedObject3); //[{teresa, 2}, {roberto, 2}, {roberto, 3}];
```
**typescript types check**
```typescript
//ts file
import {byValue, byNumber, byString} from 'sort-es'
const objsArray = [{numbProp: 2, stringProp: 'a'}, {numbProp: 3, stringProp: 'f'}];
//Incorrect sort property
const incorrectSortedArray = objsArray.sort(byValue(i => i.numbProp, byString()));
//ts check error : Type 'number' is not assignable to type 'string'.
//Correct sort type
const sortedArray = objsArray.sort(byValue(i => i.numbProp, byNumber()))
//ts check ok
```
## See full Docs
### [**sort-es.netlify.app**](https://sort-es.netlify.app)
# License
MIT © Cosimo chellini