Add PromoOfferRequestTrackingCode class and corresponding tests

- Introduced PromoOfferRequestTrackingCode class for handling request tracking promo codes.
- Implemented request method with detailed type hints and Google-style docstrings.
- Added comprehensive test cases for successful requests, error handling, and validation checks in test_promo_offers.py.
- Updated imports in test files to include the new class.

Author: nnnLik

admitad/items/promo_offers.py

@@ -1,6 +1,12 @@
 from admitad.items.base import Item
 
 
+__all__ = [
+    'PromoOffersForCampaign',
+    'PromoOfferRequestTrackingCode',
+]
+
+
 class PromoOffersForCampaign(Item):
     """
     List of the campaign promo offers
@@ -28,3 +34,44 @@ def get(self, _id: int, **kwargs: dict) -> dict:
             .set_pagination(**kwargs)
             .request(**request_data)
         )
+
+
+class PromoOfferRequestTrackingCode(Item):
+    """
+    Request tracking promo code for website from specific promo offer
+    """
+
+    SCOPE = 'request_tracking_coupon'
+
+    URL = Item.prepare_url('advcampaigns/request-tracking-coupon')
+
+    def request(
+        self,
+        coupon_id: int,
+        advcampaign_id: int,
+        website_id: int,
+    ) -> dict:
+        """
+        Args:
+            coupon_id (int): ID promo offer (coupon)
+            advcampaign_id (int): ID advertising campaign
+            website_id (int): ID website
+
+        Returns:
+            dict: Answer with assigned promo code and tracking link
+                {
+                    "assigned_promo_code": str | None,  # promo code or None if request is created
+                    "tracking_link": str | None,        # tracking link or None
+                }
+        """
+        request_data = {
+            'coupon_id': Item.sanitize_id(coupon_id),
+            'advcampaign_id': Item.sanitize_id(advcampaign_id),
+            'website_id': Item.sanitize_id(website_id),
+        }
+
+        return (
+            self.transport.post()
+            .set_data(request_data)
+            .request(url=self.URL)
+        )

admitad/tests/test_promo_offers.py

@@ -1,13 +1,14 @@
 import unittest
 import responses
 
-from admitad.items import PromoOffersForCampaign
+from admitad.exceptions import HttpException
+from admitad.items import PromoOffersForCampaign, PromoOfferRequestTrackingCode
 from admitad.tests.base import BaseTestCase
 
 
 class PromoOffersForCampaignTestCase(BaseTestCase):
 
-    def test_get_promo_offers_for_campaign_request(self):
+    def test_get_promo_offers_for_campaign_request(self) -> None:
         with responses.RequestsMock() as resp:
             resp.add(
                 resp.GET,
@@ -24,5 +25,109 @@ def test_get_promo_offers_for_campaign_request(self):
         self.assertIn('status', result)
 
 
+class PromoOfferRequestTrackingCodeTestCase(BaseTestCase):
+
+    def test_request_tracking_promo_code_success(self) -> None:
+        with responses.RequestsMock() as resp:
+            resp.add(
+                resp.POST,
+                PromoOfferRequestTrackingCode.URL,
+                json={
+                    'assigned_promo_code': 'TESTCODE123',
+                    'tracking_link': 'https://ad.admitad.com/g/123abc/'
+                },
+                status=200
+            )
+            result = self.client.PromoOfferRequestTrackingCode.request(
+                coupon_id=100,
+                advcampaign_id=200,
+                website_id=300
+            )
+
+        self.assertIn('assigned_promo_code', result)
+        self.assertIn('tracking_link', result)
+        self.assertEqual(result['assigned_promo_code'], 'TESTCODE123')
+
+    def test_request_tracking_promo_code_creates_request(self) -> None:
+        with responses.RequestsMock() as resp:
+            resp.add(
+                resp.POST,
+                PromoOfferRequestTrackingCode.URL,
+                json={
+                    'assigned_promo_code': None,
+                    'tracking_link': None
+                },
+                status=200
+            )
+            result = self.client.PromoOfferRequestTrackingCode.request(
+                coupon_id=100,
+                advcampaign_id=200,
+                website_id=300
+            )
+
+        self.assertIn('assigned_promo_code', result)
+        self.assertIn('tracking_link', result)
+        self.assertIsNone(result['assigned_promo_code'])
+        self.assertIsNone(result['tracking_link'])
+
+    def test_request_tracking_promo_code_no_coupon_error(self) -> None:
+        with responses.RequestsMock() as resp:
+            resp.add(
+                resp.POST,
+                PromoOfferRequestTrackingCode.URL,
+                json={
+                    'error_code': 'CHECK_PRE_APPROVED_COUPON_ERROR_CODE_NO_COUPON'
+                },
+                status=400
+            )
+            with self.assertRaises(HttpException):
+                self.client.PromoOfferRequestTrackingCode.request(
+                    coupon_id=100,
+                    advcampaign_id=200,
+                    website_id=300
+                )
+
+    def test_request_tracking_promo_code_not_connected_error(self) -> None:
+        with responses.RequestsMock() as resp:
+            resp.add(
+                resp.POST,
+                PromoOfferRequestTrackingCode.URL,
+                json={
+                    'error_code': 'webmaster_not_connected'
+                },
+                status=400
+            )
+            with self.assertRaises(HttpException):
+                self.client.PromoOfferRequestTrackingCode.request(
+                    coupon_id=100,
+                    advcampaign_id=200,
+                    website_id=300
+                )
+
+    def test_request_tracking_promo_code_invalid_coupon_id(self) -> None:
+        with self.assertRaises(ValueError):
+            self.client.PromoOfferRequestTrackingCode.request(
+                coupon_id=0,
+                advcampaign_id=200,
+                website_id=300
+            )
+
+    def test_request_tracking_promo_code_invalid_advcampaign_id(self) -> None:
+        with self.assertRaises(ValueError):
+            self.client.PromoOfferRequestTrackingCode.request(
+                coupon_id=100,
+                advcampaign_id=0,
+                website_id=300
+            )
+
+    def test_request_tracking_promo_code_invalid_website_id(self) -> None:
+        with self.assertRaises(ValueError):
+            self.client.PromoOfferRequestTrackingCode.request(
+                coupon_id=100,
+                advcampaign_id=200,
+                website_id=0,
+            )
+
+
 if __name__ == '__main__':
     unittest.main()