%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 ![torrentfile](https://github.com/alexpdev/torrentfile/blob/master/site/images/torrentfile.png?raw=true) * * * ![GitHub repo size](https://img.shields.io/github/repo-size/alexpdev/torrentfile?color=orange) ![GitHub License](https://img.shields.io/github/license/alexpdev/torrentfile?color=red&logo=apache) ![PyPI - Downloads](https://img.shields.io/pypi/dm/torrentfile?color=brown) ![GitHub Last Commit](https://badgen.net/github/last-commit/alexpdev/torrentfile?color=blue) [![CI](https://github.com/alexpdev/TorrentFile/actions/workflows/pyworkflow.yml/badge.svg?branch=master&event=push)](https://github.com/alexpdev/torrentfile/actions/workflows/pyworkflow.yml) [![Codacy Badge](https://app.codacy.com/project/badge/Coverage/b67ff65b3d574025b65b6587266bbab7)](https://www.codacy.com/gh/alexpdev/torrentfile/dashboard?utm_source=github.com&utm_medium=referral&utm_content=alexpdev/torrentfile&utm_campaign=Badge_Coverage) [![Codacy Badge](https://app.codacy.com/project/badge/Grade/b67ff65b3d574025b65b6587266bbab7)](https://www.codacy.com/gh/alexpdev/torrentfile/dashboard?utm_source=github.com&utm_medium=referral&utm_content=alexpdev/torrentfile&utm_campaign=Badge_Grade) [![DeepSource](https://deepsource.io/gh/alexpdev/TorrentFile.svg/?label=active+issues&token=16Sl_dF7nTU8YgPilcqhvHm8)](https://deepsource.io/gh/alexpdev/torrentfile/) [![codecov](https://codecov.io/gh/alexpdev/torrentfile/branch/master/graph/badge.svg?token=EWF7NIL9SQ)](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 ## 🔌 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 ![Basic Usage](https://github.com/alexpdev/torrentfile/blob/master/assets/Torrentfile.gif?raw=True) > 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 * * * ## 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 ![torrentfile](https://github.com/alexpdev/torrentfile/blob/master/site/images/torrentfile.png?raw=true) * * * ![GitHub repo size](https://img.shields.io/github/repo-size/alexpdev/torrentfile?color=orange) ![GitHub License](https://img.shields.io/github/license/alexpdev/torrentfile?color=red&logo=apache) ![PyPI - Downloads](https://img.shields.io/pypi/dm/torrentfile?color=brown) ![GitHub Last Commit](https://badgen.net/github/last-commit/alexpdev/torrentfile?color=blue) [![CI](https://github.com/alexpdev/TorrentFile/actions/workflows/pyworkflow.yml/badge.svg?branch=master&event=push)](https://github.com/alexpdev/torrentfile/actions/workflows/pyworkflow.yml) [![Codacy Badge](https://app.codacy.com/project/badge/Coverage/b67ff65b3d574025b65b6587266bbab7)](https://www.codacy.com/gh/alexpdev/torrentfile/dashboard?utm_source=github.com&utm_medium=referral&utm_content=alexpdev/torrentfile&utm_campaign=Badge_Coverage) [![Codacy Badge](https://app.codacy.com/project/badge/Grade/b67ff65b3d574025b65b6587266bbab7)](https://www.codacy.com/gh/alexpdev/torrentfile/dashboard?utm_source=github.com&utm_medium=referral&utm_content=alexpdev/torrentfile&utm_campaign=Badge_Grade) [![DeepSource](https://deepsource.io/gh/alexpdev/TorrentFile.svg/?label=active+issues&token=16Sl_dF7nTU8YgPilcqhvHm8)](https://deepsource.io/gh/alexpdev/torrentfile/) [![codecov](https://codecov.io/gh/alexpdev/torrentfile/branch/master/graph/badge.svg?token=EWF7NIL9SQ)](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 ## 🔌 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 ![Basic Usage](https://github.com/alexpdev/torrentfile/blob/master/assets/Torrentfile.gif?raw=True) > 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 * * * ## 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 ![torrentfile](https://github.com/alexpdev/torrentfile/blob/master/site/images/torrentfile.png?raw=true) * * * ![GitHub repo size](https://img.shields.io/github/repo-size/alexpdev/torrentfile?color=orange) ![GitHub License](https://img.shields.io/github/license/alexpdev/torrentfile?color=red&logo=apache) ![PyPI - Downloads](https://img.shields.io/pypi/dm/torrentfile?color=brown) ![GitHub Last Commit](https://badgen.net/github/last-commit/alexpdev/torrentfile?color=blue) [![CI](https://github.com/alexpdev/TorrentFile/actions/workflows/pyworkflow.yml/badge.svg?branch=master&event=push)](https://github.com/alexpdev/torrentfile/actions/workflows/pyworkflow.yml) [![Codacy Badge](https://app.codacy.com/project/badge/Coverage/b67ff65b3d574025b65b6587266bbab7)](https://www.codacy.com/gh/alexpdev/torrentfile/dashboard?utm_source=github.com&utm_medium=referral&utm_content=alexpdev/torrentfile&utm_campaign=Badge_Coverage) [![Codacy Badge](https://app.codacy.com/project/badge/Grade/b67ff65b3d574025b65b6587266bbab7)](https://www.codacy.com/gh/alexpdev/torrentfile/dashboard?utm_source=github.com&utm_medium=referral&utm_content=alexpdev/torrentfile&utm_campaign=Badge_Grade) [![DeepSource](https://deepsource.io/gh/alexpdev/TorrentFile.svg/?label=active+issues&token=16Sl_dF7nTU8YgPilcqhvHm8)](https://deepsource.io/gh/alexpdev/torrentfile/) [![codecov](https://codecov.io/gh/alexpdev/torrentfile/branch/master/graph/badge.svg?token=EWF7NIL9SQ)](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 ## 🔌 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 ![Basic Usage](https://github.com/alexpdev/torrentfile/blob/master/assets/Torrentfile.gif?raw=True) > 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 * * * ## 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 - 0.8.13-1 - Package Spec generated