You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
146 lines
4.9 KiB
146 lines
4.9 KiB
# -*- coding: utf-8 -*-
|
|
# BSD 3-Clause License
|
|
#
|
|
# Apprise - Push Notification Library.
|
|
# Copyright (c) 2023, Chris Caron <lead2gold@gmail.com>
|
|
#
|
|
# Redistribution and use in source and binary forms, with or without
|
|
# modification, are permitted provided that the following conditions are met:
|
|
#
|
|
# 1. Redistributions of source code must retain the above copyright notice,
|
|
# this list of conditions and the following disclaimer.
|
|
#
|
|
# 2. Redistributions in binary form must reproduce the above copyright notice,
|
|
# this list of conditions and the following disclaimer in the documentation
|
|
# and/or other materials provided with the distribution.
|
|
#
|
|
# 3. Neither the name of the copyright holder nor the names of its
|
|
# contributors may be used to endorse or promote products derived from
|
|
# this software without specific prior written permission.
|
|
#
|
|
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
|
|
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
# POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
import re
|
|
import os
|
|
from .AttachBase import AttachBase
|
|
from ..common import ContentLocation
|
|
from ..AppriseLocale import gettext_lazy as _
|
|
|
|
|
|
class AttachFile(AttachBase):
|
|
"""
|
|
A wrapper for File based attachment sources
|
|
"""
|
|
|
|
# The default descriptive name associated with the service
|
|
service_name = _('Local File')
|
|
|
|
# The default protocol
|
|
protocol = 'file'
|
|
|
|
# Content is local to the same location as the apprise instance
|
|
# being called (server-side)
|
|
location = ContentLocation.LOCAL
|
|
|
|
def __init__(self, path, **kwargs):
|
|
"""
|
|
Initialize Local File Attachment Object
|
|
|
|
"""
|
|
super().__init__(**kwargs)
|
|
|
|
# Store path but mark it dirty since we have not performed any
|
|
# verification at this point.
|
|
self.dirty_path = os.path.expanduser(path)
|
|
return
|
|
|
|
def url(self, privacy=False, *args, **kwargs):
|
|
"""
|
|
Returns the URL built dynamically based on specified arguments.
|
|
"""
|
|
|
|
# Define any URL parameters
|
|
params = {}
|
|
|
|
if self._mimetype:
|
|
# A mime-type was enforced
|
|
params['mime'] = self._mimetype
|
|
|
|
if self._name:
|
|
# A name was enforced
|
|
params['name'] = self._name
|
|
|
|
return 'file://{path}{params}'.format(
|
|
path=self.quote(self.dirty_path),
|
|
params='?{}'.format(self.urlencode(params)) if params else '',
|
|
)
|
|
|
|
def download(self, **kwargs):
|
|
"""
|
|
Perform retrieval of our data.
|
|
|
|
For file base attachments, our data already exists, so we only need to
|
|
validate it.
|
|
"""
|
|
|
|
if self.location == ContentLocation.INACCESSIBLE:
|
|
# our content is inaccessible
|
|
return False
|
|
|
|
# Ensure any existing content set has been invalidated
|
|
self.invalidate()
|
|
|
|
if not os.path.isfile(self.dirty_path):
|
|
return False
|
|
|
|
if self.max_file_size > 0 and \
|
|
os.path.getsize(self.dirty_path) > self.max_file_size:
|
|
|
|
# The content to attach is to large
|
|
self.logger.error(
|
|
'Content exceeds allowable maximum file length '
|
|
'({}KB): {}'.format(
|
|
int(self.max_file_size / 1024), self.url(privacy=True)))
|
|
|
|
# Return False (signifying a failure)
|
|
return False
|
|
|
|
# We're good to go if we get here. Set our minimum requirements of
|
|
# a call do download() before returning a success
|
|
self.download_path = self.dirty_path
|
|
self.detected_name = os.path.basename(self.download_path)
|
|
|
|
# We don't need to set our self.detected_mimetype as it can be
|
|
# pulled at the time it's needed based on the detected_name
|
|
return True
|
|
|
|
@staticmethod
|
|
def parse_url(url):
|
|
"""
|
|
Parses the URL so that we can handle all different file paths
|
|
and return it as our path object
|
|
|
|
"""
|
|
|
|
results = AttachBase.parse_url(url, verify_host=False)
|
|
if not results:
|
|
# We're done early; it's not a good URL
|
|
return results
|
|
|
|
match = re.match(r'file://(?P<path>[^?]+)(\?.*)?', url, re.I)
|
|
if not match:
|
|
return None
|
|
|
|
results['path'] = AttachFile.unquote(match.group('path'))
|
|
return results
|