/usr/share/pyshared/Pyblosxom/entries/fileentry.py is in pyblosxom 1.5.3-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 | #######################################################################
# This file is part of Pyblosxom.
#
# Copyright (C) 2003-2011 by the Pyblosxom team. See AUTHORS.
#
# Pyblosxom is distributed under the MIT license. See the file
# LICENSE for distribution details.
#######################################################################
"""
This module contains FileEntry class which is used to retrieve entries
from a file system. Since pulling data from the file system and
parsing it is expensive (especially when you have 100s of entries) we
delay fetching data until it's demanded.
The FileEntry calls EntryBase methods addToCache and getFromCache to
handle caching.
"""
import time
import os
import re
from Pyblosxom import tools
from Pyblosxom.entries import base
class FileEntry(base.EntryBase):
"""
This class gets it's data and metadata from the file specified
by the filename argument.
"""
def __init__(self, request, filename, root, datadir=""):
"""
:param request: the Request object
:param filename: the complete filename for the file in question
including path
:param root: i have no clue what this is
:param datadir: the datadir
"""
base.EntryBase.__init__(self, request)
self._config = request.get_configuration()
self._filename = filename.replace(os.sep, '/')
self._root = root.replace(os.sep, '/')
self._datadir = datadir or self._config["datadir"]
if self._datadir.endswith(os.sep):
self._datadir = self._datadir[:-1]
self._timetuple = tools.filestat(self._request, self._filename)
self._mtime = time.mktime(self._timetuple)
self._fulltime = time.strftime("%Y%m%d%H%M%S", self._timetuple)
self._populated_data = 0
def __repr__(self):
return "<fileentry f'%s' r'%s'>" % (self._filename, self._root)
def get_id(self):
"""
Returns the id for this content item--in this case, it's the
filename.
:returns: the id of the fileentry (the filename)
"""
return self._filename
getId = tools.deprecated_function(get_id)
def get_data(self):
"""
Returns the data for this file entry. The data is the parsed
(via the entryparser) content of the entry. We do this on-demand
by checking to see if we've gotten it and if we haven't then
we get it at that point.
:returns: the content for this entry
"""
if self._populated_data == 0:
self._populatedata()
return self._data
getData = tools.deprecated_function(get_data)
def get_metadata(self, key, default=None):
"""
This overrides the ``base.EntryBase`` ``get_metadata`` method.
.. Note::
We populate our metadata lazily--only when it's requested.
This delays parsing of the file as long as we can.
"""
if self._populated_data == 0:
self._populatedata()
return self._metadata.get(key, default)
getMetadata = tools.deprecated_function(get_metadata)
def _populatedata(self):
"""
Fills the metadata dict with metadata about the given file.
This metadata consists of things we pick up from an os.stat
call as well as knowledge of the filename and the root
directory. We then parse the file and fill in the rest of the
information that we know.
"""
file_basename = os.path.basename(self._filename)
path = self._filename.replace(self._root, '')
path = path.replace(os.path.basename(self._filename), '')
path = path[:-1]
absolute_path = self._filename.replace(self._datadir, '')
absolute_path = self._filename.replace(self._datadir, '', 1)
absolute_path = absolute_path.replace(file_basename, '')
absolute_path = absolute_path[1:][:-1]
if absolute_path and absolute_path[-1] == "/":
absolute_path = absolute_path[0:-1]
filenamenoext = os.path.splitext(file_basename)[0]
if absolute_path == '':
file_path = filenamenoext
else:
file_path = '/'.join((absolute_path, filenamenoext))
tb_id = '%s/%s' % (absolute_path, filenamenoext)
tb_id = re.sub(r'[^A-Za-z0-9]', '_', tb_id)
self['path'] = path
self['tb_id'] = tb_id
self['absolute_path'] = absolute_path
self['file_path'] = file_path
self['fn'] = filenamenoext
self['filename'] = self._filename
self.set_time(self._timetuple)
data = self._request.get_data()
entrydict = self.get_from_cache(self._filename)
if not entrydict:
fileext = os.path.splitext(self._filename)
if fileext:
fileext = fileext[1][1:]
eparser = data['extensions'][fileext]
entrydict = eparser(self._filename, self._request)
self.add_to_cache(self._filename, entrydict)
self.update(entrydict)
self._populated_data = 1
|