Metadata-Version: 2.1
Name: tidytwitter
Version: 0.1.2
Summary: Delete your old tweets and favorites using the Twitter API
Home-page: https://github.com/mikepqr/tidytwitter
Author: Mike Lee Williams
Author-email: mike@mike.place
License: UNKNOWN
Project-URL: Bug Reports, https://github.com/mikepqr/tidytwitter/issues
Project-URL: Source, https://github.com/mikepqr/tidytwitter
Keywords: twitter
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: tweepy
Requires-Dist: click

# tidytwitter

Delete your old tweets and favorites using the Twitter API.

```
tidytwitter tweets
```
will delete all of your tweets except those that:

 - are older than `--days` (default: 60), or
 - have more than `--favorite_threshold` favorites (default:20), or
 - you have favorited yourself

```
tidytwitter favorites
```
will delete all your favorites except those that:

 - are older than `--days` (default: 60), or
 - are of one of your own tweets

```
tidytwitter both
```
will delete both tweets and favorites.

See `tidytwitter --help`, `tidytwitter tweets --help` and `tidytwitter favorites
--help` for more.

The idea to preserve self-favorited tweets is stolen with thanks from [a script
by Chris
Albon](https://gist.github.com/chrisalbon/b9bd4a6309c9f5f5eeab41377f27a670).

## Installation

```
pip install tidytwitter
```

Create a new project in your [Twitter developer
account](https://developer.twitter.com/apps) and get the key, secret, access
token and access token secret.

You can either export those as environment variables:

```
export TIDYTWITTER_API_KEY="your_api_key"
export TIDYTWITTER_API_SECRET="your_api_secret"
export TIDYTWITTER_ACCESS_TOKEN="your_access_token"
export TIDYTWITTER_ACCESS_TOKEN_SECRET="your_access_token_secret"
```

or pass them as command line options (`--api-key`, etc., see `--help`).


