nojhan/weboob-devel
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Added module dhl

Browse source 
This module enables parceloob to track parcels sent with DHL.

Signed-off-by: Matthieu Weber <mweber+weboob@free.fr>
Signed-off-by: Romain Bignon <romain@symlink.me>
This commit is contained in:
Matthieu Weber 2015-05-13 21:16:07 +03:00 • committed by Romain Bignon
commit 0111b5c5a7
6 changed files with 210 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

24
modules/dhl/__init__.py Normal file
View file

@ -0,0 +1,24 @@
# -*- coding: utf-8 -*-
# Copyright(C) 2015 Matthieu Weber
#
# This file is part of weboob.
#
# weboob is free software: you can redistribute it and/or modify
# it under the terms of the GNU Affero General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# weboob 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 Affero General Public License for more details.
#
# You should have received a copy of the GNU Affero General Public License
# along with weboob. If not, see <http://www.gnu.org/licenses/>.
from .module import DHLModule
__all__ = ['DHLModule']

32
modules/dhl/browser.py Normal file
View file

@ -0,0 +1,32 @@
# -*- coding: utf-8 -*-
# Copyright(C) 2015 Matthieu Weber
#
# This file is part of weboob.
#
# weboob is free software: you can redistribute it and/or modify
# it under the terms of the GNU Affero General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# weboob 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 Affero General Public License for more details.
#
# You should have received a copy of the GNU Affero General Public License
# along with weboob. If not, see <http://www.gnu.org/licenses/>.
from weboob.browser import PagesBrowser, URL
from .pages import SearchPage
class DHLBrowser(PagesBrowser):
BASEURL = 'http://nolp.dhl.de'
search_page = URL('/nextt-online-public/set_identcodes.do\?lang=en&idc=(?P<id>.+)', SearchPage)
def get_tracking_info(self, _id):
return self.search_page.go(id=_id).get_info(_id)

BIN
modules/dhl/favicon.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 419 B

49
modules/dhl/module.py Normal file
View file

@ -0,0 +1,49 @@
# -*- coding: utf-8 -*-
# Copyright(C) 2015 Matthieu Weber
#
# This file is part of weboob.
#
# weboob is free software: you can redistribute it and/or modify
# it under the terms of the GNU Affero General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# weboob 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 Affero General Public License for more details.
#
# You should have received a copy of the GNU Affero General Public License
# along with weboob. If not, see <http://www.gnu.org/licenses/>.
from weboob.tools.backend import Module
from weboob.capabilities.parcel import CapParcel
from .browser import DHLBrowser
__all__ = ['DHLModule']
class DHLModule(Module, CapParcel):
NAME = 'dhl'
DESCRIPTION = u'DHL website'
MAINTAINER = u'Matthieu Weber'
EMAIL = 'mweber+weboob@free.fr'
LICENSE = 'AGPLv3+'
VERSION = '1.1'
BROWSER = DHLBrowser
def get_parcel_tracking(self, id):
"""
Get information abouut a parcel.
:param id: ID of the parcel
:type id: :class:`str`
:rtype: :class:`Parcel`
:raises: :class:`ParcelNotFound`
"""
return self.browser.get_tracking_info(id)

76
modules/dhl/pages.py Normal file
View file

@ -0,0 +1,76 @@
# -*- coding: utf-8 -*-
# Copyright(C) 2015 Matthieu Weber
#
# This file is part of weboob.
#
# weboob is free software: you can redistribute it and/or modify
# it under the terms of the GNU Affero General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# weboob 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 Affero General Public License for more details.
#
# You should have received a copy of the GNU Affero General Public License
# along with weboob. If not, see <http://www.gnu.org/licenses/>.
from dateutil.parser import parse as parse_date
from weboob.browser.pages import HTMLPage
from weboob.capabilities.parcel import Parcel, Event, ParcelNotFound
# Based on http://www.parcelok.com/delivery-status-dhl.html
STATUSES = {
"The instruction data for this shipment have been provided by the sender to DHL "
"electronically": Parcel.STATUS_PLANNED,
"The shipment has been posted by the sender at the retail outlet": Parcel.STATUS_PLANNED,
"The shipment has been processed in the destination parcel center": Parcel.STATUS_IN_TRANSIT,
"The international shipment has been processed in the parcel center of origin": Parcel.STATUS_IN_TRANSIT,
"The international shipment has been processed in the export parcel center": Parcel.STATUS_IN_TRANSIT,
"The shipment will be transported to the destination country and, from there, handed over to "
"the delivery organization.": Parcel.STATUS_IN_TRANSIT,
"The shipment has arrived in the destination country": Parcel.STATUS_IN_TRANSIT,
"The shipment has arrived at the parcel center.": Parcel.STATUS_IN_TRANSIT,
"Shipment is prepared for customs clearance in country of destination": Parcel.STATUS_IN_TRANSIT,
"The shipment is being prepared for delivery in the delivery depot": Parcel.STATUS_IN_TRANSIT,
"Scheduled for delivery": Parcel.STATUS_IN_TRANSIT,
"The shipment has been loaded onto the delivery vehicle": Parcel.STATUS_IN_TRANSIT,
"Shipment has arrived at delivery location": Parcel.STATUS_IN_TRANSIT,
"With delivery courier": Parcel.STATUS_IN_TRANSIT,
"Delivery attempted; consignee premises closed": Parcel.STATUS_IN_TRANSIT,
"The shipment has been damaged and is being returned to the parcel center for"
"repackaging": Parcel.STATUS_IN_TRANSIT,
"The shipment has been successfully delivered": Parcel.STATUS_ARRIVED,
}
class SearchPage(HTMLPage):
def get_info(self, _id):
result_id = self.doc.xpath('//th[@class="mm_sendungsnummer"]')
if not result_id:
raise ParcelNotFound("No such ID: %s" % _id)
result_id = result_id[0].text
if result_id != _id:
raise ParcelNotFound("ID mismatch: expecting %s, got %s" % (_id, result_id))
p = Parcel(_id)
events = self.doc.xpath('//div[@class="accordion-inner"]/table/tbody/tr')
p.history = [self.build_event(i, tr) for i, tr in enumerate(events)]
p.status, p.info = self.guess_status(p.history[-1])
return p
def guess_status(self, most_recent):
txt = most_recent.activity
return STATUSES.get(txt, Parcel.STATUS_UNKNOWN), txt
def build_event(self, index, tr):
event = Event(index)
event.date = parse_date(tr.xpath('./td[1]')[0].text.strip(), dayfirst=True, fuzzy=True)
event.location = unicode(tr.xpath('./td[2]')[0].text.strip())
event.activity = unicode(tr.xpath('./td[3]')[0].text.strip())
return event

29
modules/dhl/test.py Normal file
View file

@ -0,0 +1,29 @@
# -*- coding: utf-8 -*-
# Copyright(C) 2015 Matthieu Weber
#
# This file is part of weboob.
#
# weboob is free software: you can redistribute it and/or modify
# it under the terms of the GNU Affero General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# weboob 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 Affero General Public License for more details.
#
# You should have received a copy of the GNU Affero General Public License
# along with weboob. If not, see <http://www.gnu.org/licenses/>.
from weboob.tools.test import BackendTest
from weboob.capabilities.parcel import ParcelNotFound
class DHLTest(BackendTest):
MODULE = 'dhl'
def test_dhl(self):
self.assertRaises(ParcelNotFound, self.backend.get_parcel_tracking, "foo")