name_tamer 0.6.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: f4cec196a889452445f937bcebe32026091d7e39
-  data.tar.gz: 458fb4f8fad553bb4633302ad640772a0182b2f3
+SHA256:
+  metadata.gz: 8a398c8020be8c46d8a50bd42ed442d567a0a4eeb281fd1d88854b5ff8e5e505
+  data.tar.gz: dc8bd4b94fd402e2753303aa0753a148ae8ec2b4d16c0e0d8c622570b8f015e0
 SHA512:
-  metadata.gz: 15cf43c55b31ca59761a17c1779d0fa556f16e0e52c2c7fcefebd531883a12bf5395b63aa0f551a9c0a50392942f75d463a0ef694c7220457e03d6fc2e90b5ab
-  data.tar.gz: afe13378d864b4e7c06eccf6aae5969f5626d2d629987b218f33a4db0f0f781df5be047980c5fff49994ca40da9fb220dc9ccee729b8c24d5c79d541071ad6d3
+  metadata.gz: 27a6f4233d5e71791a18aa063c9b7b32509f7bd9d00beded4e1d99a08a29c2a52e94507d627db812bc298620cd22d11e8198546a856d78f6aabcfda4dd04452d
+  data.tar.gz: f420d7a4dfc7dd97f773c745d57cb0a73be6864c754838197ba440c0b2790f118314b9e2de4cd3e4b146bf9578de913e8f7ee6ad86705cd80db76aedc813535d

data/CHANGELOG.md

