add create_performer function. release 0.5.0

README.md

@@ -13,7 +13,7 @@ Annacl is published on [Hex](https://hex.pm/packages/annacl). The package can be
 ```elixir
 def deps do
   [
-    {:annacl, "~> 0.4.1"}
+    {:annacl, "~> 0.5.0"}
   ]
 end
 ```
@@ -82,7 +82,14 @@ end
 Annacl.grant_permission_to_role(user_role, posts_list)
 Annacl.grant_permission_to_role(user_role, posts_read)
 
+# Create a performer for each user
+performer = Annacl.create_performer()
 
+my_user
+|> Ecto.Changeset.change(%{performer_id: performer.id})
+|> Repo.update!()
+
+# How to assign role to users
 superadmin = MyApp.Accounts.assign_role!(%MyApp.Accounts.User{performer_id: "00000000-0000-0000-0000-000000000000"}, "superadmin")
 
 user = MyApp.Accounts.assign_role!(%MyApp.Accounts.User{performer_id: "00000000-0000-0000-0000-000000000001"}, "user")

lib/annacl.ex

@@ -11,7 +11,7 @@ defmodule Annacl do
   alias Annacl.Permissions.Permission
   alias Annacl.PermissionsRoles.PermissionRole
   alias Annacl.Performers
-  alias Annacl.Performers.{PerformerRole, PerformerPermission}
+  alias Annacl.Performers.{Performer, PerformerRole, PerformerPermission}
 
   defmacro __using__(_opts) do
     quote do
@@ -85,6 +85,9 @@ defmodule Annacl do
   @spec role_can?(Role.t(), Permission.t()) :: boolean
   defdelegate role_can?(role, permission), to: Roles, as: :can?
 
+  @spec create_performer :: {:ok, Performer.t()} | {:error, Ecto.Changeset.t()}
+  defdelegate create_performer, to: Performers
+
   @spec assign_role!(%{performer_id: binary()}, binary()) ::
           {:ok, PerformerRole.t()} | {:error, Ecto.Changeset.t()}
   def assign_role!(%{performer_id: performer_id}, role_name) do

lib/annacl/behaviours/role_and_permission.ex

@@ -2,6 +2,7 @@ defmodule Annacl.Behaviour.RoleAndPermission do
   alias Annacl.Roles.Role
   alias Annacl.Permissions.Permission
   alias Annacl.PermissionsRoles.PermissionRole
+  alias Annacl.Performers.Performer
 
   @callback create_permission(binary()) :: {:ok, Permission.t()} | {:error, Ecto.Changeset.t()}
   @callback get_permission!(binary()) :: Permission.t()
@@ -18,4 +19,6 @@ defmodule Annacl.Behaviour.RoleAndPermission do
   @callback revoke_permission_from_role(Role.t(), Permission.t()) ::
               {:ok, PermissionRole.t()} | {:error, Ecto.Changeset.t()}
   @callback role_can?(Role.t(), Permission.t()) :: boolean
+
+  @callback create_performer() :: {:ok, Performer.t()} | {:error, Ecto.Changeset.t()}
 end

lib/annacl/performers/performers.ex

@@ -15,6 +15,13 @@ defmodule Annacl.Performers do
     |> repo().get!(id)
   end
 
+  @spec create_performer() :: {:ok, Performer.t()} | {:error, Ecto.Changeset.t()}
+  def create_performer() do
+    %Performer{}
+    |> Ecto.Changeset.change(%{})
+    |> repo().insert()
+  end
+
   @spec assign_role(Performer.t(), Role.t() | [Role.t()]) ::
           {:ok, PerformerRole.t() | [PerformerRole.t()]} | {:error, Ecto.Changeset.t()}
   def assign_role(%Performer{} = performer, %Role{} = role) do

mix.exs

@@ -4,7 +4,7 @@ defmodule Annacl.MixProject do
   def project do
     [
       app: :annacl,
-      version: "0.4.1",
+      version: "0.5.0",
       elixir: "~> 1.8",
       start_permanent: Mix.env() == :prod,
       description: description(),

test/annacl/performers/performers_test.exs

@@ -12,6 +12,12 @@ defmodule Annacl.PerformersTest do
     1 => "00000000-0000-0000-0000-000000000001"
   }
 
+  describe "create_performer/0" do
+    test "creates the performer" do
+      assert {:ok, %Performer{}} = Performers.create_performer()
+    end
+  end
+
   describe "get_performer!/1" do
     test "when the performer does not exist, raise an Ecto.NoResultsError" do
       assert_raise Ecto.NoResultsError, fn ->

test/annacl/permissions/permissions_test.exs

@@ -21,7 +21,8 @@ defmodule Annacl.PermissionsTest do
     test "when data is valid, creates the api_key" do
       permission_params = params_for(:permission)
 
-      assert {:ok, %Permission{} = api_key} = Permissions.create_permission(permission_params)
+      assert {:ok, %Permission{} = permission} = Permissions.create_permission(permission_params)
+      assert permission.name == permission_params.name
     end
   end