Metadata-Version: 2.0
Name: pathlib-mate
Version: 0.0.12
Summary: An extended and more powerful pathlib.
Home-page: https://github.com/MacHu-GWU/
Author: Sanhe Hu
Author-email: husanhe@gmail.com
License: MIT
Download-URL: https://github.com/MacHu-GWU//tarball/2017-09-07
Description-Content-Type: UNKNOWN
Platform: Windows
Platform: MacOS
Platform: Unix
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Requires-Dist: autopep8

.. image:: https://travis-ci.org/MacHu-GWU/pathlib_mate-project.svg?branch=master
    :target: https://travis-ci.org/MacHu-GWU/pathlib_mate-project?branch=master

.. image:: https://codecov.io/gh/MacHu-GWU/pathlib_mate-project/branch/master/graph/badge.svg
  :target: https://codecov.io/gh/MacHu-GWU/pathlib_mate-project

.. image:: https://img.shields.io/pypi/v/pathlib_mate.svg
    :target: https://pypi.python.org/pypi/pathlib_mate

.. image:: https://img.shields.io/pypi/l/pathlib_mate.svg
    :target: https://pypi.python.org/pypi/pathlib_mate

.. image:: https://img.shields.io/pypi/pyversions/pathlib_mate.svg
    :target: https://pypi.python.org/pypi/pathlib_mate

.. image:: https://img.shields.io/badge/Star_Me_on_GitHub!--None.svg?style=social
    :target: https://github.com/MacHu-GWU/pathlib_mate-project


Welcome to pathlib_mate Documentation
=====================================

`pathlib <https://docs.python.org/3/library/pathlib.html>`_ is an awesome library handling path in different OS. And it's been added into standard library since Python3.4. ``pathlib_mate`` gives extensive methods and attributes, makes ``pathlib`` more powerful and user-friendly.

Features:

- ``os`` module style path parts attributes access, for example: ``Path.abspath``.
- select, filter, sort file from directory, easy to customize filter.
- md5 calculation support.
- utility tools: big file dir lookup, directory backup.
- if you are looking for winzip support, `check this out <https://github.com/MacHu-GWU/single_file_module-project/blob/master/sfm/winzip.py>`_.


**Quick Links**
---------------
- `GitHub Homepage <https://github.com/MacHu-GWU/pathlib_mate-project>`_
- `Online Documentation <http://www.wbh-doc.com.s3.amazonaws.com/pathlib_mate/index.html>`_
- `PyPI download <https://pypi.python.org/pypi/pathlib_mate>`_
- `Install <install_>`_
- `Issue submit and feature request <https://github.com/MacHu-GWU/pathlib_mate-project/issues>`_
- `API reference and source code <http://www.wbh-doc.com.s3.amazonaws.com/pathlib_mate/pathlib_mate/mate.html#module-pathlib_mate.mate.PathlibMatePath>`_


.. _install:

Install
-------

``pathlib_mate`` is released on PyPI, so all you need is:

.. code-block:: console

	$ pip install pathlib_mate

To upgrade to latest version:

.. code-block:: console

	$ pip install --upgrade pathlib_mate

