dtoro
d4d99a7473
Problem: the hexagonal refactor churns the backend tree for nine more phases; the UI delivery stack (web/ SPA, cmd/desktop Wails wrapper, compose/web image) must move to its own repo first so doc/layout rewrites land once on a backend-only tree. Change: - New repo git.hubris.network/dtoro/oikos-web (v0.33.0): web/, desktop/ (updateURL repointed to oikos-web releases), compose/, own CI (web + desktop jobs), own deploy script (CI-green gate, TOCTOU guard, version-tagged images, prune-to-3), own webhook receiver on :9798 + launchd unit, own compose project publishing the same 8091:80. - Cutover executed on mac-mini in order: oikos stack's web service stopped+removed, oikos-web project brought up on 8091; outer Caddy untouched (targets the published port) — serving + Authentik flow + /wails 404 quirk verified post-cutover. - Stripped from oikos: web/, cmd/desktop/, compose/web/, desktop CI workflow, ci.yml web job, Makefile ui/desktop/desktop-package/install targets, the compose web service, oikos-web from deploy.sh's fallback prune list; wails + go-keyring dropped from go.mod, vendor synced. - README / CONTRIBUTING / AGENTS.md / .agents dev+operations docs now point at the new repo; mbse + mascot design docs carry a path note. Risk: production SPA serving depends on the new pipeline now; rollback is versioned-image re-up of the old web service from a pre-split checkout (port 8091). Desktop builds installed before the split still check dtoro/oikos releases — one manual reinstall, noted in the oikos-web release notes. Verification: go vet, make test (race), make generate-check, golangci (no new findings; baseline down 400→365); post-cutover curls — localhost:8091 200, /wails/runtime.js 404, outer Caddy 302 Authentik.
126 lines
3.3 KiB
Markdown
126 lines
3.3 KiB
Markdown
|
||
[Build]: http://img.shields.io/travis/litejs/natural-compare-lite.png
|
||
[Coverage]: http://img.shields.io/coveralls/litejs/natural-compare-lite.png
|
||
[1]: https://travis-ci.org/litejs/natural-compare-lite
|
||
[2]: https://coveralls.io/r/litejs/natural-compare-lite
|
||
[npm package]: https://npmjs.org/package/natural-compare-lite
|
||
[GitHub repo]: https://github.com/litejs/natural-compare-lite
|
||
|
||
|
||
|
||
@version 1.4.0
|
||
@date 2015-10-26
|
||
@stability 3 - Stable
|
||
|
||
|
||
Natural Compare – [![Build][]][1] [![Coverage][]][2]
|
||
===============
|
||
|
||
Compare strings containing a mix of letters and numbers
|
||
in the way a human being would in sort order.
|
||
This is described as a "natural ordering".
|
||
|
||
```text
|
||
Standard sorting: Natural order sorting:
|
||
img1.png img1.png
|
||
img10.png img2.png
|
||
img12.png img10.png
|
||
img2.png img12.png
|
||
```
|
||
|
||
String.naturalCompare returns a number indicating
|
||
whether a reference string comes before or after or is the same
|
||
as the given string in sort order.
|
||
Use it with builtin sort() function.
|
||
|
||
|
||
|
||
### Installation
|
||
|
||
- In browser
|
||
|
||
```html
|
||
<script src=min.natural-compare.js></script>
|
||
```
|
||
|
||
- In node.js: `npm install natural-compare-lite`
|
||
|
||
```javascript
|
||
require("natural-compare-lite")
|
||
```
|
||
|
||
### Usage
|
||
|
||
```javascript
|
||
// Simple case sensitive example
|
||
var a = ["z1.doc", "z10.doc", "z17.doc", "z2.doc", "z23.doc", "z3.doc"];
|
||
a.sort(String.naturalCompare);
|
||
// ["z1.doc", "z2.doc", "z3.doc", "z10.doc", "z17.doc", "z23.doc"]
|
||
|
||
// Use wrapper function for case insensitivity
|
||
a.sort(function(a, b){
|
||
return String.naturalCompare(a.toLowerCase(), b.toLowerCase());
|
||
})
|
||
|
||
// In most cases we want to sort an array of objects
|
||
var a = [ {"street":"350 5th Ave", "room":"A-1021"}
|
||
, {"street":"350 5th Ave", "room":"A-21046-b"} ];
|
||
|
||
// sort by street, then by room
|
||
a.sort(function(a, b){
|
||
return String.naturalCompare(a.street, b.street) || String.naturalCompare(a.room, b.room);
|
||
})
|
||
|
||
// When text transformation is needed (eg toLowerCase()),
|
||
// it is best for performance to keep
|
||
// transformed key in that object.
|
||
// There are no need to do text transformation
|
||
// on each comparision when sorting.
|
||
var a = [ {"make":"Audi", "model":"A6"}
|
||
, {"make":"Kia", "model":"Rio"} ];
|
||
|
||
// sort by make, then by model
|
||
a.map(function(car){
|
||
car.sort_key = (car.make + " " + car.model).toLowerCase();
|
||
})
|
||
a.sort(function(a, b){
|
||
return String.naturalCompare(a.sort_key, b.sort_key);
|
||
})
|
||
```
|
||
|
||
- Works well with dates in ISO format eg "Rev 2012-07-26.doc".
|
||
|
||
|
||
### Custom alphabet
|
||
|
||
It is possible to configure a custom alphabet
|
||
to achieve a desired order.
|
||
|
||
```javascript
|
||
// Estonian alphabet
|
||
String.alphabet = "ABDEFGHIJKLMNOPRSŠZŽTUVÕÄÖÜXYabdefghijklmnoprsšzžtuvõäöüxy"
|
||
["t", "z", "x", "õ"].sort(String.naturalCompare)
|
||
// ["z", "t", "õ", "x"]
|
||
|
||
// Russian alphabet
|
||
String.alphabet = "АБВГДЕЁЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯабвгдеёжзийклмнопрстуфхцчшщъыьэюя"
|
||
["Ё", "А", "Б"].sort(String.naturalCompare)
|
||
// ["А", "Б", "Ё"]
|
||
```
|
||
|
||
|
||
External links
|
||
--------------
|
||
|
||
- [GitHub repo][https://github.com/litejs/natural-compare-lite]
|
||
- [jsperf test](http://jsperf.com/natural-sort-2/12)
|
||
|
||
|
||
Licence
|
||
-------
|
||
|
||
Copyright (c) 2012-2015 Lauri Rooden <lauri@rooden.ee>
|
||
[The MIT License](http://lauri.rooden.ee/mit-license.txt)
|
||
|
||
|