From e13b640d9918210e4fa0e68cd3b36367539ff1f7 Mon Sep 17 00:00:00 2001 From: oseovie Date: Sat, 14 Mar 2026 23:00:37 +0100 Subject: [PATCH 1/2] Add documentation for Data Types module Introduced documentation for data types used in the PaystackEase library, including BulkChargeItem and BulkChargeListObject classes. --- docs/source/datatype.rst | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 docs/source/datatype.rst diff --git a/docs/source/datatype.rst b/docs/source/datatype.rst new file mode 100644 index 0000000..f2fbeb2 --- /dev/null +++ b/docs/source/datatype.rst @@ -0,0 +1,40 @@ +=========================================== +Data Types +=========================================== + +The Data Types module defines structured data models used throughout +the PaystackEase library when sending requests to the Paystack API. + +These models are implemented using **Pydantic**, which provides automatic +data validation and type checking before data is sent to the API. + +Using these models ensures that required fields are provided and that +data types are correct. + + +Bulk Charge Data Models +----------------------- + +These models are used when interacting with the Bulk Charges API. + + +.. py:class:: BulkChargeItem(authorization: str, amount: int, reference: str) + + Represents a single bulk charge request. + + :param authorization: Authorization code obtained from a successful card transaction. + :type authorization: str + + :param amount: Amount to charge in the smallest currency unit (e.g. kobo for NGN). + :type amount: int + + :param reference: A unique reference used to identify the transaction. + :type reference: str + + +.. py:class:: BulkChargeListObject(charges: list[BulkChargeItem]) + + Container object used when initiating multiple bulk charges. + + :param charges: A list of bulk charge items. + :type charges: list[BulkChargeItem] From 6c423d8e6195d91fd3d4e2e8054a1a11a7097e07 Mon Sep 17 00:00:00 2001 From: oseovie Date: Sat, 14 Mar 2026 23:14:23 +0100 Subject: [PATCH 2/2] Add new sections to the documentation index --- docs/source/index.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/source/index.rst b/docs/source/index.rst index 8131d6e..b5306c5 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -89,6 +89,10 @@ If you want to download the sdist packages directly: :maxdepth: 1 :caption: Contents: + bulkcharge + convert + datatype + usage submodules paystackease.apis