No commit activity in last 3 years
No release in over 3 years
There's a lot of open issues
Mongoid::AppSettings allows you to store settings in MongoDB, and access them easily
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

 Project Readme

mongoid-app_settings

Build Status

This is a fairly simple gem to let you work with application configuration that's stored in Mongoid. It's inspired by a similar project called rails-settings, except this stores it in MongoDB using Mongoid.

It's a little more explicit in that it requires you to define a list of settings beforehand.

Usage

Simply create some class and include Mongoid::AppSettings.

class MySettings
  include Mongoid::AppSettings

  setting :enable_my_feature, default: true
  setting :something_else, type: Integer
end

Then you can do things like:

MySettings.enable_my_feature
=> true

MySettings.enable_my_feature = false
MySettings.enable_my_feature
=> false

MySettings.something_else = "42"
MySettings.something_else
=> "42"

You can unset a value (reverting it to the default if given):

MySettings.delete(:enable_my_feature)
MySettings.enable_my_feature
=> true

You can get a list of all values:

MySettings.all
=> {:enable_my_feature => true, :something_else => "42"}

You can get a list of defaults:

MySettings.defaults
=> {:enable_my_feature => true, :something_else => nil}

Settings are cached until manually reloaded. In your ApplicationController, you might want to do something like

class ApplicationController < ActionController::Base
  before_filter :reload_settings

  def reload_settings
    Settings.reload
  end
end

Changelog

  • 1.3.0 - Added support for converting to proper types, using Mongoid's conversion.
  • 1.2.0 - Added chaining behaviour for reload: AppSettings.reload.some_setting is now possible.
  • 1.1.1 - Add support for Mongoid 4 (available in git). Still supports Mongoid 2 and 3.
  • 1.1 - Add support for Mongoid 3. Mongoid 2 is still supported.
  • 1.0 - Feature complete and stable. Until I need more features, that is.

Contributing to mongoid-app_settings

  • Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
  • Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
  • Fork the project
  • Start a feature/bugfix branch
  • Commit and push until you are happy with your contribution
  • Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
  • Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

Copyright

Copyright (c) 2011 Marten Veldthuis. See LICENSE.txt for further details.