Little bob

A simple human name and sentence generator in your language.

Make up names, nicknames, and find sample textual content for your applications, using the provided dictionaries.

The name is a tribute to the "Le petit Robert" Dictionaries.

What it does

Lorem Ipsum is sooooooo 2016.

With Little Bob, you can generate lots of FullNames (given name, surname, nickname, gender) and Fortune sayings and quotes, in the language of your choice.

Current supported languages: FRENCH, ENGLISH

Compatibility / Setup

The sources are compatible with JDK 6+.

To use the library with maven, add these lines to your pom.xml file:

<dependency>
 <groupId>io.resourcepool</groupId>
 <artifactId>little-bob</artifactId>
 <version>1.0</version>
</dependency>

API / Sample use

Fortune

For starters, initialize your generator (ideally as a class attribute):

FortuneGenerator generator = new SimpleFortuneGenerator();

Generate a fortune in any language:

Fortune f = generator.nextFortune();

Generate a fortune in a specific language:

Fortune f = generator.nextFortune(Language.FRENCH);

Generate a list of 100 fortunes in any language:

List<Fortune> f = generator.nextFortunes(100);

Generate a list of 100 fortunes in FRENCH

Query q = Query.builder()
               .count(100)
               .languages(Language.FRENCH)
               .build();
List<Fortune> f = generator.nextFortunes(q);

Example:

public class Main {
  
  public static void main(String[] args){
    FortuneGenerator generator = new SimpleFortuneGenerator();
    // Generate one fortune in any language
    Fortune f = generator.nextFortune();
    System.out.println("Fortune of the day:");
    System.out.println(f.text);    
    System.out.println("That fortune is from:");
    System.out.println(f.source);
    
    // Generate one fortune in French
    f = generator.nextFortune(Language.FRENCH);
    System.out.println("French Fortune of the day:");
    System.out.println(f.text);    
    System.out.println("That french fortune is from:");
    System.out.println(f.source);
    
    // Generate 100 fortunes in English or French
    List<Fortune> fortunes = generator.nextFortunes(
      Query.builder()
           .count(100)
           .languages(Language.ENGLISH, Language.FRENCH)
           .build()
    );
  }
}

Names

For starters, initialize your generator (ideally as a class attribute):

NameGenerator generator = new SimpleNameGenerator();

Generate a name in any language:

// Full name (given name, surname, nickname, gender)
FullName fn = generator.nextName();
// Given name (given name, nickname, gender)
GivenName gn = generator.nextGivenName();
// Nickname
String nick = generator.nextNickname();
// Surname
String surname = generator.nextSurname();

Generate a list of 100 names in any language:

List<FullName> fns = generator.nextNames(100);

Generate a list of 100 names in FRENCH

Query q = Query.builder()
               .count(100)
               .languages(Language.FRENCH)
               .build();
List<FullName> f = generator.nextNames(q);

Example:

public class Main {
  
  public static void main(String[] args){
    FortuneGenerator generator = new SimpleFortuneGenerator();
    // Generate one name in any language
    FullName fn = generator.nextName();
    System.out.println("The murderer has a name:");
    System.out.println(fn.givenName + " " + fn.surname);    
    System.out.println(Gender.MALE.equals(fn.gender) ? "He" : "She" + " goes by the alias:");
    System.out.println(fn.nickname);
    
    // Generate 100 names in English or French
    List<FullName> accomplices = generator.nextNames(
      Query.builder()
           .count(100)
           .languages(Language.ENGLISH, Language.FRENCH)
           .build()
    );
  }
}

License

This project is licensed under the Apache 2.0 License.

Contributions

We welcome any contributions via Issues and/or Pull-requests