Unreleased#
+Added#
+-
+
Added logging support +Overview
+The bucketfs logger can be referenced via
+exasol.bucketfs
++import logging +# Get the logger for 'exasol.bucketfs' +logger = logging.getLogger('exasol.bucketfs') +
For most use cases it should be sufficient to just configure the root logger, in order +to retrieve the logs from bucketfs.
+++import logging + +logging.basicConfig(level=logging.INFO) +
+
Internal#
-
@@ -285,6 +306,7 @@
- Unreleased diff --git a/objects.inv b/objects.inv index 8cf42f86..c5bd4916 100644 Binary files a/objects.inv and b/objects.inv differ diff --git a/searchindex.js b/searchindex.js index e0bed077..87f64bae 100644 --- a/searchindex.js +++ b/searchindex.js @@ -1 +1 @@ -Search.setIndex({"docnames": ["api", "changes/changelog", "changes/changes_0.1.0", "changes/changes_0.2.0", "changes/changes_0.3.0", "changes/changes_0.4.0", "changes/changes_0.5.0", "changes/changes_0.6.0", "changes/changes_0.7.0", "changes/changes_0.8.0", "changes/changes_0.9.0", "changes/unreleased", "developer_guide/developer_guide", "index", "user_guide/advanced", "user_guide/basics", "user_guide/upload_github_release_to_bucket", "user_guide/user_guide"], "filenames": ["api.rst", "changes/changelog.md", "changes/changes_0.1.0.md", "changes/changes_0.2.0.md", "changes/changes_0.3.0.md", "changes/changes_0.4.0.md", "changes/changes_0.5.0.md", "changes/changes_0.6.0.md", "changes/changes_0.7.0.md", "changes/changes_0.8.0.md", "changes/changes_0.9.0.md", "changes/unreleased.md", "developer_guide/developer_guide.rst", "index.rst", "user_guide/advanced.rst", "user_guide/basics.rst", "user_guide/upload_github_release_to_bucket.rst", "user_guide/user_guide.rst"], "titles": ["\ud83e\uddf0 API Reference", "\ud83d\udcdd Changes", "BucketFs Utils Python 0.1.0, released 2022-01-18", "BucketFs Utils Python 0.2.0, released 2022-04-29", "BucketFs Utils Python 0.3.0, released 2022-07-20", "BucketFs Python 0.4.0, released 2022-09-28", "BucketFs Python 0.5.0, released 2022-10-12", "BucketFs Python 0.6.0, released 2022-11-11", "BucketFs Python 0.7.0, released 2022-12-22", "BucketFs Python 0.8.0, released 2023-03-21", "BucketFs Python 0.9.0, released 2024-02-16", "Unreleased", "\ud83d\udee0 Developer Guide", "Exasol Bucketfs", "Advanced", "Basic\u2019s", "Github Artifacts", "\ud83d\udc64 User Guide"], "terms": {"class": 0, "url": [0, 5, 14, 15, 17], "str": 0, "credenti": [0, 14, 15, 17], "map": 0, "none": [0, 5], "verifi": 0, "bool": 0, "true": 0, "sourc": [0, 3, 4, 16], "base": 0, "object": [0, 2, 14, 15], "provid": [0, 2, 7, 14, 15], "simpl": 0, "us": [0, 3, 7, 9, 15, 16], "access": [0, 6], "list": [0, 3, 4, 6, 13, 17], "all": [0, 6, 13, 14, 17], "avail": [0, 6, 7, 17], "__init__": 0, "creat": 0, "new": [0, 3, 5, 7, 12], "instanc": 0, "paramet": 0, "e": [0, 9], "g": [0, 9], "http": [0, 14, 15, 16, 17], "": [0, 5, 7, 13, 16, 17], "127": 0, "0": [0, 1, 11, 12, 14, 15, 17], "1": [0, 1, 5, 11], "2580": 0, "A": [0, 15], "contain": [0, 2, 15], "usernam": [0, 14, 15, 17], "password": [0, 14, 15, 16, 17], "bucket1": 0, "foo": 0, "bar": 0, "either": 0, "boolean": 0, "which": [0, 7, 12, 15], "case": [0, 15], "control": 0, "whether": 0, "we": [0, 3, 9], "server": 0, "tl": [0, 10], "certif": 0, "string": [0, 2, 3, 5, 14, 15], "must": [0, 12], "path": [0, 3, 4, 5, 14, 15, 16], "ca": 0, "bundl": 0, "default": [0, 14, 15, 17], "properti": 0, "mutablemap": 0, "name": [0, 2, 3, 4, 5], "where": 0, "thi": [0, 2, 3, 4, 7, 15, 16, 17], "i": [0, 2, 4, 7, 13, 17], "host": [0, 15, 16], "authent": 0, "delet": [0, 3, 12, 13, 17], "specif": [0, 3], "file": [0, 2, 3, 13, 16, 17], "point": 0, "shall": 0, "rais": 0, "oper": 0, "couldn": 0, "t": 0, "execut": 0, "successfulli": [0, 12], "download": [0, 2, 13, 17], "chunk_siz": 0, "int": 0, "8192": 0, "iter": [0, 15], "bytestr": 0, "return": 0, "an": [0, 5, 15, 16], "binari": 0, "chunk": [0, 15], "repres": 0, "upload": [0, 2, 4, 12, 13, 16, 17], "data": [0, 14, 15, 17], "binaryio": 0, "onto": 0, "associ": 0, "raw": [0, 14, 15], "content": [0, 14, 15, 17], "transform": 0, "set": [0, 15], "byte": [0, 14, 15], "like": [0, 9, 14, 15], "concaten": 0, "singl": [0, 15], "continu": 0, "encod": [0, 14, 15], "utf": [0, 14, 15], "8": [0, 1, 4, 13, 14, 15], "convert": 0, "represent": 0, "filenam": [0, 14, 15], "written": 0, "algorithm": 0, "sha1": 0, "calcul": 0, "hash": 0, "input": [0, 5], "checksum": 0, "hex": 0, "digest": 0, "wrap": 0, "variou": 0, "conveni": [0, 14], "featur": [0, 14], "index": 0, "even": [0, 14], "though": [0, 14], "veri": [0, 14], "interfac": 0, "function": [0, 16], "should": [0, 15], "care": 0, "mai": [0, 14, 15], "obviou": [0, 14], "do": [0, 7, 14], "involv": [0, 14], "interact": [0, 13, 14, 15], "background": [0, 14], "sync": [0, 14], "etc": [0, 14], "keep": [0, 15], "mind": 0, "when": [0, 15], "size": 0, "except": 0, "arg": 0, "kwarg": 0, "error": 0, "occur": 0, "while": 0, "f": [0, 14, 15], "unreleas": 1, "9": 1, "7": [1, 2], "6": [1, 2, 17], "5": [1, 17], "4": [1, 6, 10, 11, 12, 17], "3": [1, 13, 17], "2": [1, 5, 17], "code": [2, 3, 4, 7, 8], "initi": 2, "implement": 2, "version": [2, 3, 4, 5, 9, 10, 12], "It": 2, "allow": 2, "you": [2, 16], "from": [2, 3, 4, 11, 12, 13, 16, 17], "insid": 2, "udf": [2, 4, 5], "altern": 2, "can": [2, 13, 15, 16, 17], "read": 2, "also": [2, 17], "local": [2, 12], "bucket": [2, 3, 4, 5, 6, 13, 16, 17], "system": [2, 10, 11], "ad": [2, 3, 4, 5, 6, 8, 10, 11], "fileobj": 2, "fileboj": 2, "29": 2, "add": [2, 4, 6, 7, 8], "sphinx": 2, "13": 2, "joblib": 2, "obj": 2, "languag": 2, "45": 2, "droid": 2, "github": [2, 10, 12, 17], "workflow": [2, 10, 12], "prepar": [2, 5], "49": 2, "complaint": 2, "regard": [2, 15], "changelog": [2, 12], "47": 2, "15": 2, "remov": [2, 3, 4, 7], "dephel": 2, "depend": [2, 7, 8, 11, 15, 17], "becaus": [2, 3], "maintain": 2, "anymor": 2, "42": 2, "move": 2, "locat": 2, "over": 2, "exasol_data_science_utils_python": 2, "n": 2, "method": [3, 4, 5], "introduc": 3, "two": 3, "certain": 3, "under": 3, "furthermor": [3, 4], "numpi": [3, 4], "build": [3, 4, 11], "against": 3, "buffer": 3, "overflow": 3, "vulner": [3, 7, 9], "55": 3, "61": 3, "54": 3, "posixpath": 3, "convers": 3, "alter": 3, "session": 3, "58": [3, 9], "type": 3, "hint": 3, "51": 3, "bucketfsloc": [4, 5], "gener": [4, 5, 14, 15], "upgrad": 4, "generate_bucket_udf_path": 4, "bucketfsloct": 4, "In": [4, 12, 15], "addit": 4, "ar": 4, "72": [4, 5], "63": 4, "correct": 4, "fileobject": 4, "mock": 4, "66": 4, "localf": 4, "74": 4, "53": 4, "again": 4, "38": 4, "replac": 4, "old": [4, 7], "bash": 4, "script": 4, "sphinx_github": 4, "page": 4, "migrat": 4, "nox": [4, 7], "68": 4, "instal": 4, "instruct": 4, "readm": 4, "first": 5, "pypi": [5, 12], "test": 5, "handl": 5, "base_path": 5, "empti": 5, "79": 5, "joinpath": 5, "81": 5, "updat": [5, 8, 9, 10, 11], "poetri": [5, 9, 11, 12], "ci": [5, 12], "project": [5, 7, 8, 11], "prerequisit": 5, "adjust": 5, "contributor": 5, "support": [6, 8, 10], "servic": [6, 13, 14, 17], "inform": 6, "how": 6, "trigger": 6, "doe": 7, "major": 7, "api": [7, 13], "rework": 7, "still": [7, 14, 15], "consid": 7, "deprec": 7, "futur": 7, "integr": 7, "more": [7, 15, 17], "easili": 7, "abil": 7, "standard": 7, "built": 7, "mechan": 7, "achiev": 7, "desir": 7, "outcom": 7, "without": 7, "need": [7, 12], "extend": 7, "exist": 7, "entir": 7, "match": [7, 12], "structur": 7, "packag": [7, 12], "exasol": [7, 8, 12, 14, 15, 16, 17], "warn": 7, "issu": [7, 9, 12], "evalu": 7, "cve": [7, 9], "42969": 7, "silenc": 7, "The": [7, 13, 17], "affect": 7, "our": [7, 9], "itself": 7, "nor": 7, "pull": 7, "librari": [7, 9, 13], "check": [7, 9], "search": 7, "pytest": 7, "track": 7, "toolbox": [8, 10], "fix": [8, 10, 12], "invalid": 8, "command": 8, "develop": 8, "guid": 8, "exampl": [8, 10, 12, 16], "basic": [8, 17], "user": [8, 9, 15, 16], "setup": [8, 11, 17], "section": [8, 11, 17], "pre": 8, "commit": 8, "hook": 8, "attent": 9, "have": [9, 17], "been": 9, "address": 9, "henc": 9, "advis": 9, "own": 9, "tree": 9, "scanner": 9, "trivi": 9, "intern": 9, "lock": 9, "0286": 9, "23931": 9, "restrict": [9, 15], "typeguard": [9, 10], "configur": [10, 17], "ssl": 10, "valid": 10, "overview": [10, 17], "typo": 10, "60": 10, "lockfil": 10, "pin": 10, "relock": 11, "abatilo": 11, "action": [11, 12], "v2": 11, "v3": 11, "python": [11, 12, 13], "v5": 11, "pyproject": 11, "toml": 11, "git": 12, "com": 12, "bucketf": [12, 14, 16], "run": [12, 17], "chang": 12, "log": 12, "date": 12, "latest": [12, 13, 16], "tag": 12, "For": [12, 17], "changes_0": 12, "md": 12, "order": [12, 15], "push": 12, "further": 12, "detail": [12, 17], "see": 12, "cd": 12, "yml": 12, "appropri": 12, "number": 12, "x": 12, "y": 12, "z": 12, "origin": 12, "d": 12, "remot": 12, "lead": 12, "start": 12, "process": 12, "begin": 12, "finish": 12, "redo": 12, "manual": 12, "scenario": 12, "publish": 12, "wa": 12, "got": 12, "interrupt": 12, "solut": 12, "pip": 13, "found": 13, "here": 13, "follow": 14, "describ": 14, "pattern": 14, "come": 14, "handi": 14, "import": [14, 15, 16, 17], "localhost": [14, 15, 17], "6666": [14, 15, 17], "w": [14, 15, 17], "write": [14, 15, 17], "default_bucket": [14, 15, 17], "io": [14, 15], "65": [14, 15], "some": [14, 15, 16], "file1": [14, 15], "bin": [14, 15], "open": [14, 15, 16], "myfile1": 14, "txt": [14, 15, 17], "rb": [14, 15], "destin": [14, 15], "file_lik": [14, 15], "bytesio": [14, 15], "b": [14, 15, 17], "file2": [14, 15], "conent": 14, "text": [14, 15], "abcd": [14, 15], "_": [14, 15], "rang": [14, 15, 17], "10": [14, 15], "as_byt": [14, 15, 17], "other": [14, 15], "as_fil": [14, 15], "myfil": [14, 15, 17], "my_utf8_str": [14, 15], "as_str": [14, 15], "utf8": [14, 15], "my_ascii_str": [14, 15], "ascii": [14, 15], "del": 14, "multipl": 15, "one": [15, 16, 17], "request": 15, "myfile2": 15, "back": 15, "caller": 15, "recept": 15, "effici": 15, "flexibl": 15, "memori": 15, "usag": 15, "most": 15, "prefer": 15, "tangibl": [15, 17], "as_hash": 15, "With": 16, "public": 16, "releas": 16, "want": 16, "artefact": 16, "repositori": 16, "exasol_bucketfs_utils_python": 16, "github_release_file_bucketfs_upload": 16, "githubreleasefilebucketfsupload": 16, "release_upload": 16, "file_to_download_nam": 16, "github_us": 16, "repository_nam": 16, "release_nam": 16, "path_inside_bucket": 16, "port": 16, "databas": 17, "straight": 17, "forward": 17, "fairli": 17, "complex": 17, "due": 17, "fact": 17, "each": 17, "worker": 17, "cluster": 17, "node": 17, "hold": 17, "bellow": 17, "tri": 17, "illustr": 17, "manner": 17, "pleas": 17, "look": 17, "document": 17, "get": 17, "advanc": 17, "artifact": 17}, "objects": {"exasol.bucketfs": [[0, 0, 1, "", "Bucket"], [0, 3, 1, "", "BucketFsError"], [0, 0, 1, "", "MappedBucket"], [0, 4, 1, "", "as_bytes"], [0, 4, 1, "", "as_file"], [0, 4, 1, "", "as_hash"], [0, 4, 1, "", "as_string"]], "exasol.bucketfs.Bucket": [[0, 1, 1, "", "__init__"], [0, 1, 1, "", "delete"], [0, 1, 1, "", "download"], [0, 2, 1, "", "files"], [0, 2, 1, "", "name"], [0, 1, 1, "", "upload"]], "exasol.bucketfs.MappedBucket": [[0, 1, 1, "", "__init__"], [0, 2, 1, "", "chunk_size"]]}, "objtypes": {"0": "py:class", "1": "py:method", "2": "py:property", "3": "py:exception", "4": "py:function"}, "objnames": {"0": ["py", "class", "Python class"], "1": ["py", "method", "Python method"], "2": ["py", "property", "Python property"], "3": ["py", "exception", "Python exception"], "4": ["py", "function", "Python function"]}, "titleterms": {"api": 0, "refer": [0, 15], "exasol": [0, 13], "bucketf": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 13, 15, 17], "servic": [0, 15], "bucket": [0, 14, 15], "as_byt": 0, "as_str": 0, "as_fil": 0, "as_hash": 0, "mappedbucket": [0, 14], "bucketfserror": 0, "chang": [1, 8], "util": [2, 3, 4], "python": [2, 3, 4, 5, 6, 7, 8, 9, 10], "0": [2, 3, 4, 5, 6, 7, 8, 9, 10], "1": 2, "releas": [2, 3, 4, 5, 6, 7, 8, 9, 10, 12], "2022": [2, 3, 4, 5, 6, 7, 8], "01": 2, "18": 2, "summari": [2, 3, 4, 5, 6, 7, 8, 9], "featur": [2, 3, 4, 5, 6, 7, 10, 13], "enhanc": [2, 3, 4, 5, 6, 7], "bug": [2, 3, 4, 5], "fix": [2, 3, 4, 5], "document": [2, 4, 5, 6, 7, 8, 10, 13], "refactor": [2, 3, 4, 5, 7], "secur": [2, 3, 7, 9], "2": 3, "04": 3, "29": 3, "3": 4, "07": 4, "20": 4, "4": 5, "09": 5, "28": 5, "5": 6, "10": 6, "12": [6, 8], "6": 7, "11": 7, "7": 8, "22": 8, "8": 9, "2023": 9, "03": 9, "21": 9, "depend": [9, 10, 12], "9": 10, "2024": 10, "02": 10, "16": 10, "intern": [10, 11], "unreleas": 11, "develop": 12, "guid": [12, 17], "set": 12, "up": [12, 17], "workspac": 12, "checkout": 12, "project": 12, "instal": [12, 13], "setup": 12, "pre": 12, "commit": 12, "hook": 12, "": [12, 15], "creat": 12, "prerequisit": [12, 13], "trigger": 12, "what": 12, "do": 12, "fail": 12, "The": [12, 14, 15], "dure": 12, "check": 12, "One": 12, "step": 12, "partial": 12, "advanc": 14, "list": [14, 15], "file": [14, 15], "upload": [14, 15], "download": [14, 15], "from": [14, 15], "delet": [14, 15], "basic": 15, "get": 15, "class": 15, "avail": 15, "convert": 15, "github": 16, "artifact": 16, "user": 17, "quickstart": 17, "follow": 17}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.viewcode": 1, "sphinx.ext.intersphinx": 1, "sphinx": 57}, "alltitles": {"\ud83e\uddf0 API Reference": [[0, "api-reference"]], "exasol.bucketfs.Service": [[0, "exasol-bucketfs-service"]], "exasol.bucketfs.Bucket": [[0, "exasol-bucketfs-bucket"]], "exasol.bucketfs.as_bytes": [[0, "exasol-bucketfs-as-bytes"]], "exasol.bucketfs.as_string": [[0, "exasol-bucketfs-as-string"]], "exasol.bucketfs.as_file": [[0, "exasol-bucketfs-as-file"]], "exasol.bucketfs.as_hash": [[0, "exasol-bucketfs-as-hash"]], "exasol.bucketfs.MappedBucket": [[0, "exasol-bucketfs-mappedbucket"]], "exasol.bucketfs.BucketFsError": [[0, "exasol-bucketfs-bucketfserror"]], "\ud83d\udcdd Changes": [[1, "changes"]], "BucketFs Utils Python 0.1.0, released 2022-01-18": [[2, "bucketfs-utils-python-0-1-0-released-2022-01-18"]], "Summary": [[2, "summary"], [3, "summary"], [4, "summary"], [5, "summary"], [6, "summary"], [7, "summary"], [8, "summary"], [9, "summary"]], "Features / Enhancements": [[2, "features-enhancements"], [3, "features-enhancements"], [4, "features-enhancements"], [5, "features-enhancements"], [6, "features-enhancements"], [7, "features-enhancements"]], "Bug Fixes": [[2, "bug-fixes"], [3, "bug-fixes"], [4, "bug-fixes"], [5, "bug-fixes"]], "Documentation": [[2, "documentation"], [4, "documentation"], [5, "documentation"], [6, "documentation"], [7, "documentation"], [8, "documentation"], [10, "documentation"]], "Refactoring": [[2, "refactoring"], [3, "refactoring"], [4, "refactoring"], [5, "refactoring"], [7, "refactoring"]], "Security": [[2, "security"], [3, "security"], [7, "security"], [9, "security"]], "BucketFs Utils Python 0.2.0, released 2022-04-29": [[3, "bucketfs-utils-python-0-2-0-released-2022-04-29"]], "BucketFs Utils Python 0.3.0, released 2022-07-20": [[4, "bucketfs-utils-python-0-3-0-released-2022-07-20"]], "BucketFs Python 0.4.0, released 2022-09-28": [[5, "bucketfs-python-0-4-0-released-2022-09-28"]], "BucketFs Python 0.5.0, released 2022-10-12": [[6, "bucketfs-python-0-5-0-released-2022-10-12"]], "BucketFs Python 0.6.0, released 2022-11-11": [[7, "bucketfs-python-0-6-0-released-2022-11-11"]], "BucketFs Python 0.7.0, released 2022-12-22": [[8, "bucketfs-python-0-7-0-released-2022-12-22"]], "Changes": [[8, "changes"]], "BucketFs Python 0.8.0, released 2023-03-21": [[9, "bucketfs-python-0-8-0-released-2023-03-21"]], "Dependencies": [[9, "dependencies"], [10, "dependencies"]], "BucketFs Python 0.9.0, released 2024-02-16": [[10, "bucketfs-python-0-9-0-released-2024-02-16"]], "Feature": [[10, "feature"]], "Internal": [[10, "internal"], [11, "internal"]], "Unreleased": [[11, "unreleased"]], "\ud83d\udee0 Developer Guide": [[12, "developer-guide"]], "Setting up the workspace": [[12, "setting-up-the-workspace"]], "Checkout the Project": [[12, "checkout-the-project"]], "Install project dependencies": [[12, "install-project-dependencies"]], "Setup pre-commit hook(s)": [[12, "setup-pre-commit-hook-s"]], "Creating a Release": [[12, "creating-a-release"]], "Prerequisites": [[12, "prerequisites"]], "Triggering the Release": [[12, "triggering-the-release"]], "What to do if the release failed?": [[12, "what-to-do-if-the-release-failed"]], "The release failed during pre-release checks": [[12, "the-release-failed-during-pre-release-checks"]], "One of the release steps failed (Partial Release)": [[12, "one-of-the-release-steps-failed-partial-release"]], "Exasol Bucketfs": [[13, "exasol-bucketfs"]], "\ud83d\ude80 Features": [[13, "features"]], "\ud83d\udd0c\ufe0f Prerequisites": [[13, "prerequisites"]], "\ud83d\udcbe Installation": [[13, "installation"]], "\ud83d\udcda Documentation": [[13, "documentation"]], "Advanced": [[14, "advanced"]], "The MappedBucket": [[14, "the-mappedbucket"]], "List files in a Bucket": [[14, "list-files-in-a-bucket"], [15, "list-files-in-a-bucket"]], "Upload files to a Bucket": [[14, "upload-files-to-a-bucket"], [15, "upload-files-to-a-bucket"]], "Download files from a Bucket": [[14, "download-files-from-a-bucket"], [15, "download-files-from-a-bucket"]], "Delete files from Bucket": [[14, "delete-files-from-bucket"], [15, "delete-files-from-bucket"]], "Basic\u2019s": [[15, "basic-s"]], "The Bucketfs Service": [[15, "the-bucketfs-service"]], "List buckets": [[15, "list-buckets"]], "Get a Bucket reference": [[15, "get-a-bucket-reference"]], "Bucket class": [[15, "bucket-class"]], "Available Converters": [[15, "available-converters"]], "Github Artifacts": [[16, "github-artifacts"]], "\ud83d\udc64 User Guide": [[17, "user-guide"]], "Bucketfs": [[17, "bucketfs"]], "Quickstart": [[17, "quickstart"]], "Follow Up": [[17, "follow-up"]]}, "indexentries": {"bucket (class in exasol.bucketfs)": [[0, "exasol.bucketfs.Bucket"]], "bucketfserror": [[0, "exasol.bucketfs.BucketFsError"]], "mappedbucket (class in exasol.bucketfs)": [[0, "exasol.bucketfs.MappedBucket"]], "__init__() (exasol.bucketfs.bucket method)": [[0, "exasol.bucketfs.Bucket.__init__"]], "__init__() (exasol.bucketfs.mappedbucket method)": [[0, "exasol.bucketfs.MappedBucket.__init__"]], "as_bytes() (in module exasol.bucketfs)": [[0, "exasol.bucketfs.as_bytes"]], "as_file() (in module exasol.bucketfs)": [[0, "exasol.bucketfs.as_file"]], "as_hash() (in module exasol.bucketfs)": [[0, "exasol.bucketfs.as_hash"]], "as_string() (in module exasol.bucketfs)": [[0, "exasol.bucketfs.as_string"]], "chunk_size (exasol.bucketfs.mappedbucket property)": [[0, "exasol.bucketfs.MappedBucket.chunk_size"]], "delete() (exasol.bucketfs.bucket method)": [[0, "exasol.bucketfs.Bucket.delete"]], "download() (exasol.bucketfs.bucket method)": [[0, "exasol.bucketfs.Bucket.download"]], "files (exasol.bucketfs.bucket property)": [[0, "exasol.bucketfs.Bucket.files"]], "name (exasol.bucketfs.bucket property)": [[0, "exasol.bucketfs.Bucket.name"]], "upload() (exasol.bucketfs.bucket method)": [[0, "exasol.bucketfs.Bucket.upload"]]}}) \ No newline at end of file +Search.setIndex({"docnames": ["api", "changes/changelog", "changes/changes_0.1.0", "changes/changes_0.2.0", "changes/changes_0.3.0", "changes/changes_0.4.0", "changes/changes_0.5.0", "changes/changes_0.6.0", "changes/changes_0.7.0", "changes/changes_0.8.0", "changes/changes_0.9.0", "changes/unreleased", "developer_guide/developer_guide", "index", "user_guide/advanced", "user_guide/basics", "user_guide/upload_github_release_to_bucket", "user_guide/user_guide"], "filenames": ["api.rst", "changes/changelog.md", "changes/changes_0.1.0.md", "changes/changes_0.2.0.md", "changes/changes_0.3.0.md", "changes/changes_0.4.0.md", "changes/changes_0.5.0.md", "changes/changes_0.6.0.md", "changes/changes_0.7.0.md", "changes/changes_0.8.0.md", "changes/changes_0.9.0.md", "changes/unreleased.md", "developer_guide/developer_guide.rst", "index.rst", "user_guide/advanced.rst", "user_guide/basics.rst", "user_guide/upload_github_release_to_bucket.rst", "user_guide/user_guide.rst"], "titles": ["\ud83e\uddf0 API Reference", "\ud83d\udcdd Changes", "BucketFs Utils Python 0.1.0, released 2022-01-18", "BucketFs Utils Python 0.2.0, released 2022-04-29", "BucketFs Utils Python 0.3.0, released 2022-07-20", "BucketFs Python 0.4.0, released 2022-09-28", "BucketFs Python 0.5.0, released 2022-10-12", "BucketFs Python 0.6.0, released 2022-11-11", "BucketFs Python 0.7.0, released 2022-12-22", "BucketFs Python 0.8.0, released 2023-03-21", "BucketFs Python 0.9.0, released 2024-02-16", "Unreleased", "\ud83d\udee0 Developer Guide", "Exasol Bucketfs", "Advanced", "Basic\u2019s", "Github Artifacts", "\ud83d\udc64 User Guide"], "terms": {"class": 0, "url": [0, 5, 14, 15, 17], "str": 0, "credenti": [0, 14, 15, 17], "map": 0, "none": [0, 5], "verifi": 0, "bool": 0, "true": 0, "sourc": [0, 3, 4, 16], "base": 0, "object": [0, 2, 14, 15], "provid": [0, 2, 7, 14, 15], "simpl": 0, "us": [0, 3, 7, 9, 11, 15, 16], "access": [0, 6], "list": [0, 3, 4, 6, 13, 17], "all": [0, 6, 13, 14, 17], "avail": [0, 6, 7, 17], "__init__": 0, "creat": 0, "new": [0, 3, 5, 7, 12], "instanc": 0, "paramet": 0, "e": [0, 9], "g": [0, 9], "http": [0, 14, 15, 16, 17], "": [0, 5, 7, 13, 16, 17], "127": 0, "0": [0, 1, 11, 12, 14, 15, 17], "1": [0, 1, 5, 11, 14], "2580": 0, "A": [0, 15], "contain": [0, 2, 15], "usernam": [0, 14, 15, 17], "password": [0, 14, 15, 16, 17], "bucket1": 0, "foo": 0, "bar": 0, "either": 0, "boolean": 0, "which": [0, 7, 12, 14, 15], "case": [0, 11, 14, 15], "control": 0, "whether": 0, "we": [0, 3, 9], "server": 0, "tl": [0, 10], "certif": 0, "string": [0, 2, 3, 5, 14, 15], "must": [0, 12], "path": [0, 3, 4, 5, 14, 15, 16], "ca": 0, "bundl": 0, "default": [0, 14, 15, 17], "properti": 0, "mutablemap": 0, "name": [0, 2, 3, 4, 5], "where": [0, 14], "thi": [0, 2, 3, 4, 7, 14, 15, 16, 17], "i": [0, 2, 4, 7, 13, 14, 17], "host": [0, 15, 16], "authent": 0, "delet": [0, 3, 12, 13, 17], "specif": [0, 3], "file": [0, 2, 3, 13, 16, 17], "point": 0, "shall": 0, "rais": 0, "oper": 0, "couldn": 0, "t": 0, "execut": 0, "successfulli": [0, 12], "download": [0, 2, 13, 17], "chunk_siz": 0, "int": 0, "8192": 0, "iter": [0, 15], "bytestr": 0, "return": 0, "an": [0, 5, 15, 16], "binari": 0, "chunk": [0, 15], "repres": 0, "upload": [0, 2, 4, 12, 13, 16, 17], "data": [0, 14, 15, 17], "binaryio": 0, "onto": 0, "associ": 0, "raw": [0, 14, 15], "content": [0, 14, 15, 17], "transform": 0, "set": [0, 14, 15], "byte": [0, 14, 15], "like": [0, 9, 14, 15], "concaten": 0, "singl": [0, 15], "continu": 0, "encod": [0, 14, 15], "utf": [0, 14, 15], "8": [0, 1, 4, 13, 14, 15], "convert": 0, "represent": 0, "filenam": [0, 14, 15], "written": 0, "algorithm": 0, "sha1": 0, "calcul": 0, "hash": 0, "input": [0, 5], "checksum": 0, "hex": 0, "digest": 0, "wrap": 0, "variou": 0, "conveni": [0, 14], "featur": [0, 14], "index": 0, "even": [0, 14], "though": [0, 14], "veri": [0, 14], "interfac": 0, "function": [0, 16], "should": [0, 11, 14, 15], "care": 0, "mai": [0, 14, 15], "obviou": [0, 14], "do": [0, 7, 14], "involv": [0, 14], "interact": [0, 13, 14, 15], "background": [0, 14], "sync": [0, 14], "etc": [0, 14], "keep": [0, 15], "mind": 0, "when": [0, 15], "size": 0, "except": 0, "arg": 0, "kwarg": 0, "error": 0, "occur": 0, "while": 0, "f": [0, 14, 15], "unreleas": 1, "9": 1, "7": [1, 2], "6": [1, 2, 17], "5": [1, 17], "4": [1, 6, 10, 11, 12, 17], "3": [1, 13, 14, 17], "2": [1, 5, 14, 17], "code": [2, 3, 4, 7, 8], "initi": 2, "implement": 2, "version": [2, 3, 4, 5, 9, 10, 12], "It": [2, 14], "allow": 2, "you": [2, 14, 16], "from": [2, 3, 4, 11, 12, 13, 16, 17], "insid": 2, "udf": [2, 4, 5], "altern": 2, "can": [2, 11, 13, 15, 16, 17], "read": 2, "also": [2, 17], "local": [2, 12], "bucket": [2, 3, 4, 5, 6, 13, 16, 17], "system": [2, 10, 11], "ad": [2, 3, 4, 5, 6, 8, 10], "fileobj": 2, "fileboj": 2, "29": 2, "add": [2, 4, 6, 7, 8], "sphinx": 2, "13": 2, "joblib": 2, "obj": 2, "languag": 2, "45": 2, "droid": 2, "github": [2, 10, 12, 17], "workflow": [2, 10, 12], "prepar": [2, 5], "49": 2, "complaint": 2, "regard": [2, 15], "changelog": [2, 12], "47": 2, "15": 2, "remov": [2, 3, 4, 7], "dephel": 2, "depend": [2, 7, 8, 11, 15, 17], "becaus": [2, 3], "maintain": 2, "anymor": 2, "42": 2, "move": 2, "locat": 2, "over": 2, "exasol_data_science_utils_python": 2, "n": 2, "method": [3, 4, 5], "introduc": 3, "two": 3, "certain": 3, "under": 3, "furthermor": [3, 4], "numpi": [3, 4], "build": [3, 4, 11], "against": 3, "buffer": 3, "overflow": 3, "vulner": [3, 7, 9], "55": 3, "61": 3, "54": 3, "posixpath": 3, "convers": 3, "alter": 3, "session": 3, "58": [3, 9], "type": 3, "hint": 3, "51": 3, "bucketfsloc": [4, 5], "gener": [4, 5, 14, 15], "upgrad": 4, "generate_bucket_udf_path": 4, "bucketfsloct": 4, "In": [4, 12, 15], "addit": 4, "ar": [4, 14], "72": [4, 5], "63": 4, "correct": 4, "fileobject": 4, "mock": 4, "66": 4, "localf": 4, "74": 4, "53": 4, "again": 4, "38": 4, "replac": 4, "old": [4, 7], "bash": 4, "script": [4, 14], "sphinx_github": 4, "page": 4, "migrat": 4, "nox": [4, 7], "68": 4, "instal": 4, "instruct": 4, "readm": 4, "first": 5, "pypi": [5, 12], "test": 5, "handl": [5, 14], "base_path": 5, "empti": 5, "79": 5, "joinpath": 5, "81": 5, "updat": [5, 8, 9, 10, 11], "poetri": [5, 9, 11, 12], "ci": [5, 12], "project": [5, 7, 8, 11], "prerequisit": 5, "adjust": 5, "contributor": 5, "support": [6, 8, 10, 11], "servic": [6, 13, 14, 17], "inform": 6, "how": 6, "trigger": 6, "doe": 7, "major": 7, "api": [7, 13], "rework": 7, "still": [7, 14, 15], "consid": 7, "deprec": 7, "futur": 7, "integr": 7, "more": [7, 15, 17], "easili": 7, "abil": 7, "standard": 7, "built": 7, "mechan": 7, "achiev": 7, "desir": 7, "outcom": 7, "without": [7, 14], "need": [7, 12, 14], "extend": 7, "exist": 7, "entir": 7, "match": [7, 12], "structur": 7, "packag": [7, 12], "exasol": [7, 8, 11, 12, 14, 15, 16, 17], "warn": 7, "issu": [7, 9, 12], "evalu": 7, "cve": [7, 9], "42969": 7, "silenc": 7, "The": [7, 11, 13, 17], "affect": 7, "our": [7, 9], "itself": 7, "nor": 7, "pull": 7, "librari": [7, 9, 13, 14], "check": [7, 9], "search": 7, "pytest": 7, "track": 7, "toolbox": [8, 10], "fix": [8, 10, 12], "invalid": 8, "command": 8, "develop": 8, "guid": 8, "exampl": [8, 10, 12, 16], "basic": [8, 17], "user": [8, 9, 15, 16], "setup": [8, 11, 17], "section": [8, 11, 17], "pre": 8, "commit": 8, "hook": 8, "attent": [9, 14], "have": [9, 17], "been": 9, "address": 9, "henc": 9, "advis": 9, "own": 9, "tree": 9, "scanner": 9, "trivi": 9, "intern": 9, "lock": 9, "0286": 9, "23931": 9, "restrict": [9, 15], "typeguard": [9, 10], "configur": [10, 11, 17], "ssl": 10, "valid": 10, "overview": [10, 11, 17], "typo": 10, "60": 10, "lockfil": 10, "pin": 10, "log": [11, 12], "bucketf": [11, 12, 14, 16], "logger": [11, 14], "referenc": 11, "via": 11, "import": [11, 14, 15, 16, 17], "get": [11, 14, 17], "getlogg": [11, 14], "For": [11, 12, 17], "most": [11, 15], "suffici": [11, 14], "just": 11, "root": [11, 14], "order": [11, 12, 15], "retriev": 11, "basicconfig": [11, 14, 15], "level": [11, 14, 15], "info": [11, 14, 15], "relock": 11, "abatilo": 11, "action": [11, 12], "v2": 11, "v3": 11, "python": [11, 12, 13, 14], "v5": 11, "pyproject": 11, "toml": 11, "git": 12, "com": 12, "run": [12, 17], "chang": 12, "date": 12, "latest": [12, 13, 16], "tag": 12, "changes_0": 12, "md": 12, "push": 12, "further": 12, "detail": [12, 17], "see": 12, "cd": 12, "yml": 12, "appropri": 12, "number": 12, "x": 12, "y": 12, "z": 12, "origin": 12, "d": 12, "remot": 12, "lead": 12, "start": 12, "process": 12, "begin": [12, 14], "finish": 12, "redo": 12, "manual": 12, "scenario": 12, "publish": 12, "wa": 12, "got": 12, "interrupt": 12, "solut": 12, "pip": 13, "found": 13, "here": 13, "follow": 14, "describ": 14, "pattern": 14, "come": 14, "handi": 14, "localhost": [14, 15, 17], "6666": [14, 15, 17], "w": [14, 15, 17], "write": [14, 15, 17], "default_bucket": [14, 15, 17], "io": [14, 15], "65": [14, 15], "some": [14, 15, 16], "file1": [14, 15], "bin": [14, 15], "open": [14, 15, 16], "myfile1": 14, "txt": [14, 15, 17], "rb": [14, 15], "destin": [14, 15], "file_lik": [14, 15], "bytesio": [14, 15], "b": [14, 15, 17], "file2": [14, 15], "conent": 14, "text": [14, 15], "abcd": [14, 15], "_": [14, 15], "rang": [14, 15, 17], "10": [14, 15], "as_byt": [14, 15, 17], "other": [14, 15], "as_fil": [14, 15], "myfil": [14, 15, 17], "my_utf8_str": [14, 15], "as_str": [14, 15], "utf8": [14, 15], "my_ascii_str": [14, 15], "ascii": [14, 15], "del": 14, "essenti": 14, "your": 14, "ensur": 14, "messag": 14, "includ": 14, "those": 14, "correctli": 14, "proper": 14, "might": 14, "appear": 14, "expect": 14, "explicityli": 14, "refer": 14, "bucketfs_logg": 14, "note": 14, "By": 14, "notset": 14, "doc": 14, "org": 14, "11": 14, "html": 14, "lot": 14, "approri": 14, "setlevel": 14, "debug": 14, "multipl": 15, "one": [15, 16, 17], "request": 15, "myfile2": 15, "back": 15, "caller": 15, "recept": 15, "effici": 15, "flexibl": 15, "memori": 15, "usag": 15, "prefer": 15, "tangibl": [15, 17], "as_hash": 15, "With": 16, "public": 16, "releas": 16, "want": 16, "artefact": 16, "repositori": 16, "exasol_bucketfs_utils_python": 16, "github_release_file_bucketfs_upload": 16, "githubreleasefilebucketfsupload": 16, "release_upload": 16, "file_to_download_nam": 16, "github_us": 16, "repository_nam": 16, "release_nam": 16, "path_inside_bucket": 16, "port": 16, "databas": 17, "straight": 17, "forward": 17, "fairli": 17, "complex": 17, "due": 17, "fact": 17, "each": 17, "worker": 17, "cluster": 17, "node": 17, "hold": 17, "bellow": 17, "tri": 17, "illustr": 17, "manner": 17, "pleas": 17, "look": 17, "document": 17, "advanc": 17, "artifact": 17}, "objects": {"exasol.bucketfs": [[0, 0, 1, "", "Bucket"], [0, 3, 1, "", "BucketFsError"], [0, 0, 1, "", "MappedBucket"], [0, 4, 1, "", "as_bytes"], [0, 4, 1, "", "as_file"], [0, 4, 1, "", "as_hash"], [0, 4, 1, "", "as_string"]], "exasol.bucketfs.Bucket": [[0, 1, 1, "", "__init__"], [0, 1, 1, "", "delete"], [0, 1, 1, "", "download"], [0, 2, 1, "", "files"], [0, 2, 1, "", "name"], [0, 1, 1, "", "upload"]], "exasol.bucketfs.MappedBucket": [[0, 1, 1, "", "__init__"], [0, 2, 1, "", "chunk_size"]]}, "objtypes": {"0": "py:class", "1": "py:method", "2": "py:property", "3": "py:exception", "4": "py:function"}, "objnames": {"0": ["py", "class", "Python class"], "1": ["py", "method", "Python method"], "2": ["py", "property", "Python property"], "3": ["py", "exception", "Python exception"], "4": ["py", "function", "Python function"]}, "titleterms": {"api": 0, "refer": [0, 15], "exasol": [0, 13], "bucketf": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 13, 15, 17], "servic": [0, 15], "bucket": [0, 14, 15], "as_byt": 0, "as_str": 0, "as_fil": 0, "as_hash": 0, "mappedbucket": [0, 14], "bucketfserror": 0, "chang": [1, 8], "util": [2, 3, 4], "python": [2, 3, 4, 5, 6, 7, 8, 9, 10], "0": [2, 3, 4, 5, 6, 7, 8, 9, 10], "1": 2, "releas": [2, 3, 4, 5, 6, 7, 8, 9, 10, 12], "2022": [2, 3, 4, 5, 6, 7, 8], "01": 2, "18": 2, "summari": [2, 3, 4, 5, 6, 7, 8, 9], "featur": [2, 3, 4, 5, 6, 7, 10, 13], "enhanc": [2, 3, 4, 5, 6, 7], "bug": [2, 3, 4, 5], "fix": [2, 3, 4, 5], "document": [2, 4, 5, 6, 7, 8, 10, 13], "refactor": [2, 3, 4, 5, 7], "secur": [2, 3, 7, 9], "2": 3, "04": 3, "29": 3, "3": 4, "07": 4, "20": 4, "4": 5, "09": 5, "28": 5, "5": 6, "10": 6, "12": [6, 8], "6": 7, "11": 7, "7": 8, "22": 8, "8": 9, "2023": 9, "03": 9, "21": 9, "depend": [9, 10, 12], "9": 10, "2024": 10, "02": 10, "16": 10, "intern": [10, 11], "unreleas": 11, "ad": 11, "develop": 12, "guid": [12, 17], "set": 12, "up": [12, 17], "workspac": 12, "checkout": 12, "project": 12, "instal": [12, 13], "setup": 12, "pre": 12, "commit": 12, "hook": 12, "": [12, 15], "creat": 12, "prerequisit": [12, 13], "trigger": 12, "what": 12, "do": 12, "fail": 12, "The": [12, 14, 15], "dure": 12, "check": 12, "One": 12, "step": 12, "partial": 12, "advanc": 14, "list": [14, 15], "file": [14, 15], "upload": [14, 15], "download": [14, 15], "from": [14, 15], "delet": [14, 15], "configur": [14, 15], "log": [14, 15], "basic": 15, "get": 15, "class": 15, "avail": 15, "convert": 15, "github": 16, "artifact": 16, "user": 17, "quickstart": 17, "follow": 17}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.viewcode": 1, "sphinx.ext.intersphinx": 1, "sphinx": 57}, "alltitles": {"\ud83e\uddf0 API Reference": [[0, "api-reference"]], "exasol.bucketfs.Service": [[0, "exasol-bucketfs-service"]], "exasol.bucketfs.Bucket": [[0, "exasol-bucketfs-bucket"]], "exasol.bucketfs.as_bytes": [[0, "exasol-bucketfs-as-bytes"]], "exasol.bucketfs.as_string": [[0, "exasol-bucketfs-as-string"]], "exasol.bucketfs.as_file": [[0, "exasol-bucketfs-as-file"]], "exasol.bucketfs.as_hash": [[0, "exasol-bucketfs-as-hash"]], "exasol.bucketfs.MappedBucket": [[0, "exasol-bucketfs-mappedbucket"]], "exasol.bucketfs.BucketFsError": [[0, "exasol-bucketfs-bucketfserror"]], "\ud83d\udcdd Changes": [[1, "changes"]], "BucketFs Utils Python 0.1.0, released 2022-01-18": [[2, "bucketfs-utils-python-0-1-0-released-2022-01-18"]], "Summary": [[2, "summary"], [3, "summary"], [4, "summary"], [5, "summary"], [6, "summary"], [7, "summary"], [8, "summary"], [9, "summary"]], "Features / Enhancements": [[2, "features-enhancements"], [3, "features-enhancements"], [4, "features-enhancements"], [5, "features-enhancements"], [6, "features-enhancements"], [7, "features-enhancements"]], "Bug Fixes": [[2, "bug-fixes"], [3, "bug-fixes"], [4, "bug-fixes"], [5, "bug-fixes"]], "Documentation": [[2, "documentation"], [4, "documentation"], [5, "documentation"], [6, "documentation"], [7, "documentation"], [8, "documentation"], [10, "documentation"]], "Refactoring": [[2, "refactoring"], [3, "refactoring"], [4, "refactoring"], [5, "refactoring"], [7, "refactoring"]], "Security": [[2, "security"], [3, "security"], [7, "security"], [9, "security"]], "BucketFs Utils Python 0.2.0, released 2022-04-29": [[3, "bucketfs-utils-python-0-2-0-released-2022-04-29"]], "BucketFs Utils Python 0.3.0, released 2022-07-20": [[4, "bucketfs-utils-python-0-3-0-released-2022-07-20"]], "BucketFs Python 0.4.0, released 2022-09-28": [[5, "bucketfs-python-0-4-0-released-2022-09-28"]], "BucketFs Python 0.5.0, released 2022-10-12": [[6, "bucketfs-python-0-5-0-released-2022-10-12"]], "BucketFs Python 0.6.0, released 2022-11-11": [[7, "bucketfs-python-0-6-0-released-2022-11-11"]], "BucketFs Python 0.7.0, released 2022-12-22": [[8, "bucketfs-python-0-7-0-released-2022-12-22"]], "Changes": [[8, "changes"]], "BucketFs Python 0.8.0, released 2023-03-21": [[9, "bucketfs-python-0-8-0-released-2023-03-21"]], "Dependencies": [[9, "dependencies"], [10, "dependencies"]], "BucketFs Python 0.9.0, released 2024-02-16": [[10, "bucketfs-python-0-9-0-released-2024-02-16"]], "Feature": [[10, "feature"]], "Internal": [[10, "internal"], [11, "internal"]], "Unreleased": [[11, "unreleased"]], "Added": [[11, "added"]], "\ud83d\udee0 Developer Guide": [[12, "developer-guide"]], "Setting up the workspace": [[12, "setting-up-the-workspace"]], "Checkout the Project": [[12, "checkout-the-project"]], "Install project dependencies": [[12, "install-project-dependencies"]], "Setup pre-commit hook(s)": [[12, "setup-pre-commit-hook-s"]], "Creating a Release": [[12, "creating-a-release"]], "Prerequisites": [[12, "prerequisites"]], "Triggering the Release": [[12, "triggering-the-release"]], "What to do if the release failed?": [[12, "what-to-do-if-the-release-failed"]], "The release failed during pre-release checks": [[12, "the-release-failed-during-pre-release-checks"]], "One of the release steps failed (Partial Release)": [[12, "one-of-the-release-steps-failed-partial-release"]], "Exasol Bucketfs": [[13, "exasol-bucketfs"]], "\ud83d\ude80 Features": [[13, "features"]], "\ud83d\udd0c\ufe0f Prerequisites": [[13, "prerequisites"]], "\ud83d\udcbe Installation": [[13, "installation"]], "\ud83d\udcda Documentation": [[13, "documentation"]], "Advanced": [[14, "advanced"]], "The MappedBucket": [[14, "the-mappedbucket"]], "List files in a Bucket": [[14, "list-files-in-a-bucket"], [15, "list-files-in-a-bucket"]], "Upload files to a Bucket": [[14, "upload-files-to-a-bucket"], [15, "upload-files-to-a-bucket"]], "Download files from a Bucket": [[14, "download-files-from-a-bucket"], [15, "download-files-from-a-bucket"]], "Delete files from Bucket": [[14, "delete-files-from-bucket"], [15, "delete-files-from-bucket"]], "Configure logging": [[14, "configure-logging"], [15, "configure-logging"]], "Basic\u2019s": [[15, "basic-s"]], "The Bucketfs Service": [[15, "the-bucketfs-service"]], "List buckets": [[15, "list-buckets"]], "Get a Bucket reference": [[15, "get-a-bucket-reference"]], "Bucket class": [[15, "bucket-class"]], "Available Converters": [[15, "available-converters"]], "Github Artifacts": [[16, "github-artifacts"]], "\ud83d\udc64 User Guide": [[17, "user-guide"]], "Bucketfs": [[17, "bucketfs"]], "Quickstart": [[17, "quickstart"]], "Follow Up": [[17, "follow-up"]]}, "indexentries": {"bucket (class in exasol.bucketfs)": [[0, "exasol.bucketfs.Bucket"]], "bucketfserror": [[0, "exasol.bucketfs.BucketFsError"]], "mappedbucket (class in exasol.bucketfs)": [[0, "exasol.bucketfs.MappedBucket"]], "__init__() (exasol.bucketfs.bucket method)": [[0, "exasol.bucketfs.Bucket.__init__"]], "__init__() (exasol.bucketfs.mappedbucket method)": [[0, "exasol.bucketfs.MappedBucket.__init__"]], "as_bytes() (in module exasol.bucketfs)": [[0, "exasol.bucketfs.as_bytes"]], "as_file() (in module exasol.bucketfs)": [[0, "exasol.bucketfs.as_file"]], "as_hash() (in module exasol.bucketfs)": [[0, "exasol.bucketfs.as_hash"]], "as_string() (in module exasol.bucketfs)": [[0, "exasol.bucketfs.as_string"]], "chunk_size (exasol.bucketfs.mappedbucket property)": [[0, "exasol.bucketfs.MappedBucket.chunk_size"]], "delete() (exasol.bucketfs.bucket method)": [[0, "exasol.bucketfs.Bucket.delete"]], "download() (exasol.bucketfs.bucket method)": [[0, "exasol.bucketfs.Bucket.download"]], "files (exasol.bucketfs.bucket property)": [[0, "exasol.bucketfs.Bucket.files"]], "name (exasol.bucketfs.bucket property)": [[0, "exasol.bucketfs.Bucket.name"]], "upload() (exasol.bucketfs.bucket method)": [[0, "exasol.bucketfs.Bucket.upload"]]}}) \ No newline at end of file diff --git a/user_guide/advanced.html b/user_guide/advanced.html index 4d19e5c4..4598e0fc 100644 --- a/user_guide/advanced.html +++ b/user_guide/advanced.html @@ -320,6 +320,31 @@
Internal
Delete files from Bucket
+Configure logging#
+import logging
+from exasol.bucketfs import Service
+
+# Attention:
+# It is essential to configure the root logger at the beginning of your script.
+# This ensures that log messages, including those from the bucketfs are handled correctly.
+# Without proper configuration, log messages might not appear as expected.
+logging.basicConfig(level=logging.INFO)
+
+# Explicityly Configure the bucketfs logger if you need to.
+#
+# 1. Get a reference to the bucketfs logger
+bucketfs_logger = logging.getLogger('exasol.bucketfs')
+
+# 2. Configure the bucketfs logger as needed
+# Note:
+# By default bucketfs logger is set to NOTSET (https://docs.python.org/3.11/library/logging.html#logging.NOTSET)
+# which should be sufficient in lots of cases where the root logger is configured approriately.
+bucketfs_logger.setLevel(logging.DEBUG)
+...
+
+
+
Delete files from Bucket
+Configure logging#
+import logging
+from exasol.bucketfs import Service
+
+# Attention:
+# It is essential to configure the root logger at the beginning of your script.
+# This ensures that log messages, including those from the bucketfs are handled correctly.
+# Without proper configuration, log messages might not appear as expected.
+logging.basicConfig(level=logging.INFO)
+
+# Explicityly Configure the bucketfs logger if you need to.
+#
+# 1. Get a reference to the bucketfs logger
+bucketfs_logger = logging.getLogger('exasol.bucketfs')
+
+# 2. Configure the bucketfs logger as needed
+# Note:
+# By default bucketfs logger is set to NOTSET (https://docs.python.org/3.11/library/logging.html#logging.NOTSET)
+# which should be sufficient in lots of cases where the root logger is configured approriately.
+bucketfs_logger.setLevel(logging.DEBUG)
+...
+
+
+
import logging
+from exasol.bucketfs import Service
+
+# Attention:
+# It is essential to configure the root logger at the beginning of your script.
+# This ensures that log messages, including those from the bucketfs are handled correctly.
+# Without proper configuration, log messages might not appear as expected.
+logging.basicConfig(level=logging.INFO)
+
+# Explicityly Configure the bucketfs logger if you need to.
+#
+# 1. Get a reference to the bucketfs logger
+bucketfs_logger = logging.getLogger('exasol.bucketfs')
+
+# 2. Configure the bucketfs logger as needed
+# Note:
+# By default bucketfs logger is set to NOTSET (https://docs.python.org/3.11/library/logging.html#logging.NOTSET)
+# which should be sufficient in lots of cases where the root logger is configured approriately.
+bucketfs_logger.setLevel(logging.DEBUG)
+...
+