Custom file location

README.md

@@ -143,6 +143,27 @@ Pusher.key    = Figaro.env.pusher_key!
 Pusher.secret = Figaro.env.pusher_secret!
 ```
 
+### Custom file location
+
+Say your deployment process require you to have your configuration at a certain file path or that you want to provide defaults for different platforms in development.
+You can achieve this by using an environment variable to tell Figaro where to look for your yaml file.
+
+```bash
+$ docker run -e FIGARO_PATH=./config/application.docker.yml my-container rails s
+```
+
+```bash
+$ FIGARO_PATH=/storage_device/configuration/my_app_variables.yml rails s
+```
+
+If you're not using rails or if you want to determine the file path by other means, set the `Figaro.adapter.path` to your desired value.
+
+```ruby
+require "figaro"
+Figaro.adapter.path = "/my/config/file.yml"
+Figaro.load
+```
+
 ### Deployment
 
 Figaro is written with deployment in mind. In fact, [Heroku](https://www.heroku.com)'s use of `ENV` for application configuration was the original inspiration for Figaro.

lib/figaro/rails/application.rb

@@ -6,7 +6,11 @@ class Application < Figaro::Application
       def default_path
         rails_not_initialized! unless ::Rails.root
 
-        ::Rails.root.join("config", "application.yml")
+        if ::ENV["FIGARO_PATH"]
+          ::Rails.root.join(::ENV["FIGARO_PATH"])
+        else
+          ::Rails.root.join("config", "application.yml")
+        end
       end
 
       def default_environment

spec/figaro/rails/application_spec.rb

@@ -4,16 +4,34 @@ module Rails
       describe "#default_path" do
         let!(:application) { Application.new }
 
-        it "defaults to config/application.yml in Rails.root" do
-          allow(::Rails).to receive(:root) { Pathname.new("/path/to/app") }
+        before { allow(::Rails).to receive(:root) { Pathname.new("/path/to/app") } }
 
+        it "defaults to config/application.yml in Rails.root" do
           expect {
             allow(::Rails).to receive(:root) { Pathname.new("/app") }
           }.to change {
             application.send(:default_path).to_s
           }.from("/path/to/app/config/application.yml").to("/app/config/application.yml")
         end
 
+        it "defaults to path relative to Rails.root from the FIGARO_PATH environment variable" do
+          expect {
+            ::ENV["FIGARO_PATH"] = "./config/application.docker.yml"
+          }.to change {
+            application.send(:default_path).to_s
+          }.from("/path/to/app/config/application.yml").to("/path/to/app/config/application.docker.yml")
+          ::ENV["FIGARO_PATH"] = nil
+        end
+
+        it "defaults to absolute path from the FIGARO_PATH environment variable" do
+          expect {
+            ::ENV["FIGARO_PATH"] = "/var/config/my-app.yml"
+          }.to change {
+            application.send(:default_path).to_s
+          }.from("/path/to/app/config/application.yml").to("/var/config/my-app.yml")
+          ::ENV["FIGARO_PATH"] = nil
+        end
+
         it "raises an error when Rails.root isn't set yet" do
           allow(::Rails).to receive(:root) { nil }