delfinance-python-sdk 0.0.4__tar.gz → 0.6.0__tar.gz

delfinance_python_sdk-0.6.0/.Jenkinsfiles/master.groovy

@@ -0,0 +1,73 @@
+def pipelineRoll() {
+
+    stage('Checkout') {
+        withCredentials([usernamePassword(credentialsId: 'giteauth', usernameVariable: 'GIT_USERNAME', passwordVariable: 'GIT_PASSWORD')]) {
+            echo '---------------------GitHub Checkout started!----------------------'
+            sh '''
+              apt-get update
+              apt-get install -y git ca-certificates
+            '''
+            sh 'rm -rf ${GIT_REPO_NAME}'
+            sh 'git clone https://${GIT_USERNAME}:${GIT_PASSWORD}@git.delbank.srv.br/DelbankDev/${GIT_REPO_NAME}.git'
+
+            dir("${GIT_REPO_NAME}") {
+                sh 'git fetch --all --tags'
+                sh "git checkout ${env.BRANCH_NAME}"
+
+                def tagged = sh(
+                    script: 'git tag --points-at HEAD',
+                    returnStdout: true
+                ).trim()
+
+                // Remove o prefixo 'v' da tag para garantir compatibilidade com PEP 440
+                def tag = sh(
+                    script: 'git describe --tags --abbrev=0 2>/dev/null | sed "s/^v//" || echo 0.0.0',
+                    returnStdout: true
+                ).trim()
+
+                if (tagged) {
+                    env.VERSION = "${tag}"
+                } else {
+                    env.VERSION = "${tag}b${TAG}"
+                }
+            }
+            echo "---------------------GitHub Checkout finished! VERSION=${env.VERSION}---------------------"
+        }
+    }
+
+    stage('Generating Artifact') {
+        echo "Python artifact will be generated for version ${env.VERSION}"
+        sh 'rm -rf /dist'
+        sh 'pip install -U pip setuptools wheel'
+
+        dir("${GIT_REPO_NAME}") {
+            sh 'pip install -r requirements.txt'
+
+            // withEnv garante que a variável chegue corretamente ao setuptools_scm
+            // evitando que ele tente parsear a tag do git (que vem como 'origin/v0.6.0' e falha)
+            withEnv(["SETUPTOOLS_SCM_PRETEND_VERSION=${env.VERSION}"]) {
+                sh 'python setup.py sdist bdist_wheel'
+            }
+        }
+
+        sh 'pip install -U pip twine'
+    }
+
+    stage('Publish to Gitea') {
+        withCredentials([
+            string(credentialsId: 'gitea-package-publisher', variable: 'GITEA_TOKEN')
+        ]) {
+            dir("${GIT_REPO_NAME}") {
+                sh """
+                    export TWINE_USERNAME=__token__
+                    export TWINE_PASSWORD=${GITEA_TOKEN}
+
+                    twine upload --repository-url ${GITEA_PYPI_SOURCE} dist/delfinance_python_sdk-${env.VERSION}*
+                """
+            }
+        }
+    }
+
+}
+
+return this

delfinance_python_sdk-0.6.0/Dockerfile

@@ -0,0 +1,11 @@
+FROM python:3.7-slim
+
+WORKDIR /app
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+# Iniciar com debugpy ouvindo na porta 5678 e aguardando conexão
+CMD ["python", "-m", "debugpy", "--listen", "0.0.0.0:5678", "--wait-for-client", "main.py"]

{delfinance_python_sdk-0.0.4 → delfinance_python_sdk-0.6.0}/Jenkinsfile

