Skip to content

Commit 32cc45d

Browse files
authored
Merge pull request #184 from alexpdev/0.9.1
0.9.1
2 parents 113aff6 + 224808e commit 32cc45d

File tree

72 files changed

+5223
-5152
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

72 files changed

+5223
-5152
lines changed

CHANGELOG.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,15 @@
11
# CHANGELOG
22

3+
## Version 0.9.1
4+
5+
- Clean up and consolidate many cli help strings
6+
- Removed some of the less popularly used argument shortcuts
7+
- Edited module and class level docstrings
8+
- Removed old/useless code.
9+
- Added `--align` cli flag for piece aligning v1 torrents
10+
11+
---
12+
313
## Version 0.9.0
414

515
- Updates to Documentation.

README.md

Lines changed: 13 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@
1616

1717
## 🌐 Overview
1818

19-
A command line interface for creating, reviewing, editing, or verifying bittorrent meta files (`.torrent` files).
19+
A command line interface for creating, reviewing, editing, or verifying bittorrent meta files (`.torrent` files).
2020
_`torrentfile`_ is open source, and supports all versions of Bittorrent files, including hybrid meta files. The code base
2121
is also importable and can easily be used as a library for creating or manipulating torrent files in external projects.
2222
Documentation is available at [https://alexpdev.github.io/torrentfile](https://alexpdev.github.io/torrentfile).
@@ -25,8 +25,8 @@ Documentation is available at [https://alexpdev.github.io/torrentfile](https://a
2525
2626
## 🔌 Requirements
2727

28-
- Python 3.6+
29-
- Tested on Linux, Windows and Mac
28+
- Python 3.6+
29+
- Tested on Linux, Windows and Mac
3030

3131
## 💻 Install
3232

@@ -63,10 +63,7 @@ Apache Software License v2.0 - See [LICENSE]("https://github.com/alexpdev/torren
6363
## 💡 Issues & Requests & PRs
6464

6565
If you encounter any bugs or would like to request a new feature please open a new issue.
66-
67-
> PRs and other contributions are welcome
68-
69-
<https://github.com/alexpdev/torrentfile/issues>
66+
PRs and other contributions that are meaningful and add value to the project are welcome.
7067

7168
* * *
7269

@@ -80,7 +77,7 @@ Creating a basic torrent file is as easy as using the create subcommand with the
8077
torrentfile create /path/to/content
8178
```
8279

83-
You can add one or more trackers by using any one of `-a`, `--announce`
80+
You can add one or more trackers by using any one of `-a`, `--announce`
8481
flags and listing their URL as a space separated list.
8582

8683
```bash
@@ -99,10 +96,6 @@ By default **`torrentfile`** displays a progress bar indicating how much of the
9996
has already been processed. To turn off this display you can either use `--quiet` mode in
10097
as a global flag or you can set the `--prog` flag to 0.
10198

102-
```bash
103-
torrentfile --quiet create /path/to/content
104-
```
105-
10699
```bash
107100
torrentfile create /path/to/content --prog 0
108101
```
@@ -132,10 +125,9 @@ For example the following command would create a torrent file at `/some/other/pa
132125
torrentfile create /path/to/content -o /some/other/path/
133126
```
134127

135-
Bittorrent protocol V1 is still the most commonly used version, therefore _`torrentfile`_ creates
136-
Bittorrent version 1 torrent files by default. To specify creating a V2 file or hybrid (v1 and v2)
137-
use the `--meta-version` followed by the specific version number format to use. The options include:
138-
`1`(v1 default), `2`(v2), or `3`(v1 & v2).
128+
_`torrentfile`_ creates Bittorrent v1 files by default. To create a V2 or hybrid (v1 and v2)
129+
torrent file, use the `--meta-version` option followed by the preferred version number option.
130+
The options include: `1`(v1 default), `2`(v2), or `3`(v1 & v2).
139131

140132
```bash
141133
torrentfile create /path/to/content --meta-version 2
@@ -145,17 +137,17 @@ torrentfile create /path/to/content --meta-version 2
145137
torrentfile create /path/to/content --meta-version 3
146138
```
147139

148-
>`torrentfile` now includes the option to command line flags for the `create` sub-command from an `ini` style
140+
`torrentfile` includes the option to command line flags for the `create` sub-command from an `ini` style
149141
configuration file, by using the `--config` and optional `--config-path` options to specify the path
150142
to the configuration file. If `--config-path` is ommited, then `torrentfile` will look by default in the current
151-
working directory for a file named `torrentfile.ini`. If the file is not discovered in the current working directory,
152-
it will move on to look `~/.torrentfile/torrentfile.ini` followed by `~/.config/torrentfile.ini`. Please see the
143+
working directory for a file named `torrentfile.ini`. If the file is not discovered in the current working directory,
144+
it will move on to look `~/.torrentfile/torrentfile.ini` followed by `~/.config/torrentfile.ini`. Please see the
153145
[documentation](https://alexpdev.github.io/torrentfile/overview/) for more details on how the configuration file should be
154146
formatted.
155147

156148
### Check/Recheck Torrent
157149

158-
The `recheck` subcommand allows you to scan a Bittorrent file and compare it's contents,
150+
The `recheck` subcommand allows you to scan a Bittorrent file and compare it's contents,
159151
against a file or directory containing the contents the torrent file was created from.
160152
The output provided by this process gives a detailed perspective if any files are missing
161153
or have been corrupted in any way. Supports any version of Bittorrent file.
@@ -183,7 +175,7 @@ torrentfile edit -h
183175
### Create Magnet
184176

185177
To create a magnet URI for a pre-existing torrent meta file, use the sub-command
186-
`magnet` or `m` with the path to the torrent file.
178+
`magnet` with the path to the torrent file.
187179

188180
```bash
189181
torrentfile magnet /path/to/some.torrent

0 commit comments

Comments
 (0)