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
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
|
/*
* Copyright (C) 2011-2017 elementary Developers
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program 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 General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
* Authors: ammonkey <am.monkeyd@gmail.com>,
* lampe2 <michael@lazarski.me>,
* Victor Martinez <victoreduardm@gmail.com>
*
* The original Contractor implementation in Python was created by:
* Allen Lowe <lallenlowe@gmail.com>
*/
namespace Contractor {
[DBus (name = "org.elementary.ContractorError")]
/**
* Errors specific to the Contractor D-Bus service.
*/
public errordomain ContractorError {
/**
* Error if no MIME type was passed where mandatory.
*/
NO_MIMETYPES_GIVEN
}
/**
* A D-Bus service handling requests for Contracts defined by .contract
* files.
*/
[DBus (name = "org.elementary.Contractor")]
public class DBusService : Object {
/**
* Signal which gets sent when Contracts change.
*/
public signal void contracts_changed ();
/**
* Source from where .Contracts are loaded.
*/
private ContractSource contract_source;
/**
* Constructor to create a DBusService object and setup a
* ContractSource.
*/
public DBusService () {
contract_source = new ContractSource ();
contract_source.changed.connect (() => contracts_changed ());
}
/**
* This method gets an array of GenericContracts filtered by a
* MIME type.
*
* @param mime_type a MIME type string, e.g. text, image
*
* @return an array of GenericContracts
*/
public GenericContract[] get_contracts_by_mime (string mime_type) throws Error {
string[] mime_types = { mime_type };
return get_contracts_by_mimelist (mime_types);
}
/**
* This method gets an array of GenericContracts filtered by an array of
* MIME types.
*
* @param mime_types an array of MIME type strings, e.g. text, image
*
* @return an array of GenericContracts
*/
public GenericContract[] get_contracts_by_mimelist (string[] mime_types) throws Error {
var all_contracts = contract_source.get_contracts ();
var contracts = ContractMatcher.get_contracts_for_types (mime_types, all_contracts);
return convert_to_generic_contracts (contracts);
}
/**
* This method gets an array of GenericContracts filtered by the file
* size in bytes.
*
* @param file_size the file size in bytes, e.g. from FileInfo.get_size ()
*
* @return an array of GenericContracts
*/
public GenericContract[] get_contracts_by_file_size (int64 file_size) throws Error {
var all_contracts = contract_source.get_contracts ();
var contracts = ContractMatcher.get_contracts_for_file_size (file_size, all_contracts);
return convert_to_generic_contracts (contracts);
}
/**
* This method gets an array of GenericContracts filtered by a MIME type
* and the file size in bytes.
*
* @param mime_type a MIME type string, e.g. text, image
* @param file_size the file size in bytes, e.g. from FileInfo.get_size ()
*
* @return an array of GenericContracts
*/
public GenericContract[] get_contracts_by_mime_and_file_size (string mime_type, int64 file_size) throws Error {
string[] mime_types = { mime_type };
return get_contracts_by_mimelist_and_file_size (mime_types, file_size);
}
/**
* This method gets an array of GenericContracts filtered by an array of
* MIME types and the file size in bytes.
*
* The file size should probably be the sum of all files file size.
*
* @param mime_types an array of MIME type strings, e.g. text, image
* @param file_size the file size in bytes, e.g. from FileInfo.get_size ()
*
* @return an array of GenericContracts
*/
public GenericContract[] get_contracts_by_mimelist_and_file_size (string[] mime_types, int64 file_size) throws Error {
var all_contracts = contract_source.get_contracts ();
var contracts = ContractMatcher.get_contracts_for_types_and_file_size (mime_types, file_size, all_contracts);
return convert_to_generic_contracts (contracts);
}
public void execute_with_uri (string id, string uri) throws Error {
string[] uris = { uri };
execute_with_uri_list (id, uris);
}
public void execute_with_uri_list (string id, string[] uris) throws Error {
var contract = contract_source.lookup_by_id (id);
contract.launch_uris (uris);
}
/**
* This method gets an array of GenericContracts containing all
* contracts that exist.
*
* @return an array of GenericContracts containing all contracts
*/
public GenericContract[] list_all_contracts () {
var contracts = contract_source.get_contracts ();
return convert_to_generic_contracts (contracts);
}
/**
* Converts a Collection of Contracts into an array of
* GenericContracts.
*
* @return an array of GenericContracts
*/
private static GenericContract[] convert_to_generic_contracts (Gee.Collection<Contract> contracts) {
var generic_contracts = new GenericContract[0];
foreach (var contract in contracts) {
generic_contracts += contract.get_generic ();
}
return generic_contracts;
}
}
}
|