diff options
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | python-torrentfile.spec | 661 | ||||
| -rw-r--r-- | sources | 1 |
3 files changed, 663 insertions, 0 deletions
@@ -0,0 +1 @@ +/torrentfile-0.8.13.tar.gz diff --git a/python-torrentfile.spec b/python-torrentfile.spec new file mode 100644 index 0000000..f9bef95 --- /dev/null +++ b/python-torrentfile.spec @@ -0,0 +1,661 @@ +%global _empty_manifest_terminate_build 0 +Name: python-torrentfile +Version: 0.8.13 +Release: 1 +Summary: Terminal based command line tool for creating Bittorrent files. +License: Apache Software License +URL: https://pypi.org/project/torrentfile/ +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/3b/02/d8f6621e00e1d611af8d65786914bf54391bf191e1f47507701140417ec9/torrentfile-0.8.13.tar.gz +BuildArch: noarch + +Requires: python3-pyben + +%description +# TorrentFile
+
+
+
+* * *
+
+
+
+
+
+[](https://github.com/alexpdev/torrentfile/actions/workflows/pyworkflow.yml)
+[](https://www.codacy.com/gh/alexpdev/torrentfile/dashboard?utm_source=github.com&utm_medium=referral&utm_content=alexpdev/torrentfile&utm_campaign=Badge_Coverage)
+[](https://www.codacy.com/gh/alexpdev/torrentfile/dashboard?utm_source=github.com&utm_medium=referral&utm_content=alexpdev/torrentfile&utm_campaign=Badge_Grade)
+[](https://deepsource.io/gh/alexpdev/torrentfile/)
+[](https://codecov.io/gh/alexpdev/torrentfile?color=navy&logo=codecov)
+
+## 🌐 Overview
+
+A command line tool for creating, reviewing, editing, or verifying bittorrent meta files (`.torrent` files).
+_`torrentfile`_ is open source, and supports all versions of Bittorrent files, including hybrid meta files.
+
+> A GUI frontend for this project can be found at <https://github.com/alexpdev/TorrentfileQt>
+
+## 🔌 Requirements
+
+- Python 3.6+
+- Tested on Linux, Windows and Mac
+
+## 💻 Install
+
+**PyPi:**
+
+```bash
+pip install torrentfile
+```
+
+**Git:**
+
+```bash
+git clone https://github.com/alexpdev/torrentfile.git
+cd torrentfile
+pip install .
+```
+
+> Download pre-compiled binaries from the [release page](https://github.com/alexpdev/torrentfile/releases).
+
+## 📚 Documentation
+
+Documentation can be found [here](https://alexpdev.github.io/torrentfile)
+or in the _`docs`_ directory.
+
+## 🚀 Usage & Documentation
+
+
+
+> Usage examples can be found in the project documentation on the [examples page.](https://alexpdev.github.io/torrentfile/usage)
+
+## 📝 License
+
+Apache Software License v2.0 - See [LICENSE]("https://github.com/alexpdev/torrentfile/blob/master/LICENSE")
+
+## 💡 Issues & Requests & PRs
+
+If you encounter any bugs or would like to request a new feature please open a new issue.
+
+> PRs and other contributions are welcome
+
+<https://github.com/alexpdev/torrentfile/issues>
+
+* * *
+
+## Usage Examples
+
+### Creating Bittorrent Files
+
+Basic torrent file creation is as easy and using the `create` sub-commnand and providing
+the path to the contents.
+
+```bash
+torrentfile create /path/to/content
+```
+
+You can add one or more trackers by using any one of `-a`, `--announce`
+flags and listing their URL as a space separated list.
+
+```bash
+torrentfile create /path/to/content -a http://tracker1.com http://tracker2.net
+```
+
+If you intend to distribute the file on a private tracker then you should use one
+of `-p`, `--private` flags, which tells your Bittorrent clients to disable DHT and
+multitracker protocols.
+
+```bash
+torrentfile create /path/to/content --private
+```
+
+By default **`torrentfile`** displays a progress bar indicating how much of the content
+has already been processed. To turn off this display you can either use `--quiet` mode in
+as a global flag or you can set the `--prog` flag to 0.
+
+```bash
+torrentfile --quiet create /path/to/content
+```
+
+```bash
+torrentfile create /path/to/content --prog 0
+```
+
+**`torrentfile`** extracts the name of the contents top level file or directory
+and saves the torrent file to the current working directory with the extracted title.
+
+For example running the follwing command would create `./content.torrent`.
+
+```bash
+torrentfile create /path/to/content
+```
+
+To specify an alternative path or filename you may use the `-o`, `--out` flags
+followed by the relative or absolute path to your preferred output location.
+
+```bash
+torrentfile create /path/to/content -o /some/other/path/torrent.torrent
+```
+
+If the path specified is an existing directory, then the torrent file will be
+saved to that directory, with same filename as the default top level path name.
+
+For example the following command would create a torrent file at `/some/other/path/content.torrent`.
+
+```bash
+torrentfile create /path/to/content -o /some/other/path/
+```
+
+Bittorrent protocol V1 is still the most commonly used version, therefore _`torrentfile`_ creates
+Bittorrent version 1 torrent files by default. To specify creating a V2 file or hybrid (v1 and v2)
+use the `--meta-version` followed by the specific version number format to use. The options include:
+`1`(v1 default), `2`(v2), or `3`(v1 & v2).
+
+```bash
+torrentfile create /path/to/content --meta-version 2
+```
+
+```bash
+torrentfile create /path/to/content --meta-version 3
+```
+
+__NEW FEATURE in v0.8.8__:
+
+>`torrentfile` now includes the option to command line flags for the `create` sub-command from an `ini` style
+configuration file, by using the `--config` and optional `--config-path` options to specify the path
+to the configuration file. If `--config-path` is ommited, then `torrentfile` will look by default in the current
+working directory for a file named `torrentfile.ini`. If the file is not discovered in the current working directory,
+it will move on to look `~/.torrentfile/torrentfile.ini` followed by `~/.config/torrentfile.ini`. Please see the
+[documentation](https://alexpdev.github.io/torrentfile/overview/) for more details on how the configuration file should be
+formatted.
+
+### Check/Recheck Torrent
+
+The `recheck` subcommand allows you to scan a Bittorrent file and compare it's contents,
+against a file or directory containing the contents the torrent file was created from.
+The output provided by this process gives a detailed perspective if any files are missing
+or have been corrupted in any way. Supports any version of Bittorrent file.
+
+```bash
+torrentfile recheck /path/to/some.torrent /path/to/content
+```
+
+### Edit Torrent
+
+To edit specific fields of the torrent file, there is the `edit` subcommand. Using this
+subcommand you can specify the field with one of the available field flags, for example
+`--tracker` and specify the value you wish to change it to.
+
+```bash
+torrentfile edit /path/to/content --tracker https://new.tracker.url1.com https://newtracker.url/2
+```
+
+You can use the `-h` flag for a full list of available fields that can be edited.
+
+```bash
+torrentfile edit -h
+```
+
+### Create Magnet
+
+To create a magnet URI for a pre-existing torrent meta file, use the sub-command
+`magnet` or `m` with the path to the torrent file.
+
+```bash
+torrentfile magnet /path/to/some.torrent
+```
+
+### GUI
+
+If you prefer a windowed GUI please check out the official GUI frontend [here](https://github.com/alexpdev/TorrentFileQt)
+ + +%package -n python3-torrentfile +Summary: Terminal based command line tool for creating Bittorrent files. +Provides: python-torrentfile +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-torrentfile +# TorrentFile
+
+
+
+* * *
+
+
+
+
+
+[](https://github.com/alexpdev/torrentfile/actions/workflows/pyworkflow.yml)
+[](https://www.codacy.com/gh/alexpdev/torrentfile/dashboard?utm_source=github.com&utm_medium=referral&utm_content=alexpdev/torrentfile&utm_campaign=Badge_Coverage)
+[](https://www.codacy.com/gh/alexpdev/torrentfile/dashboard?utm_source=github.com&utm_medium=referral&utm_content=alexpdev/torrentfile&utm_campaign=Badge_Grade)
+[](https://deepsource.io/gh/alexpdev/torrentfile/)
+[](https://codecov.io/gh/alexpdev/torrentfile?color=navy&logo=codecov)
+
+## 🌐 Overview
+
+A command line tool for creating, reviewing, editing, or verifying bittorrent meta files (`.torrent` files).
+_`torrentfile`_ is open source, and supports all versions of Bittorrent files, including hybrid meta files.
+
+> A GUI frontend for this project can be found at <https://github.com/alexpdev/TorrentfileQt>
+
+## 🔌 Requirements
+
+- Python 3.6+
+- Tested on Linux, Windows and Mac
+
+## 💻 Install
+
+**PyPi:**
+
+```bash
+pip install torrentfile
+```
+
+**Git:**
+
+```bash
+git clone https://github.com/alexpdev/torrentfile.git
+cd torrentfile
+pip install .
+```
+
+> Download pre-compiled binaries from the [release page](https://github.com/alexpdev/torrentfile/releases).
+
+## 📚 Documentation
+
+Documentation can be found [here](https://alexpdev.github.io/torrentfile)
+or in the _`docs`_ directory.
+
+## 🚀 Usage & Documentation
+
+
+
+> Usage examples can be found in the project documentation on the [examples page.](https://alexpdev.github.io/torrentfile/usage)
+
+## 📝 License
+
+Apache Software License v2.0 - See [LICENSE]("https://github.com/alexpdev/torrentfile/blob/master/LICENSE")
+
+## 💡 Issues & Requests & PRs
+
+If you encounter any bugs or would like to request a new feature please open a new issue.
+
+> PRs and other contributions are welcome
+
+<https://github.com/alexpdev/torrentfile/issues>
+
+* * *
+
+## Usage Examples
+
+### Creating Bittorrent Files
+
+Basic torrent file creation is as easy and using the `create` sub-commnand and providing
+the path to the contents.
+
+```bash
+torrentfile create /path/to/content
+```
+
+You can add one or more trackers by using any one of `-a`, `--announce`
+flags and listing their URL as a space separated list.
+
+```bash
+torrentfile create /path/to/content -a http://tracker1.com http://tracker2.net
+```
+
+If you intend to distribute the file on a private tracker then you should use one
+of `-p`, `--private` flags, which tells your Bittorrent clients to disable DHT and
+multitracker protocols.
+
+```bash
+torrentfile create /path/to/content --private
+```
+
+By default **`torrentfile`** displays a progress bar indicating how much of the content
+has already been processed. To turn off this display you can either use `--quiet` mode in
+as a global flag or you can set the `--prog` flag to 0.
+
+```bash
+torrentfile --quiet create /path/to/content
+```
+
+```bash
+torrentfile create /path/to/content --prog 0
+```
+
+**`torrentfile`** extracts the name of the contents top level file or directory
+and saves the torrent file to the current working directory with the extracted title.
+
+For example running the follwing command would create `./content.torrent`.
+
+```bash
+torrentfile create /path/to/content
+```
+
+To specify an alternative path or filename you may use the `-o`, `--out` flags
+followed by the relative or absolute path to your preferred output location.
+
+```bash
+torrentfile create /path/to/content -o /some/other/path/torrent.torrent
+```
+
+If the path specified is an existing directory, then the torrent file will be
+saved to that directory, with same filename as the default top level path name.
+
+For example the following command would create a torrent file at `/some/other/path/content.torrent`.
+
+```bash
+torrentfile create /path/to/content -o /some/other/path/
+```
+
+Bittorrent protocol V1 is still the most commonly used version, therefore _`torrentfile`_ creates
+Bittorrent version 1 torrent files by default. To specify creating a V2 file or hybrid (v1 and v2)
+use the `--meta-version` followed by the specific version number format to use. The options include:
+`1`(v1 default), `2`(v2), or `3`(v1 & v2).
+
+```bash
+torrentfile create /path/to/content --meta-version 2
+```
+
+```bash
+torrentfile create /path/to/content --meta-version 3
+```
+
+__NEW FEATURE in v0.8.8__:
+
+>`torrentfile` now includes the option to command line flags for the `create` sub-command from an `ini` style
+configuration file, by using the `--config` and optional `--config-path` options to specify the path
+to the configuration file. If `--config-path` is ommited, then `torrentfile` will look by default in the current
+working directory for a file named `torrentfile.ini`. If the file is not discovered in the current working directory,
+it will move on to look `~/.torrentfile/torrentfile.ini` followed by `~/.config/torrentfile.ini`. Please see the
+[documentation](https://alexpdev.github.io/torrentfile/overview/) for more details on how the configuration file should be
+formatted.
+
+### Check/Recheck Torrent
+
+The `recheck` subcommand allows you to scan a Bittorrent file and compare it's contents,
+against a file or directory containing the contents the torrent file was created from.
+The output provided by this process gives a detailed perspective if any files are missing
+or have been corrupted in any way. Supports any version of Bittorrent file.
+
+```bash
+torrentfile recheck /path/to/some.torrent /path/to/content
+```
+
+### Edit Torrent
+
+To edit specific fields of the torrent file, there is the `edit` subcommand. Using this
+subcommand you can specify the field with one of the available field flags, for example
+`--tracker` and specify the value you wish to change it to.
+
+```bash
+torrentfile edit /path/to/content --tracker https://new.tracker.url1.com https://newtracker.url/2
+```
+
+You can use the `-h` flag for a full list of available fields that can be edited.
+
+```bash
+torrentfile edit -h
+```
+
+### Create Magnet
+
+To create a magnet URI for a pre-existing torrent meta file, use the sub-command
+`magnet` or `m` with the path to the torrent file.
+
+```bash
+torrentfile magnet /path/to/some.torrent
+```
+
+### GUI
+
+If you prefer a windowed GUI please check out the official GUI frontend [here](https://github.com/alexpdev/TorrentFileQt)
+ + +%package help +Summary: Development documents and examples for torrentfile +Provides: python3-torrentfile-doc +%description help +# TorrentFile
+
+
+
+* * *
+
+
+
+
+
+[](https://github.com/alexpdev/torrentfile/actions/workflows/pyworkflow.yml)
+[](https://www.codacy.com/gh/alexpdev/torrentfile/dashboard?utm_source=github.com&utm_medium=referral&utm_content=alexpdev/torrentfile&utm_campaign=Badge_Coverage)
+[](https://www.codacy.com/gh/alexpdev/torrentfile/dashboard?utm_source=github.com&utm_medium=referral&utm_content=alexpdev/torrentfile&utm_campaign=Badge_Grade)
+[](https://deepsource.io/gh/alexpdev/torrentfile/)
+[](https://codecov.io/gh/alexpdev/torrentfile?color=navy&logo=codecov)
+
+## 🌐 Overview
+
+A command line tool for creating, reviewing, editing, or verifying bittorrent meta files (`.torrent` files).
+_`torrentfile`_ is open source, and supports all versions of Bittorrent files, including hybrid meta files.
+
+> A GUI frontend for this project can be found at <https://github.com/alexpdev/TorrentfileQt>
+
+## 🔌 Requirements
+
+- Python 3.6+
+- Tested on Linux, Windows and Mac
+
+## 💻 Install
+
+**PyPi:**
+
+```bash
+pip install torrentfile
+```
+
+**Git:**
+
+```bash
+git clone https://github.com/alexpdev/torrentfile.git
+cd torrentfile
+pip install .
+```
+
+> Download pre-compiled binaries from the [release page](https://github.com/alexpdev/torrentfile/releases).
+
+## 📚 Documentation
+
+Documentation can be found [here](https://alexpdev.github.io/torrentfile)
+or in the _`docs`_ directory.
+
+## 🚀 Usage & Documentation
+
+
+
+> Usage examples can be found in the project documentation on the [examples page.](https://alexpdev.github.io/torrentfile/usage)
+
+## 📝 License
+
+Apache Software License v2.0 - See [LICENSE]("https://github.com/alexpdev/torrentfile/blob/master/LICENSE")
+
+## 💡 Issues & Requests & PRs
+
+If you encounter any bugs or would like to request a new feature please open a new issue.
+
+> PRs and other contributions are welcome
+
+<https://github.com/alexpdev/torrentfile/issues>
+
+* * *
+
+## Usage Examples
+
+### Creating Bittorrent Files
+
+Basic torrent file creation is as easy and using the `create` sub-commnand and providing
+the path to the contents.
+
+```bash
+torrentfile create /path/to/content
+```
+
+You can add one or more trackers by using any one of `-a`, `--announce`
+flags and listing their URL as a space separated list.
+
+```bash
+torrentfile create /path/to/content -a http://tracker1.com http://tracker2.net
+```
+
+If you intend to distribute the file on a private tracker then you should use one
+of `-p`, `--private` flags, which tells your Bittorrent clients to disable DHT and
+multitracker protocols.
+
+```bash
+torrentfile create /path/to/content --private
+```
+
+By default **`torrentfile`** displays a progress bar indicating how much of the content
+has already been processed. To turn off this display you can either use `--quiet` mode in
+as a global flag or you can set the `--prog` flag to 0.
+
+```bash
+torrentfile --quiet create /path/to/content
+```
+
+```bash
+torrentfile create /path/to/content --prog 0
+```
+
+**`torrentfile`** extracts the name of the contents top level file or directory
+and saves the torrent file to the current working directory with the extracted title.
+
+For example running the follwing command would create `./content.torrent`.
+
+```bash
+torrentfile create /path/to/content
+```
+
+To specify an alternative path or filename you may use the `-o`, `--out` flags
+followed by the relative or absolute path to your preferred output location.
+
+```bash
+torrentfile create /path/to/content -o /some/other/path/torrent.torrent
+```
+
+If the path specified is an existing directory, then the torrent file will be
+saved to that directory, with same filename as the default top level path name.
+
+For example the following command would create a torrent file at `/some/other/path/content.torrent`.
+
+```bash
+torrentfile create /path/to/content -o /some/other/path/
+```
+
+Bittorrent protocol V1 is still the most commonly used version, therefore _`torrentfile`_ creates
+Bittorrent version 1 torrent files by default. To specify creating a V2 file or hybrid (v1 and v2)
+use the `--meta-version` followed by the specific version number format to use. The options include:
+`1`(v1 default), `2`(v2), or `3`(v1 & v2).
+
+```bash
+torrentfile create /path/to/content --meta-version 2
+```
+
+```bash
+torrentfile create /path/to/content --meta-version 3
+```
+
+__NEW FEATURE in v0.8.8__:
+
+>`torrentfile` now includes the option to command line flags for the `create` sub-command from an `ini` style
+configuration file, by using the `--config` and optional `--config-path` options to specify the path
+to the configuration file. If `--config-path` is ommited, then `torrentfile` will look by default in the current
+working directory for a file named `torrentfile.ini`. If the file is not discovered in the current working directory,
+it will move on to look `~/.torrentfile/torrentfile.ini` followed by `~/.config/torrentfile.ini`. Please see the
+[documentation](https://alexpdev.github.io/torrentfile/overview/) for more details on how the configuration file should be
+formatted.
+
+### Check/Recheck Torrent
+
+The `recheck` subcommand allows you to scan a Bittorrent file and compare it's contents,
+against a file or directory containing the contents the torrent file was created from.
+The output provided by this process gives a detailed perspective if any files are missing
+or have been corrupted in any way. Supports any version of Bittorrent file.
+
+```bash
+torrentfile recheck /path/to/some.torrent /path/to/content
+```
+
+### Edit Torrent
+
+To edit specific fields of the torrent file, there is the `edit` subcommand. Using this
+subcommand you can specify the field with one of the available field flags, for example
+`--tracker` and specify the value you wish to change it to.
+
+```bash
+torrentfile edit /path/to/content --tracker https://new.tracker.url1.com https://newtracker.url/2
+```
+
+You can use the `-h` flag for a full list of available fields that can be edited.
+
+```bash
+torrentfile edit -h
+```
+
+### Create Magnet
+
+To create a magnet URI for a pre-existing torrent meta file, use the sub-command
+`magnet` or `m` with the path to the torrent file.
+
+```bash
+torrentfile magnet /path/to/some.torrent
+```
+
+### GUI
+
+If you prefer a windowed GUI please check out the official GUI frontend [here](https://github.com/alexpdev/TorrentFileQt)
+ + +%prep +%autosetup -n torrentfile-0.8.13 + +%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-torrentfile -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Fri May 05 2023 Python_Bot <Python_Bot@openeuler.org> - 0.8.13-1 +- Package Spec generated @@ -0,0 +1 @@ +ae86b304d11b40d6375fcc5e81dcfc0b torrentfile-0.8.13.tar.gz |