@@ -0,0 +1,41 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-07-18
+
+### Changed
+
+- **Breaking:** Ruby 3.3 or newer is required; Ruby 2.7–3.2 are no longer
+  supported.
+- **Breaking:** `name_tamer` no longer defines methods on core classes. The
+  `String` helpers (`whitespace_to!`, `approximate_latin_chars!` and friends)
+  are now pure functions on `NameTamer::Strings`, and `Array#neighbours` has
+  become an internal helper of `NameTamer::Text`. The public API —
+  `NameTamer[]`, `NameTamer::Name`, `NameTamer.parameterize` — is unchanged.
+- **Breaking:** the terminal-colour `String` methods (`"text".yellow` etc.)
+  have been removed; they were unrelated to name taming.
+
+### Fixed
+
+- Multi-word prefixes and suffixes (for example `Chartered F.C.S.I.`,
+  `Private Limited`) are stripped correctly again, restoring the behaviour
+  of the released 0.6.1 gem after a regression when the adfix lists moved
+  into data files.
+- The test suite runs on Ruby 3.4+ again (`yaml` is now required explicitly
+  and fixtures load under Psych 4's safe defaults).
+
+### Added
+
+- Continuous integration on GitHub Actions: RuboCop plus RSpec on Ruby 3.3,
+  3.4 and 4.0, with 100% line and branch coverage enforced.
+- SonarQube Cloud analysis with imported coverage and RuboCop reports.
+- Releases are published to RubyGems via trusted publishing (OIDC) from a
+  gated GitHub Actions environment.
+
+## [0.6.1] and earlier
+
+See the [commit history](https://github.com/dominicsayers/name_tamer/commits/main).

data/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2017 Dominic Sayers
+Copyright (c) 2017-2026 Dominic Sayers
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,28 +1,31 @@
-## NameTamer
+# NameTamer
 
 [![Gem version](https://badge.fury.io/rb/name_tamer.svg)](https://rubygems.org/gems/name_tamer)
 [![Gem downloads](https://img.shields.io/gem/dt/name_tamer.svg)](https://rubygems.org/gems/name_tamer)
-[![Build Status](https://travis-ci.org/dominicsayers/name_tamer.svg?branch=master)](https://travis-ci.org/dominicsayers/name_tamer)
-[![Code Climate](https://codeclimate.com/github/dominicsayers/name_tamer/badges/gpa.svg)](https://codeclimate.com/github/dominicsayers/name_tamer)
-[![Test Coverage](https://codeclimate.com/github/dominicsayers/name_tamer/badges/coverage.svg)](https://codeclimate.com/github/dominicsayers/name_tamer/coverage)
-[![Dependency Status](https://gemnasium.com/badges/github.com/dominicsayers/name_tamer.svg)](https://gemnasium.com/github.com/dominicsayers/name_tamer)
-[![Security](https://hakiri.io/github/dominicsayers/name_tamer/master.svg)](https://hakiri.io/github/dominicsayers/name_tamer/master)
+[![Test](https://github.com/dominicsayers/name_tamer/actions/workflows/test.yml/badge.svg)](https://github.com/dominicsayers/name_tamer/actions/workflows/test.yml)
+[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=dominicsayers_name_tamer&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=dominicsayers_name_tamer)
 
 NameTamer: making sense of names
 
 ## Installation
 
-Add this line to your application's Gemfile:
+Add the gem to your application:
 
-    gem 'name_tamer'
+```console
+bundle add name_tamer
+```
 
-And then execute:
+Or install it yourself:
 
-    $ bundle
+```console
+gem install name_tamer
+```
 
-Or install it yourself as:
+## Supported Ruby versions
 
-    $ gem install name_tamer
+`name_tamer` supports the Ruby versions in [normal or security maintenance
+upstream](https://www.ruby-lang.org/en/downloads/branches/) — currently
+Ruby 3.3, 3.4 and 4.0. The test suite runs against all of them.
 
 ## Usage
 
@@ -42,41 +45,64 @@ name_tamer.nice_name # => John Q. Smith
 name_tamer.contact_type # => :person
 ```
 
-NameTamer will make an intelligent guess at the type of the name but it's not infallible. NameTamer likes it if you tell it whether the name is a person or an organization:
+NameTamer will make an intelligent guess at the type of the name but it's
+not infallible. NameTamer likes it if you tell it whether the name is a
+person or an organization:
 
 ```ruby
-name_tamer = NameTamer::Name.new 'Di Doo Doo d.o.o.', contact_type: :organization
-name_tamer.simple_name # => Di Doo Doo
+name_tamer = NameTamer::Name.new 'Acme Group Private Limited', contact_type: :organization
+name_tamer.simple_name # => Acme Group
 ```
 
+## Upgrading from 0.x
+
+Version 1.0.0 makes three breaking changes:
+
+- Ruby 3.3 or newer is required.
+- The gem no longer defines methods on `String` or `Array`. The helpers are
+  pure functions on `NameTamer::Strings` (e.g.
+  `NameTamer::Strings.approximate_latin_chars('Reñé')`), and each returns a
+  new string instead of mutating the receiver.
+- The terminal-colour `String` methods (`'text'.yellow` and friends) are
+  gone; use a dedicated gem such as `rainbow` if you need them.
+
+The documented API — `NameTamer[]`, `NameTamer::Name`,
+`NameTamer.parameterize` — is unchanged.
+
 ## Contributing
 
-There must be lots of name suffixes and prefixes that I haven't catered for, so please get in touch if `name_tamer` doesn't recognise one that you've found.
+There must be lots of name suffixes and prefixes that I haven't catered
+for, so please get in touch if `name_tamer` doesn't recognise one that
+you've found.
 
-If there are any other common two-word family names that I've missed then please let me know. `name_tamer` tries to make sure Helena Bonham Carter gets slugified to `helena-bonham-carter` and not `helena-carter`, but I'm sure there are loads of two-word family names I don't know about.
+If there are any other common two-word family names that I've missed then
+please let me know. `name_tamer` tries to make sure Helena Bonham Carter
+gets slugified to `helena-bonham-carter` and not `helena-carter`, but I'm
+sure there are loads of two-word family names I don't know about.
 
 Please read all the following articles before contributing:
 
-* [Personal names around the world](https://www.w3.org/International/questions/qa-personal-names)
-* [Falsehoods Programmers Believe About Names](https://www.kalzumeus.com/2010/06/17/falsehoods-programmers-believe-about-names/)
-* [Last Name First](http://www.solidether.net/article/last-name-first/)
-* [Namae (名前)](https://github.com/berkmancenter/namae)
-* [Matts Name Parser](https://github.com/mericson/people)
-* [Types of business entity](http://en.wikipedia.org/wiki/Types_of_business_entity)
-* [List of professional designations in the United States](http://en.wikipedia.org/wiki/List_of_post-nominal_letters_(USA))
-* [List of post-nominal letters (United Kingdom)](http://en.wikipedia.org/wiki/List_of_post-nominal_letters_(United_Kingdom))
-* [Nobiliary particle](http://en.wikipedia.org/wiki/Nobiliary_particle)
-* [Spanish naming customs](http://en.wikipedia.org/wiki/Spanish_naming_customs)
-* [Unified style sheet for linguistics](http://linguistlist.org/pubs/tocs/JournalUnifiedStyleSheet2007.pdf) [PDF]
+- [Personal names around the world](https://www.w3.org/International/questions/qa-personal-names)
+- [Falsehoods Programmers Believe About Names](https://www.kalzumeus.com/2010/06/17/falsehoods-programmers-believe-about-names/)
+- [Last Name First](http://www.solidether.net/article/last-name-first/)
+- [Namae (名前)](https://github.com/berkmancenter/namae)
+- [Matts Name Parser](https://github.com/mericson/people)
+- [Types of business entity](http://en.wikipedia.org/wiki/Types_of_business_entity)
+- [List of professional designations in the United States](http://en.wikipedia.org/wiki/List_of_post-nominal_letters_(USA))
+- [List of post-nominal letters (United Kingdom)](http://en.wikipedia.org/wiki/List_of_post-nominal_letters_(United_Kingdom))
+- [Nobiliary particle](http://en.wikipedia.org/wiki/Nobiliary_particle)
+- [Spanish naming customs](http://en.wikipedia.org/wiki/Spanish_naming_customs)
+- [Unified style sheet for linguistics](http://linguistlist.org/pubs/tocs/JournalUnifiedStyleSheet2007.pdf) [PDF]
 
 ### How to contribute
 
-1.  Fork it
-1.  Create your feature branch (`git checkout -b my-new-feature`)
-1.  Commit your changes (`git commit -am 'Add some feature'`)
-1.  Push to the branch (`git push origin my-new-feature`)
-1.  Create new Pull Request
+1. Fork it
+1. Create your feature branch (`git checkout -b my-new-feature`)
+1. Commit your changes (`git commit -am 'Add some feature'`)
+1. Push to the branch (`git push origin my-new-feature`)
+1. Create new Pull Request
 
 ## Acknowledgements
 
-1.  Thanks to Ryan Bigg for the guide to making your first gem https://github.com/radar/guides/blob/master/gem-development.md
+1. Thanks to Ryan Bigg for the
+   [guide to making your first gem](https://github.com/radar/guides/blob/master/gem-development.md)

data/lib/name-tamer.rb

@@ -1 +1,3 @@
+# frozen_string_literal: true
+
 require 'name_tamer'

data/lib/name_tamer/constants/adfixes_prefix_person

@@ -0,0 +1,44 @@
+Baroness
+Capt.
+Captain
+Col.
+Colonel
+Dame
+Doctor
+Doktor
+Dr.
+Frau
+Herr
+Judge
+Justice
+Lady
+Lieut.
+Lieutenant
+Lord
+Madame
+Major
+Master
+Matron
+Messrs.
+Mgr.
+Miss
+Mister
+Mlle.
+Mme.
+Mons.
+Mr. & Mrs.
+Mr. and Mrs.
+Mr.
+Mrs.
+Ms.
+Msgr.
+Prof.
+Professor
+Rev.
+Reverend
+Sir
+Sister
+The Hon.
+The Lady.
+The Lord
+The Rt. Hon.

data/lib/name_tamer/constants/adfixes_suffix_organization

@@ -0,0 +1,213 @@
+S. de R.L. de C.V.
+S.A.P.I. de C.V.
+y. Cía. S. en C.
+Private Limited
+S.M. Pte. Ltd.
+Cía. S. C. A.
+y. Cía. S. C.
+S.A. de C.V.
+spol. s.r.o.
+(Pty.) Ltd.
+(Pvt.) Ltd.
+A.D.S.I.Tz.
+S.p. z.o.o.
+(Pvt.)Ltd.
+akc. spol.
+Cía. Ltda.
+E.B.V.B.A.
+P. Limited
+S. de R.L.
+S.I.C.A.V.
+S.P.R.L.U.
+А.Д.С.И.Ц.
+(P.) Ltd.
+C. por A.
+Comm.V.A.
+Ltd. Şti.
+Plc. Ltd.
+Pte. Ltd.
+Pty. Ltd.
+Pvt. Ltd.
+Soc. Col.
+A.M.B.A.
+A.S.B.L.
+A.V.E.E.
+B.V.B.A.
+B.V.I.O.
+C.V.B.A.
+C.V.O.A.
+E.E.I.G.
+E.I.R.L.
+E.O.O.D.
+E.U.R.L.
+F.M.B.A.
+G.m.b.H.
+Ges.b.R.
+K.G.a.A.
+L.L.L.P.
+Ltd. Co.
+Ltd. Co.
+M.E.P.E.
+n.y.r.t.
+O.V.E.E.
+P.E.E.C.
+P.L.L.C.
+P.L.L.C.
+S. en C.
+S.a.p.a.
+S.A.R.L.
+S.à.R.L.
+S.A.S.U.
+S.C.e.I.
+S.C.O.P.
+S.C.p.A.
+S.C.R.I.
+S.C.R.L.
+S.M.B.A.
+S.P.R.L.
+Е.О.О.Д.
+&. Cie.
+and Co.
+Comm.V.
+Limited
+P. Ltd.
+Part.G.
+Sh.p.k.
+&. Co.
+C.X.A.
+d.n.o.
+d.o.o.
+E.A.D.
+e.h.f.
+E.P.E.
+E.S.V.
+F.C.P.
+F.I.E.
+G.b.R.
+G.I.E.
+G.M.K.
+G.S.K.
+H.U.F.
+K.D.A.
+k.f.t.
+k.h.t.
+k.k.t.
+L.L.C.
+L.L.P.
+o.h.f.
+O.H.G.
+O.O.D.
+O.y.j.
+p.l.c.
+P.S.U.
+S.A.E.
+S.A.S.
+S.C.A.
+S.C.E.
+S.C.S.
+S.E.M.
+S.E.P.
+s.e.s.
+S.G.R.
+S.N.C.
+S.p.A.
+S.P.E.
+S.R.L.
+s.r.o.
+Unltd.
+V.O.F.
+V.o.G.
+v.o.s.
+V.Z.W.
+z.r.t.
+А.А.Т.
+Е.А.Д.
+З.А.Т.
+К.Д.А.
+О.О.Д.
+Т.А.А.
+股份有限公司
+Ap.S.
+Corp.
+ltda.
+Sh.A.
+st.G.
+Ultd.
+a.b.
+A.D.
+A.E.
+A.G.
+A.S.
+A.Ş.
+A.y.
+B.M.
+b.t.
+B.V.
+C.A.
+C.V.
+d.d.
+e.c.
+E.E.
+e.G.
+E.I.
+E.P.
+E.T.
+E.U.
+e.v.
+G.K.
+G.P.
+h.f.
+Inc.
+K.D.
+K.G.
+K.K.
+k.s.
+k.v.
+K.y.
+L.C.
+L.P.
+Ltd.
+N.K.
+N.L.
+N.V.
+O.E.
+O.G.
+O.Ü.
+O.y.
+P.C.
+p.l.
+Pty.
+PUP.
+Pvt.
+r.t.
+S.A.
+S.D.
+S.E.
+s.f.
+S.L.
+S.P.
+S.s.
+T.K.
+T.Ü.
+U.Ü.
+Y.K.
+А.Д.
+І.П.
+К.Д.
+ПУП.
+С.Д.
+בע"מ
+任意組合
+匿名組合
+合同会社
+合名会社
+合資会社
+有限会社
+有限公司
+株式会社
+A/S
+G/S
+I/S
+K/S
+P/S
+S/A

data/lib/name_tamer/constants/adfixes_suffix_person

@@ -0,0 +1,131 @@
+A.A.M.S.
+A.C.A.
+A.C.C.
+A.C.C.A.
+A.C.M.A.
+A.E.P.
+A.I.F.
+A.I.F.A.
+A.S.A.
+A.W.M.A.
+B.A.
+B.Ed.
+B.Eng.
+B.Sc.
+B.Tech.
+C.A.
+C.A.I.A.
+C.A.P.M.
+C.B.V.
+C.C.I.M.
+C.D.F.A.
+C.E.M.
+C.E.P.P.
+C.Eng.
+C.F.A.
+C.F.B.S.
+C.F.F.
+C.F.P.
+C.F.S.
+C.G.A.
+C.G.B.
+C.G.M.A.
+C.G.P.
+C.I.M.
+C.I.S.S.P.
+C.I.T.P.
+C.L.P.
+C.L.T.C.
+C.L.U.
+C.M.A.
+C.M.T.
+C.P.A.
+C.P.C.C.
+C.R.P.C.
+C.R.P.S.
+C.S.O.X.
+C.S.S.D.
+C.T.A.
+C.W.S.
+Cantab.
+Ch.F.C.
+Chartered F.C.S.I.
+Chartered M.C.S.I.
+D.B.E.
+D.D.S.
+D.Phil.
+D.V.M.
+Dip. D.M.
+E.A.
+E.R.P.
+Ed.D.
+Ed.M.
+Eng.D.
+Esq.
+F.B.C.S.
+F.C.A.
+F.C.C.A.
+F.C.I.P.S.
+F.C.M.I.
+F.C.S.I.
+F.I.E.T.
+F.I.R.P.
+F.Inst.L.M.
+F.P.C.
+F.R.M.
+F.R.M.
+G.S.P.
+Hons.
+I.F.R.S. Certified
+I.T.I.L. v3
+II
+III
+IV
+J.D.
+Jr.
+K.C.
+L.P.S.
+LL.B.
+LL.D.
+LL.M.
+M.A.
+M.B.A.
+M.B.E.
+M.D.
+M.E.P.
+M.Ed.
+M.Eng.
+M.I.E.T.
+M.Io.D.
+M.Jur.
+M.P.
+M.P.A.
+M.R.I.C.S.
+M.S.
+M.S.F.
+M.S.F.S.
+M.S.P.
+M.Sc. D.
+M.Sc.
+O.B.E.
+O.K.
+O.R.S.C.
+Oxon.
+P.A.
+P.C.C.
+P.F.S.
+P.H.R.
+P.M.C.
+P.M.P.
+P.M.P.
+P.S.P.
+Ph.D.
+Q.C.
+R.D.
+R.F.C.
+R.I.C.P.
+S.C.M.P
+Sr.
+T.M.I.E.T.
+V
+V.M.D.