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.
97 DDNSProviderLightningWireLabs
,
100 self
.register_provider(provider
)
102 def get_provider_names(self
):
104 Returns a list of names of all registered providers.
106 return sorted(self
.providers
.keys())
108 def load_configuration(self
, filename
):
109 configs
= ConfigParser
.SafeConfigParser()
110 configs
.read([filename
,])
112 # First apply all global configuration settings.
113 for k
, v
in configs
.items("config"):
116 for entry
in configs
.sections():
117 # Skip the special config section.
118 if entry
== "config":
122 for k
, v
in configs
.items(entry
):
124 settings
["hostname"] = entry
126 # Get the name of the provider.
127 provider
= settings
.get("provider", None)
129 logger
.warning("Entry '%s' lacks a provider setting. Skipping." % entry
)
132 # Try to find the provider with the wanted name.
134 provider
= self
.providers
[provider
]
136 logger
.warning("Could not find provider '%s' for entry '%s'." % (provider
, entry
))
139 # Create an instance of the provider object with settings from the
140 # configuration file.
141 entry
= provider(self
, **settings
)
143 # Add new entry to list (if not already exists).
144 if not entry
in self
.entries
:
145 self
.entries
.append(entry
)
147 def updateone(self
, hostname
, **kwargs
):
148 for entry
in self
.entries
:
149 if not entry
.hostname
== hostname
:
152 return self
._update
(entry
, **kwargs
)
154 raise DDNSHostNotFoundError(hostname
)
156 def updateall(self
, **kwargs
):
158 Update all configured entries.
160 # If there are no entries, there is nothing to do.
162 logger
.debug(_("Found no entries in the configuration file. Exiting."))
165 for entry
in self
.entries
:
166 self
._update
(entry
, **kwargs
)
168 def _update(self
, entry
, force
=False):
172 except DDNSUpdateError
, e
:
173 logger
.error(_("Dynamic DNS update for %(hostname)s (%(provider)s) failed:") % \
174 { "hostname" : entry
.hostname
, "provider" : entry
.name
})
175 logger
.error(" %s" % e
)
178 logger
.error(_("Dynamic DNS update for %(hostname)s (%(provider)s) throwed an unhandled exception:") % \
179 { "hostname" : entry
.hostname
, "provider" : entry
.name
})
180 logger
.error(" %s" % e
)
182 logger
.info(_("Dynamic DNS update for %(hostname)s (%(provider)s) successful") % \
183 { "hostname" : entry
.hostname
, "provider" : entry
.name
})