2 ###############################################################################
4 # ddns - A dynamic DNS client for IPFire #
5 # Copyright (C) 2012 IPFire development team #
7 # This program is free software: you can redistribute it and/or modify #
8 # it under the terms of the GNU General Public License as published by #
9 # the Free Software Foundation, either version 3 of the License, or #
10 # (at your option) any later version. #
12 # This program is distributed in the hope that it will be useful, #
13 # but WITHOUT ANY WARRANTY; without even the implied warranty of #
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the #
15 # GNU General Public License for more details. #
17 # You should have received a copy of the GNU General Public License #
18 # along with this program. If not, see <http://www.gnu.org/licenses/>. #
20 ###############################################################################
23 import logging
.handlers
28 logger
= logging
.getLogger("ddns.core")
31 from .providers
import *
32 from .system
import DDNSSystem
36 rootlogger
= logging
.getLogger("ddns")
37 rootlogger
.setLevel(logging
.INFO
)
39 # Setup a logger that logs to syslog.
40 handler
= logging
.handlers
.SysLogHandler(address
="/dev/log",
41 facility
=logging
.handlers
.SysLogHandler
.LOG_DAEMON
43 handler
.setLevel(logging
.INFO
)
44 rootlogger
.addHandler(handler
)
46 handler
= logging
.StreamHandler()
47 rootlogger
.addHandler(handler
)
51 class DDNSCore(object):
52 def __init__(self
, debug
=False):
53 # In debug mode, enable debug logging.
55 logger
.setLevel(logging
.DEBUG
)
56 logger
.debug(_("Debugging mode enabled"))
58 # Initialize the settings array.
61 # Dict with all providers, that are supported.
63 self
.register_all_providers()
65 # List of configuration entries.
68 # Add the system class.
69 self
.system
= DDNSSystem(self
)
71 def register_provider(self
, provider
):
73 Registers a new provider.
75 assert issubclass(provider
, DDNSProvider
)
77 provider_handle
= provider
.INFO
.get("handle")
78 assert provider_handle
80 assert not self
.providers
.has_key(provider_handle
), \
81 "Provider '%s' has already been registered" % provider_handle
83 provider_name
= provider
.INFO
.get("name")
86 logger
.debug("Registered new provider: %s (%s)" % (provider_name
, provider_handle
))
87 self
.providers
[provider_handle
] = provider
89 def register_all_providers(self
):
91 Simply registers all providers.
100 DDNSProviderFreeDNSAfraidOrg
,
102 DDNSProviderLightningWireLabs
,
105 DDNSProviderSelfhost
,
107 DDNSProviderVariomedia
,
109 self
.register_provider(provider
)
111 def get_provider_names(self
):
113 Returns a list of names of all registered providers.
115 return sorted(self
.providers
.keys())
117 def load_configuration(self
, filename
):
118 logger
.debug(_("Loading configuration file %s") % filename
)
120 configs
= ConfigParser
.SafeConfigParser()
121 configs
.read([filename
,])
123 # First apply all global configuration settings.
124 for k
, v
in configs
.items("config"):
127 for entry
in configs
.sections():
128 # Skip the special config section.
129 if entry
== "config":
133 for k
, v
in configs
.items(entry
):
135 settings
["hostname"] = entry
137 # Get the name of the provider.
138 provider
= settings
.get("provider", None)
140 logger
.warning("Entry '%s' lacks a provider setting. Skipping." % entry
)
143 # Try to find the provider with the wanted name.
145 provider
= self
.providers
[provider
]
147 logger
.warning("Could not find provider '%s' for entry '%s'." % (provider
, entry
))
150 # Create an instance of the provider object with settings from the
151 # configuration file.
152 entry
= provider(self
, **settings
)
154 # Add new entry to list (if not already exists).
155 if not entry
in self
.entries
:
156 self
.entries
.append(entry
)
158 def updateone(self
, hostname
, **kwargs
):
159 for entry
in self
.entries
:
160 if not entry
.hostname
== hostname
:
163 return self
._update
(entry
, **kwargs
)
165 raise DDNSHostNotFoundError(hostname
)
167 def updateall(self
, **kwargs
):
169 Update all configured entries.
171 # If there are no entries, there is nothing to do.
173 logger
.debug(_("Found no entries in the configuration file. Exiting."))
176 for entry
in self
.entries
:
177 self
._update
(entry
, **kwargs
)
179 def _update(self
, entry
, force
=False):
183 except DDNSUpdateError
, e
:
184 logger
.error(_("Dynamic DNS update for %(hostname)s (%(provider)s) failed:") % \
185 { "hostname" : entry
.hostname
, "provider" : entry
.name
})
186 logger
.error(" %s" % e
)
189 logger
.error(_("Dynamic DNS update for %(hostname)s (%(provider)s) throwed an unhandled exception:") % \
190 { "hostname" : entry
.hostname
, "provider" : entry
.name
})
191 logger
.error(" %s" % e
)
194 logger
.info(_("Dynamic DNS update for %(hostname)s (%(provider)s) successful") % \
195 { "hostname" : entry
.hostname
, "provider" : entry
.name
})