Skip to content

ragellistiyono/random-name-generator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎲 Random Name Generator 🎲

Go Version License Code Size

A powerful and customizable random name generator built in Go


🚀 Features

  • 🎯 Generate random names with custom length
  • 📁 Save results with custom file names
  • ⚡ Fast and efficient name generation
  • 🔒 Unique name validation
  • 📊 Progress tracking and summary statistics
  • 🛡️ Input validation and error handling

📦 Installation

  1. Prerequisites

    • Go 1.20 or higher
    • Randommer.io API key
  2. Clone the repository

    git clone https://github.com/yourusername/random-name-generator.git
    cd random-name-generator
  3. Set up environment

    cp .env.example .env
    # Add your Randommer.io API key to .env
  4. Initialize Go modules

    go mod init random-name-generator
    go mod tidy
  5. Run the application

    go run main.go

🛠️ Usage

Basic Usage

$ go run main.go
Enter number of names to generate (1-1000): 10
Enter desired name length (5-50 characters): 15
Enter output file name (without extension, or press Enter for default): my_names

Progress: 10/10 (100.0%)

Summary:
Total execution time: 1.23s
Number of valid names generated: 10
Names saved to: my_names.txt

🧰 Technology Stack

Component Technology
Language Go
API Integration Randommer.io
Configuration .env files
File Handling Standard Library
Input Validation Regex

🐛 Issues

If you would like to request new features or report problems when running this script, please open an issue in our repository. Include detailed information about your feature request or the problem you're encountering, including:

  • Expected behavior
  • Actual behavior
  • Steps to reproduce
  • Relevant error messages or screenshots
  • Your environment details (OS, version, etc.)

🙏 Attribution

This tool utilizes the randommer.io API for its functionality. We are grateful for their service and the valuable resources they provide to the developer community.


⚖️ Compliance

This tool strictly adheres to randommer.io's Terms of Service and Usage Guidelines. Users must comply with these terms when using this tool.


⚠️ Disclaimer

  • This tool must not be used to harm others or for any malicious purposes
  • The author (ragellistiyono) is not responsible for any misuse of this script
  • Users are solely responsible for their actions when using this tool
  • This tool is provided "as-is" without any warranties

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.


Made with ❤️ by [Ragel Listiyono]

About

Random name genetaor using randommer.io API

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages