Metadata-Version: 2.1
Name: redturtle.filesretriever
Version: 1.0.4
Summary: Save all files from an external page
Home-page: https://github.com/collective/redturtle.filesretriever
Author: RedTurtle Technology
Author-email: sviluppo@redturtle.it
License: GPL version 2
Project-URL: PyPI, https://pypi.python.org/pypi/redturtle.filesretriever
Project-URL: Source, https://github.com/collective/redturtle.filesretriever
Project-URL: Tracker, https://github.com/collective/redturtle.filesretriever/issues
Keywords: Python Plone CMS
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: Addon
Classifier: Framework :: Plone :: 5.2
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.7
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Requires-Python: >=3.7
Provides-Extra: test
License-File: LICENSE.GPL
License-File: LICENSE.rst

.. This README is meant for consumption by humans and pypi. Pypi can render rst files so please do not use Sphinx features.
   If you want to learn more about writing documentation, please check out: http://docs.plone.org/about/documentation_styleguide.html
   This text does not appear on pypi or github. It is a comment.

.. image:: https://travis-ci.org/collective/redturtle.filesretriever.svg?branch=master
    :target: https://travis-ci.org/collective/redturtle.filesretriever

.. image:: https://coveralls.io/repos/github/collective/redturtle.filesretriever/badge.svg?branch=master
    :target: https://coveralls.io/github/collective/redturtle.filesretriever?branch=master
    :alt: Coveralls

.. image:: https://img.shields.io/pypi/v/redturtle.filesretriever.svg
    :target: https://pypi.python.org/pypi/redturtle.filesretriever/
    :alt: Latest Version

.. image:: https://img.shields.io/pypi/status/redturtle.filesretriever.svg
    :target: https://pypi.python.org/pypi/redturtle.filesretriever
    :alt: Egg Status

.. image:: https://img.shields.io/pypi/pyversions/redturtle.filesretriever.svg?style=plastic   :alt: Supported - Python Versions

.. image:: https://img.shields.io/pypi/l/redturtle.filesretriever.svg
    :target: https://pypi.python.org/pypi/redturtle.filesretriever/
    :alt: License


=========================
RedTurtle Files Retriever
=========================

Utility view to retrieve massive files from a remote page.

View
----

There is an helper view (**/files-retriever**) that you can call on every Plone folderish context.

Files will be saved in that context.

Restapi endpoints
-----------------

There are two endpoints:

- @files-list (POST): accept an url and some CSS selectors, and returns a list of found links in the page.
- @save-files (POST): accept a list of urls/titles and will download resources and save them in the current context.

Translations
------------

This product has been translated into

- English
- Italian


Installation
------------

Install redturtle.filesretriever by adding it to your buildout::

    [buildout]

    ...

    eggs =
        redturtle.filesretriever


and then running ``bin/buildout``


Contribute
----------

- Issue Tracker: https://github.com/RedTurtle/redturtle.filesretriever/issues
- Source Code: https://github.com/RedTurtle/redturtle.filesretriever


License
-------

The project is licensed under the GPLv2.


Contributors
============

- RedTurtle Technology, sviluppo@redturtle.it


Changelog
=========


1.0.4 (2025-09-16)
------------------

- Handle relative links in html pages.
  [cekk]


1.0.3 (2025-03-31)
------------------

- Handle wrong ssl certs also when download data.
  [cekk]


1.0.2 (2025-03-31)
------------------

- Add custom Cipher adapter for requests session to allow download files from servers with old/wrong ssl certs.
  [cekk]


1.0.1 (2024-06-18)
------------------

- Better handle edge-cases in content-type ad disposition headers.
  [cekk]


1.0.0 (2021-12-27)
------------------

- Initial release.
  [cekk]
