infila-python 0.1.3

A library for file information and manipulation

infila

infila is a Python library designed for file operations. It provides various functions to retrieve information about files, including their size, creation and modification times, type, line count, and encoding.

Installation

You can install the infila library using pip:

pip install infila

What's new in version 0.1.3?

infila received the final update for its full release 0.1.3, which includes standard features:

• File size in specified unit via get_size
• File creation time via get_creation_time
• File modification time via get_modification_time
• File type via get_file_type
• Number of lines in the file via count_lines
• File encoding via detect_encoding
• File attributes via get_attributes
• Previous versions via get_previous_versions (temporarily unavailable)
• File security via get_security
• SHA-256 sum via get_sha256

Manual

Initialization

To begin, create an instance of infila by passing the file path as a parameter:

file = infila("path/to/your/file")

Methods

Below are the main methods available in the infila class:

get_size(unit='bytes')

Description: Returns the size of the file in the specified unit. Parameters:

• unit (str): Unit for file size. Options include 'bits', 'bytes', 'kilobytes', 'megabytes', 'gigabytes', and 'terabytes'.

Returns: File size in the specified unit. Example:

size_in_kb = file.get_size('kb')

get_creation_time()

Description: Retrieves the creation time of the file. Returns: Creation time as a formatted string. Example:

creation_time = file.get_creation_time()

get_modification_time()

Description: Retrieves the last modification time of the file. Returns: Modification time as a formatted string. Example:

modification_time = file.get_modification_time()

get_file_type()

Description: Returns the file extension type. Returns: File extension as a string. Example:

file_type = file.get_file_type()

count_lines()

Description: Counts the number of lines in the file (assumes UTF-8 encoding). Returns: Integer count of lines in the file. Example:

line_count = file.count_lines()

detect_encoding()

Description: Detects the encoding of the file using the chardet library. Returns: Detected file encoding as a string. Example:

encoding = file.detect_encoding()

get_attributes()

Description: Retrieves attributes of the file, such as readability, writability, executability, owner ID, and permissions. Returns: Dictionary containing file attributes. Example:

attributes = file.get_attributes()

get_previous_versions()

Description: Placeholder method to retrieve previous file versions. Currently unsupported. Returns: String stating that previous versions are not supported. Example:

previous_versions = file.get_previous_versions()

check_security()

Description: A convenience method to check file security attributes. Returns: Security-related attributes (similar to get_attributes). Example:

security_attributes = file.check_security()

get_sha256()

Description: Calculates and returns the SHA-256 checksum of the file for verification purposes. Returns: SHA-256 hash as a hexadecimal string. Example:

file_hash = file.get_sha256()

Example Usage

file = infila("example.txt")

# Get file size in kilobytes
print("Size (KB):", file.get_size('kb'))

# Get creation and modification times
print("Creation Time:", file.get_creation_time())
print("Modification Time:", file.get_modification_time())

# Get file type and line count
print("File Type:", file.get_file_type())
print("Line Count:", file.count_lines())

# Detect encoding
print("Encoding:", file.detect_encoding())

# Get file attributes
print("Attributes:", file.get_attributes())

# Calculate SHA-256 checksum
print("SHA-256 Checksum:", file.get_sha256())