docs: def get_by_bucket(cls, bucket, versions=False, with_deleted=False):
          """Return query that fetches all the objects in a bucket.
  
          :param bucket: The bucket (instance or id) to query.
          :param versions: Select all versions if True, only heads otherwise.
          :param with_deleted: Select also deleted objects if True.
          :returns: The query to retrieve filtered objects in the given bucket.
          """
          bucket_id = bucket.id if isinstance(bucket, Bucket) else bucket
  
          filters = [
              cls.bucket_id == bucket_id,
          ]
  
          if not versions:
              filters.append(cls.is_head.is_(True))
  
          if not with_deleted:
              filters.append(cls.file_id.isnot(None))
  
          return cls.query.filter(*filters).order_by(cls.key, cls.created.desc())