/usr/lib/python2.7/dist-packages/roslib/resources.py is in python-roslib 1.14.2-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 | # Software License Agreement (BSD License)
#
# Copyright (c) 2008, Willow Garage, Inc.
# All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions
# are met:
#
# * Redistributions of source code must retain the above copyright
# notice, this list of conditions and the following disclaimer.
# * 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.
# * Neither the name of Willow Garage, Inc. 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 OWNER 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.
#
"""
Warning: do not use this library. It is unstable and most of the routines
here have been superceded by other libraries (e.g. rospkg). These
routines will likely be *deleted* in future releases.
"""
import os
import roslib.manifest
import roslib.names
import roslib.packages
def _get_manifest_by_dir(package_dir):
"""
Helper routine for loading Manifest instances
@param package_dir: package directory location
@type package_dir: str
@return: manifest for package
@rtype: Manifest
"""
f = os.path.join(package_dir, roslib.manifest.MANIFEST_FILE)
if f:
return roslib.manifest.parse_file(f)
else:
return None
def list_package_resources_by_dir(package_dir, include_depends, subdir, rfilter=os.path.isfile):
"""
List resources in a package directory within a particular
subdirectory. This is useful for listing messages, services, etc...
@param package_dir: package directory location
@type package_dir: str
@param subdir: name of subdirectory
@type subdir: str
@param include_depends: if True, include resources in dependencies as well
@type include_depends: bool
@param rfilter: resource filter function that returns true if filename is the desired resource type
@type rfilter: fn(filename)->bool
"""
package = os.path.basename(package_dir)
resources = []
dir = roslib.packages._get_pkg_subdir_by_dir(package_dir, subdir, False)
if os.path.isdir(dir):
resources = [roslib.names.resource_name(package, f, my_pkg=package) \
for f in os.listdir(dir) if rfilter(os.path.join(dir, f))]
else:
resources = []
if include_depends:
depends = _get_manifest_by_dir(package_dir).depends
dirs = [roslib.packages.get_pkg_subdir(d.package, subdir, False) for d in depends]
for (dep, dir_) in zip(depends, dirs): #py3k
if not dir_ or not os.path.isdir(dir_):
continue
resources.extend(\
[roslib.names.resource_name(dep.package, f, my_pkg=package) \
for f in os.listdir(dir_) if rfilter(os.path.join(dir_, f))])
return resources
def list_package_resources(package, include_depends, subdir, rfilter=os.path.isfile):
"""
List resources in a package within a particular subdirectory. This is useful for listing
messages, services, etc...
@param package: package name
@type package: str
@param subdir: name of subdirectory
@type subdir: str
@param include_depends: if True, include resources in dependencies as well
@type include_depends: bool
@param rfilter: resource filter function that returns true if filename is the desired resource type
@type rfilter: fn(filename)->bool
"""
package_dir = roslib.packages.get_pkg_dir(package)
return list_package_resources_by_dir(package_dir, include_depends, subdir, rfilter)
|