MAGETWO-53850: API interfaces lack @api annotation

- improve static test

Author: mslabko

app/code/Magento/CatalogRule/Api/CatalogRuleRepositoryInterface.php

@@ -5,34 +5,34 @@
  */
 namespace Magento\CatalogRule\Api;
 
+/**
+ * Interface CatalogRuleRepositoryInterface
+ * @api
+ */
 interface CatalogRuleRepositoryInterface
 {
     /**
-     * @api
      * @param \Magento\CatalogRule\Api\Data\RuleInterface $rule
      * @return \Magento\CatalogRule\Api\Data\RuleInterface
      * @throws \Magento\Framework\Exception\CouldNotSaveException
      */
     public function save(\Magento\CatalogRule\Api\Data\RuleInterface $rule);
 
     /**
-     * @api
      * @param int $ruleId
      * @return \Magento\CatalogRule\Api\Data\RuleInterface
      * @throws \Magento\Framework\Exception\NoSuchEntityException
      */
     public function get($ruleId);
 
     /**
-     * @api
      * @param \Magento\CatalogRule\Api\Data\RuleInterface $rule
      * @return bool
      * @throws \Magento\Framework\Exception\CouldNotDeleteException
      */
     public function delete(\Magento\CatalogRule\Api\Data\RuleInterface $rule);
 
     /**
-     * @api
      * @param int $ruleId
      * @return bool
      * @throws \Magento\Framework\Exception\CouldNotDeleteException

app/code/Magento/Customer/Api/AccountManagementInterface.php

@@ -9,6 +9,7 @@
 
 /**
  * Interface for managing customers accounts.
+ * @api
  */
 interface AccountManagementInterface
 {
@@ -24,7 +25,6 @@ interface AccountManagementInterface
     /**
      * Create customer account. Perform necessary business operations like sending email.
      *
-     * @api
      * @param \Magento\Customer\Api\Data\CustomerInterface $customer
      * @param string $password
      * @param string $redirectUrl
@@ -59,7 +59,6 @@ public function createAccountWithPasswordHash(
     /**
      * Validate customer data.
      *
-     * @api
      * @param \Magento\Customer\Api\Data\CustomerInterface $customer
      * @return \Magento\Customer\Api\Data\ValidationResultsInterface
      * @throws \Magento\Framework\Exception\LocalizedException
@@ -80,7 +79,6 @@ public function isReadonly($customerId);
     /**
      * Activate a customer account using a key that was sent in a confirmation email.
      *
-     * @api
      * @param string $email
      * @param string $confirmationKey
      * @return \Magento\Customer\Api\Data\CustomerInterface
@@ -102,7 +100,6 @@ public function activateById($customerId, $confirmationKey);
     /**
      * Authenticate a customer by username and password
      *
-     * @api
      * @param string $email
      * @param string $password
      * @return \Magento\Customer\Api\Data\CustomerInterface
@@ -113,7 +110,6 @@ public function authenticate($email, $password);
     /**
      * Change customer password.
      *
-     * @api
      * @param string $email
      * @param string $currentPassword
      * @param string $newPassword
@@ -125,7 +121,6 @@ public function changePassword($email, $currentPassword, $newPassword);
     /**
      * Change customer password.
      *
-     * @api
      * @param int $customerId
      * @param string $currentPassword
      * @param string $newPassword
@@ -137,7 +132,6 @@ public function changePasswordById($customerId, $currentPassword, $newPassword);
     /**
      * Send an email to the customer with a password reset link.
      *
-     * @api
      * @param string $email
      * @param string $template
      * @param int $websiteId
@@ -149,7 +143,6 @@ public function initiatePasswordReset($email, $template, $websiteId = null);
     /**
      * Reset customer password.
      *
-     * @api
      * @param string $email
      * @param string $resetToken
      * @param string $newPassword
@@ -161,7 +154,6 @@ public function resetPassword($email, $resetToken, $newPassword);
     /**
      * Check if password reset token is valid.
      *
-     * @api
      * @param int $customerId
      * @param string $resetPasswordLinkToken
      * @return bool True if the token is valid
@@ -176,7 +168,6 @@ public function validateResetPasswordLinkToken($customerId, $resetPasswordLinkTo
     /**
      * Gets the account confirmation status.
      *
-     * @api
      * @param int $customerId
      * @return string
      * @throws \Magento\Framework\Exception\LocalizedException
@@ -186,7 +177,6 @@ public function getConfirmationStatus($customerId);
     /**
      * Resend confirmation email.
      *
-     * @api
      * @param string $email
      * @param int $websiteId
      * @param string $redirectUrl
@@ -198,7 +188,6 @@ public function resendConfirmation($email, $websiteId, $redirectUrl = '');
     /**
      * Check if given email is associated with a customer account in given website.
      *
-     * @api
      * @param string $customerEmail
      * @param int $websiteId If not set, will use the current websiteId
      * @return bool
@@ -209,7 +198,6 @@ public function isEmailAvailable($customerEmail, $websiteId = null);
     /**
      * Check store availability for customer given the customerId.
      *
-     * @api
      * @param int $customerWebsiteId
      * @param int $storeId
      * @return bool
@@ -220,7 +208,6 @@ public function isCustomerInStore($customerWebsiteId, $storeId);
     /**
      * Retrieve default billing address for the given customerId.
      *
-     * @api
      * @param int $customerId
      * @return \Magento\Customer\Api\Data\AddressInterface
      * @throws \Magento\Framework\Exception\NoSuchEntityException If the customer Id is invalid
@@ -231,7 +218,6 @@ public function getDefaultBillingAddress($customerId);
     /**
      * Retrieve default shipping address for the given customerId.
      *
-     * @api
      * @param int $customerId
      * @return \Magento\Customer\Api\Data\AddressInterface
      * @throws \Magento\Framework\Exception\NoSuchEntityException If the customer Id is invalid
@@ -242,7 +228,6 @@ public function getDefaultShippingAddress($customerId);
     /**
      * Return hashed password, which can be directly saved to database.
      *
-     * @api
      * @param string $password
      * @return string
      */

app/code/Magento/Customer/Api/AddressRepositoryInterface.php

@@ -8,13 +8,13 @@
 
 /**
  * Customer address CRUD interface.
+ * @api
  */
 interface AddressRepositoryInterface
 {
     /**
      * Save customer address.
      *
-     * @api
      * @param \Magento\Customer\Api\Data\AddressInterface $address
      * @return \Magento\Customer\Api\Data\AddressInterface
      * @throws \Magento\Framework\Exception\LocalizedException
@@ -24,7 +24,6 @@ public function save(\Magento\Customer\Api\Data\AddressInterface $address);
     /**
      * Retrieve customer address.
      *
-     * @api
      * @param int $addressId
      * @return \Magento\Customer\Api\Data\AddressInterface
      * @throws \Magento\Framework\Exception\LocalizedException
@@ -34,7 +33,6 @@ public function getById($addressId);
     /**
      * Retrieve customers addresses matching the specified criteria.
      *
-     * @api
      * @param \Magento\Framework\Api\SearchCriteriaInterface $searchCriteria
      * @return \Magento\Customer\Api\Data\AddressSearchResultsInterface
      * @throws \Magento\Framework\Exception\LocalizedException
@@ -44,7 +42,6 @@ public function getList(\Magento\Framework\Api\SearchCriteriaInterface $searchCr
     /**
      * Delete customer address.
      *
-     * @api
      * @param \Magento\Customer\Api\Data\AddressInterface $address
      * @return bool true on success
      * @throws \Magento\Framework\Exception\LocalizedException
@@ -54,7 +51,6 @@ public function delete(\Magento\Customer\Api\Data\AddressInterface $address);
     /**
      * Delete customer address by ID.
      *
-     * @api
      * @param int $addressId
      * @return bool true on success
      * @throws \Magento\Framework\Exception\NoSuchEntityException

app/code/Magento/Customer/Api/CustomerRepositoryInterface.php

@@ -9,13 +9,13 @@
 
 /**
  * Customer CRUD interface.
+ * @api
  */
 interface CustomerRepositoryInterface
 {
     /**
      * Create or update a customer.
      *
-     * @api
      * @param \Magento\Customer\Api\Data\CustomerInterface $customer
      * @param string $passwordHash
      * @return \Magento\Customer\Api\Data\CustomerInterface
@@ -28,7 +28,6 @@ public function save(\Magento\Customer\Api\Data\CustomerInterface $customer, $pa
     /**
      * Retrieve customer.
      *
-     * @api
      * @param string $email
      * @param int|null $websiteId
      * @return \Magento\Customer\Api\Data\CustomerInterface
@@ -40,7 +39,6 @@ public function get($email, $websiteId = null);
     /**
      * Get customer by customer ID.
      *
-     * @api
      * @param int $customerId
      * @return \Magento\Customer\Api\Data\CustomerInterface
      * @throws \Magento\Framework\Exception\NoSuchEntityException If customer with the specified ID does not exist.
@@ -55,7 +53,6 @@ public function getById($customerId);
      * included. See http://devdocs.magento.com/codelinks/attributes.html#CustomerRepositoryInterface to determine
      * which call to use to get detailed information about all attributes for an object.
      *
-     * @api
      * @param \Magento\Framework\Api\SearchCriteriaInterface $searchCriteria
      * @return \Magento\Customer\Api\Data\CustomerSearchResultsInterface
      * @throws \Magento\Framework\Exception\LocalizedException
@@ -65,7 +62,6 @@ public function getList(\Magento\Framework\Api\SearchCriteriaInterface $searchCr
     /**
      * Delete customer.
      *
-     * @api
      * @param \Magento\Customer\Api\Data\CustomerInterface $customer
      * @return bool true on success
      * @throws \Magento\Framework\Exception\LocalizedException
@@ -75,7 +71,6 @@ public function delete(\Magento\Customer\Api\Data\CustomerInterface $customer);
     /**
      * Delete customer by ID.
      *
-     * @api
      * @param int $customerId
      * @return bool true on success
      * @throws \Magento\Framework\Exception\NoSuchEntityException