path: root/python-autopaths.spec

%global _empty_manifest_terminate_build 0
Name:		python-autopaths
Version:	1.6.0
Release:	1
Summary:	autopaths is a python package for dealing with file paths and automation.
License:	MIT
URL:		http://github.com/xapple/autopaths/
Source0:	https://mirrors.aliyun.com/pypi/web/packages/81/c7/f0130c20c4b584e07761d17969869ebe6051477641f278350fe3dc8f554b/autopaths-1.6.0.tar.gz
BuildArch:	noarch


%description
[![PyPI version](https://badge.fury.io/py/autopaths.svg)](https://badge.fury.io/py/autopaths)

# `autopaths` version 1.6.0

`autopaths` is a python package for dealing with file paths and automation.

It has many convenience methods that apply to directory paths and/or file paths and contains several submodules that are useful when building pipelines. See below for examples and documentation.

## Prerequisites

Since `autopaths` is written in python, it is compatible with all operating systems: Linux, macOS and Windows. The only prerequisite is `python3` (which is often installed by default) along with the `pip3` package manager.

To check if you have `python3` installed, type the following on your terminal:

    $ python3 -V

If you do not have `python3` installed, please refer to the section [obtaining python3](docs/installing_tips.md#obtaining-python3).

To check you have `pip3` installed, type the following on your terminal:

    $ pip3 -V

If you do not have `pip3` installed, please refer to the section [obtaining pip3](docs/installing_tips.md#obtaining-pip3).

## Installing

To install the `autopaths` package, simply type the following commands on your terminal:

    $ pip3 install --user autopaths

Alternatively, if you want to install it for all users of the system:

    $ sudo pip3 install autopaths

## Usage

Bellow are some examples to illustrate the various ways there are to use this package.


### `FilePath` object

Here are a few example usages of this object:

    from autopaths.file_path import FilePath
    f = FilePath("input/raw/reads_56.fastq")
    print(f.exists)
    print(f.extension)
    print(f.size)
    print(f.contains_binary)
    f.prepend('# This file was backed-up\n')
    f.gzip_to('backup/old_reads/reads_56.fastq.gz')
    f.move_to(f.parent)

As you can see, once you have created a FilePath, many useful methods are available. No more need for long `os.path` or `shutil` commands of which you can never remember the syntax.

To see the complete list of utility methods and properties, look at the source code. You can find lots of the common things you would need to do with file paths such as `f.make_executable()` etc. right at your fingertips.

### `DirectoryPath` object

Similar to a file path object. Here is an example usage of this object:

    from autopaths.dir_path import DirectoryPath
    d = DirectoryPath("cleaned/reads/")
    print(d.mod_time)
    d.create_if_not_exists()
    f = d + 'new.fastq'

### `AutoPaths` object

You can use this class like this when making pipelines to quickly refer to a predefined file path with a simple attribute lookup. This example explains it:

    class Sample(object):
        all_paths = """
                    /raw/raw.sff
                    /raw/raw.fastq
                    /clean/trim.fastq
                    /clean/clean.fastq
                    """

        def __init__(self, base_dir):
            from autopaths.auto_paths import AutoPaths
            self.p = AutoPaths(base_dir, self.all_paths)

        def clean(self):
            shutil.move(self.p.raw_sff, self.p.clean_fastq)

## Extra documentation

More documentation is available at:

<http://xapple.github.io/autopaths/autopaths>

This documentation is simply generated with:

    $ pdoc --html --output-dir docs --force autopaths



%package -n python3-autopaths
Summary:	autopaths is a python package for dealing with file paths and automation.
Provides:	python-autopaths
BuildRequires:	python3-devel
BuildRequires:	python3-setuptools
BuildRequires:	python3-pip
%description -n python3-autopaths
[![PyPI version](https://badge.fury.io/py/autopaths.svg)](https://badge.fury.io/py/autopaths)

# `autopaths` version 1.6.0

`autopaths` is a python package for dealing with file paths and automation.

It has many convenience methods that apply to directory paths and/or file paths and contains several submodules that are useful when building pipelines. See below for examples and documentation.

## Prerequisites

Since `autopaths` is written in python, it is compatible with all operating systems: Linux, macOS and Windows. The only prerequisite is `python3` (which is often installed by default) along with the `pip3` package manager.

To check if you have `python3` installed, type the following on your terminal:

    $ python3 -V

If you do not have `python3` installed, please refer to the section [obtaining python3](docs/installing_tips.md#obtaining-python3).

To check you have `pip3` installed, type the following on your terminal:

    $ pip3 -V

If you do not have `pip3` installed, please refer to the section [obtaining pip3](docs/installing_tips.md#obtaining-pip3).

## Installing

To install the `autopaths` package, simply type the following commands on your terminal:

    $ pip3 install --user autopaths

Alternatively, if you want to install it for all users of the system:

    $ sudo pip3 install autopaths

## Usage

Bellow are some examples to illustrate the various ways there are to use this package.


### `FilePath` object

Here are a few example usages of this object:

    from autopaths.file_path import FilePath
    f = FilePath("input/raw/reads_56.fastq")
    print(f.exists)
    print(f.extension)
    print(f.size)
    print(f.contains_binary)
    f.prepend('# This file was backed-up\n')
    f.gzip_to('backup/old_reads/reads_56.fastq.gz')
    f.move_to(f.parent)

As you can see, once you have created a FilePath, many useful methods are available. No more need for long `os.path` or `shutil` commands of which you can never remember the syntax.

To see the complete list of utility methods and properties, look at the source code. You can find lots of the common things you would need to do with file paths such as `f.make_executable()` etc. right at your fingertips.

### `DirectoryPath` object

Similar to a file path object. Here is an example usage of this object:

    from autopaths.dir_path import DirectoryPath
    d = DirectoryPath("cleaned/reads/")
    print(d.mod_time)
    d.create_if_not_exists()
    f = d + 'new.fastq'

### `AutoPaths` object

You can use this class like this when making pipelines to quickly refer to a predefined file path with a simple attribute lookup. This example explains it:

    class Sample(object):
        all_paths = """
                    /raw/raw.sff
                    /raw/raw.fastq
                    /clean/trim.fastq
                    /clean/clean.fastq
                    """

        def __init__(self, base_dir):
            from autopaths.auto_paths import AutoPaths
            self.p = AutoPaths(base_dir, self.all_paths)

        def clean(self):
            shutil.move(self.p.raw_sff, self.p.clean_fastq)

## Extra documentation

More documentation is available at:

<http://xapple.github.io/autopaths/autopaths>

This documentation is simply generated with:

    $ pdoc --html --output-dir docs --force autopaths



%package help
Summary:	Development documents and examples for autopaths
Provides:	python3-autopaths-doc
%description help
[![PyPI version](https://badge.fury.io/py/autopaths.svg)](https://badge.fury.io/py/autopaths)

# `autopaths` version 1.6.0

`autopaths` is a python package for dealing with file paths and automation.

It has many convenience methods that apply to directory paths and/or file paths and contains several submodules that are useful when building pipelines. See below for examples and documentation.

## Prerequisites

Since `autopaths` is written in python, it is compatible with all operating systems: Linux, macOS and Windows. The only prerequisite is `python3` (which is often installed by default) along with the `pip3` package manager.

To check if you have `python3` installed, type the following on your terminal:

    $ python3 -V

If you do not have `python3` installed, please refer to the section [obtaining python3](docs/installing_tips.md#obtaining-python3).

To check you have `pip3` installed, type the following on your terminal:

    $ pip3 -V

If you do not have `pip3` installed, please refer to the section [obtaining pip3](docs/installing_tips.md#obtaining-pip3).

## Installing

To install the `autopaths` package, simply type the following commands on your terminal:

    $ pip3 install --user autopaths

Alternatively, if you want to install it for all users of the system:

    $ sudo pip3 install autopaths

## Usage

Bellow are some examples to illustrate the various ways there are to use this package.


### `FilePath` object

Here are a few example usages of this object:

    from autopaths.file_path import FilePath
    f = FilePath("input/raw/reads_56.fastq")
    print(f.exists)
    print(f.extension)
    print(f.size)
    print(f.contains_binary)
    f.prepend('# This file was backed-up\n')
    f.gzip_to('backup/old_reads/reads_56.fastq.gz')
    f.move_to(f.parent)

As you can see, once you have created a FilePath, many useful methods are available. No more need for long `os.path` or `shutil` commands of which you can never remember the syntax.

To see the complete list of utility methods and properties, look at the source code. You can find lots of the common things you would need to do with file paths such as `f.make_executable()` etc. right at your fingertips.

### `DirectoryPath` object

Similar to a file path object. Here is an example usage of this object:

    from autopaths.dir_path import DirectoryPath
    d = DirectoryPath("cleaned/reads/")
    print(d.mod_time)
    d.create_if_not_exists()
    f = d + 'new.fastq'

### `AutoPaths` object

You can use this class like this when making pipelines to quickly refer to a predefined file path with a simple attribute lookup. This example explains it:

    class Sample(object):
        all_paths = """
                    /raw/raw.sff
                    /raw/raw.fastq
                    /clean/trim.fastq
                    /clean/clean.fastq
                    """

        def __init__(self, base_dir):
            from autopaths.auto_paths import AutoPaths
            self.p = AutoPaths(base_dir, self.all_paths)

        def clean(self):
            shutil.move(self.p.raw_sff, self.p.clean_fastq)

## Extra documentation

More documentation is available at:

<http://xapple.github.io/autopaths/autopaths>

This documentation is simply generated with:

    $ pdoc --html --output-dir docs --force autopaths



%prep
%autosetup -n autopaths-1.6.0

%build
%py3_build

%install
%py3_install
install -d -m755 %{buildroot}/%{_pkgdocdir}
if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
pushd %{buildroot}
if [ -d usr/lib ]; then
	find usr/lib -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/lib64 ]; then
	find usr/lib64 -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/bin ]; then
	find usr/bin -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/sbin ]; then
	find usr/sbin -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
touch doclist.lst
if [ -d usr/share/man ]; then
	find usr/share/man -type f -printf "\"/%h/%f.gz\"\n" >> doclist.lst
fi
popd
mv %{buildroot}/filelist.lst .
mv %{buildroot}/doclist.lst .

%files -n python3-autopaths -f filelist.lst
%dir %{python3_sitelib}/*

%files help -f doclist.lst
%{_docdir}/*

%changelog
* Fri Jun 09 2023 Python_Bot <Python_Bot@openeuler.org> - 1.6.0-1
- Package Spec generated