/usr/include/GNUstep/NGExtensions/NGResourceLocator.h is in libsope-dev 2.2.17-1build2.
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 | /*
Copyright (C) 2004-2005 SKYRIX Software AG
This file is part of SOPE.
SOPE is free software; you can redistribute it and/or modify it under
the terms of the GNU Lesser General Public License as published by the
Free Software Foundation; either version 2, or (at your option) any
later version.
SOPE is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
License for more details.
You should have received a copy of the GNU Lesser General Public
License along with SOPE; see the file COPYING. If not, write to the
Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA
02111-1307, USA.
*/
#ifndef __NGExtensions_NGResourceLocator_H__
#define __NGExtensions_NGResourceLocator_H__
#import <Foundation/NSObject.h>
/*
NGResourceLocator
This class can be used by libraries to lookup resources in either the GNUstep
hierarchy or in FHS locations (/usr/local etc).
The pathes given in are relative to the respective root, eg: "Library/Models"
and "share/mytool/models".
*/
@class NSString, NSArray, NSFileManager, NSMutableDictionary;
@interface NGResourceLocator : NSObject
{
NSString *gsSubPath;
NSString *fhsSubPath;
NSFileManager *fileManager;
NSArray *searchPathes;
NSMutableDictionary *nameToPathCache;
struct {
int cacheSearchPathes:1;
int cachePathHits:1;
int cachePathMisses:1;
int reserved:29;
} flags;
}
/* The 'GNUstepPath' is a string describing the required path. This
* is the relative location of the path in a standard GNUstep
* hierarchy when a standard GNUstep hierarchy is being used; but if
* gnustep-base (which supports arbitrary filesystem layouts) is being
* used, the path is heuristically mapped to the standard paths
* accepted by NSSearchPathForDirectoriesInDomains using the following
* logic:
*
* "Library/WebApplications" --> GSWebApplicationsDirectory
* "Library/Libraries" --> GSLibrariesDirectory
* "Tools" --> GSToolsDirectory
* "Tools/Admin" --> GSAdminToolsDirectory
* "Applications" --> GSApplicationsDirectory
* "Applications/Admin" --> GSAdminApplicationsDirectory
* "Library/xxx" --> NSLibraryDirectory/xxx
* "yyy" --> NSLibraryDirectory/yyy
*
* In the last two cases 'xxx' and 'yyy' are arbitrary strings/paths
* that don't match anything else. Eg, if you create an
* NGResourceLocators to look up files in "Library/Resources" you will
* get one that looks them up in NSLibraryDirectory/Resources (which
* means a list of directories containing
* GNUSTEP_USER_LIBRARY/Resources, GNUSTEP_LOCAL_LIBRARY/Resources,
* GNUSTEP_NETWORK_LIBRARY/Resources,
* GNUSTEP_SYSTEM_LIBRARY/Resources).
*/
+ (id)resourceLocatorForGNUstepPath:(NSString *)_path fhsPath:(NSString *)_fhs;
- (id)initWithGNUstepPath:(NSString *)_path fhsPath:(NSString *)_fhs;
/* resource pathes */
/* It's not a good idea to access these directly if you want portable
* code. More logical to use directly the 'operations' lookup methods
* below which encapsulate all the internal filesystem details.
*/
- (NSArray *)gsRootPathes; /* GNUSTEP_PATHPREFIX_LIST or MacOSX */
- (NSArray *)fhsRootPathes;
- (NSArray *)searchPathes;
/* operations */
/* These are public and work across all types of filesystems, it's how you find resources. */
- (NSString *)lookupFileWithName:(NSString *)_name;
- (NSString *)lookupFileWithName:(NSString *)_name extension:(NSString *)_ext;
- (NSArray *)lookupAllFilesWithExtension:(NSString *)_ext
doReturnFullPath:(BOOL)_withPath;
/* End public */
@end
#endif /* __NGExtensions_NGResourceLocator_H__ */
|