blob: 757b6ed683e977f6ebd8ad96690aa5e4a74155fc (
plain)
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
|
#ifndef EINA_VPATH_H
#define EINA_VPATH_H
#include "eina_prefix.h"
/**
* Eina vpath is a path that can be prefixed with a virtual path.
*
* A virtual path can either start with (:XXXXXXXX:) that indicates a virtual
* path with XXXXXXXX as the location, OR a normal path with / or a relative
* path like ./ or ../ or even shell common locators like ~/ or ~username/
*
* The string between (: and :) is used as key to lookup the real value.
* The key has to be set by an interface before, otherwise you will get an
* error.
*
* Sample paths:
*
* ~/myfiles/file.png
* ~bob/dir/file.txt
* /path/to/file.cfg
* ./file/relative/path.txt
* file/relative/path.txt
* (:tmp:)/some-temp-file/file.txt
* (:home:)/myfiles/file.png
*
* (:app.dir:)/bin/app-executable
* (:app.bin:)/app-executable-file
* (:app.lib:)/app-library.so
* (:app.data:)/application/datafile.png
* (:app.locale:)/en_US/LC_MESSAGES/app.mo
* (:app.config:)/application-config.xml
* (:app.local:)/application-data-file.jpg
* (:app.tmp:)/some-temp-file/path/file.txt
*
* (:usr.desktop:)/file-in-users-desktop-directory.txt
* (:usr.documents:)/letter-to-gradma.doc
* (:usr.downloads:)/file-downloaded-here.zip
* (:usr.music:)/fave-song.mp3
* (:usr.pictures:)/a-photo.,jpg
* (:usr.public:)/some-publicly-shared-file
* (:usr.templates:)/some-template-document.txt
* (:usr.videos:)/some-video-file.mp4
* (:usr.data:)/file-in-user-data-dir
* (:usr.config:)/file-in-user-conifg-dir
* (:usr.cache:)/file-in-user-cache-dir
* (:usr.run:)/file-in-xdg-runtime-dir
* (:usr.tmp:)/some-temp-file/path/file.txt
*
* Commonly mapped to real path (but may vary):
*
* (:tmp:) - /tmp
* (:home:) - ~/
*
* (:app.dir:) - /usr - (assuming app install PREFIX of /usr. may be /usr/local or others too)
* (:app.bin:) - /usr/bin - (almost always PREFIX/bin)
* (:app.lib:) - /usr/lib - (almost always PREFIX/lib)
* (:app.data:) - /usr/share/appname - (almost always PREFIX/share/appname)
* (:app.locale:) - /usr/share/locale - (almost always PREFIX/locale)
* (:app.config:) - ~/.config/appname
* (:app.local:) - ~/.local/share/appname
* (:app.tmp:) - ~/.local/tmp/appname
*
* (:usr.desktop:) - ~/Desktop
* (:usr.documents:) - ~/Documents
* (:usr.downloads:) - ~/Downloads
* (:usr.music:) - ~/Music
* (:usr.pictures:) - ~/Pictures
* (:usr.public:) - ~/Public
* (:usr.templates:) - ~/Templates
* (:usr.videos:) - ~/Videos
* (:usr.data:) - ~/.local/share
* (:usr.config:) - ~/.config
* (:usr.cache:) - ~/.cache
* (:usr.run:) - /var/run/user/1000
* (:usr.tmp:) - ~/.local/tmp
*
* Additional info: https://phab.enlightenment.org/w/eina_vpath/
*
*/
typedef const char * Eina_Vpath;
/*
* Translate a virtual path into a normal path.
*
* @return NULL if failed, or a full normal string file path that is resolved
*
*/
EAPI char *eina_vpath_resolve(Eina_Vpath path);
#endif
|
