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 rootlogger
= logging
.getLogger("ddns")
56 rootlogger
.setLevel(logging
.DEBUG
)
58 logger
.debug(_("Debugging mode enabled"))
60 # Initialize the settings array.
63 # Dict with all providers, that are supported.
65 self
.register_all_providers()
67 # List of configuration entries.
70 # Add the system class.
71 self
.system
= DDNSSystem(self
)
73 def register_provider(self
, provider
):
75 Registers a new provider.
77 assert issubclass(provider
, DDNSProvider
)
79 if not all((provider
.handle
, provider
.name
, provider
.website
)):
80 raise DDNSError(_("Provider is not properly configured"))
82 assert not self
.providers
.has_key(provider
.handle
), \
83 "Provider '%s' has already been registered" % provider
.handle
85 logger
.debug("Registered new provider: %s (%s)" % (provider
.name
, provider
.handle
))
86 self
.providers
[provider
.handle
] = provider
88 def register_all_providers(self
):
90 Simply registers all providers.
100 DDNSProviderFreeDNSAfraidOrg
,
101 DDNSProviderNamecheap
,
103 DDNSProviderLightningWireLabs
,
106 DDNSProviderSelfhost
,
111 DDNSProviderVariomedia
,
112 DDNSProviderZoneedit
,
114 self
.register_provider(provider
)
116 def get_provider_names(self
):
118 Returns a list of names of all registered providers.
120 return sorted(self
.providers
.keys())
122 def load_configuration(self
, filename
):
123 logger
.debug(_("Loading configuration file %s") % filename
)
125 configs
= ConfigParser
.SafeConfigParser()
126 configs
.read([filename
,])
128 # First apply all global configuration settings.
129 for k
, v
in configs
.items("config"):
132 for entry
in configs
.sections():
133 # Skip the special config section.
134 if entry
== "config":
138 for k
, v
in configs
.items(entry
):
140 settings
["hostname"] = entry
142 # Get the name of the provider.
143 provider
= settings
.get("provider", None)
145 logger
.warning("Entry '%s' lacks a provider setting. Skipping." % entry
)
148 # Try to find the provider with the wanted name.
150 provider
= self
.providers
[provider
]
152 logger
.warning("Could not find provider '%s' for entry '%s'." % (provider
, entry
))
155 # Create an instance of the provider object with settings from the
156 # configuration file.
157 entry
= provider(self
, **settings
)
159 # Add new entry to list (if not already exists).
160 if not entry
in self
.entries
:
161 self
.entries
.append(entry
)
163 def updateone(self
, hostname
, **kwargs
):
164 for entry
in self
.entries
:
165 if not entry
.hostname
== hostname
:
168 return self
._update
(entry
, **kwargs
)
170 raise DDNSHostNotFoundError(hostname
)
172 def updateall(self
, **kwargs
):
174 Update all configured entries.
176 # If there are no entries, there is nothing to do.
178 logger
.debug(_("Found no entries in the configuration file. Exiting."))
181 for entry
in self
.entries
:
182 self
._update
(entry
, **kwargs
)
184 def _update(self
, entry
, force
=False):
189 logger
.error(_("Dynamic DNS update for %(hostname)s (%(provider)s) failed:") % \
190 { "hostname" : entry
.hostname
, "provider" : entry
.name
})
191 logger
.error(" %s: %s" % (e
.__class
__.__name
__, e
.reason
))
193 logger
.error(" %s" % e
.message
)
196 logger
.error(_("Dynamic DNS update for %(hostname)s (%(provider)s) throwed an unhandled exception:") % \
197 { "hostname" : entry
.hostname
, "provider" : entry
.name
}, exc_info
=True)
200 logger
.info(_("Dynamic DNS update for %(hostname)s (%(provider)s) successful") % \
201 { "hostname" : entry
.hostname
, "provider" : entry
.name
})