Merge branch 'development' into development
This commit is contained in:
commit
324242a9bc
32
README.md
32
README.md
|
@ -12,12 +12,18 @@ Included in this README are a few example Bash tricks to get certain behaviour.
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
*Bulk Downloader for Reddit* needs Python version 3.9 or above. Please update Python before installation to meet the requirement. Then, you can install it as such:
|
*Bulk Downloader for Reddit* needs Python version 3.9 or above. Please update Python before installation to meet the requirement. Then, you can install it via pip with:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python3 -m pip install bdfr --upgrade
|
python3 -m pip install bdfr --upgrade
|
||||||
```
|
```
|
||||||
|
|
||||||
|
or via [pipx](https://pypa.github.io/pipx) with:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python3 -m pipx install bdfr --upgrade
|
||||||
|
```
|
||||||
|
|
||||||
**To update BDFR**, run the above command again after the installation.
|
**To update BDFR**, run the above command again after the installation.
|
||||||
|
|
||||||
### AUR Package
|
### AUR Package
|
||||||
|
@ -42,47 +48,47 @@ Note that the `clone` command is not a true, failthful clone of Reddit. It simpl
|
||||||
After installation, run the program from any directory as shown below:
|
After installation, run the program from any directory as shown below:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python3 -m bdfr download
|
bdfr download
|
||||||
```
|
```
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python3 -m bdfr archive
|
bdfr archive
|
||||||
```
|
```
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python3 -m bdfr clone
|
bdfr clone
|
||||||
```
|
```
|
||||||
|
|
||||||
However, these commands are not enough. You should chain parameters in [Options](#options) according to your use case. Don't forget that some parameters can be provided multiple times. Some quick reference commands are:
|
However, these commands are not enough. You should chain parameters in [Options](#options) according to your use case. Don't forget that some parameters can be provided multiple times. Some quick reference commands are:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python3 -m bdfr download ./path/to/output --subreddit Python -L 10
|
bdfr download ./path/to/output --subreddit Python -L 10
|
||||||
```
|
```
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python3 -m bdfr download ./path/to/output --user reddituser --submitted -L 100
|
bdfr download ./path/to/output --user reddituser --submitted -L 100
|
||||||
```
|
```
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python3 -m bdfr download ./path/to/output --user me --saved --authenticate -L 25 --file-scheme '{POSTID}'
|
bdfr download ./path/to/output --user me --saved --authenticate -L 25 --file-scheme '{POSTID}'
|
||||||
```
|
```
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python3 -m bdfr download ./path/to/output --subreddit 'Python, all, mindustry' -L 10 --make-hard-links
|
bdfr download ./path/to/output --subreddit 'Python, all, mindustry' -L 10 --make-hard-links
|
||||||
```
|
```
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python3 -m bdfr archive ./path/to/output --user reddituser --submitted --all-comments --comment-context
|
bdfr archive ./path/to/output --user reddituser --submitted --all-comments --comment-context
|
||||||
```
|
```
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python3 -m bdfr archive ./path/to/output --subreddit all --format yaml -L 500 --folder-scheme ''
|
bdfr archive ./path/to/output --subreddit all --format yaml -L 500 --folder-scheme ''
|
||||||
```
|
```
|
||||||
|
|
||||||
Alternatively, you can pass options through a YAML file.
|
Alternatively, you can pass options through a YAML file.
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python3 -m bdfr download ./path/to/output --opts my_opts.yaml
|
bdfr download ./path/to/output --opts my_opts.yaml
|
||||||
```
|
```
|
||||||
|
|
||||||
For example, running it with the following file
|
For example, running it with the following file
|
||||||
|
@ -100,7 +106,7 @@ subreddit:
|
||||||
would be equilavent to (take note that in YAML there is `file_scheme` instead of `file-scheme`):
|
would be equilavent to (take note that in YAML there is `file_scheme` instead of `file-scheme`):
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python3 -m bdfr download ./path/to/output --skip mp4 --skip avi --file-scheme "{UPVOTES}_{REDDITOR}_{POSTID}_{DATE}" -L 10 -S top --subreddit EarthPorn --subreddit CityPorn
|
bdfr download ./path/to/output --skip mp4 --skip avi --file-scheme "{UPVOTES}_{REDDITOR}_{POSTID}_{DATE}" -L 10 -S top --subreddit EarthPorn --subreddit CityPorn
|
||||||
```
|
```
|
||||||
|
|
||||||
In case when the same option is specified both in the YAML file and in as a command line argument, the command line argument takes prs
|
In case when the same option is specified both in the YAML file and in as a command line argument, the command line argument takes prs
|
||||||
|
@ -277,7 +283,7 @@ Alternatively, you can use the command-line [xargs](https://en.wikipedia.org/wik
|
||||||
For a list of users `users.txt` (one user per line), type:
|
For a list of users `users.txt` (one user per line), type:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cat users.txt | xargs -L 1 echo --user | xargs -L 50 python3 -m bdfr download <ARGS>
|
cat users.txt | xargs -L 1 echo --user | xargs -L 50 bdfr download <ARGS>
|
||||||
```
|
```
|
||||||
|
|
||||||
The part `-L 50` is to make sure that the character limit for a single line isn't exceeded, but may not be necessary. This can also be used to load subreddits from a file, simply exchange `--user` with `--subreddit` and so on.
|
The part `-L 50` is to make sure that the character limit for a single line isn't exceeded, but may not be necessary. This can also be used to load subreddits from a file, simply exchange `--user` with `--subreddit` and so on.
|
||||||
|
|
|
@ -55,7 +55,7 @@ python3 -m pip install -e .
|
||||||
Then, you can run the program from anywhere in your disk as such:
|
Then, you can run the program from anywhere in your disk as such:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
$ python3 -m bdfr
|
bdfr
|
||||||
```
|
```
|
||||||
|
|
||||||
## Style Guide
|
## Style Guide
|
||||||
|
|
|
@ -4,7 +4,7 @@ description_file = README.md
|
||||||
description_content_type = text/markdown
|
description_content_type = text/markdown
|
||||||
home_page = https://github.com/aliparlakci/bulk-downloader-for-reddit
|
home_page = https://github.com/aliparlakci/bulk-downloader-for-reddit
|
||||||
keywords = reddit, download, archive
|
keywords = reddit, download, archive
|
||||||
version = 2.6.0
|
version = 2.6.2
|
||||||
author = Ali Parlakci
|
author = Ali Parlakci
|
||||||
author_email = parlakciali@gmail.com
|
author_email = parlakciali@gmail.com
|
||||||
maintainer = Serene Arc
|
maintainer = Serene Arc
|
||||||
|
@ -20,3 +20,7 @@ platforms = any
|
||||||
|
|
||||||
[files]
|
[files]
|
||||||
packages = bdfr
|
packages = bdfr
|
||||||
|
|
||||||
|
[entry_points]
|
||||||
|
console_scripts =
|
||||||
|
bdfr = bdfr.__main__:cli
|
||||||
|
|
Loading…
Reference in a new issue