getname Library

0.1.1 · active · verified Fri Apr 17

The `getname` library, currently at version 0.1.1, provides simple functions to retrieve popular names for categories such as cats, dogs, superheroes, and supervillains. It is designed for straightforward use cases requiring quick access to lists of themed names. The library has an infrequent release cadence, with the last update in January 2023.

Common errors

```
AttributeError: module 'getname' has no attribute 'get_cat_name'
```
cause Attempting to call functions with an incorrect naming convention. The library uses direct category names as function names (e.g., `cat`, `dog`) rather than common 'get_' prefixes.

fix Use the exact function names provided by the library: `getname.cat()`, `getname.dog()`, `getname.superhero()`, `getname.supervillain()`.
```
TypeError: getname.cat() takes 0 positional arguments but 1 was given
```
cause Attempting to pass arguments to functions like `getname.cat()`, perhaps expecting to specify count or filters. The functions in `getname` do not accept any arguments.

fix Call the functions without any arguments: `getname.cat()`. To get multiple names, call the function multiple times in a loop or list comprehension.

Warnings

gotcha Functions like `getname.cat()` return a single random name (a string), not a list of names. If you need multiple names, you must call the function multiple times.
Fix: To get multiple names, iterate and call the function repeatedly: `[getname.cat() for _ in range(3)]`
gotcha The library's name datasets are static and embedded within the package version. They do not update dynamically from an external source. New names are only added with a new library release.
Fix: If you require updated or more extensive name lists, consider contributing to the project or using a different library that offers dynamic data sourcing.
gotcha There are no configuration options or arguments to control the number of names returned, specific attributes of names (e.g., gender, origin), or to filter the lists. Each function simply returns one random name from its internal list.
Fix: The library is designed for simplicity. For advanced name generation or filtering, you would need to implement custom logic around the returned names or choose a more feature-rich library.

Install

pip install getname Install stable version

Imports

getname
```
import getname
```

Quickstart

This quickstart demonstrates how to import the `getname` library and call its main functions to retrieve a single random name from each category.

import getname

print("Random Cat Name:", getname.cat())
print("Random Dog Name:", getname.dog())
print("Random Superhero Name:", getname.superhero())
print("Random Supervillain Name:", getname.supervillain())

view raw JSON →