@@ -1,5 +1,5 @@
 pipeline {
-    agent any  
+    agent any
 
     environment {
         REGISTRY = 'https://registry.digitalocean.com/delbank-1/internet-banking'
@@ -8,14 +8,18 @@ pipeline {
         PYPI_API_SOURCE = "https://upload.pypi.org/legacy/"
         GITEA_PYPI_SOURCE = 'https://git.delbank.srv.br/api/packages/DelbankDev/pypi'
     }
-        
+
     options {
         disableConcurrentBuilds()
         timestamps()
     }
 
-
     stages {
+
+        // ---------------------------------------------------------------
+        // Build por BRANCH (não tag): envia apenas para o Gitea
+        // Versão gerada: <ultima-tag>b<BUILD_ID>  ex: 0.6.0b47
+        // ---------------------------------------------------------------
         stage('Check Branch') {
             when {
                 not {
@@ -32,6 +36,7 @@ pipeline {
                 script {
                     env.SAFE_BRANCH = env.BRANCH_NAME.replaceAll('/', '_')
                     env.TARGET_FILE_PATH = ".Jenkinsfiles/${env.SAFE_BRANCH}.groovy"
+
                     if (fileExists(env.TARGET_FILE_PATH)) {
                         currentBuild.result = 'SUCCESS'
                         def myScript = load(env.TARGET_FILE_PATH)
@@ -44,11 +49,14 @@ pipeline {
             }
         }
 
+        // ---------------------------------------------------------------
+        // Build por TAG: envia para o Gitea E para o PyPI
+        // Versão gerada: <tag-sem-prefixo-v>  ex: 0.6.0  (PEP 440)
+        // ---------------------------------------------------------------
         stage('Publish to PyPI') {
             when {
                 buildingTag()
             }
-
             agent {
                 docker {
                     image 'python:3.12-slim'
@@ -56,17 +64,26 @@ pipeline {
                 }
             }
             steps {
-                script{
+                script {
+                    // pipelineRoll() do master.groovy já faz:
+                    //   - Checkout + cálculo de VERSION (sem prefixo 'v')
+                    //   - Build do artefato com SETUPTOOLS_SCM_PRETEND_VERSION
+                    //   - Publish no Gitea
                     def myScript = load(".Jenkinsfiles/master.groovy")
                     myScript.pipelineRoll()
+
+                    // Após o Gitea, envia também para o PyPI oficial
                     withCredentials([
-                     string(credentialsId: 'PYPI_API_KEY', variable: 'PYPI_API_KEY')
-                    ]){
-                        sh """
-                            export TWINE_USERNAME=__token__
-                            export TWINE_PASSWORD=$PYPI_API_KEY
-                            twine upload   --repository-url $PYPI_API_SOURCE dist/delfinance_python_sdk-$VERSION*
-                        """
+                        string(credentialsId: 'PYPI_API_KEY', variable: 'PYPI_API_KEY')
+                    ]) {
+                        dir("${GIT_REPO_NAME}") {
+                            sh """
+                                export TWINE_USERNAME=__token__
+                                export TWINE_PASSWORD=${PYPI_API_KEY}
+
+                                twine upload --repository-url ${PYPI_API_SOURCE} dist/delfinance_python_sdk-${env.VERSION}*
+                            """
+                        }
                     }
                 }
             }

{delfinance_python_sdk-0.0.4 → delfinance_python_sdk-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: delfinance-python-sdk
-Version: 0.0.4
+Version: 0.6.0
 Summary: SDK oficial da Delfinance para Python
 Home-page: https://github.com/delfinance/python-sdk
 Author: Delfinance Team
@@ -124,3 +124,15 @@ Para testes e desenvolvimento local:
 docker-compose up --build
 ```
 Isso iniciará uma aplicação Flask simples que executa um teste de integração e exibe o resultado em `http://localhost:8080`.
+
+## 8. Depuração
+
+O ambiente Docker está configurado para suportar depuração remota via `debugpy` na porta **5678**.
+
+### Usando VS Code
+
+1.  Inicie o ambiente com `docker-compose up --build`.
+2.  No VS Code, abra a aba "Run and Debug" (Ctrl+Shift+D).
+3.  Selecione a configuração **"Docker: Remote Attach"**.
+4.  Pressione **F5** para conectar o depurador ao container.
+5.  Defina breakpoints no código e acesse `http://localhost:8080` para disparar a execução.

{delfinance_python_sdk-0.0.4 → delfinance_python_sdk-0.6.0}/README.md

@@ -97,3 +97,15 @@ Para testes e desenvolvimento local:
 docker-compose up --build
 ```
 Isso iniciará uma aplicação Flask simples que executa um teste de integração e exibe o resultado em `http://localhost:8080`.
+
+## 8. Depuração
+
+O ambiente Docker está configurado para suportar depuração remota via `debugpy` na porta **5678**.
+
+### Usando VS Code
+
+1.  Inicie o ambiente com `docker-compose up --build`.
+2.  No VS Code, abra a aba "Run and Debug" (Ctrl+Shift+D).
+3.  Selecione a configuração **"Docker: Remote Attach"**.
+4.  Pressione **F5** para conectar o depurador ao container.
+5.  Defina breakpoints no código e acesse `http://localhost:8080` para disparar a execução.

{delfinance_python_sdk-0.0.4 → delfinance_python_sdk-0.6.0}/docker-compose.yml

@@ -8,5 +8,6 @@ services:
       - .:/app
     ports:
       - "8080:80"
+      - "5678:5678"
     tty: true
     stdin_open: true

{delfinance_python_sdk-0.0.4 → delfinance_python_sdk-0.6.0}/requirements.txt

@@ -1,4 +1,5 @@
 requests==2.31.0
 python-dotenv==0.21.1
 flask==2.2.5
-setuptools_scm==9.2.2
+debugpy==1.7.0
+setuptools_scm==7.1.0

delfinance_python_sdk-0.6.0/src/delfinance/charges/__init__.py

@@ -0,0 +1,11 @@
+from .requests import (
+    BillPaymentsRequest,
+    CreateChargeRequest,
+    ListChargesByPeriodRequest
+)
+from .responses import (
+    BillPaymentResponse,
+    ChargeResponse,
+    ValidatePaymentDetailsResponse
+)
+from .services import ChargesService

delfinance_python_sdk-0.6.0/src/delfinance/charges/interfaces/icharges_service.py

@@ -0,0 +1,45 @@
+from abc import ABC, abstractmethod
+from typing import List
+from io import BytesIO
+from ..requests.create_charge_request import CreateChargeRequest
+from ..requests.bill_payments_request import BillPaymentsRequest
+from ..requests.list_charges_by_period_request import ListChargesByPeriodRequest
+from ..responses.charge_response import ChargeResponse
+from ..responses.bill_payment_response import BillPaymentResponse
+from ..responses.validate_payment_details_response import ValidatePaymentDetailsResponse
+
+class IChargesService(ABC):
+    """
+    Interface IChargesService
+    """
+    @abstractmethod
+    def create_charge(self, request: CreateChargeRequest) -> ChargeResponse:
+        pass
+
+    @abstractmethod
+    def get_charge_by_id(self, correlation_id: str) -> ChargeResponse:
+        pass
+
+    @abstractmethod
+    def list_charges_by_period(self, request: ListChargesByPeriodRequest) -> List[ChargeResponse]:
+        pass
+
+    @abstractmethod
+    def download_charge_pdf(self, id: str) -> BytesIO:
+        pass
+
+    @abstractmethod
+    def update_charge(self, correlation_id: str, request: CreateChargeRequest):
+        pass
+
+    @abstractmethod
+    def void_charge(self, correlation_id: str):
+        pass
+
+    @abstractmethod
+    def validate_payment_details(self, barcode_or_digitable_line: str) -> ValidatePaymentDetailsResponse:
+        pass
+
+    @abstractmethod
+    def bill_payment(self, request: BillPaymentsRequest, idempotency_key: str) -> BillPaymentResponse:
+        pass

delfinance_python_sdk-0.6.0/src/delfinance/charges/requests/__init__.py

@@ -0,0 +1,3 @@
+from .create_charge_request import CreateChargeRequest
+from .bill_payments_request import BillPaymentsRequest
+from .list_charges_by_period_request import ListChargesByPeriodRequest

delfinance_python_sdk-0.6.0/src/delfinance/charges/requests/bill_payments_request.py

@@ -0,0 +1,38 @@
+from typing import Optional, Dict, Any
+
+class BillPaymentsRequest:
+    def __init__(
+        self,
+        bar_code: Optional[str] = None,
+        digitable_line: Optional[str] = None,
+        amount: Optional[float] = None,
+        pay_at: Optional[str] = None,
+        category: Optional[str] = None,
+        **kwargs
+    ):
+        self.bar_code = bar_code
+        self.digitable_line = digitable_line
+        self.amount = amount
+        self.pay_at = pay_at
+        self.category = category
+
+    def to_body_request(self) -> Dict[str, Any]:
+        data = {}
+
+        if self.bar_code is not None:
+            data['barCode'] = self.bar_code
+
+        if self.digitable_line is not None:
+            data['digitableLine'] = self.digitable_line
+
+        if self.amount is not None:
+            data['amount'] = self.amount
+
+        if self.pay_at is not None:
+            data['payAt'] = self.pay_at
+
+        if self.category is not None:
+            data['category'] = self.category
+
+        return data
+

delfinance_python_sdk-0.6.0/src/delfinance/charges/requests/create_charge_request.py

@@ -0,0 +1,89 @@
+from typing import Optional, Dict, Any
+
+class CreateChargeRequest:
+    def __init__(
+        self,
+        type: Optional[str] = None,
+        correlation_id: Optional[str] = None,
+        amount: Optional[float] = None,
+        rebate_amount: Optional[float] = None,
+        your_number: Optional[str] = None,
+        our_number: Optional[str] = None,
+        description: Optional[str] = None,
+        due_date: Optional[str] = None,
+        void_date: Optional[str] = None,
+        payer: Optional[Dict[str, Any]] = None,
+        final_beneficiary: Optional[Dict[str, Any]] = None,
+        discount: Optional[Dict[str, Any]] = None,
+        late_fine: Optional[Dict[str, Any]] = None,
+        late_payment: Optional[Dict[str, Any]] = None,
+        notify_payer_of_creation: Optional[bool] = None,
+        **kwargs
+    ):
+        self.type = type
+        self.correlation_id = correlation_id
+        self.amount = amount
+        self.rebate_amount = rebate_amount
+        self.your_number = your_number
+        self.our_number = our_number
+        self.description = description
+        self.due_date = due_date
+        self.void_date = void_date
+        self.payer = payer
+        self.final_beneficiary = final_beneficiary
+        self.discount = discount
+        self.late_fine = late_fine
+        self.late_payment = late_payment
+        self.notify_payer_of_creation = notify_payer_of_creation
+
+    def to_body_request(self) -> Dict[str, Any]:
+        data = {}
+
+        if self.type is not None:
+            data['type'] = self.type
+
+        if self.correlation_id is not None:
+            data['correlationId'] = self.correlation_id
+
+        if self.amount is not None:
+            data['amount'] = self.amount
+
+        if self.rebate_amount is not None:
+            data['rebateAmount'] = self.rebate_amount
+
+        if self.your_number is not None:
+            data['yourNumber'] = self.your_number
+
+        if self.our_number is not None:
+            data['ourNumber'] = self.our_number
+
+        if self.description is not None:
+            data['description'] = self.description
+
+        if self.due_date is not None:
+            data['dueDate'] = self.due_date
+
+        if self.void_date is not None:
+            data['voidDate'] = self.void_date
+
+        if self.payer is not None:
+            data['payer'] = self.payer
+
+        if self.final_beneficiary is not None:
+            data['finalBeneficiary'] = self.final_beneficiary
+
+        if self.discount is not None:
+            data['discount'] = self.discount
+
+        if self.late_fine is not None:
+            data['lateFine'] = self.late_fine
+
+        if self.late_payment is not None:
+            data['latePayment'] = self.late_payment
+
+        if self.notify_payer_of_creation is not None:
+            data['notifyPayerOfCreation'] = self.notify_payer_of_creation
+
+        return data
+
+

delfinance_python_sdk-0.6.0/src/delfinance/charges/requests/list_charges_by_period_request.py

@@ -0,0 +1,32 @@
+from typing import Optional, Dict, Any
+
+class ListChargesByPeriodRequest:
+    def __init__(
+            self,
+            page: Optional[int] = None,
+            limit: Optional[int] = None,
+            start_date: Optional[str] = None,
+            end_date: Optional[str] = None,
+            **kwargs
+    ):
+        self.page = page
+        self.limit = limit
+        self.start_date = start_date
+        self.end_date = end_date
+
+    def to_body_request(self) -> Dict[str, Any]:
+        data = {}
+
+        if self.page is not None:
+            data['page'] = self.page
+
+        if self.limit is not None:
+            data['limit'] = self.limit
+
+        if self.start_date is not None:
+            data['startDate'] = self.start_date
+
+        if self.end_date is not None:
+            data['endDate'] = self.end_date
+
+        return data

delfinance_python_sdk-0.6.0/src/delfinance/charges/responses/__init__.py

@@ -0,0 +1,3 @@
+from .bill_payment_response import BillPaymentResponse
+from .charge_response import ChargeResponse
+from .validate_payment_details_response import ValidatePaymentDetailsResponse

delfinance_python_sdk-0.6.0/src/delfinance/charges/responses/bill_payment_response.py

@@ -0,0 +1,28 @@
+from typing import Optional, Dict, Any
+
+class BillPaymentResponse:
+    def __init__(self, data: Dict[str, Any]):
+        self.id: Optional[str] = data.get('id')
+        self.bar_code: Optional[str] = data.get('barCode')
+        self.digitable_line: Optional[str] = data.get('digitableLine')
+        self.identifier_number: Optional[str] = data.get('identifierNumber')
+        self.bankslip_amount: Optional[float] = data.get('bankslipAmount')
+        self.status: Optional[str] = data.get('status')
+        self.due_date: Optional[str] = data.get('dueDate')
+        self.payment_deadline: Optional[str] = data.get('paymentDeadline')
+        self.total_to_be_charged_amount: Optional[float] = data.get('totalToBeChargedAmount')
+        self.fee_amount: Optional[float] = data.get('feeAmount')
+        self.fine_amount: Optional[float] = data.get('fineAmount')
+        self.discount_amount: Optional[float] = data.get('discountAmount')
+        self.rebate_amount: Optional[float] = data.get('rebateAmount')
+        self.paid_amount: Optional[float] = data.get('paidAmount')
+        self.created_at: Optional[str] = data.get('createdAt')
+        self.paid_at: Optional[str] = data.get('paidAt')
+        self.pay_at: Optional[str] = data.get('payAt')
+        self.beneficiary: Optional[Dict[str, Any]] = data.get('beneficiary')
+        self.payer: Optional[Dict[str, Any]] = data.get('payer')
+        self.bank_issuer: Optional[Dict[str, Any]] = data.get('bankIssuer')
+        self.payment_cancellation: Optional[Dict[str, Any]] = data.get('paymentCancellation')
+        self.calculation: Optional[Dict[str, Any]] = data.get('calculation')
+        self.category: Optional[Dict[str, Any]] = data.get('category')
+

delfinance_python_sdk-0.6.0/src/delfinance/charges/responses/charge_response.py

@@ -0,0 +1,32 @@
+from typing import Optional, Dict, Any, List
+
+class ChargeResponse:
+    def __init__(self, data: Dict[str, Any]):
+        self.bank_account: Optional[str] = data.get('bankAccount')
+        self.type: Optional[str] = data.get('type')
+        self.correlation_id: Optional[str] = data.get('correlationId')
+        self.amount: Optional[float] = data.get('amount')
+        self.rebate_amount: Optional[float] = data.get('rebateAmount')
+        self.wallet_number: Optional[str] = data.get('walletNumber')
+        self.your_number: Optional[str] = data.get('yourNumber')
+        self.our_number: Optional[str] = data.get('ourNumber')
+        self.description: Optional[str] = data.get('description')
+        self.due_date: Optional[str] = data.get('dueDate')
+        self.void_date: Optional[str] = data.get('voidDate')
+        self.qr_code: Optional[str] = data.get('qrCode')
+        self.qr_code_image_base64: Optional[str] = data.get('qrCodeImageBase64')
+        self.bar_code: Optional[str] = data.get('barCode')
+        self.digitable_line: Optional[str] = data.get('digitableLine')
+        self.payer: Optional[Dict[str, Any]] = data.get('payer')
+        self.beneficiary: Optional[Dict[str, Any]] = data.get('beneficiary')
+        self.final_beneficiary: Optional[Dict[str, Any]] = data.get('finalBeneficiary')
+        self.discount: Optional[Dict[str, Any]] = data.get('discount')
+        self.late_fine: Optional[Dict[str, Any]] = data.get('lateFine')
+        self.late_payment: Optional[Dict[str, Any]] = data.get('latePayment')
+        self.status: Optional[str] = data.get('status')
+        self.payments: Optional[List[Dict[str, Any]]] = data.get('payments')
+        self.additional_info: Optional[List[Dict[str, str]]] = data.get('additionalInfo')
+        self.notify_payer_of_creation: Optional[bool] = data.get('notifyPayerOfCreation')
+        self.updated_at: Optional[str] = data.get('updatedAt')
+        self.created_at: Optional[str] = data.get('createdAt')
+

delfinance_python_sdk-0.6.0/src/delfinance/charges/responses/validate_payment_details_response.py

@@ -0,0 +1,23 @@
+from typing import Optional, Dict, Any, List
+
+class ValidatePaymentDetailsResponse:
+    def __init__(self, data: Dict[str, Any]):
+        self.identifier_number: Optional[str] = data.get('identifierNumber')
+        self.type: Optional[str] = data.get('type')
+        self.is_paid: Optional[bool] = data.get('isPaid')
+        self.status: Optional[str] = data.get('status')
+        self.amount: Optional[float] = data.get('amount')
+        self.due_date: Optional[str] = data.get('dueDate')
+        self.payment_deadline: Optional[str] = data.get('paymentDeadline')
+        self.bar_code: Optional[str] = data.get('barCode')
+        self.digitable_line: Optional[str] = data.get('digitableLine')
+        self.is_allow_partial_payment: Optional[bool] = data.get('isAllowPartialPayment')
+        self.is_payment_blocked: Optional[bool] = data.get('isPaymentBlocked')
+        self.payment_calculation: Optional[Dict[str, Any]] = data.get('paymentCalculation')
+        self.payer: Optional[Dict[str, Any]] = data.get('payer')
+        self.overdue_payment_interest: Optional[Dict[str, Any]] = data.get('overduePaymentInterest')
+        self.overdue_payment_fine: Optional[Dict[str, Any]] = data.get('overduePaymentFine')
+        self.discounts: Optional[List[Dict[str, Any]]] = data.get('discounts')
+        self.beneficiary: Optional[Dict[str, Any]] = data.get('beneficiary')
+        self.issuer: Optional[Dict[str, Any]] = data.get('issuer')
+

delfinance_python_sdk-0.6.0/src/delfinance/charges/services/__init__.py

@@ -0,0 +1 @@
+from .charges_service import ChargesService