FM / docs

/usr/lib/rads/venv/lib/python3.13/site-packages/botocore/docs/

/usr/lib/rads/venv/lib/python3.13/site-packages/botocore/docs

Name	Size	Mode	Actions
bcdoc/	-	0755	rm
__pycache__/	-	0755	rm
client.py	17321	0644	edit dl rm
docstring.py	3648	0644	edit dl rm
example.py	8945	0644	edit dl rm
method.py	12058	0644	edit dl rm
paginator.py	8988	0644	edit dl rm
params.py	11727	0644	edit dl rm
service.py	4990	0644	edit dl rm
shape.py	5198	0644	edit dl rm
sharedexample.py	9202	0644	edit dl rm
translator.py	2331	0644	edit dl rm
utils.py	7301	0644	edit dl rm
waiter.py	6546	0644	edit dl rm
__init__.py	2027	0644	edit dl rm

Edit: /usr/lib/rads/venv/lib/python3.13/site-packages/botocore/docs/docstring.py (3648B)

# Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License"). You
# may not use this file except in compliance with the License. A copy of
# the License is located at
#
# http://aws.amazon.com/apache2.0/
#
# or in the "license" file accompanying this file. This file is
# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
# ANY KIND, either express or implied. See the License for the specific
# language governing permissions and limitations under the License.
from botocore.docs.bcdoc.restdoc import DocumentStructure
from botocore.docs.method import document_model_driven_method
from botocore.docs.paginator import document_paginate_method
from botocore.docs.waiter import document_wait_method

class LazyLoadedDocstring(str):
    """Used for lazily loading docstrings

You can instantiate this class and assign it to a __doc__ value.
    The docstring will not be generated till accessed via __doc__ or
    help(). Note that all docstring classes **must** subclass from
    this class. It cannot be used directly as a docstring.
    """

def __init__(self, *args, **kwargs):
        """
        The args and kwargs are the same as the underlying document
        generation function. These just get proxied to the underlying
        function.
        """
        super().__init__()
        self._gen_args = args
        self._gen_kwargs = kwargs
        self._docstring = None

def __new__(cls, *args, **kwargs):
        # Needed in order to sub class from str with args and kwargs
        return super().__new__(cls)

def _write_docstring(self, *args, **kwargs):
        raise NotImplementedError(
            '_write_docstring is not implemented. Please subclass from '
            'this class and provide your own _write_docstring method'
        )

def expandtabs(self, tabsize=8):
        """Expands tabs to spaces

So this is a big hack in order to get lazy loaded docstring work
        for the ``help()``. In the ``help()`` function, ``pydoc`` and
        ``inspect`` are used. At some point the ``inspect.cleandoc``
        method is called. To clean the docs ``expandtabs`` is called
        and that is where we override the method to generate and return the
        docstrings.
        """
        if self._docstring is None:
            self._generate()
        return self._docstring.expandtabs(tabsize)

def __str__(self):
        return self._generate()

# __doc__ of target will use either __repr__ or __str__ of this class.
    __repr__ = __str__

def _generate(self):
        # Generate the docstring if it is not already cached.
        if self._docstring is None:
            self._docstring = self._create_docstring()
        return self._docstring

def _create_docstring(self):
        docstring_structure = DocumentStructure('docstring', target='html')
        # Call the document method function with the args and kwargs
        # passed to the class.
        self._write_docstring(
            docstring_structure, *self._gen_args, **self._gen_kwargs
        )
        return docstring_structure.flush_structure().decode('utf-8')

class ClientMethodDocstring(LazyLoadedDocstring):
    def _write_docstring(self, *args, **kwargs):
        document_model_driven_method(*args, **kwargs)

class WaiterDocstring(LazyLoadedDocstring):
    def _write_docstring(self, *args, **kwargs):
        document_wait_method(*args, **kwargs)

class PaginatorDocstring(LazyLoadedDocstring):
    def _write_docstring(self, *args, **kwargs):
        document_paginate_method(*args, **kwargs)

cmd: