From e759f484f5dda1a23f27c8303749336fad98da3e Mon Sep 17 00:00:00 2001 From: CoprDistGit Date: Mon, 29 May 2023 11:13:16 +0000 Subject: automatic import of python-ratarmountcore --- .gitignore | 1 + python-ratarmountcore.spec | 446 +++++++++++++++++++++++++++++++++++++++++++++ sources | 1 + 3 files changed, 448 insertions(+) create mode 100644 python-ratarmountcore.spec create mode 100644 sources diff --git a/.gitignore b/.gitignore index e69de29..17dbe59 100644 --- a/.gitignore +++ b/.gitignore @@ -0,0 +1 @@ +/ratarmountcore-0.5.0.tar.gz diff --git a/python-ratarmountcore.spec b/python-ratarmountcore.spec new file mode 100644 index 0000000..3ec9e34 --- /dev/null +++ b/python-ratarmountcore.spec @@ -0,0 +1,446 @@ +%global _empty_manifest_terminate_build 0 +Name: python-ratarmountcore +Version: 0.5.0 +Release: 1 +Summary: Random Access Read-Only Tar Mount Library +License: MIT +URL: https://github.com/mxmlnkn/ratarmount/ratarmountcore +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/e2/dd/9d15ae7763e4e5de9a3077d46e95506adf779bc040d5f857dbc245695ca1/ratarmountcore-0.5.0.tar.gz +BuildArch: noarch + +Requires: python3-dataclasses +Requires: python3-importlib-metadata +Requires: python3-indexed-bzip2 +Requires: python3-indexed-bzip2 +Requires: python3-indexed-gzip +Requires: python3-rarfile +Requires: python3-xz +Requires: python3-indexed-zstd +Requires: python3-indexed-zstd +Requires: python3-indexed-gzip +Requires: python3-rarfile +Requires: python3-xz +Requires: python3-indexed-zstd +Requires: python3-indexed-zstd + +%description +# Random Access Read-Only Tar Mount (Ratarmount) Library + +[![PyPI version](https://badge.fury.io/py/ratarmountcore.svg)](https://badge.fury.io/py/ratarmountcore) +[![Python Version](https://img.shields.io/pypi/pyversions/ratarmountcore)](https://pypi.org/project/ratarmountcore/) +[![Downloads](https://pepy.tech/badge/ratarmountcore/month)](https://pepy.tech/project/ratarmountcore) +[![License](https://img.shields.io/badge/license-MIT-blue.svg)](http://opensource.org/licenses/MIT) + +This is the library used as backend by ratarmount (CLI). +For a full description including motivation and performance comparisons, see [ratarmount](https://github.com/mxmlnkn/ratarmount). + + +# Table of Contents + +1. [Installation](#installation) +2. [Usage](#usage) + + +# Installation + + +## PIP Package Installation + +In many cases a simple pip install should work: + +```bash +pip install ratarmountcore[full] +``` + +If there is trouble with one of the compression dependencies, first try installing it without dependencies: + +```bash +pip install ratarmountcore +``` + +And if that works, only install those dependencies you need, e.g.: + +```bash +pip install ratarmountcore[bzip2,gzip] +``` + +You can install the latest development version with: + +```bash +python3 -m pip install --user --force-reinstall 'git+https://github.com/mxmlnkn/ratarmount.git@develop#egginfo=ratarmountcore&subdirectory=core' +``` + + +## Dependencies + +Python 3.6+ and preferably pip 19.0+ are required. +These should be preinstalled on most systems. + +Ratarmountcore has as few required dependencies as necessary in order to cause the least troubles on all possible systems. +This means that only uncompressed TAR and ZIP support will work by default. +All optional dependencies are offered as extras. + + +## Extras + +Ratarmountcore offers these extras (optional dependencies): + + - full, bzip2, gzip, rar, xz, zip, zstd + +Full includes all dependencies of the other extras. +The `zip` extra is currently only a placeholder because the built-in `zipfile` module is being used. + +In order to install one of these extract, append them in brackets: + +```bash +python3 -m pip install --user ratarmount[bzip2] +``` + +If you are installing on a system for which there exists no manylinux wheel, then you'll have to install dependencies required to build from source: + +```bash +sudo apt install python3 python3-pip fuse build-essential software-properties-common zlib1g-dev libzstd-dev liblzma-dev +``` + + +# Usage + +This library offers an interface which is sufficient to work with FUSE. +This `MountSource` interface has methods for listing paths and getting file metadata and contents. + +The ratarmountcore library offers multiple implementations of `MountSource` for different archive formats: + + - `SQLiteIndexedTar`: + This is the oldest and most powerful implementation. + It supports fast access to files inside (compressed) TARs. + - `RarMountSource`: An implementation for RARs using rarfile. + - `ZipMountSource`: An implementation for ZIPs using zipfile. + - `FolderMountSource`: An implementation taking an existing folder as input. + +There also are these functional implementations of `MountSource`: + + - `UnionMountSource`: Takes multiple MountSource implementations and shows a merged view of their file hierarchy. + - `FileVersionLayer`: + Takes a MountSource as input, decodes the requested paths, also accepting `.version/` paths, + and calls the methods of the `MountSource` with the given file version. + - `AutoMountLayer`: + Takes one `MountSource`, goes over all its files and mounts archives recursively in a similar manner to `UnionMountSource`. + +The factory function `open` opens one of the archive `MountSource` implementations according to the file type. + +[![Mount Source Class Diagram](doc/MountSource.png)](doc/MountSource.svg) + + +## Example + +```Python3 +import ratarmountcore as rmc + +archive = rmc.open("foo.tar", recursive=True) +archive.listDir("/") +info = archive.getFileInfo("/bar") + +print "Contents of /bar:" +with archive.open(info) as file: + print(file.read()) +``` + + +%package -n python3-ratarmountcore +Summary: Random Access Read-Only Tar Mount Library +Provides: python-ratarmountcore +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-ratarmountcore +# Random Access Read-Only Tar Mount (Ratarmount) Library + +[![PyPI version](https://badge.fury.io/py/ratarmountcore.svg)](https://badge.fury.io/py/ratarmountcore) +[![Python Version](https://img.shields.io/pypi/pyversions/ratarmountcore)](https://pypi.org/project/ratarmountcore/) +[![Downloads](https://pepy.tech/badge/ratarmountcore/month)](https://pepy.tech/project/ratarmountcore) +[![License](https://img.shields.io/badge/license-MIT-blue.svg)](http://opensource.org/licenses/MIT) + +This is the library used as backend by ratarmount (CLI). +For a full description including motivation and performance comparisons, see [ratarmount](https://github.com/mxmlnkn/ratarmount). + + +# Table of Contents + +1. [Installation](#installation) +2. [Usage](#usage) + + +# Installation + + +## PIP Package Installation + +In many cases a simple pip install should work: + +```bash +pip install ratarmountcore[full] +``` + +If there is trouble with one of the compression dependencies, first try installing it without dependencies: + +```bash +pip install ratarmountcore +``` + +And if that works, only install those dependencies you need, e.g.: + +```bash +pip install ratarmountcore[bzip2,gzip] +``` + +You can install the latest development version with: + +```bash +python3 -m pip install --user --force-reinstall 'git+https://github.com/mxmlnkn/ratarmount.git@develop#egginfo=ratarmountcore&subdirectory=core' +``` + + +## Dependencies + +Python 3.6+ and preferably pip 19.0+ are required. +These should be preinstalled on most systems. + +Ratarmountcore has as few required dependencies as necessary in order to cause the least troubles on all possible systems. +This means that only uncompressed TAR and ZIP support will work by default. +All optional dependencies are offered as extras. + + +## Extras + +Ratarmountcore offers these extras (optional dependencies): + + - full, bzip2, gzip, rar, xz, zip, zstd + +Full includes all dependencies of the other extras. +The `zip` extra is currently only a placeholder because the built-in `zipfile` module is being used. + +In order to install one of these extract, append them in brackets: + +```bash +python3 -m pip install --user ratarmount[bzip2] +``` + +If you are installing on a system for which there exists no manylinux wheel, then you'll have to install dependencies required to build from source: + +```bash +sudo apt install python3 python3-pip fuse build-essential software-properties-common zlib1g-dev libzstd-dev liblzma-dev +``` + + +# Usage + +This library offers an interface which is sufficient to work with FUSE. +This `MountSource` interface has methods for listing paths and getting file metadata and contents. + +The ratarmountcore library offers multiple implementations of `MountSource` for different archive formats: + + - `SQLiteIndexedTar`: + This is the oldest and most powerful implementation. + It supports fast access to files inside (compressed) TARs. + - `RarMountSource`: An implementation for RARs using rarfile. + - `ZipMountSource`: An implementation for ZIPs using zipfile. + - `FolderMountSource`: An implementation taking an existing folder as input. + +There also are these functional implementations of `MountSource`: + + - `UnionMountSource`: Takes multiple MountSource implementations and shows a merged view of their file hierarchy. + - `FileVersionLayer`: + Takes a MountSource as input, decodes the requested paths, also accepting `.version/` paths, + and calls the methods of the `MountSource` with the given file version. + - `AutoMountLayer`: + Takes one `MountSource`, goes over all its files and mounts archives recursively in a similar manner to `UnionMountSource`. + +The factory function `open` opens one of the archive `MountSource` implementations according to the file type. + +[![Mount Source Class Diagram](doc/MountSource.png)](doc/MountSource.svg) + + +## Example + +```Python3 +import ratarmountcore as rmc + +archive = rmc.open("foo.tar", recursive=True) +archive.listDir("/") +info = archive.getFileInfo("/bar") + +print "Contents of /bar:" +with archive.open(info) as file: + print(file.read()) +``` + + +%package help +Summary: Development documents and examples for ratarmountcore +Provides: python3-ratarmountcore-doc +%description help +# Random Access Read-Only Tar Mount (Ratarmount) Library + +[![PyPI version](https://badge.fury.io/py/ratarmountcore.svg)](https://badge.fury.io/py/ratarmountcore) +[![Python Version](https://img.shields.io/pypi/pyversions/ratarmountcore)](https://pypi.org/project/ratarmountcore/) +[![Downloads](https://pepy.tech/badge/ratarmountcore/month)](https://pepy.tech/project/ratarmountcore) +[![License](https://img.shields.io/badge/license-MIT-blue.svg)](http://opensource.org/licenses/MIT) + +This is the library used as backend by ratarmount (CLI). +For a full description including motivation and performance comparisons, see [ratarmount](https://github.com/mxmlnkn/ratarmount). + + +# Table of Contents + +1. [Installation](#installation) +2. [Usage](#usage) + + +# Installation + + +## PIP Package Installation + +In many cases a simple pip install should work: + +```bash +pip install ratarmountcore[full] +``` + +If there is trouble with one of the compression dependencies, first try installing it without dependencies: + +```bash +pip install ratarmountcore +``` + +And if that works, only install those dependencies you need, e.g.: + +```bash +pip install ratarmountcore[bzip2,gzip] +``` + +You can install the latest development version with: + +```bash +python3 -m pip install --user --force-reinstall 'git+https://github.com/mxmlnkn/ratarmount.git@develop#egginfo=ratarmountcore&subdirectory=core' +``` + + +## Dependencies + +Python 3.6+ and preferably pip 19.0+ are required. +These should be preinstalled on most systems. + +Ratarmountcore has as few required dependencies as necessary in order to cause the least troubles on all possible systems. +This means that only uncompressed TAR and ZIP support will work by default. +All optional dependencies are offered as extras. + + +## Extras + +Ratarmountcore offers these extras (optional dependencies): + + - full, bzip2, gzip, rar, xz, zip, zstd + +Full includes all dependencies of the other extras. +The `zip` extra is currently only a placeholder because the built-in `zipfile` module is being used. + +In order to install one of these extract, append them in brackets: + +```bash +python3 -m pip install --user ratarmount[bzip2] +``` + +If you are installing on a system for which there exists no manylinux wheel, then you'll have to install dependencies required to build from source: + +```bash +sudo apt install python3 python3-pip fuse build-essential software-properties-common zlib1g-dev libzstd-dev liblzma-dev +``` + + +# Usage + +This library offers an interface which is sufficient to work with FUSE. +This `MountSource` interface has methods for listing paths and getting file metadata and contents. + +The ratarmountcore library offers multiple implementations of `MountSource` for different archive formats: + + - `SQLiteIndexedTar`: + This is the oldest and most powerful implementation. + It supports fast access to files inside (compressed) TARs. + - `RarMountSource`: An implementation for RARs using rarfile. + - `ZipMountSource`: An implementation for ZIPs using zipfile. + - `FolderMountSource`: An implementation taking an existing folder as input. + +There also are these functional implementations of `MountSource`: + + - `UnionMountSource`: Takes multiple MountSource implementations and shows a merged view of their file hierarchy. + - `FileVersionLayer`: + Takes a MountSource as input, decodes the requested paths, also accepting `.version/` paths, + and calls the methods of the `MountSource` with the given file version. + - `AutoMountLayer`: + Takes one `MountSource`, goes over all its files and mounts archives recursively in a similar manner to `UnionMountSource`. + +The factory function `open` opens one of the archive `MountSource` implementations according to the file type. + +[![Mount Source Class Diagram](doc/MountSource.png)](doc/MountSource.svg) + + +## Example + +```Python3 +import ratarmountcore as rmc + +archive = rmc.open("foo.tar", recursive=True) +archive.listDir("/") +info = archive.getFileInfo("/bar") + +print "Contents of /bar:" +with archive.open(info) as file: + print(file.read()) +``` + + +%prep +%autosetup -n ratarmountcore-0.5.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-ratarmountcore -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Mon May 29 2023 Python_Bot - 0.5.0-1 +- Package Spec generated diff --git a/sources b/sources new file mode 100644 index 0000000..70fa655 --- /dev/null +++ b/sources @@ -0,0 +1 @@ +b724dd40d471886f17e3c0679a52c59a ratarmountcore-0.5.0.tar.gz -- cgit v1.2.3