Library to obtain names of Spanish men and women as well as surnames
Project description
Random Spanish Information
What is that?
This library is my first library created for Python (so sorry if there are any bugs). With this library you will be able to obtain both names (for men and women) and Spanish surnames
How can I install it?
Just install with: pip install random-spanish
or pip3 install random-spanish
How can I use it?
You've got two ways:
Download the CSVs locally (Recommended)
I recommend you download and import the csv file locally, otherwise the library will load the CSV from my online hosting, which can slow down the speed of your program. Just download the CSV here:
Then, import files to your project and pass it in the third parameter of each function (files' parameter)
mens_csv = "./path/to/your/mans.csv"
surnames_csv = "./path/to/your/surnames.csv"
print(getRandomMaleName(2, True, ["men.csv", "apellidos.csv"])) # Return an array with two full names
Use it without download CSV (Unrecommended)
If you prefer, you can ignore the third parameter and then the library will load the CSV from my online hosting and then continue working.
print(getRandomMaleName(2, True)) # Return an array with two full names
Documentation
In this library you've got three functions
Get random male name
getRandomMaleName
expects three optional parameters:
- First one expects a integer with the number of the names you need. Default is 1
- If you pass 1, function will return a string. Otherwise, It'll return an array of strings
- Second one expects a boolean to return a full name or not. Default is False
- If you pass True, function will return a full name with name and surname. Otherwise It'll return just the name
- Third one expects a array string with the path to the CSV. Default is my website host.
- See the Download the CSVs locally (Recommended) point for more info
Get random female name
getRandomFemaleName
expects three optional parameters:
- First one expects a integer with the number of the names you need. Default is 1
- If you pass 1, function will return a string. Otherwise, It'll return an array of strings
- Second one expects a boolean to return a full name or not. Default is False
- If you pass True, function will return a full name with name and surname. Otherwise It'll return just the name
- Third one expects a array string with the path to the CSV. Default is my website host.
- See the Download the CSVs locally (Recommended) point for more info
Get random surname
getRandomSurname
expects three optional parameters:
- First one expects a integer with the number of the surnames you need. Default is 1
- If you pass 1, function will return a string. Otherwise, It'll return an array of strings
- Second one expects a boolean to return a pair of surnames or not. Default is False
- If you pass True, function will return a pairs of surnames as in Spain everybody got two surnames. Otherwise It'll return just one surname
- Third one expects a array string with the path to the CSV. Default is my website host.
- See the Download the CSVs locally (Recommended) point for more info
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for random_spanish-1.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a4b18175c3e30d44ed97416759996369d673a56b3734b34e60feee86efbe274c |
|
MD5 | 192a4a4b163628024321b08c0fe6b031 |
|
BLAKE2b-256 | bbe877252712a9d2d93b2c8a8753152374dde5e99e1abe4e01d2b23d2d94f5b9 |