OXIESEC PANEL

Name	Size	Modified	Perms
📁 ..	-	10/09/2024 06:13:32 AM	rwxr-xr-x
📄 advanced_search.rst	2.72 KB	10/09/2024 06:13:32 AM	rw-r--r--
📄 cli.rst	3.61 KB	10/09/2024 06:13:32 AM	rw-r--r--
📄 getstarted.rst	1.7 KB	10/09/2024 06:13:32 AM	rw-r--r--
📄 handling_result.rst	595 bytes	10/09/2024 06:13:32 AM	rw-r--r--
📄 miscellaneous.rst	1.98 KB	10/09/2024 06:13:32 AM	rw-r--r--
📄 support.rst	6.89 KB	10/09/2024 06:13:32 AM	rw-r--r--

Editing: miscellaneous.rst

==============
 Miscellaneous
==============

Convert to str
--------------

Any ``CharsetMatch`` object can be transformed to exploitable ``str`` variable.

my_byte_str = 'Bсеки човек има право на образование.'.encode('cp1251')

# Assign return value so we can fully exploit result
    result = from_bytes(
        my_byte_str
    ).best()

# This should print 'Bсеки човек има право на образование.'
    print(str(result))

Logging
-------

Prior to the version 2.0.11 you may encounter some unexpected logs in your streams.
Something along the line of:

It is most likely because you altered the root getLogger instance. The package has its own logic behind logging and why
it is useful. See https://docs.python.org/3/howto/logging.html to learn the basics.

If you are looking to silence and/or reduce drastically the amount of logs, please upgrade to the latest version
available for `charset-normalizer` using your package manager or by `pip install charset-normalizer -U`.

The latest version will no longer produce any entry greater than `DEBUG`.
On `DEBUG` only one entry will be observed and that is about the detection result.

Then regarding the others log entries, they will be pushed as `Level 5`. Commonly known as TRACE level, but we do
not register it globally.

Detect binaries
---------------

This package offers a neat way to detect files that can be considered as 'binaries'
meaning that it is not likely to be a text-file.

from charset_normalizer import is_binary

# It can receive both a path or bytes or even a file pointer.
    result = is_binary("./my-file.ext")

# This should print 'True' or 'False'
    print(result)