Metadata-Version: 2.1
Name: rname
Version: 0.2.0
Summary: Draw random first and last USA names
Home-page: https://github.com/ajwalkiewicz/randnames
Author: Adam Walkiewicz
License: MIT
Project-URL: Documentation, https://ajwalkiewicz.github.io/randnames/_build/html/index.html
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Description-Content-Type: text/markdown

# randnames
Python module to draw random names.

# Summary

to be done

# Installation

Randnames is availabe in python repository, and can be downloaded with pip.

```
pip3 install randnames
```

# Simple Usage

For more visit project [website](https://github.com/ajwalkiewicz/randnames) or 
[documentation](https://ajwalkiewicz.github.io/randnames/_build/html/index.html#)

```
>>> import randnames

# Get first name
>>> randnames.first_name()
'John'

# Get last name
>>> randnames.last_name()
'Doe'

# Get full name
>>>randnames.full_name()
'John Doe'
```

# Documentation

Detailed documentation of module can by found here:
[randnames documentation](https://ajwalkiewicz.github.io/randnames/_build/html/index.html#)

# Database

So far project uses databases from www.census.gov and www.ssa.gov.

### Last names

Databases for USA last names: 

https://www.census.gov/topics/population/genealogy/data/1990_census.html
https://www.census.gov/topics/population/genealogy/data/2000_surnames.html
https://www.census.gov/topics/population/genealogy/data/2010_surnames.html

### first names

Database for USA first names:

https://www.ssa.gov/oact/babynames/limits.html

### license
https://www.census.gov/data/software/x13as/disclaimer.html

# License

Randnames is licensed under the terms of the [MIT license](LICENSE)

