insideapp-python-sdk 1.30.2__tar.gz

insideapp_python_sdk-1.30.2/.github/workflows/publish-to-pypi.yml

@@ -0,0 +1,82 @@
+name: Publish Python Package to PyPI
+
+on:
+  # Trigger on release creation
+  release:
+    types: [published]
+  
+  # Allow manual workflow dispatch
+  workflow_dispatch:
+    inputs:
+      target:
+        description: 'Publish target'
+        required: true
+        default: 'testpypi'
+        type: choice
+        options:
+        - testpypi
+        - pypi
+
+jobs:
+  build-and-publish:
+    name: Build and publish to PyPI
+    runs-on: ubuntu-latest
+    
+    permissions:
+      contents: read
+      id-token: write  # Required for trusted publishing
+    
+    steps:
+    - name: 🛎️ Checkout repository
+      uses: actions/checkout@v4
+      
+    - name: 🐍 Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.12'
+        
+    - name: 📦 Install build dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine pytest
+        
+    - name: 🧪 Run tests
+      run: |
+        python -m pytest tests/unit/ -v
+        
+    - name: 🔧 Build package
+      run: |
+        python -m build
+        
+    - name: 🔍 Check distribution
+      run: |
+        python -m twine check dist/*
+        
+    - name: 📋 List built packages
+      run: |
+        ls -la dist/
+        
+    # Publish to Test PyPI (on manual dispatch with testpypi target)
+    - name: 🧪 Publish to Test PyPI
+      if: github.event_name == 'workflow_dispatch' && github.event.inputs.target == 'testpypi'
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        repository-url: https://test.pypi.org/legacy/
+        password: ${{ secrets.TEST_PYPI_API_TOKEN }}
+        
+    # Publish to PyPI (on release or manual dispatch with pypi target)
+    - name: 🚀 Publish to PyPI
+      if: github.event_name == 'release' || (github.event_name == 'workflow_dispatch' && github.event.inputs.target == 'pypi')
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        password: ${{ secrets.PYPI_API_TOKEN }}
+        
+    - name: ✅ Success notification
+      if: success()
+      run: |
+        echo "🎉 Package successfully published!"
+        if [[ "${{ github.event_name }}" == "release" || "${{ github.event.inputs.target }}" == "pypi" ]]; then
+          echo "📦 Available at: https://pypi.org/project/insideapp-python-sdk/"
+        else
+          echo "📦 Available at: https://test.pypi.org/project/insideapp-python-sdk/"
+        fi

insideapp_python_sdk-1.30.2/.gitignore

@@ -0,0 +1,133 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# macOS
+.DS_Store
+
+# Windows
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+
+# Test credentials and sensitive files
+.test_credentials
+*.key
+*.pem
+.secrets

insideapp_python_sdk-1.30.2/CHANGELOG.md

@@ -0,0 +1,101 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.30.2] - 2024-02-24
+
+### Added
+- 🐍 **Initial Python SDK Release**: Complete 1:1 port from PHP SDK
+- 🌍 **Geographic Information Methods**: 
+  - `info_judete()` - Complete list of Romanian counties (42 counties)
+  - `info_localitati(judet)` - Localities for specific county code
+- 📋 **Complete Invoice Management**:
+  - Proforma invoices: `emite_proforma()`, `view_proforma()`, `factureaza_proforma()`
+  - Fiscal invoices: `emite_factura()`, `view_factura()`, `incaseaza_factura()`, `storneaza_factura()`
+  - Receipts: `emite_chitanta()`, `view_chitanta()`, `anuleaza_chitanta()`
+- 🏛️ **Full SPV/eFactura Integration**:
+  - `e_factura_emise()`, `e_factura_furnizori()` - Lists from Private Virtual Space
+  - `e_factura_upload_xml()`, `e_factura_upload_status()` - XML upload to ANAF
+  - `e_factura_descarca_emise()`, `e_factura_descarca_furnizori()` - PDF downloads
+- 👥 **Complete Data Management**:
+  - Clients: `clienti_lista()`, `clienti_adauga()`, `clienti_modifica()`, `clienti_sterge()`
+  - Products/Services: `produse_lista()`, `produse_adauga()`, `produse_modifica()`
+  - Bank Accounts: `conturi_bancare_lista()`, `conturi_bancare_adauga()`
+  - Series Configuration: `serie_lista()`, `serie_adauga()`, `serie_design()`
+- 🏢 **Reseller API Support**:
+  - Company management: `firma_lista()`, `firma_adauga()`, `firma_activeaza()`
+  - API credentials: `firma_api()`, `firma_api_reset()`
+  - eFactura settings: `e_factura_vizualizare_setari()`, `e_factura_modifica_setarile()`
+- 🔧 **Utility Functions**:
+  - `curs_valutar()` - Current exchange rates
+  - `info_cif(cif)` - CIF validation and company information
+- 📝 **Comprehensive Examples**: 
+  - Complete examples for all major functionalities
+  - Real API response structures documented
+  - Error handling demonstrations
+- 🧪 **Testing Infrastructure**:
+  - Unit tests with 100% method coverage
+  - Integration tests with real API validation
+  - Performance tests with response time monitoring  
+  - Mock fixtures for development
+
+### Technical
+- 🎯 **Python 3.8+ Support**: Modern Python type hints and async compatibility
+- 📦 **PyPI Ready**: Professional packaging with pyproject.toml
+- 🔒 **Structured Exception Handling**: Custom exception hierarchy
+  - `InsideAppAPIError`, `InsideAppAuthError`, `InsideAppTimeoutError`
+- 🚀 **Performance Optimized**: 
+  - Response times < 300ms for geographic methods
+  - HTTP session pooling and connection reuse
+  - Automatic timeout and retry handling
+- 📊 **Type Safety**: Full type hints for IDE support and code quality
+- 🛠️ **Development Tools**: Black formatting, flake8 linting, mypy type checking
+
+### Developer Experience  
+- 📖 **Complete Documentation**: README with examples and API coverage
+- 🎮 **Easy Testing**: Environment variable configuration
+- 🔄 **1:1 PHP Parity**: Identical functionality and response structures
+- 📱 **IDE Support**: IntelliSense and autocomplete for all methods
+- 🐛 **Comprehensive Error Messages**: Detailed error context and debugging info
+
+---
+
+## Migration from PHP SDK
+
+This Python SDK maintains complete compatibility with the PHP SDK:
+
+### Method Naming Convention
+- PHP `camelCase` → Python `snake_case`
+- Same parameters and response structures
+- Identical API endpoints and functionality
+
+### Examples
+- PHP: `$client->emiteFactura($data)` 
+- Python: `client.emite_factura(data)`
+
+### Error Handling
+- PHP: Generic exceptions
+- Python: Structured exception hierarchy with context
+
+### Performance
+- Similar response times to PHP SDK
+- Enhanced connection pooling in Python
+- Better async compatibility for future versions
+
+---
+
+## Links
+
+- [Repository GitHub](https://github.com/AninuApps/InsideApp-Python)
+- [PyPI Package](https://pypi.org/project/insideapp-python-sdk/)
+- [Documentation](https://doc.iapp.ro)
+- [Support](mailto:support@iapp.ro) 
+- [PHP SDK (Original)](https://github.com/AninuApps/InsideApp-PHP)
+
+[Unreleased]: https://github.com/AninuApps/InsideApp-Python/compare/v1.30.2...HEAD
+[1.30.2]: https://github.com/AninuApps/InsideApp-Python/releases/tag/v1.30.2

insideapp_python_sdk-1.30.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 InsideApp
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

insideapp_python_sdk-1.30.2/Makefile

@@ -0,0 +1,116 @@
+.PHONY: install test test-unit test-integration lint format type-check build clean help
+
+# Variables
+PYTHON := python3
+PIP := pip3
+PYTEST := pytest
+
+help: ## Show this help message
+	@echo "InsideApp Python SDK - Development Commands"
+	@echo "=========================================="
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'
+
+install: ## Install package in development mode
+	$(PIP) install -e .
+
+install-dev: ## Install with development dependencies
+	$(PIP) install -e .[dev]
+
+install-test: ## Install with test dependencies  
+	$(PIP) install -e .[test]
+
+test: ## Run all tests
+	$(PYTEST) tests/ -v
+
+test-unit: ## Run unit tests only
+	$(PYTEST) tests/unit/ -v
+
+test-integration: ## Run integration tests (requires credentials)
+	$(PYTEST) tests/integration/ -v -m integration
+
+test-coverage: ## Run tests with coverage report
+	$(PYTEST) tests/ --cov=insideapp --cov-report=html --cov-report=term
+
+test-verbose: ## Run tests with detailed output
+	$(PYTEST) tests/ -v -s --tb=long
+
+lint: ## Run flake8 linting
+	flake8 insideapp/ tests/ examples/
+
+format: ## Format code with black
+	black insideapp/ tests/ examples/
+
+format-check: ## Check code formatting
+	black --check insideapp/ tests/ examples/
+
+type-check: ## Run type checking with mypy
+	mypy insideapp/
+
+quality: lint format-check type-check ## Run all quality checks
+
+build: clean ## Build package for distribution
+	$(PYTHON) -m build
+
+build-check: ## Check built package
+	twine check dist/*
+
+upload-test: build ## Upload to Test PyPI
+	twine upload --repository testpypi dist/*
+
+upload-prod: build ## Upload to Production PyPI
+	twine upload dist/*
+
+clean: ## Clean build artifacts
+	rm -rf build/
+	rm -rf dist/
+	rm -rf *.egg-info/
+	rm -rf .pytest_cache/
+	rm -rf htmlcov/
+	find . -type d -name __pycache__ -delete
+	find . -type f -name "*.pyc" -delete
+
+docs: ## Generate documentation (if using sphinx)
+	cd docs && make html
+
+example-basic: ## Run basic examples
+	cd examples && $(PYTHON) curs_valutar.py
+	cd examples && $(PYTHON) info_judete.py
+
+example-invoice: ## Run invoice example
+	cd examples/FacturiFiscale && $(PYTHON) emite_factura_fiscala.py
+
+dev-setup: install-dev ## Complete development setup
+	pre-commit install
+
+release-check: quality test build-check ## Run all checks before release
+	@echo "✅ All checks passed! Ready for release."
+
+# Environment setup for integration tests
+test-env:
+	@echo "Set these environment variables for integration tests:"
+	@echo "export INSIDEAPP_TEST_USERNAME='your_username'"
+	@echo "export INSIDEAPP_TEST_PASSWORD='your_password'"
+	@echo "export INSIDEAPP_TEST_EMAIL='your@email.com'"
+	@echo "export INSIDEAPP_INTEGRATION_TESTS=true"
+
+# Quick development workflow
+dev: format lint test-unit ## Quick development workflow
+
+# Full CI/CD workflow  
+ci: quality test build-check ## Full CI/CD pipeline
+
+# Package information
+info: ## Show package information
+	@echo "Package: insideapp-python-sdk"
+	@echo "Version: 1.30.2"
+	@echo "Python: $(shell $(PYTHON) --version)"
+	@echo "Pytest: $(shell $(PYTEST) --version)"
+	@echo "Location: $(shell pwd)"
+
+# Virtual environment helpers
+venv: ## Create virtual environment
+	$(PYTHON) -m venv venv
+	@echo "Activate with: source venv/bin/activate"
+
+venv-activate: ## Show activation command
+	@echo "source venv/bin/activate"