This file is indexed.

/usr/bin/copy-from-journal is in python-carquinyol 0.106.0-1.

This file is owned by root:root, with mode 0o755.

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
#!/usr/bin/python
#
# Simple script to export a file from the datastore
# Reinier Heeres, <reinier@heeres.eu>, 2007-12-24
# Phil Bordelon <phil@thenexusproject.org>

import os
import shutil
import optparse
import dbus

if os.path.exists("/tmp/olpc-session-bus"):
    os.environ["DBUS_SESSION_BUS_ADDRESS"] = "unix:path=/tmp/olpc-session-bus"

from sugar3.datastore import datastore
import sugar3.mime

# Limit the number of objects returned on an ambiguous query to this number,
# for quicker operation.
RETURN_LIMIT = 2


def build_option_parser():

    usage = "Usage: %prog [-o OBJECT_ID] [-q SEARCH_STR] [-m] OUTFILE"
    parser = optparse.OptionParser(usage=usage)

    parser.add_option("-o", "--object_id", action="store", dest="object_id",
                      help="Retrieve object with explicit ID OBJECT_ID",
                      metavar="OBJECT_ID", default=None)

    parser.add_option("-q", "--query", action="store", dest="query",
                      help="Full-text-search the metadata for SEARCH_STR",
                      metavar="SEARCH_STR", default=None)

    parser.add_option("-m", "--metadata", action="store_true",
            dest="show_meta",
            help="Show all non-preview metadata [default: hide]",
            default=False)

    return parser

if __name__ == "__main__":

    option_parser = build_option_parser()
    options, args = option_parser.parse_args()
    if len(args) < 1:
        option_parser.print_help()
        exit(0)

    try:
        dsentry = None

        # Get object directly if we were given an explicit object ID.
        if options.object_id is not None:
            dsentry = datastore.get(options.object_id)

        # Compose the query based on the options provided.
        if dsentry is None:
            query = {}

            if options.query is not None:
                query['query'] = options.query

            # We only want a single file at a time; limit the number of objects
            # returned to two, as anything more than one means the criteria
            # were not limited enough.
            objects, count = \
                    datastore.find(query, limit=RETURN_LIMIT, sorting='-mtime')
            if count > 1:
                print 'WARNING: %d objects found; getting most recent.' % count
                for i in xrange(1, RETURN_LIMIT):
                    objects[i].destroy()

            if count > 0:
                dsentry = objects[0]

        # If neither an explicit object ID nor a query gave us data, fail.
        if dsentry is None:
            print 'ERROR: unable to determine journal object to copy.'
            option_parser.print_help()
            exit(0)

        # Print metadata if that is what the user asked for.
        if options.show_meta:
            print 'Metadata:'
            for key, val in dsentry.metadata.get_dictionary().iteritems():
                if key != 'preview':
                    print '%20s -> %s' % (key, val)

        # If no file is associated with this object, we can't save it out.
        if dsentry.get_file_path() == "":
            print 'ERROR: no file associated with object, just metadata.'
            dsentry.destroy()
            exit(0)

        outname = args[0]
        outroot, outext = os.path.splitext(outname)

        # Do our best to determine the output file extension, based on Sugar's
        # MIME-type-to-extension mappings.
        if outext == "":
            mimetype = dsentry.metadata['mime_type']
            outext = sugar.mime.get_primary_extension(mimetype)
            if outext == None:
                outext = "dsobject"
            outext = '.' + outext

        # Lastly, actually copy the file out of the datastore and onto the
        # filesystem.
        shutil.copyfile(dsentry.get_file_path(), outroot + outext)
        print '%s -> %s' % (dsentry.get_file_path(), outroot + outext)

        # Cleanup.
        dsentry.destroy()

    except dbus.DBusException:
        print 'ERROR: Unable to connect to the datastore.\n'\
              'Check that you are running in the same environment as the '\
              'datastore service.'

    except Exception, e:
        print 'ERROR: %s' % (e)