2 @deprecated: see L{driver} instead.
5 # Copyright (C) 2009, Thomas Leonard
6 # See the README file for details, or visit http://0install.net.
8 from zeroinstall
import _
9 from logging
import info
11 from zeroinstall
import SafeException
12 from zeroinstall
.injector
import driver
13 from zeroinstall
.injector
.model
import Interface
, Implementation
, network_offline
14 from zeroinstall
.injector
.config
import load_config
17 """@deprecated: Use Driver instead."""
18 __slots__
= ['driver']
20 help_with_testing
= property(lambda self
: self
.config
.help_with_testing
,
21 lambda self
, value
: setattr(self
.config
, 'help_with_testing', bool(value
)))
23 network_use
= property(lambda self
: self
.config
.network_use
,
24 lambda self
, value
: setattr(self
.config
, 'network_use', value
))
26 freshness
= property(lambda self
: self
.config
.freshness
,
27 lambda self
, value
: setattr(self
.config
, 'freshness', str(value
)))
29 target_arch
= property(lambda self
: self
.driver
.target_arch
,
30 lambda self
, value
: setattr(self
.driver
, 'target_arch', value
))
32 implementation
= property(lambda self
: self
.solver
.selections
)
34 ready
= property(lambda self
: self
.solver
.ready
)
35 config
= property(lambda self
: self
.driver
.config
)
36 requirements
= property(lambda self
: self
.driver
.requirements
)
39 handler
= property(lambda self
: self
.config
.handler
,
40 lambda self
, value
: setattr(self
.config
, 'handler', value
))
43 def __init__(self
, root
= None, handler
= None, src
= None, command
= -1, config
= None, requirements
= None):
45 @param requirements: Details about the program we want to run
46 @type requirements: L{requirements.Requirements}
47 @param config: The configuration settings to use, or None to load from disk.
48 @type config: L{config.Config}
49 Note: all other arguments are deprecated (since 0launch 0.52)
52 #warnings.warn("Policy is deprecated; use a Driver instead", DeprecationWarning, 2)
53 if requirements
is None:
54 from zeroinstall
.injector
.requirements
import Requirements
55 requirements
= Requirements(root
)
56 requirements
.source
= bool(src
) # Root impl must be a "src" machine type
62 requirements
.command
= command
64 assert root
== src
== None
68 config
= load_config(handler
)
70 assert handler
is None, "can't pass a handler and a config"
72 self
.driver
= driver
.Driver(config
= config
, requirements
= requirements
)
76 return self
.config
.fetcher
80 return self
.driver
.watchers
84 return self
.driver
.solver
86 def save_config(self
):
87 self
.config
.save_globals()
89 def usable_feeds(self
, iface
):
90 """Generator for C{iface.feeds} that are valid for our architecture.
93 a
= self
.driver
.target_arch
94 if iface
.uri
!= self
.root
:
95 # note: assumes that only the root arch may be different (e.g. if using --source)
97 return self
.config
.iface_cache
.usable_feeds(iface
, a
)
99 def is_stale(self
, feed
):
100 """@deprecated: use IfaceCache.is_stale"""
101 return self
.config
.iface_cache
.is_stale(feed
, self
.config
.freshness
)
103 def get_implementation_path(self
, impl
):
104 """Return the local path of impl.
106 @raise zeroinstall.zerostore.NotStored: if it needs to be added to the cache first."""
107 assert isinstance(impl
, Implementation
)
108 return impl
.local_path
or self
.config
.stores
.lookup_any(impl
.digests
)
110 def get_implementation(self
, interface
):
111 """Get the chosen implementation.
112 @type interface: Interface
113 @rtype: L{model.Implementation}
114 @raise SafeException: if interface has not been fetched or no implementation could be
116 assert isinstance(interface
, Interface
)
119 return self
.implementation
[interface
]
121 raise SafeException(_("No usable implementation found for '%s'.") % interface
.uri
)
123 def get_cached(self
, impl
):
124 """Check whether an implementation is available locally.
125 @type impl: model.Implementation
128 return impl
.is_available(self
.config
.stores
)
130 def get_uncached_implementations(self
):
131 return self
.driver
.get_uncached_implementations()
133 def refresh_all(self
, force
= True):
134 """Start downloading all feeds for all selected interfaces.
135 @param force: Whether to restart existing downloads."""
136 return self
.solve_with_downloads(force
= True)
138 def get_feed_targets(self
, feed
):
139 """@deprecated: use IfaceCache.get_feed_targets"""
140 return self
.config
.iface_cache
.get_feed_targets(feed
)
142 def solve_with_downloads(self
, force
= False, update_local
= False):
143 return self
.driver
.solve_with_downloads(force
, update_local
)
145 def solve_and_download_impls(self
, refresh
= False, select_only
= False):
146 return self
.driver
.solve_and_download_impls(refresh
, select_only
)
148 def need_download(self
):
149 return self
.driver
.need_download()
151 def download_uncached_implementations(self
):
152 return self
.driver
.download_uncached_implementations()
154 def download_icon(self
, interface
, force
= False):
155 """Download an icon for this interface and add it to the
156 icon cache. If the interface has no icon or we are offline, do nothing.
157 @return: the task doing the import, or None
158 @rtype: L{tasks.Task}"""
159 if self
.network_use
== network_offline
:
160 info("Not downloading icon for %s as we are off-line", interface
)
163 return self
.fetcher
.download_icon(interface
, force
)
165 def get_interface(self
, uri
):
166 """@deprecated: use L{iface_cache.IfaceCache.get_interface} instead"""
168 warnings
.warn("Policy.get_interface is deprecated!", DeprecationWarning, stacklevel
= 2)
169 return self
.config
.iface_cache
.get_interface(uri
)
173 return self
.requirements
.command
177 return self
.requirements
.interface_uri
180 def get_deprecated_singleton_config():
183 _config
= load_config()