faker-japanese-name 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 39d0a9f7ffef6efb3a268fb16285098f862cca2cbf970d4f8e01dc4ee6ea235e
+  data.tar.gz: 45f498a2df1a84a4de0f5a5ff4b97ea29d213efa2532911c3803a1900d410b6a
+SHA512:
+  metadata.gz: 66bf2d80d151bb1ade07f3f01d52dc2afa8c25c6b0aba77b04bce084a5e80207ffb312be637de18382c279b003f0501495ad5e6dbd78153ba1b3863ea9d4bd11
+  data.tar.gz: 6d15bc4d58235ffc71e559df583a18516f73c13a55702e0418c4eba88cbe01811a12f87a6527ad4231ab64005c833c4e1d9adbce15e166ec761247e4958cef57

data/.devcontainer/Dockerfile

@@ -0,0 +1,22 @@
+FROM mcr.microsoft.com/devcontainers/base:1-bookworm
+
+RUN apt-get update && \
+    export DEBIAN_FRONTEND=noninteractive && \
+    apt-get -y install --no-install-recommends \
+    fish \
+    build-essential autoconf libssl-dev libyaml-dev zlib1g-dev libffi-dev libgmp-dev rustc && \
+    rm -rf /var/lib/apt/lists/* /var/cache/apt/archives/*
+
+# Install asdf
+RUN curl -L 'https://github.com/asdf-vm/asdf/releases/download/v0.18.0/asdf-v0.18.0-linux-amd64.tar.gz' | tar -xz -C /usr/local/bin && \
+    mkdir -p /home/vscode/.config/fish/conf.d && \
+    curl -L 'https://raw.githubusercontent.com/asdf-vm/asdf/refs/tags/v0.18.0/asdf.fish' > /home/vscode/.config/fish/conf.d/asdf.fish && \
+    chown -R vscode:vscode /home/vscode/.config
+
+# Install asdf plugins and specified runtimes
+USER vscode
+WORKDIR /home/vscode
+COPY --chown=vscode:vscode .tool-versions /home/vscode/.tool-versions
+RUN asdf plugin add ruby && \
+    asdf install && \
+    asdf reshim

data/.devcontainer/compose.yaml

@@ -0,0 +1,18 @@
+name: "faker-japanese-name"
+
+services:
+  faker-japanese-name:
+    build:
+      context: ..
+      dockerfile: .devcontainer/Dockerfile
+
+    volumes:
+    - ../..:/workspaces:cached
+    - ./fish/conf.d/abbrs.fish:/home/vscode/.config/fish/conf.d/abbrs.fish
+    - ./fish/functions/git.fish:/home/vscode/.config/fish/conf.d/git.fish
+
+    # Overrides default command so things don't shut down after the process ends.
+    command: sleep infinity
+
+    # Uncomment the next line to use a non-root user for all processes.
+    user: vscode

data/.devcontainer/devcontainer.json

@@ -0,0 +1,37 @@
+// For format details, see https://containers.dev/implementors/json_reference/.
+// For config options, see the README at: https://github.com/devcontainers/templates/tree/main/src/ruby
+{
+  "name": "faker-japanese-name",
+  "dockerComposeFile": "compose.yaml",
+  "service": "faker-japanese-name",
+  "workspaceFolder": "/workspaces/${localWorkspaceFolderBasename}",
+
+  // Features to add to the dev container. More info: https://containers.dev/features.
+  "features": {
+    "ghcr.io/devcontainers/features/github-cli:1": {}
+  },
+
+  "containerEnv": {},
+
+  // Use 'forwardPorts' to make a list of ports inside the container available locally.
+  "forwardPorts": [],
+
+  // Configure tool-specific properties.
+  "customizations": {
+    "vscode": {
+      "settings": {
+        "terminal.integrated.defaultProfile.linux": "fish"
+      },
+      "extensions": [
+        "EditorConfig.EditorConfig",
+        "Shopify.ruby-lsp",
+      ]
+    }
+  },
+
+  // Uncomment to connect as root instead. More info: https://containers.dev/implementors/json_reference/#remoteUser.
+  // "remoteUser": "root",
+
+  // Use 'postCreateCommand' to run commands after the container is created.
+  "postCreateCommand": "./.devcontainer/post_create.fish"
+}

data/.devcontainer/fish/conf.d/abbrs.fish

@@ -0,0 +1,3 @@
+if type -q git
+  abbr -a g git
+end

data/.devcontainer/fish/functions/git.fish

@@ -0,0 +1,12 @@
+if type -q git
+  function git
+    if test (count $argv) -eq 0
+      git status
+    else if test $argv[1] = "up"
+      git rev-parse --is-inside-work-tree > /dev/null 2>&1 && \
+        cd (pwd)/(git rev-parse --show-cdup)
+    else
+      command git $argv
+    end
+  end
+end

data/.devcontainer/post_create.fish

@@ -0,0 +1 @@
+#!/bin/fish

data/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.{md,markdown}]
+trim_trailing_whitespace = false

data/.standard.yml

@@ -0,0 +1,2 @@
+# For available configuration options, see:
+#   https://github.com/standardrb/standard

data/.tool-versions

@@ -0,0 +1 @@
+ruby 3.1.6

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Shuhei YOSHIDA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,102 @@
+# Faker::JapaneseName
+
+A Faker gem that provides Japanese family names and gender-specific given names, along with their kana (reading).
+
+## Features
+- Random generation of Japanese family and given names (male/female)
+- All names include kana (reading) information
+- Data sourced from Wikidata (CC0-1.0 license)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'faker-japanese-name'
+```
+
+And then execute:
+
+```sh
+bundle install
+```
+
+Or install it yourself as:
+
+```sh
+gem install faker-japanese-name
+```
+
+## Usage
+
+First, require the gem:
+
+```ruby
+require 'faker-japanese-name'
+```
+
+### Generate a Full Name
+
+```ruby
+name = Faker::JapaneseName.name
+puts name[:name]  #=> "佐藤 太郎"
+puts name[:kana]  #=> "さとう たろう"
+```
+
+### Generate Male or Female Full Name
+
+```ruby
+male_name = Faker::JapaneseName.male_name
+puts male_name[:name]  #=> "佐藤 太郎"
+puts male_name[:kana]  #=> "さとう たろう"
+
+female_name = Faker::JapaneseName.female_name
+puts female_name[:name]  #=> "佐藤 花子"
+puts female_name[:kana]  #=> "さとう はなこ"
+```
+
+### Generate Family Name Only
+
+```ruby
+family = Faker::JapaneseName.family_name
+puts family[:name]  #=> "佐藤"
+puts family[:kana]  #=> "さとう"
+```
+
+### Generate Given Name Only
+
+```ruby
+given = Faker::JapaneseName.given_name
+puts given[:name]  #=> "太郎"
+puts given[:kana]  #=> "たろう"
+```
+
+### Generate Male or Female Given Name
+
+```ruby
+male = Faker::JapaneseName.male_given_name
+puts male[:name]  #=> "太郎"
+puts male[:kana]  #=> "たろう"
+
+female = Faker::JapaneseName.female_given_name
+puts female[:name]  #=> "花子"
+puts female[:kana]  #=> "はなこ"
+```
+
+### About the Return Value
+
+Each method returns a hash with `:name` and `:kana` keys, containing the Japanese name and its reading in kana.
+
+## Data
+
+- Data source: Wikidata (CC0-1.0)
+- Data files: Data files in the `data/` directory
+
+## License
+
+- Code: MIT License
+- Name data: Wikidata, CC0-1.0 License
+
+## Acknowledgements
+
+This gem was created with reference to [tily/ruby-faker-japanese](https://github.com/tily/ruby-faker-japanese). Many thanks to the original author for inspiration.

data/Rakefile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+require "standard/rake"
+
+task default: %i[test standard]