Plugin - to structure your business logic in composable blocks!

Basically a light version of Plug.

Think:

• Plug without web-specific logic and without a typed Conn type.

Story

After having structured my business logic with middleware pattern recently to keep it simple, testable and composable I came to like that pattern very much.

If you take a look at Phoenix you see how far this pattern can be pushed and how reusable your bits of logic become.

So, I'd like to have a small library to help me build small modules that can be stacked together and composed in each other. I looked on Github and found this package: https://github.com/liveforeverx/plugin.git. It's mostly a copy-paste from Plug with some changes.

It gave me the initial direction, but it had no unit tests and was quite unusable.

So, I rewrote some bits and here we are.

Installation

1. Add plugin to your list of dependencies in mix.exs:

   def deps do [{:plugin, "~> 0.1.0"}] end

Usage

All the rules how you structure/implement Plugs apply here:

• Module Plugins
• Function Plugins
• Builder Plugins

Example for Builder plugins:

defmodule Plugin1 do
  use Plugin.Builder
  plugin :first_fn

  def first_fn(acc, _) do
    Map.put(acc, :first_fn_passed, true)
  end
end

defmodule Plugin2 do
  use Plugin.Builder
  plugin :second_fn

  def second_fn(acc, _) do
    Map.put(acc, :second_fn_passed, true)
  end
end

defmodule Plugin3 do
  use Plugin.Builder
  plugin Plugin1
  plugin Plugin2
end

acc = Plugin.call(Plugin3, %{})
true = Map.get(acc, :first_fn_passed)
true = Map.get(acc, :second_fn_passed)

Most of the code is taken directly from plug.

License for part of codes:

Copyright (c) 2013 Plataformatec.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.