cloudnoteslib 0.1.0__py3-none-any.whl

cloudnoteslib/security/__init__.py

@@ -0,0 +1,12 @@
+"""
+cloudnoteslib.security — Note Security Tools.
+
+Exports:
+    NoteEncryptor: AES encryption/decryption for sensitive notes.
+    ContentSanitizer: XSS prevention and HTML sanitization.
+"""
+
+from .encryptor import NoteEncryptor
+from .sanitizer import ContentSanitizer
+
+__all__ = ["NoteEncryptor", "ContentSanitizer"]

cloudnoteslib/security/encryptor.py

@@ -0,0 +1,81 @@
+"""
+cloudnoteslib.security.encryptor — Note Encryption Engine.
+
+Provides simple AES-inspired (using Fernet) encryption for securing
+highly sensitive note content before database storage.
+"""
+
+import base64
+try:
+    from cryptography.fernet import Fernet
+    from cryptography.hazmat.primitives import hashes
+    from cryptography.hazmat.primitives.kdf.pbkdf2 import PBKDF2HMAC
+    CRYPTO_AVAILABLE = True
+except ImportError:
+    CRYPTO_AVAILABLE = False
+
+
+class NoteEncryptor:
+    """
+    Encrypts and decrypts note content.
+    
+    Uses Fernet (symmetric encryption verified with a MAC).
+    Keys are derived from a password using PBKDF2.
+    """
+    
+    def __init__(self, salt: bytes = b'cloudnotes_salt_123'):
+        if not CRYPTO_AVAILABLE:
+            raise ImportError(
+                "cryptography package is required for NoteEncryptor. "
+                "Install with: pip install cryptography"
+            )
+        self._salt = salt
+        
+    def _get_key(self, password: str) -> bytes:
+        """Derive a secure encryption key from a password."""
+        kdf = PBKDF2HMAC(
+            algorithm=hashes.SHA256(),
+            length=32,
+            salt=self._salt,
+            iterations=100000,
+        )
+        key = base64.urlsafe_b64encode(kdf.derive(password.encode()))
+        return key
+
+    def encrypt(self, plain_text: str, password: str) -> str:
+        """
+        Encrypt plain text using the password.
+        
+        Args:
+            plain_text: Text to encrypt.
+            password: Password to derive key from.
+            
+        Returns:
+            Encrypted URL-safe base64 string.
+        """
+        key = self._get_key(password)
+        f = Fernet(key)
+        encrypted = f.encrypt(plain_text.encode('utf-8'))
+        return encrypted.decode('utf-8')
+        
+    def decrypt(self, encrypted_text: str, password: str) -> str:
+        """
+        Decrypt text using the password.
+        
+        Args:
+            encrypted_text: Encrypted string.
+            password: Password to derive key from.
+            
+        Returns:
+            Decrypted plain text.
+            
+        Raises:
+            ValueError: If decryption fails (wrong password or corrupted data).
+        """
+        try:
+            key = self._get_key(password)
+            f = Fernet(key)
+            decrypted = f.decrypt(encrypted_text.encode('utf-8'))
+            return decrypted.decode('utf-8')
+        except Exception as e:
+            raise ValueError(f"Decryption failed: {str(e)}")

cloudnoteslib/security/sanitizer.py

@@ -0,0 +1,56 @@
+"""
+cloudnoteslib.security.sanitizer — Content Sanitizer.
+
+Prevents XSS (Cross-Site Scripting) by stripping malicious tags
+from HTML/Rich text content.
+"""
+
+import re
+
+
+class ContentSanitizer:
+    """
+    Sanitizes note content to prevent XSS attacks.
+    """
+    
+    # Tags that are always stripped, along with their contents
+    DANGEROUS_TAGS = ['script', 'style', 'iframe', 'object', 'embed', 'applet']
+    
+    def sanitize(self, content: str) -> str:
+        """
+        Remove dangerous HTML tags and attributes from content.
+        
+        Args:
+            content: Raw user input.
+            
+        Returns:
+            Sanitized content safe for rendering.
+        """
+        if not content:
+            return ""
+            
+        clean = content
+        
+        # 1. Remove dangerous tags and their contents entirely
+        for tag in self.DANGEROUS_TAGS:
+            pattern = f"<{tag}[^>]*>.*?</{tag}>"
+            clean = re.sub(pattern, "", clean, flags=re.IGNORECASE | re.DOTALL)
+            
+        # 2. Remove inline event handlers (onclick, onload, etc)
+        # Matches any attribute starting with 'on' followed by =
+        clean = re.sub(
+            r'(<[^>]+)(\son[a-z]+\s*=\s*(["\']).*?\3)([^>]*>)', 
+            r'\1\4', 
+            clean, 
+            flags=re.IGNORECASE
+        )
+        
+        # 3. Remove javascript: URIs in href or src attributes
+        clean = re.sub(
+            r'((?:href|src)\s*=\s*["\'])\s*javascript:[^"\']*["\']', 
+            r'\1#"', 
+            clean, 
+            flags=re.IGNORECASE
+        )
+        
+        return clean

