Post-Local sync at 2025-06-23T22:46:07Z

.venv/lib/python3.12/site-packages/internetarchive/__init__.py

@@ -0,0 +1,89 @@
+#
+# The internetarchive module is a Python/CLI interface to Archive.org.
+#
+# Copyright (C) 2012-2024 Internet Archive
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as
+# published by the Free Software Foundation, either version 3 of the
+# License, or (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+"""
+Internetarchive Library
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Internetarchive is a python interface to archive.org.
+
+Usage::
+
+    >>> from internetarchive import get_item
+    >>> item = get_item('govlawgacode20071')
+    >>> item.exists
+    True
+
+:copyright: (C) 2012-2024 by Internet Archive.
+:license: AGPL 3, see LICENSE for more details.
+"""
+
+__title__ = 'internetarchive'
+__author__ = 'Jacob M. Johnson'
+__license__ = 'AGPL 3'
+__copyright__ = 'Copyright (C) 2012-2024 Internet Archive'
+
+from .__version__ import __version__  # isort:skip
+from internetarchive.api import (
+    configure,
+    delete,
+    download,
+    get_files,
+    get_item,
+    get_session,
+    get_tasks,
+    get_user_info,
+    get_username,
+    modify_metadata,
+    search_items,
+    upload,
+)
+from internetarchive.catalog import Catalog
+from internetarchive.files import File
+from internetarchive.item import Item
+from internetarchive.search import Search
+from internetarchive.session import ArchiveSession
+
+__all__ = [
+    # Classes.
+    'ArchiveSession',
+    'Catalog',
+    'File',
+    'Item',
+    'Search',
+    '__version__',
+    'configure',
+    'delete',
+    'download',
+    'get_files',
+    # API.
+    'get_item',
+    'get_session',
+    'get_tasks',
+    'get_username',
+    'modify_metadata',
+    'search_items',
+    'upload',
+]
+
+
+# Set default logging handler to avoid "No handler found" warnings.
+import logging
+
+log = logging.getLogger(__name__)
+log.addHandler(logging.NullHandler())