Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ozdemirburak/full-name-generator
Generate random names using data from popular names and surnames of various countries.
https://github.com/ozdemirburak/full-name-generator
hacktoberfest name random-name random-name-generator random-name-generators
Last synced: 11 days ago
JSON representation
Generate random names using data from popular names and surnames of various countries.
- Host: GitHub
- URL: https://github.com/ozdemirburak/full-name-generator
- Owner: ozdemirburak
- License: mit
- Created: 2023-10-11T12:24:35.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-02-01T21:25:43.000Z (9 months ago)
- Last Synced: 2024-08-18T12:05:58.157Z (3 months ago)
- Topics: hacktoberfest, name, random-name, random-name-generator, random-name-generators
- Language: TypeScript
- Homepage: https://fullnamegenerator.com
- Size: 229 KB
- Stars: 22
- Watchers: 2
- Forks: 15
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# [Full Name Generator](https://fullnamegenerator.com) - Generate Random Names
[![npm-version]][npm] [![npm-downloads]][npm]
Generate random names effortlessly using various data sources of popular first names and surnames
from multiple countries.
If you find this package helpful, please consider ⭐ starring it on [GitHub](https://github.com/ozdemirburak/full-name-generator).
## Installation
```bash
$ npm install full-name-generator --save
```
## Usage
````js
import { firstName, lastName, fullName } from 'full-name-generator';
// Generate Full Names
const maleFullName = fullName('US', 0);
const femaleFullName = fullName('US', 1);
// Generate First Names
const maleFirstName = firstName('US', 0);
const femaleFirstName = firstName('US', 1);
// Generate Surnames
const turkishSurname = lastName('TR');
const czechFemaleSurname = lastName('CZ', 1);
// Generate Multiple Names
const twoAmericanMaleFirstNames = firstName('US', 0, 2);
const twoAmericanLastNames = lastName('US', null, 2);
const twoAmericanNamesThreeSurnamesFemaleFullName = fullName('US', 1, 2, 3);
````
## Countries
- 🇦🇷 Argentina (AR)
- 🇦🇹 Austria (AT)
- 🇧🇪 Belgium (BE)
- 🇧🇷 Brazil (BR)
- 🇨🇳 China (CN)
- 🇨🇿 Czechia (CZ)
- 🇩🇰 Denmark (DK)
- 🇫🇮 Finland (FI)
- 🇫🇷 France (FR)
- 🇩🇪 Germany (DE)
- 🇬🇷 Greece (GR)
- 🇮🇳 India (IN)
- 🇮🇩 Indonesia (ID)
- 🇮🇱 Israel (IL)
- 🇮🇹 Italy (IT)
- 🇯🇵 Japan (JP)
- 🇲🇽 Mexico (MX)
- 🇳🇱 Netherlands (NL)
- 🇳🇴 Norway (NO)
- 🇵🇱 Poland (PL)
- 🇵🇹 Portugal (PT)
- 🇷🇺 Russia (RU)
- 🇸🇦 Saudi Arabia (SA)
- 🇰🇷 South Korea (KR)
- 🇪🇸 Spain (ES)
- 🇸🇪 Sweden (SE)
- 🇹🇼 Taiwan (TW)
- 🇹🇭 Thailand (TH)
- 🇹🇷 Türkiye (TR)
- 🇬🇧 United Kingdom (GB)
- 🇺🇸 United States (US)
- 🇻🇳 Vietnam (VN)
## Functions
### fullName
Generates a full name based on the provided parameters.
```js
fullName(isoCode: string, gender: Gender, firstN: number = 1, lastN: number = 1, space: string = ' '): string
```
- **isoCode**: The ISO code for the country (e.g., BR, CZ, US).
- **gender**: Gender category for the name. (0 - Male, 1 - Female).
- **firstN**: Number of first names to be generated (default is 1).
- **lastN**: Number of surnames to be generated (default is 1).
- **space**: Separator between the first names and surnames (default is a single whitespace).
### firstName
Generates one or more first names based on the provided country code and gender.
```js
firstName(isoCode: string, gender: Gender, n: number = 1): string
```
- **isoCode**: The ISO code for the country (e.g., BR, CZ, US).
- **gender**: Gender category for the name. (0 - Male, 1 - Female).
- **n**: Number of first names to generate (default is 1).
### lastName
Generates one or more surnames. For some countries like the Czech Republic or Poland, gender is considered.
```js
lastName(isoCode: string, gender?: Gender, n: number = 1): string
```
- **isoCode**: The ISO code for the country (e.g., BR, CZ, US).
- **gender**: (Optional) Gender category for the surname. Required for countries like the Czech Republic. (0 - Male, 1 - Female).
- **n**: Number of surnames to generate (default is 1).
## License
The MIT License (MIT). Please see [License File](LICENSE) for more information.
[npm-version]: https://img.shields.io/npm/v/full-name-generator.svg?style=flat-square
[npm-downloads]: https://img.shields.io/npm/dm/full-name-generator.svg?style=flat-square
[npm]: https://www.npmjs.com/package/full-name-generator
To reference this project, use the code snippet below:
```html
Full Name Generator
```