Speak, Friend, and enter.
Mellon is four things:
- A simple library for reading and writing notes in Mac OSX keychains. (see Mellon::Keychain)
- A simple library for using Mac OSX keychain notes as hash storage. (see Mellon::Store)
- A tiny CLI interface for Mellon::Keychain. (see Command-line interface)
I built Mellon because I wanted Yet Another Way of Managing Application Secrets™. Frankly, I am fed up with passing around some secret file not included in our source code repository that runs out of sync every time we add or change values during development.
Mellon, together with Econfig, solves this problem.
Mellon is sponsored by Elabs.
Mellon is intended for usage during development only. The recommended workflow is:
- Create an OSX keychain using Keychain Access, name it something hip and clever, like
- Share your keychain with your colleagues, through iCloud sync, Dropbox or similar.
- Hook up Mellon with your application according to instructions below.
Using with Rails and Econfig (recommended)
See instructions over at econfig-keychain.
An API reference can be found at rubydoc.info/github/elabs/mellon.
Mellon::Keychain allows you to read and write notes in OSX keychains.
keychain = ::. keychain["ruby note"] # => nil keychain["ruby note"] = "Hello from Ruby!" # creates keychain note `ruby note` keychain["ruby note"] # => "Hello from Ruby!" keychain["ruby note"] = nil # deletes keychain note `ruby note`
More documentation can be found at the API reference for Mellon::Keychain.
Mellon::Store is a layer above Mellon::Keychain, allowing you to use a single keychain note as hash storage. Notes are serialized as YAML by default.
project_name = "ruby note" store = ::.(project_name, keychain: ::.) store["some key"] # => nil store["some key"] = "Hello from Ruby!" # creates keychain note "ruby note", and puts value for "some key" in it store["some key"] # => "Hello from Ruby!" # Have a peek at the data, which is serialized as YAML store.keychain[store.project_name] # => "---\nsome key: Hello from Ruby!\n"
More documentation can be found at the API reference for Mellon::Store.
When you install the Mellon gem you also get an executable called
mellon -h for usage information.