[POC - Behat] Add RepositoryContext trait (ezsystems#1584)

* [Behat] add RepositoryContext trait

* Add Repository Context docs

* [Behat] Repository Context methods/attributes visibility more strict

doc/behat/README.md

@@ -27,4 +27,23 @@ use EzSystems\PlatformBehatBundle\Context\SubContext\DeprecationNoticeSupressor;
 class MyContextUsesDeprecatedCode implements Context
 {
     use DeprecationNoticeSupressor;
+...
+```
+
+##### Using the Repository
+To ease the usage and maintainability of the repository dependent
+Behat Contexts a trait called `RespositoryContext` was created.
+This trait includes all the methods, variables related directly
+with the repository. To use this all that is needed is to use it
+in your own Contexts. Ex:
+
+``` php
+...
+/**
+ * My very own Behat Context
+ */
+class MyContext implements Context
+{
+    use RepositoryContext;
+...
 ```

eZ/Bundle/PlatformBehatBundle/Context/RepositoryContext.php

@@ -0,0 +1,56 @@
+<?php
+/**
+ * File containing the Repository Context class for EzBehatBundle.
+ *
+ * @copyright Copyright (C) eZ Systems AS. All rights reserved.
+ * @license For full copyright and license information view LICENSE file distributed with this source code.
+ * @version //autogentag//
+ */
+namespace EzSystems\PlatformBehatBundle\Context;
+
+use eZ\Publish\API\Repository\Repository;
+use eZ\Publish\Core\Repository\Values\User\UserReference;
+
+/**
+ * Repository Context Trait.
+ * Everything repository related should go here.
+ * To be used by all the other behat contexts that need the repository.
+ * Any Context tha uses this trait will automatically login the admin user,
+ * so any operation that needs admin permissions can be executed.
+ */
+trait RepositoryContext
+{
+    /**
+     * Default Administrator user id.
+     */
+    private $adminUserId = 14;
+
+    /**
+     * @var eZ\Publish\API\Repository\Repository
+     */
+    private $repository;
+
+    /**
+     * @param $repository eZ\Publish\API\Repository\Repository $repository
+     */
+    protected function setRepository(Repository $repository)
+    {
+        $this->repository = $repository;
+    }
+
+    /**
+     * @return eZ\Publish\API\Repository\Repository $repository
+     */
+    public function getRepository()
+    {
+        return $this->repository;
+    }
+
+    /**
+     * @BeforeScenario
+     */
+    public function loginAdmin($event)
+    {
+        $this->repository->setCurrentUser(new UserReference($this->adminUserId));
+    }
+}