README.md
# Python-Random-Name-Generator
[](https://codeclimate.com/github/navchandar/Python-Random-Name-Generator) [](https://github.com/navchandar/Python-Random-Name-Generator/blob/master/LICENSE)
[](https://github.com/navchandar/Python-Random-Name-Generator/issues)
[](https://www.python.org/)
- Outputs RANDOM People names, US state, counties and addresses, Countries and Company names.
- Useful for testing Name/Address fields with random data.
### Installation
- No dependencies required. Just pure Python v3+
- Simply [download](https://github.com/navchandar/Python-Random-Name-Generator/releases/latest) the repo to your project folder or
```bash
git clone https://github.com/navchandar/Python-Random-Name-Generator.git
```
- And start using for your development/testing purposes.
- Please add your ideas/suggestions or more test data [here](https://github.com/navchandar/Python-Random-Name-Generator/issues).
### Usage
```py
import random_names
random_names.First() # outputs random first name
random_names.Middle() # outputs random middle name
random_names.Last() # outputs random last name
random_names.Full() # outputs random first and last name
random_names.Company() # outputs random company name
random_names.Address() # outputs random Address
random_names.StateCode() # outputs random US State Code
random_names.States() # outputs random US State name
random_names.Country() # outputs random Country name
random_names.Places() # outputs random Place name
```
### Donate
[](https://paypal.me/navchandar/)
[](https://ko-fi.com/navchandar/)
[](https://www.buymeacoffee.com/navchandar/)