japanese_names 0.0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    MmIzYzM1YThjMjlkZGNmMWM4Y2NjNmZkZWY2Y2EzMWQ3MmQyMTkyNg==
+  data.tar.gz: !binary |-
+    NzRkNTIxOWIzZDY4NzA2MmQyYjIxNmExMTI5ZmY0ZWUxMGNlMTdjNw==
+SHA512:
+  metadata.gz: !binary |-
+    YTdlMGM4OGRmOGNiMTQzNWFiMDkxZmFkZDQ1MzJhZmI5YjEzZmIzZTgxMDIw
+    ZWU5OWU0N2NjMWUxYTQwMzBiYTc3N2QyNThhZDM1NmYwZjk1MDc1ODhkODA2
+    MWIyM2ZlMjIzOGFjNTA2NWNiYmExMTUxNGRmZGE4ZTcwMmQ0ODU=
+  data.tar.gz: !binary |-
+    MmQ0MGJiNDA0OGJmNDk1ZmNmNmIyYjNmM2Q1NjYxN2JmNjBiOWZiZjRkMDBj
+    YmVhYTdkNDQ1NGNhNDIyMDgyODU4YTFlYWJiOTlhZjM3ODEwOGJlOGI3ZWFi
+    ODhkODc4ZWM2MWExZmZkYmJhYzk2Y2RlNGM5ZGE0N2YxZDc1Mzg=

data/LICENSE

@@ -0,0 +1,24 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Johnny Shields
+
+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.
+
+ENAMDICT is Copyright (c) The Electronic Dictionary Research and Development
+Group (http://www.edrdg.org/)

data/README.md

@@ -0,0 +1,52 @@
+# JapaneseNames
+
+Japanese name parser based on ENAMDIC
+
+## Overview
+
+JapaneseNames provides an interface to the [ENAMDIC file](http://www.csse.monash.edu.au/~jwb/enamdict_doc.html).
+
+Currently the main method is `split` which, given a kanji and kana representation of a name splits
+into to family/given names.
+
+```ruby
+  parser = JapaneseNames::Parser.new
+  parser.split('堺雅美', 'さかいマサミ')  #=> [['堺', '雅美'], ['さかい', 'マサミ']]
+```
+
+
+## ENAMDICT
+
+This library comes packaged with a compacted version of the [ENAMDIC file](http://www.csse.monash.edu.au/~jwb/enamdict_doc.html)
+at `bin/enamdict.min`.
+
+This file can be regenerated by `rake enamdict:refresh`, which downloads, extracts, and compiles the ENAMDICT file.
+
+
+## TODO
+
+* **Additional Methods:** Add additional methods to access the ENAMDICT file.
+
+* **Performance:** Currently name lookup takes approx 0.5 sec. Benchmarking and/or a native C
+implementation of the dictionary would be nice.
+
+* **Gender Lookup:** Use m/f dictionary flag to infer name gender.
+
+
+## Contributing
+
+Fork -> Commit -> Spec -> Push -> Pull Request
+
+
+## Authors
+
+* [@johnnyshields](https://github.com/johnnyshields)
+
+
+## Copyright
+
+Copyright (c) 2014 Johnny Shields.
+
+ENAMDICT is Copyright (c) [The Electronic Dictionary Research and Development Group](http://www.edrdg.org/)
+
+See LICENSE for details