cloudnoteslib-0.1.0.dist-info/METADATA

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: cloudnoteslib
+Version: 0.1.0
+Summary: A reusable Object-Oriented generic library for note processing, analysis, and security.
+Home-page: https://github.com/Kavyavegunta04/Cloudnote
+Author: Kavya
+Author-email: Kavya <kavyavegunta27@gmail.com>
+Project-URL: Homepage, https://github.com/Kavyavegunta04/Cloudnote
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: cryptography>=41.0.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# cloudnoteslib
+
+A comprehensive, reusable Python Object-Oriented Programming (OOP) library designed for text note processing, content analysis, security, and exports.
+
+## Features & OOP Principles
+- **Encapsulation:** Strongly typed `Note` and `Tag` models with data validation via `@property`.
+- **Abstraction:** Abstract `NoteProcessor` base class guaranteeing unified interfaces.
+- **Inheritance & Polymorphism:** `MarkdownProcessor`, `PlainTextProcessor`, and `RichTextProcessor` implementations sharing the same contract.
+- **Design Patterns:**
+  - **Facade Pattern:** `CloudNotesClient` acts as the single point of entry.
+  - **Strategy Pattern:** Interchangeable search algorithms (`search.py`).
+  - **Template Method Pattern:** Processors share generic steps while overriding specific details.
+  - **Singleton Pattern:** Global configuration management.
+
+## Installation
+```bash
+pip install cloudnoteslib
+```

cloudnoteslib-0.1.0.dist-info/RECORD

@@ -0,0 +1,27 @@
+cloudnoteslib/__init__.py,sha256=BI7teGxZtwtvwHsX7zj32YQ_LCv_lOgYIo4Rv70t77k,4845
+cloudnoteslib/config.py,sha256=PwdMoQQYsCPmlQeokcgYAhIH_9UuawEj_Cnbq5EkFMg,739
+cloudnoteslib/exceptions.py,sha256=tzYoc0dIcJqnSLbAXJkDj8p4eA0zhXUB-CyJZOgFFgw,518
+cloudnoteslib/analyzers/__init__.py,sha256=R2_eWlhZga4bKHvyd4_2NdVOwf0KqcoKV2UsuxNoESo,418
+cloudnoteslib/analyzers/content_analyzer.py,sha256=2x79GKkxrian3dO8wuM0h5aWXTBDGptWe6_u_JklQpw,6604
+cloudnoteslib/analyzers/search.py,sha256=f-NWgXW3-KACGv1OJlCB26VWTYGaeAe0YUxpomOImkY,4331
+cloudnoteslib/analyzers/statistics.py,sha256=RJwW5I8MZm2wlW_EtS6VTIYzqbwAH0SFz5O20e1ZBrI,2847
+cloudnoteslib/exporters/__init__.py,sha256=Zytx7kmSeJb-FmE2XIsStcdaaDcxI6fO6xGoHw8t8Lw,306
+cloudnoteslib/exporters/base.py,sha256=ezVSVArNqfY0QRQZEhJE4-VhylZ3SxGLM0JTWZTavKY,765
+cloudnoteslib/exporters/json_exporter.py,sha256=ARErXtoO8e4Op6lj8rWxjZmyoox_ZxkiDEFdLhs2-Gg,486
+cloudnoteslib/exporters/markdown_exporter.py,sha256=R7u-fxLv8SOZ-lDbo8KjQuQF82cgI77zRTimbV290hU,850
+cloudnoteslib/models/__init__.py,sha256=AGCPwqAXvycac6i1IhN1Q1Y59Y2WOZWICtW9_NxYtMY,588
+cloudnoteslib/models/note.py,sha256=TlvZZI1BcVrp9VUDWkH2-vJZhwyYAL2b09eQjpIsNSo,10916
+cloudnoteslib/models/note_collection.py,sha256=u-9FoBwHh-_zXDNRGoQcCRur5oTO3pMCmCgVj62JCEo,7521
+cloudnoteslib/models/tag.py,sha256=R0rx6jmUkNohoMb8DsII7B9Ub8Xk7jvyzg0YHFq__HQ,3705
+cloudnoteslib/processors/__init__.py,sha256=Rpm76ePqP8q9DBHCQU7c4ctB1-kVh0LG2Q_uvl8x_oE,1148
+cloudnoteslib/processors/base.py,sha256=YNYW8IYpMp6QNGbJtrhy3reZkEUExHcvw2Pl20tU0ho,5078
+cloudnoteslib/processors/markdown_processor.py,sha256=V02L8cyR_QiLrSMwNbalZ52a_GFJiVoNsu5AxMKWywY,5106
+cloudnoteslib/processors/plaintext_processor.py,sha256=B97gj5coKT26u7E7IT2QorU5Rw741p0dSzEUmXY2aVE,2979
+cloudnoteslib/processors/richtext_processor.py,sha256=Cn4iMS3xd61cSVJErKCUlJadou_ZP5YrGi2hBCObFdo,3530
+cloudnoteslib/security/__init__.py,sha256=Yy1lk1Ll_ROAqYNqE24kavtVn02hPWX2xbDPrrcUAwY,319
+cloudnoteslib/security/encryptor.py,sha256=nwu5YZm9rfEIdjCObBY-Jl5xngCA3hBtAMjkajvAldE,2521
+cloudnoteslib/security/sanitizer.py,sha256=D-45nL1AfD6XRHMEFo6oToOIwx3geJRDLYZFFgXfOgg,1608
+cloudnoteslib-0.1.0.dist-info/METADATA,sha256=pNVf9tgZNRgNCtg29X2-aPQSsX69V_xcl6-xLuHkTxo,1642
+cloudnoteslib-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+cloudnoteslib-0.1.0.dist-info/top_level.txt,sha256=az-9qrV_u-_rIoUsISe5mQAOlK9pMGddgsS8Jex4zro,14
+cloudnoteslib-0.1.0.dist-info/RECORD,,

cloudnoteslib-0.1.0.dist-info/WHEEL

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

cloudnoteslib-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+cloudnoteslib