DataOpsHub 6.2.0__py3-none-any.whl

DataOpsHub/services/user_service.py

@@ -0,0 +1,213 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+User Service Module
+
+This module provides services for user management operations.
+"""
+
+# Import modules #
+#----------------#
+
+from datetime import datetime, timedelta
+from typing import Dict, List, Optional, Union
+
+from sqlalchemy.exc import SQLAlchemyError
+from sqlalchemy.orm import Session
+
+# Import project modules #
+#------------------------#
+
+from DataOpsHub.databases import database_handler
+from DataOpsHub.models.user import User, VitalSigns, LabResults, MedicationsHistory
+
+# Define classes #
+#----------------#
+
+class UserService:
+    """
+    Service class for handling user-related operations.
+    """
+
+    def __init__(self, session: Session):
+        """
+        Initialize the UserService.
+        
+        Args:
+            session (Session): SQLAlchemy database session
+        """
+        self.session = session
+        self.db_ops = database_handler(session)
+
+    def create_user(self, user_data: dict) -> dict:
+        """
+        Create a new user.
+        
+        Args:
+            user_data (dict): Dictionary containing user data
+            
+        Returns:
+            dict: Response containing status and message
+        """
+        try:
+            user = User(**user_data)
+            self.session.add(user)
+            self.session.commit()
+            return {"status": "success", "message": "User created successfully"}
+        except SQLAlchemyError as e:
+            self.session.rollback()
+            raise ValueError(f"Error creating user: {str(e)}")
+
+    def get_user(self, user_id: str) -> User:
+        """
+        Get a user by ID.
+        
+        Args:
+            user_id (str): User ID
+            
+        Returns:
+            User: User object
+        """
+        user = self.session.query(User).filter(User.user_id == user_id).first()
+        if not user:
+            raise ValueError(f"User with ID {user_id} not found")
+        return user
+
+    def update_user(self, user_id: str, user_data: dict) -> dict:
+        """
+        Update a user.
+        
+        Args:
+            user_id (str): User ID
+            user_data (dict): Dictionary containing updated user data
+            
+        Returns:
+            dict: Response containing status and message
+        """
+        try:
+            user = self.get_user(user_id)
+            for key, value in user_data.items():
+                setattr(user, key, value)
+            self.session.commit()
+            return {"status": "success", "message": "User updated successfully"}
+        except SQLAlchemyError as e:
+            self.session.rollback()
+            raise ValueError(f"Error updating user: {str(e)}")
+
+    def delete_user(self, user_id: str) -> dict:
+        """
+        Delete a user.
+        
+        Args:
+            user_id (str): User ID
+            
+        Returns:
+            dict: Response containing status and message
+        """
+        try:
+            user = self.get_user(user_id)
+            self.session.delete(user)
+            self.session.commit()
+            return {
+                "status": "success",
+                "message": "User deleted successfully",
+            }
+        except SQLAlchemyError as e:
+            self.session.rollback()
+            raise ValueError(f"Error deleting user: {str(e)}")
+
+    def get_all_users(self) -> list:
+        """
+        Get all users.
+        
+        Returns:
+            list: List of User objects
+        """
+        return self.session.query(User).all()
+
+    def get_user_with_related_data(self, user_id: str) -> Dict:
+        """
+        Get a user's complete record including related data.
+
+        Parameters
+        ----------
+        user_id : str
+            The ID of the user to retrieve.
+
+        Returns
+        -------
+        dict
+            Complete user record including related data.
+
+        Raises
+        ------
+        ValueError
+            If no user with the specified ID exists.
+        """
+        # Get base user data
+        user = self.session.query(User).filter(User.user_id == user_id).first()
+        if not user:
+            raise ValueError(f"User with ID {user_id} not found")
+
+        # Get related data
+        vital_signs = self.session.query(VitalSigns).filter(VitalSigns.user_id == user_id).all()
+        lab_results = self.session.query(LabResults).filter(LabResults.user_id == user_id).all()
+        medications = self.session.query(MedicationsHistory).filter(MedicationsHistory.user_id == user_id).all()
+
+        return {
+            "user": user,
+            "vital_signs": vital_signs,
+            "lab_results": lab_results,
+            "medications": medications
+        }
+
+    def get_users(self, filters: Optional[Dict] = None) -> List[Dict]:
+        """
+        Get users with optional filtering.
+
+        Parameters
+        ----------
+        filters : dict, optional
+            Dictionary of filters to apply to the query.
+
+        Returns
+        -------
+        list
+            List of user records matching the filters.
+        """
+        # Get filtered users
+        users = self.session.query(User).filter_by(**(filters or {})).all()
+        return [self.get_user_with_related_data(user.user_id) for user in users]
+
+    def get_user_measurements(self, user_id: str, days: int = 30) -> Dict:
+        """
+        Get a user's measurements over time.
+
+        Parameters
+        ----------
+        user_id : str
+            The ID of the user to retrieve measurements for.
+        days : int, optional
+            Number of days to look back, defaults to 30.
+
+        Returns
+        -------
+        dict
+            Dictionary containing measurement data.
+        """
+        # Get measurement data
+        vital_signs = self.session.query(VitalSigns).filter(
+            VitalSigns.user_id == user_id,
+            VitalSigns.timestamp >= datetime.now() - timedelta(days=days)
+        ).all()
+        
+        lab_results = self.session.query(LabResults).filter(
+            LabResults.user_id == user_id,
+            LabResults.timestamp >= datetime.now() - timedelta(days=days)
+        ).all()
+
+        return {
+            "vital_signs": vital_signs,
+            "lab_results": lab_results
+        } 

dataopshub-6.2.0.dist-info/METADATA

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: DataOpsHub
+Version: 6.2.0
+Summary: A Python toolkit for streamlined data operations and database management
+Home-page: https://github.com/EusDancerDev/DataOpsHub
+Author: Jon Ander Gabantxo
+Author-email: jagabantxo@gmail.com
+License: MIT
+Project-URL: Bug Reports, https://github.com/EusDancerDev/DataOpsHub/issues
+Project-URL: Source, https://github.com/EusDancerDev/DataOpsHub
+Project-URL: Documentation, https://github.com/EusDancerDev/DataOpsHub#readme
+Keywords: database,data operations,security,web automation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Database
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: sqlalchemy>=2.0.0
+Requires-Dist: pandas>=1.3.0
+Requires-Dist: filewise>=3.7.0
+Requires-Dist: pygenutils>=15.10.0
+Requires-Dist: paramlib>=3.4.0
+Requires-Dist: email_validator>=2.0.0
+Requires-Dist: selenium>=4.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: flake8>=5.0.0; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# DataOpsHub
+
+**DataOpsHub** is a comprehensive Python package designed to streamline data operations, database management, and web automation tasks. It provides a robust framework for handling data entry, user management, and secure database operations.
+
+## Features
+
+- **Database Management**:
+  - Advanced database operations and data handling
+  - Efficient data upload and retrieval mechanisms
+  - Comprehensive database connection management
+- **User Management**:
+  - Complete user service implementation
+  - User model with extensive functionality
+  - Secure user authentication and authorisation
+- **Data Entry Forms**:
+  - Form validation and processing
+  - Custom form implementations
+  - Data integrity checks
+- **Security Features**:
+  - Automated password management
+  - Security configuration management
+  - Custom security exceptions handling
+- **Web Automation**:
+  - Browser automation support (Firefox and Chrome)
+  - Web driver setup and configuration
+- **Constants and Configuration**:
+  - Centralised error message management
+  - Table mapping configurations
+  - System-wide constants
+
+---
+
+## Installation Guide
+
+### Dependency Notice
+
+Before installing, please ensure the following dependencies are available on your system:
+
+- **Required Third-Party Libraries**:
+  - SQLAlchemy
+  - Flask
+  - Selenium
+  - PyYAML
+  - cryptography
+
+  You can install them via pip:
+  
+  ```bash
+  pip install SQLAlchemy Flask selenium PyYAML cryptography
+  ```
+
+  Or via Anaconda (recommended channel: `conda-forge`):
+
+  ```bash
+  conda install -c conda-forge sqlalchemy flask selenium pyyaml cryptography
+  ```
+
+### Installation Instructions
+
+Install the package using pip:
+
+```bash
+pip install dataopshub
+```
+
+### Package Updates
+
+To stay up-to-date with the latest version of this package, simply run:
+
+```bash
+pip install --upgrade dataopshub
+```
+
+---
+
+## Project Structure
+
+The package is organised into several sub-packages:
+
+- **databases/**: Core database operations and management
+  - `database_handler.py`: Main database operations and connection management
+  - `upload_data.py`: Data upload utilities
+
+- **models/**: Data models and base classes
+  - `user.py`: User model implementation
+  - `base.py`: Base model definitions
+
+- **services/**: Business logic and service implementations
+  - `user_service.py`: User management services
+
+- **data_entry_forms/**: Form handling and validation
+  - `forms/`: Custom form implementations
+  - `validators/`: Form validation utilities
+
+- **security/**: Security-related functionality
+  - `automated_passwords.py`: Password management
+  - `config.py`: Security configuration
+  - `exceptions.py`: Security-related exceptions
+
+- **web_automation/**: Web automation tools
+  - `webdriver_Firefox-Chrome_setup_test.py`: Browser automation setup
+
+- **constants/**: System-wide constants and configurations
+  - `error_messages.py`: Error message definitions
+  - `table_mappings.py`: Database table mappings
+
+For detailed version history and changes, please refer to:
+
+- `CHANGELOG.md`: Comprehensive list of changes for each version
+- `VERSIONING.md`: Versioning policy and guidelines

dataopshub-6.2.0.dist-info/RECORD

@@ -0,0 +1,25 @@
+DataOpsHub/__init__.py,sha256=rjtq2cQSQ9_ZfektweqodTa2Cn5GF-X4cG36p4ZckgQ,1241
+DataOpsHub/constants/__init__.py,sha256=LAqDpp3nUzb30qBXFoVbobU2aaOTl48DK23mn45gba0,761
+DataOpsHub/constants/error_messages.py,sha256=B0BOEeAqVIN2VIQQY2Z1pRKKLM2p3RB1-ozTYyDWO0A,2092
+DataOpsHub/constants/table_mappings.py,sha256=oGq7sz-5GG9c8Nk25i6WiLm_Ixi8ewJo_T4GYTa49LQ,265
+DataOpsHub/data_entry_forms/__init__.py,sha256=C2DbLx8kdF0cY5yD6r4ajvNuezTtGo-6JZl5x4gBH9g,879
+DataOpsHub/data_entry_forms/forms/__init__.py,sha256=B88NgwVtwN-JQmTSuJb-vv_XYJh51mAFThOFxAfN06U,287
+DataOpsHub/data_entry_forms/forms/forms.py,sha256=qb72pUptuZU6i3GEydd5xKg41nikBew005O6VjaFYRU,743
+DataOpsHub/data_entry_forms/validators/__init__.py,sha256=UDZ3ZQ7GSR-VcXy2nOmgcnPrbyQpIdH23VM_YBuMx8s,1427
+DataOpsHub/data_entry_forms/validators/form_field_validations.py,sha256=ARYacrxO8LN740kVyBbCU_pxZY0-Yg2biEZy6Rnfrbk,15633
+DataOpsHub/databases/__init__.py,sha256=92YFsiZYUZgAwdcR1LTEK1kFOYzqxScfigl0fwv5KAI,222
+DataOpsHub/databases/database_handler.py,sha256=03sHP1SISoHimvcLMMaccY_SW6Ajtfz1hXU0hHwlU7c,29469
+DataOpsHub/databases/upload_data.py,sha256=Gr3ZLlCzxtt0evyT3TrLFYfWWmVMsMOswofCE3gcsO4,3651
+DataOpsHub/models/__init__.py,sha256=UCejRX_HT33IYKXcor3Br8q9UhJbQKZwMtS8SAKj7HI,339
+DataOpsHub/models/base.py,sha256=5g7ANPLBW5UEoEs6mzKMbq_SUyorg-c0aEiZwXl9DA4,2273
+DataOpsHub/models/user.py,sha256=02VUSN0tS9GdxPfrlh0iwGEDETiQDTZhjI5u0LlSsT8,3292
+DataOpsHub/security/__init__.py,sha256=tJ2gUuo_inog4nb7HKZPMsToeZ55igyPVdbUfUnhIAc,307
+DataOpsHub/security/automated_passwords.py,sha256=RHoB0rGsl3zm4aHSHEz0cDGMzxJ3cJtFng2xP017CSk,1437
+DataOpsHub/security/config.py,sha256=2Mk3aTfrlsyA8yj6_Yrt1TLdiYcRNiV-HyOaD3kT9mY,3215
+DataOpsHub/security/exceptions.py,sha256=zsKMfiR7pgAfiIygyTq4zffmSTcSy6OCNAgUzVFjRwc,1078
+DataOpsHub/services/__init__.py,sha256=3h6TNNgJR--XYGgKLYVwDWqiVmIKZktaVm8VusNFckI,303
+DataOpsHub/services/user_service.py,sha256=GaL9t5_VzhUwz4xXOL4cpwJzZbM4X_QuNisf9-Rw_o0,6206
+dataopshub-6.2.0.dist-info/METADATA,sha256=NB4AggHsq8oYbqzcQ8iMp1CuPvl0HJderZ0jvbE82Pw,4936
+dataopshub-6.2.0.dist-info/WHEEL,sha256=wXxTzcEDnjrTwFYjLPcsW_7_XihufBwmpiBeiXNBGEA,91
+dataopshub-6.2.0.dist-info/top_level.txt,sha256=ldWxLwGkBVgibVhoT1TqhVK-BT2xmFcw0jqiUNbJhHg,11
+dataopshub-6.2.0.dist-info/RECORD,,

dataopshub-6.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.1.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

dataopshub-6.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+DataOpsHub