automatic import of python-ratarmountcore

3 files changed, 448 insertions, 0 deletions

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 `<file>.version/<number>` 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 `<file>.version/<number>` 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 `<file>.version/<number>` 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 <Python_Bot@openeuler.org> - 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