From a6de82b986d42b4f35f79f361dc4278571810461 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pierre=20Mazi=C3=A8re?= <pierre.maziere@gmx.com>
Date: Mon, 9 Sep 2013 23:05:46 +0200
Subject: [PATCH] new capability ICapFile
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

for web sites providing search and files download

Signed-off-by: Pierre Mazière <pierre.maziere@gmx.com>
---
 weboob/capabilities/file.py | 78 +++++++++++++++++++++++++++++++++++++
 1 file changed, 78 insertions(+)
 create mode 100644 weboob/capabilities/file.py

diff --git a/weboob/capabilities/file.py b/weboob/capabilities/file.py
new file mode 100644
index 00000000..7881603f
--- /dev/null
+++ b/weboob/capabilities/file.py
@@ -0,0 +1,78 @@
+# -*- coding: utf-8 -*-
+
+# Copyright(C) 2013 Pierre Mazière
+#
+# 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 .base import IBaseCap, CapBaseObject, NotAvailable, Field, StringField, DateField
+
+
+__all__ = ['BaseFile','ICapFile']
+
+class BaseFile(CapBaseObject):
+    """
+    Represent a file.
+    """
+    title =         StringField('File title')
+    url =           StringField('File URL')
+    author =        StringField('File author')
+    description =   StringField('File description')
+    date =          DateField('File publication date')
+    rating =        Field('Rating', int, long, float, default=NotAvailable)
+    rating_max =    Field('Maximum rating', int, long, float, default=NotAvailable)
+
+    @classmethod
+    def id2url(cls, _id):
+        """
+        Overloaded in child classes provided by backends.
+        """
+        raise NotImplementedError()
+
+    @property
+    def page_url(self):
+        """
+        Get file page URL
+        """
+        return self.id2url(self.id)
+
+class ICapFile(IBaseCap):
+    """
+    Provide file download
+    """
+    (SEARCH_RELEVANCE,
+     SEARCH_RATING,
+     SEARCH_VIEWS,
+     SEARCH_DATE) = range(4)
+
+    def search_file(self,pattern,sortby=SEARCH_RELEVANCE):
+        """
+        :param pattern: pattern to search on
+        :type pattern: str
+        :param sortby: sort by ... (user SEARCH_* constants)
+        :rtype: iter[:class:`BaseFile`]
+        """
+        raise NotImplementedError()
+
+    def get_file(self, id):
+        """
+        Get a file from an ID
+
+        :param _id: the file id. I can be a numeric ID, or a page url
+        :type _id: str
+        :rtype: :class:`BaseFile` or None if not found.
+        """
+        raise NotImplementedError()