scottish_names

Crates.ioscottish_names
lib.rsscottish_names
version0.2.2
sourcesrc
created_at2019-04-17 09:33:25.55249
updated_at2019-10-13 20:46:09.168629
descriptionLibrary for generating random names of people based on frequency of occurrence of birth-names in Scotland
homepage
repositoryhttps://github.com/sroebuck/scottish_names
max_upload_size
id128522
size4,736,974
Stuart Roebuck (sroebuck)

documentation

README

Random Scottish Names

This simple Rust library takes lists of birth names in Scotland in 2018 and lists of surnames founds in births, deaths and marriages in 2018 and combines them to form randomised names.

The first names and surnames are individually reproduced randomly but weighted to reflect the frequency of occurrence of the names. So a common female firstname like ‘Sophie’ will be output more frequently than ‘Aubree’.

The surnames are converted from a capitalised source-list so there may be issues with capitalisation - please raise an issue if you spot one.

Finally, for clarity, this code does not generate names that are traditionally Scottish: it reflects the multicultural names being given in Scotland. By using first names given at birth in 2018, the frequency of first names will be biased towards recently popular names rather than reflecting the names across generations that are found in the population.


The original names lists came from:

Release notes

Version 0.1.0

First release

Version 0.1.1

Fix to API documentation.

Version 0.2.0

Breaking change with surnames now in mixed case rather than capitalised.

Version 0.2.1

Added link to this README.md in Cargo.toml so that it would appear in crates.io.

Version 0.2.2

Updated dependencies to more recent versions to address security issue with criterion.

Commit count: 7

cargo fmt