Browse Components - Code Extractor

function log_event

Creates and persists an audit trail event in a Neo4j graph database, linking it to users, resources, and an audit trail node with comprehensive event metadata.

File: /tf/active/vicechatdev/CDocs/utils/audit_trail.py | Lines: 326-422

audit logging neo4j graph-database event-tracking

function ensure_dir

Creates a directory and all necessary parent directories if they don't already exist, returning a boolean indicating success or failure.

File: /tf/active/vicechatdev/CDocs/utils/__init__.py | Lines: 244-260

filesystem directory file-operations utility error-handling

function truncate_text

Truncates a text string to a specified maximum length and appends a suffix if truncation occurs.

File: /tf/active/vicechatdev/CDocs/utils/__init__.py | Lines: 228-242

text-processing string-manipulation truncation text-formatting utility

function from_json

Parses a JSON string into a Python object, with error handling that logs parsing failures and returns None on error.

File: /tf/active/vicechatdev/CDocs/utils/__init__.py | Lines: 212-226

json parsing deserialization error-handling logging

function to_json

Converts a Python object to a formatted JSON string with 2-space indentation, using a safe serialization helper function.

File: /tf/active/vicechatdev/CDocs/utils/__init__.py | Lines: 200-210

json serialization conversion formatting data-export

function safe_json_serialize

Recursively converts Python objects into JSON-serializable formats, with special handling for datetime objects and objects with to_dict() methods.

File: /tf/active/vicechatdev/CDocs/utils/__init__.py | Lines: 180-198

json serialization datetime recursive data-conversion

function human_readable_size

Converts a byte size value into a human-readable string format with appropriate unit suffixes (B, KB, MB, GB, TB).

File: /tf/active/vicechatdev/CDocs/utils/__init__.py | Lines: 159-178

utility formatting file-size bytes-conversion human-readable

function get_mime_type

Determines the MIME type of a file based on its file extension by mapping common extensions to their corresponding MIME type strings.

File: /tf/active/vicechatdev/CDocs/utils/__init__.py | Lines: 135-157

mime-type file-extension content-type file-handling document-processing

function is_valid_document_file

Validates whether a given filename has an extension corresponding to a supported document type by checking against a predefined list of valid document extensions.

File: /tf/active/vicechatdev/CDocs/utils/__init__.py | Lines: 121-133

validation file-validation document-processing file-extension document-types

function get_file_extension

Extracts and returns the file extension from a given filename string, normalized to lowercase without the leading dot.

File: /tf/active/vicechatdev/CDocs/utils/__init__.py | Lines: 106-119

file-handling string-manipulation utility file-extension filename-parsing

function sanitize_filename

Sanitizes a filename string by replacing invalid filesystem characters with underscores and ensuring a valid output.

File: /tf/active/vicechatdev/CDocs/utils/__init__.py | Lines: 87-104

filename sanitization validation filesystem string-processing

function parse_datetime

Parses a datetime string in YYYY-MM-DD HH:MM:SS format into a Python datetime object, returning None if parsing fails.

File: /tf/active/vicechatdev/CDocs/utils/__init__.py | Lines: 68-85

datetime parsing string-conversion date-handling error-handling

function parse_date

Parses a date string in YYYY-MM-DD format into a datetime object, returning None if parsing fails or input is empty.

File: /tf/active/vicechatdev/CDocs/utils/__init__.py | Lines: 49-66

date-parsing datetime string-conversion error-handling validation

function format_datetime

Formats a datetime object into a standardized string representation for display purposes, returning an empty string if the input is None.

File: /tf/active/vicechatdev/CDocs/utils/__init__.py | Lines: 35-47

datetime formatting display utility string-conversion

function format_datetime_v1

Converts an ISO format datetime string into a human-readable UTC datetime string formatted as 'YYYY-MM-DD HH:MM:SS UTC'.

File: /tf/active/vicechatdev/SPFCsync/dry_run_test.py | Lines: 30-38

datetime formatting string-manipulation ISO-format UTC

function format_date

Formats a datetime object into a string representation according to a predefined DATE_FORMAT constant, returning an empty string if the input is None.

File: /tf/active/vicechatdev/CDocs/utils/__init__.py | Lines: 21-33

date-formatting datetime string-conversion display utility

function check_document_permissions_on_startup

Validates and fixes document permission issues during application startup, prioritizing active documents (DRAFT, IN_REVIEW, IN_APPROVAL) to ensure proper sharing permissions are configured.

File: /tf/active/vicechatdev/CDocs/utils/sharing_validator.py | Lines: 172-227

startup initialization document-permissions validation permissions

function check_document_permissions_on_startup_v1

Performs a system-wide startup check to verify and update document permissions for all documents in the system, ensuring permissions align with document status.

File: /tf/active/vicechatdev/CDocs/controllers/permission_startup_check.py | Lines: 299-447

startup permissions document-management audit system-initialization

function validate_and_fix_document_permissions

Validates and optionally fixes document sharing permissions for controlled documents in a Neo4j database, processing documents in configurable batches with detailed progress tracking and error handling.

File: /tf/active/vicechatdev/CDocs/utils/sharing_validator.py | Lines: 22-170

validation permissions document-management batch-processing neo4j

class VersionComparisonService

A service class that compares two versions of a document using LLM-based analysis, implementing smart segmentation and chunking for handling large documents efficiently.

File: /tf/active/vicechatdev/CDocs/utils/version_comparison.py | Lines: 14-485

document-comparison version-control llm openai text-analysis