i_delete_my_tweets 0.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3ff348ad213ee9c945f3446ddcfc262ddd765b365c2ba822659ce23c50c13031
+  data.tar.gz: 5b9e89d7c7f20425ace5030692ee2691aab1635f758bf9740b3c2554d869b1eb
+SHA512:
+  metadata.gz: 958a1f50a5fac1cde0361bf7f0cc0a17294ab8fc28a00164d0a8b6d7786b938f89fb81b350c3c3883971ad60f5d6d9e7d549fae3ecfdecff54c7b3beb6b108b8
+  data.tar.gz: faef72a69487e4e84b0b0d95dc4675c7bc9f487e84b2decbcc2e29e5a55efcee345b03e7503a6cbee490ca67c57e0933adb22afd648501f68d5d29a57b8dbeff

data/.env.sample

@@ -0,0 +1,9 @@
+CONSUMER_KEY=
+CONSUMER_SECRET=
+ACCESS_TOKEN=
+ACCESS_TOKEN_SECRET=
+OLDER_THAN="2022-04-28 21:20:47 -0300"
+PATH_TO_CSV='./tweets.csv'
+FAVE_THRESHOLD=3
+RT_THRESHOLD=5
+SCREEN_NAME=jack

data/.env.test

@@ -0,0 +1,9 @@
+CONSUMER_KEY=12121122
+CONSUMER_SECRET=12321312312
+ACCESS_TOKEN=12312312321321
+ACCESS_TOKEN_SECRET=123123123123123
+OLDER_THAN="2022-04-28 21:20:47 -0300"
+PATH_TO_CSV='./tweets.csv'
+FAVE_THRESHOLD=3
+RT_THRESHOLD=5
+SCREEN_NAME=jack

data/README.md

@@ -0,0 +1,119 @@
+# I Delete My Tweets
+
+A **CLI** (as in Command Line Interface) to delete your tweets based on faves, RTs, and time.
+
+There are some services out there with a friendly web interface, but this is not one of them.
+You must know the basics of working with a UNIX terminal and configuring a Twitter API app, as this
+will only work if you have a Twitter Developer account.
+
+Due to the irrevocable nature of tweet deletion, all delete commands are `dry-run` true, meaning
+you must call all of them with a `--dry-run=false` flag if you want them to really do something.
+
+Called with `--dry-run=false`, there is no way to revoke tweet deletion. They are just gone, disappeared into the ether (or the stashed in the Twitter-owned secret place you have no access to without a mandate since nothing gets _really_ deleted from the web these days, folks).
+
+This tool won't delete all of your tweets in one fell swoop; it is more of a way to delete your old tweets from time to time. The [Twitter API rate limits](https://developer.twitter.com/en/docs/twitter-api/rate-limits) are relatively complicated, and I don't even wanna go there, but if you do intend on deleting all of your tweets, you can do it with this CLI and some perseverance. I did delete more than 100k of mine by using this script every day for a couple of weeks. The more tweets you delete, the fewer of them you have, and with time the rate limits won't be that much of a problem.
+
+I Delete My Tweets (IDMT) can delete your tweets by fetching them via API using an APP you will have to set up yourself. Still, it can also delete tweets from an CSV (comma-separated file) that you can generate from the archive you can request from twitter.com by going to Settings and privacy > Your Account > Download an archive of your data. It is out of the scope of this CLI to generate the CSV (at the moment) but [there are scripts out there](https://gist.github.com/jessefogarty/b0f2d4ea6bdd770e5e9e94d54154c751) that can do this for you.
+
+> TIP: You can find an example of the CSV header in the project's root folder.
+
+These are the keys/values that make the script work. They are read from and written to
+a `.i_delete_my_tweets` env file in your user directory (~/). You can fill
+the values yourself or work with the <config store> commands (see Usage) to do that interactively.
+
+| KEY                 | VALUE                       | DESCRIPTION                              |
+| ------------------- | --------------------------- | ---------------------------------------- |
+| CONSUMER_KEY        | String                      | Your Twitter App key                     |
+| CONSUMER_SECRET     | String                      | Your Twitter App secret                  |
+| ACCESS_TOKEN        | String                      | Account access token                     |
+| ACCESS_TOKEN_SECRET | String                      | Access token secret                      |
+| OLDER_THAN          | "2022-04-28 21:20:47 -0300" | A timestamp                              |
+| PATH_TO_CSV         | './tweets.csv'              | A path to a CSV file                     |
+| FAVE_THRESHOLD      | 3                           | Minimum number of faves to skip deletion |
+| RT_THRESHOLD        | 5                           | Minimum number of RTs to skip deletion   |
+| SCREEN_NAME         | jack                        | The account screen_name                  |
+
+Since you have to call commands with `--dry-run=false` for them to really take action, just play around with the skip rules before using `--dry-run=false` and see what works for you.
+
+## Install
+
+```sh
+$ gem install i_delete_my_tweets
+```
+
+IDMT is compatible with ruby-2.6.5 up.
+
+## Usage
+
+```sh
+$ i_delete_my_tweets -h
+```
+
+Will print all commands and options.
+
+```sh
+$ i_delete_my_tweets -v
+```
+
+Gives you the version.
+
+### Commands
+
+```sh
+$ i_delete_my_tweets config store key value
+```
+
+### Set-up
+
+- [Create a Twitter Developer Account](https://developer.twitter.com/en/apply) if you don't already have one.
+
+  You have to wait for the account to be reviewed and approved.
+
+- [Create a Twitter App](https://developer.twitter.com/en/apps/create) with read and write permission
+- Take note of the app's `CONSUMER_KEY` and `CONSUMER_SECRET`
+
+#### Config
+
+```sh
+$ i_delete_my_tweets config store CONSUMER_KEY 9183921819809283910f
+$ i_delete_my_tweets config store CONSUMER_SECRET 0293090239-2039209302-238392839
+$ i_delete_my_tweets config store RT_THRESHOLD 2
+$ i_delete_my_tweets config store FAVE_THRESHOLD 2
+$ i_delete_my_tweets config store OLDER_THAN 2021-11-02
+$ i_delete_my_tweets config store SCREEN_NAME mytwitterhandle
+```
+
+IDMT can generate an `ACCESS_TOKEN` and `ACCESS_TOKEN_SECRET` for you using a PIN provided
+that you do have a Twitter App setup and `CONSUMER_KEY` and `CONSUMER_SECRET`.
+
+You can bypass most of the configuration by doing a
+
+```sh
+$ i_delete_my_tweets config authorize_with_pin <consumer-key> <consumer-value>
+```
+
+It will generate a URL that will take you to Twitter and issue a PIN. Then IDMT will
+configure `ACCESS_TOKEN`, `ACCESS_TOKEN_SECRET`, and `SCREEN_NAME` for you.
+
+At any point, you can check if all keys/values are good to go with
+
+```sh
+$ i_delete_my_tweets config check
+```
+
+#### Delete
+
+```sh
+$ i_delete_my_tweets delete start
+```
+
+Will start traversing the API for your tweets and applying the `OLDER_THAN`, `FAVE_THRESHOLD`, and `RT_THRESHOLD` rules (they are applied in this order). The rules are NOT combined. If the first one matches the data in the tweet, the tweet is skipped, next one.
+
+Pass in `--dry-run=false` if you REALLY want to delete them otherwise this command will just output the tweets it would delete but doesn't because
+the default flag for delete commands is `--dry-run=true`.
+
+```sh
+$ i_delete_my_tweets delete from_csv
+```
+
+Will use the tweets from the CSV file and not fetch the API for them. This is a nice option if you want to avoid some of the API rate limits and will be a little faster since it will not do the initial tweet-fetching over HTTP.

data/bin/i_delete_my_tweets

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+lib = File.expand_path('../lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'semver'
+require 'dotenv'
+require 'csv'
+require 'twitter'
+require 'oauth'
+require 'active_support/all'
+require 'terminal-table'
+require 'byebug'
+require 'i_delete_my_tweets'
+
+Dotenv.overload("~/.i_delete_my_tweets")
+IDeleteMyTweets::CLI.start(ARGV)

data/i_delete_my_tweets.gemspec

@@ -0,0 +1,33 @@
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'i_delete_my_tweets/version'
+
+Gem::Specification.new do |spec|
+  spec.add_dependency 'activesupport', '~> 6.1.5.1'
+  spec.add_dependency 'csv', '~> 3.0.9'
+  spec.add_dependency 'dotenv', '~> 2.7.6'
+  spec.add_dependency 'oauth', '~> 0.4'
+  spec.add_dependency 'terminal-table', '~> 3.0.2'
+  spec.add_dependency 'thor', '~> 1.2.1'
+  spec.add_dependency 'twitter', '~> 7.0.0'
+  spec.add_development_dependency 'bundler', '>= 1.0', '< 3'
+  spec.add_development_dependency 'rubocop', '~> 1.29'
+  spec.add_development_dependency 'rubocop-performance', '~> 1.13.3'
+  spec.add_development_dependency 'rubocop-rspec', '~> 2.10.0'
+  spec.add_development_dependency 'semver2', '~> 3.4.2'
+  spec.authors = %w('Fabio Mont Alegre')
+  spec.platform = Gem::Platform::RUBY
+  spec.description = IDeleteMyTweets::Description
+  spec.email = %w(spiceee@gmail.com)
+  spec.homepage = 'https://github.com/spiceee/i_delete_my_tweets'
+  spec.licenses = %w(MIT)
+  spec.executables = %w(i_delete_my_tweets)
+  spec.name = 'i_delete_my_tweets'
+  spec.require_paths = %w(lib)
+  spec.required_ruby_version = '>= 2.6.5'
+  spec.required_rubygems_version = '>= 1.3.5'
+  spec.summary = 'A CLI to delete your tweets based on faves, RTs, and time.'
+  spec.files = Dir["*.md", "bin/*", "lib/**/*.rb"] + %w(.env.sample .env.test tweets.csv i_delete_my_tweets.gemspec)
+  spec.version = IDeleteMyTweets::Version
+  spec.metadata['rubygems_mfa_required'] = 'true'
+end

data/lib/i_delete_my_tweets/api.rb

@@ -0,0 +1,145 @@
+module IDeleteMyTweets
+  class Api
+    include Presenter
+    attr_reader :config, :verbose, :log, :dry_run, :a_bit
+    attr_accessor :delete_count, :skipped_count, :not_found_count
+
+    def initialize(opts = {})
+      @config = opts[:config] || Config.new
+      @verbose, @log, @dry_run = opts[:verbose], opts[:logger], opts[:dry_run]
+      @delete_count, @skipped_count, @not_found_count = 0, 0, 0
+      @a_bit = opts[:a_bit] || 5
+    end
+
+    def traverse_api!
+      all_tweets.each do |tweet|
+        if can_be_destroyed?(tweet)
+          destroy_with_retry(tweet)
+          sleep a_bit
+        else
+          self.skipped_count += 1
+        end
+      end
+    rescue IOError
+      do_log(" 💥 Oops, there was a connection error! ", color: :red)
+    ensure
+      do_log summary delete_count, skipped_count, not_found_count, dry_run
+    end
+
+    def traverse_csv!
+      CSV.foreach(config.path_to_csv, headers: true) do |tweet|
+        if to_time(tweet["timestamp"]) >= config.older_than
+          self.skipped_count += 1
+          next
+        end
+
+        tw_data = fetch_tweet(tweet["tweet_id"])
+        next if tw_data.nil?
+
+        if can_be_destroyed?(tw_data)
+          destroy_with_retry(tw_data)
+          sleep a_bit
+        else
+          self.skipped_count += 1
+        end
+      end
+    end
+
+    def client
+      @client ||= Twitter::REST::Client.new do |c|
+        c.consumer_key = config.consumer_key
+        c.consumer_secret = config.consumer_secret
+        c.access_token = config.access_token
+        c.access_token_secret = config.access_token_secret
+      end
+    end
+
+    def verify_credentials
+      client.verify_credentials(skip_status: true)
+      do_log(" 🎉 We could verify your ❝#{config.screen_name}❞ credentials with Twitter and it looks good! ", color: :white, force_new_line: false)
+      true
+    rescue Twitter::Error => e
+      if e.is_a?(Twitter::Error::Forbidden)
+        do_log(" 🚫 Oops, Twitter cannot verify the crendentials for #{config.screen_name} ", color: :red)
+      else
+        do_log(" 🚫 Oops, something bad happened: #{e.message} ", color: :red)
+      end
+      false
+    end
+
+  private
+
+    def destroy_with_retry(tweet)
+      destroy_tweet!(tweet.id)
+    rescue HTTP::ConnectionError
+      do_log "💥 == trying again =="
+      destroy_tweet!(tweet.id)
+    rescue Twitter::Error::TooManyRequests => e
+      do_log "💥 == we've reached a rate limit, sleeping it off =="
+      sleep e.rate_limit.reset_in + 1
+      retry
+    ensure
+      do_log tweet_presenter(tweet, dry_run, verbose: verbose), force_new_line: verbose
+    end
+
+    def destroy_tweet!(id)
+      client.destroy_status(id) unless dry_run
+      self.delete_count += 1
+    end
+
+    def do_log(message, color: nil, force_new_line: true)
+      log&.call("", nil, true) if force_new_line
+      log&.call(message, color || COLORS.sample, force_new_line)
+    end
+
+    def fetch_tweet(id)
+      client.status(id)
+    rescue Twitter::Error::NotFound
+      do_log tweet_not_found(id, dry_run, verbose: verbose)
+      self.not_found_count += 1
+      nil
+    end
+
+    def satisfies_older_than?(tweet)
+      tweet.created_at < config.older_than
+    end
+
+    def bellow_fave_threshold?(tweet)
+      return true if config.fave_threshold.to_i == 0
+      return true unless tweet.favorite_count > 0
+
+      tweet.favorite_count < config.fave_threshold.to_i
+    end
+
+    def bellow_rt_threshold?(tweet)
+      return true if config.rt_threshold.to_i == 0
+      return true unless tweet.retweet_count > 0
+
+      tweet.retweet_count < config.rt_threshold.to_i
+    end
+
+    def can_be_destroyed?(tweet)
+      return false unless satisfies_older_than? tweet
+      return false unless bellow_fave_threshold? tweet
+      return false unless bellow_rt_threshold? tweet
+
+      true
+    end
+
+    def collect_with_max_id(collection = [], max_id = nil, &block)
+      response = yield(max_id)
+      collection += response
+      response.empty? ? collection.flatten : collect_with_max_id(collection, response.last.id - 1, &block)
+    end
+
+    def all_tweets
+      @all_tweets ||= collect_with_max_id do |max_id|
+        options = {count: 200, include_rts: true}
+        options[:max_id] = max_id unless max_id.nil?
+        client.user_timeline(config.screen_name, options)
+      end
+    rescue HTTP::ConnectionError
+      do_log(" 💥 Oops, there was a connection error fetching your tweets! ", color: :red)
+    end
+  end
+end

data/lib/i_delete_my_tweets/ascii.rb

@@ -0,0 +1,52 @@
+module IDeleteMyTweets
+  module Ascii
+    def show_face
+      <<~'FACE'
+
+        @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#BPJ!~~~^^^^!7?JYPB&@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@&BP?~:..           ...    .:!P@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@P~.      ........            ... :5&@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@@@@@G.                                  .:P@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@@@@7                                      .~P&@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@@&:       ..::^~!!!77777???7!~^:..           .?@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@&.     .:~!?JY5PPPGGGGGGGGGGGPP55Y?!~.         7@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@7    .^!?JY5PPPGGGGGBBBGGGGGGPPPPP555Y?~.       ?@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@!   .!?JYY5PPPGGGGBBBBBBBBBGGGGPP55555YYJ~.      ^P&@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@:  ^!7JYYY5PPGGGBBB#BBBBBBBGGGGPPP55YYYYYJ~.. ...  .G@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@P  ^7?JYY55PPGGGGBBBBBBBBBBBGGGGGPPP5YYYYYJ7^.....    J@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@: ^7?YYY5PPPGGGGBBBBBBBBBBBBGGGGGPPP555YYJ?!^.....     G@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@# :!7?JJY5PGGBBBBBBBBBBBBBBBBBBGGGGGPP555YJ7~^..        7@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@G ~~~~^^^^7JPGGBBB###BB###BGPYJY5PGGPPP555J?~:.         !@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@B.~~~7?JJ?77?Y5PPGGBBGGGP5?7~~~~~!?Y55555YYY?^.         ~@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@&:!!!77?JY555??J5PPPPPP5YY5PPPP55YJ?7?YY5YYJYJ~.       .B@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@&^77!~^^.^?Y??77YGGGP5YJYJJJJJY55Y55Y?JYYYYYJJ!.      .#@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@#~???7?JJY55JYJ7YPPP5YJJ77?^^^7!7JJJYYYYYYYJ??~.     ~&@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@B7JJYYJJJY5555??Y555JY5Y??J5555J??J55555YYJ??7^...  ~@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@57?JY55PPGGGPJ7J555YYY5PP5YYY555PPPGPP55J?7??~:...^^^7@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@&77?Y55PGGGGPJ7?YP5YJJYPGGGGGGGGGGGGPPP5Y?7777^..:!?!~7@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@G~7J555PPPP5J??YGGPY??Y55PGBBBBBGGP5YYYYJ7!!7!::^:7J??B@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@Y~7?YY55YYYJ!^!JPPY??Y5YJ55PGBBBBGGP5YYJY7!!!^^!!:75?Y@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@Y^~7?J?7777?!~^^^!^:^~!7?55YYPGGGGPP5YJJ?7!!~~7?!!Y57&@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@B^^~!!!!7777???!~^~7JYYYY5YY??Y5555YJJ?77!!~!!77?JJ?&@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@&!~!???!~!7??JY5PPPPPPP555Y5Y?!!???77777!!~!!!7YYYP&@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@Y~!YY7~^..:~7!?7??!!77?7??JJJ?7!7!!!!777!~!!!YY5&@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@&!!?P5J7: :?PB#BB#PG5Y?~:..:!7JYYJ?7?777!~~^JB#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@P~!YGPY7^....::^~^^:::.  :?5YYP5Y?J??7!!~^7@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@!^!5PY7~!!!~^^:::^^^~~!J5PPPP5J?JJ7!!~~^^&@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@&!~75Y?~~!?JYP5YYJJJ??Y5PPPP5?7??7!~~^:~#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@@&!~YYJ7~!!77???JJ???J5P5PP5??J?7!~~::J@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@@@#^!YYYJ77777????JJY5PPPGPJ?J?7~^::~B@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@@@@B.!Y5P5YY5555PPPPPGGPG5?!77~^:.~G@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@@@@@#^^7YY55PPPPPGGPGP5J7~^^^:..^G@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@J::~!?JYYYYYJ??7!:.....:7B@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@&Y^...::::....  ..:!Y#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@&B5?~^^^^~!?5B&@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+        @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+
+      FACE
+    end
+  end
+end

data/lib/i_delete_my_tweets/auth.rb

@@ -0,0 +1,50 @@
+require "oauth"
+
+module IDeleteMyTweets
+  module Auth
+    def consumer(client)
+      OAuth::Consumer.new(
+        client.consumer_key,
+        client.consumer_secret,
+        site: Twitter::REST::Request::BASE_URL,
+      )
+    end
+
+    def pin_auth_parameters
+      {oauth_callback: "oob"}
+    end
+
+    def get_request_token(client)
+      consumer(client).get_request_token
+    rescue StandardError => e
+      say_error set_color " 🚫 Oops, something bad happened: #{e.message} ", :white, :on_red, :bold
+    end
+
+    def get_access_credentials(request_token, pin)
+      access_token = request_token.get_access_token(oauth_verifier: pin.chomp)
+      {oauth_token: access_token.token,
+       oauth_token_secret: access_token.secret,
+       screen_name: access_token.params[:screen_name]}
+    rescue StandardError => e
+      say_error set_color " 🚫 Oops, something bad happened: #{e.message} ", :white, :on_red, :bold
+    end
+
+    def generate_authorize_url(client, request_token)
+      oauth = consumer(client)
+      request = oauth.create_signed_request(:get, oauth.authorize_path, request_token, pin_auth_parameters)
+      build_path(request, build_headers(request))
+    end
+
+    def build_path(request, params)
+      "#{Twitter::REST::Request::BASE_URL}#{request.path}?#{params}"
+    end
+
+    def build_headers(request)
+      request["Authorization"].sub(/^OAuth\s+/, "").split(/,\s+/).map { |p|
+        k, v = p.split("=")
+        v =~ /"(.*?)"/
+        "#{k}=#{CGI.escape($1)}"
+      }.join("&")
+    end
+  end
+end

data/lib/i_delete_my_tweets/cli.rb

@@ -0,0 +1,138 @@
+require 'thor'
+
+module IDeleteMyTweets
+  class CommandDelete < Thor
+    class_option :dry_run, type: :boolean, default: true
+
+    include Ascii
+    desc "start", "Starts the deleting process"
+    def start
+      say show_face, :yellow if options[:verbose]
+      say set_color api.config.to_table, :green, :bold
+      api.traverse_api!
+    end
+
+    desc "from_csv", "Starts the deleting process using a csv file"
+    def from_csv
+      say show_face, :yellow if options[:verbose]
+      say set_color api.config.to_table, :green, :bold
+      api.traverse_csv!
+    end
+
+  private
+
+    def api
+      @api ||= IDeleteMyTweets::Api.new(verbose: options[:verbose], logger: method(:say), dry_run: options[:dry_run])
+    end
+  end
+
+  class CommandConfig < Thor
+    include Thor::Actions
+    include Auth
+    class_option :dry_run, type: :boolean, default: false
+
+    desc "check", "Checks if the configuration is ok"
+    def check
+      bad_configs = cli_config.empty_values
+
+      if bad_configs.empty?
+        api = IDeleteMyTweets::Api.new(logger: method(:say))
+        api.verify_credentials
+        say set_color " ✅ You're all set! ", :white, :on_green, :bold
+        say set_color cli_config.to_table, :green
+      else
+        say_error set_color " 🚫 Oops, #{bad_configs.join(', ')} #{bad_configs.size == 1 ? 'is' : 'are'} missing! ", :white, :on_red, :bold
+      end
+    end
+
+    desc "store <key> <value>", "Stores the configuration <key> with value <value>"
+    def store(key, value)
+      raise Error, "ERROR: #{key} does not exist" unless CONFIG_VARS.include?(key.strip)
+
+      conf = cli_config
+      conf.send("#{key.downcase.to_sym}=", value);
+
+      if options[:dry_run]
+        say set_color conf.to_table, :green, :bold
+      else
+        dump_to_file!(conf)
+      end
+    end
+
+    desc "authorize_with_pin <consumer-key> <consumer-secret>", "Generates a URL to auth the app"
+    map %w[-a --authorize-with-pin] => :authorize_with_pin
+    def authorize_with_pin(consumer_key, consumer_secret)
+      conf = cli_config
+      conf.consumer_key, conf.consumer_secret = consumer_key, consumer_secret
+      api = IDeleteMyTweets::Api.new(config: conf)
+
+      request_token = get_request_token(api.client)
+      auth_url = generate_authorize_url(api.client, request_token)
+
+      pin = ask set_color interactive_pin_message(auth_url), :green, :bold
+      credentials = get_access_credentials(request_token, pin)
+      update_and_rewrite_conf!(conf, credentials)
+    end
+
+  private
+
+    def update_and_rewrite_conf!(config, new_creds)
+      config.access_token, config.access_token_secret = new_creds[:oauth_token], new_creds[:oauth_token_secret]
+      config.screen_name = new_creds[:screen_name]
+
+      if options[:dry_run]
+        say set_color config.to_table, :green, :bold
+      else
+        dump_to_file!(config)
+      end
+    end
+
+    def interactive_pin_message(auth_url)
+      <<~MESSAGE
+        👋 Open this URL in a browser, preferably the one you're logged into the
+        Twitter account you want to delete tweets from:
+
+        ✂️------------------------------------------------------------------
+
+        #{auth_url}
+
+        ------------------------------------------------------------------✂️
+
+        Then copy and paste below the PIN you'll receive once you've authorized the
+        Twitter app you've set up for this ⬇️
+      MESSAGE
+    end
+
+    def dump_to_file!(conf)
+      path = File.expand_path(PATH_TO_ENV)
+      File.exist?(path) ? comment_lines(path, /^[A-Z]/) : create_file(PATH_TO_ENV)
+
+      insert_into_file(path) { ["\n", conf.to_env].join("\n") }
+    end
+
+    def cli_config
+      @cli_config ||= IDeleteMyTweets::Config.new
+    end
+  end
+
+  class CLI < Thor
+    check_unknown_options!
+    class_option :verbose, type: :boolean, default: true
+
+    def self.exit_on_failure?
+      true
+    end
+
+    desc "version", "Displays version"
+    map %w[-v --version] => :version
+    def version
+      say Gem.loaded_specs["i_delete_my_tweets"]&.version || Version
+    end
+
+    desc "delete command ...ARGS", "Deletes your tweets based on time, faves and RTs"
+    subcommand "delete", CommandDelete
+
+    desc "config command ...ARGS", "Configures the Twitter app credentials"
+    subcommand "config", CommandConfig
+  end
+end

data/lib/i_delete_my_tweets/config.rb

@@ -0,0 +1,76 @@
+require 'thor'
+
+module IDeleteMyTweets
+  CONFIG_VARS = [
+    "CONSUMER_KEY",
+    "CONSUMER_SECRET",
+    "ACCESS_TOKEN",
+    "ACCESS_TOKEN_SECRET",
+    "OLDER_THAN",
+    "PATH_TO_CSV",
+    "FAVE_THRESHOLD",
+    "RT_THRESHOLD",
+    "SCREEN_NAME"
+  ].freeze
+  PATH_TO_ENV = "~/.i_delete_my_tweets".freeze
+  OBFUSCATE_WORDS = %w(secret token key).freeze
+
+  class Config
+    attr_accessor :consumer_key,
+                  :consumer_secret,
+                  :access_token,
+                  :access_token_secret,
+                  :older_than,
+                  :path_to_csv,
+                  :fave_threshold,
+                  :rt_threshold,
+                  :screen_name
+
+    def initialize(opts = {})
+      @consumer_key = opts[:consumer_key] || ENV.fetch("CONSUMER_KEY", nil)
+      @consumer_secret = opts[:consumer_secret] || ENV.fetch("CONSUMER_SECRET", nil)
+      @access_token = opts[:access_token] || ENV.fetch("ACCESS_TOKEN", nil)
+      @access_token_secret = opts[:access_token_secret] || ENV.fetch("ACCESS_TOKEN_SECRET", nil)
+      @older_than = opts[:older_than] || Time.parse(ENV.fetch("OLDER_THAN", 1.week.ago).to_s)
+      @path_to_csv = opts[:path_to_csv] || ENV.fetch("PATH_TO_CSV", "./")
+      @fave_threshold = opts[:fave_threshold] || ENV.fetch("FAVE_THRESHOLD", 0)
+      @rt_threshold = opts[:rt_threshold] || ENV.fetch("RT_THRESHOLD", 0)
+      @screen_name = opts[:screen_name] || ENV.fetch("SCREEN_NAME", "")
+    end
+
+    def zipped
+      values = CONFIG_VARS.map do |k|
+        normalized_key = k.downcase
+        value = send(normalized_key.to_sym)
+        OBFUSCATE_WORDS.any? { |word| normalized_key.include?(word) } ? obfuscate_token(value) : value
+      end
+      CONFIG_VARS.zip(values)
+    end
+
+    def to_table
+      Terminal::Table.new do |table|
+        table.title = "[I Delete My Tweets] Configuration"
+        table.headings = ["KEY", "VALUE"]
+        table.rows = zipped
+        table.style = Presenter::TABLE_STYLE
+      end
+    end
+
+    def to_env
+      CONFIG_VARS.map { |k| "#{k}='#{send(k.downcase.to_sym).to_s.gsub("'"){ "\\'" }}'" }
+      # ^ Escaping with single quotes because some shells are not nice with ruby unquoted timestamps
+    end
+
+    def empty_values
+      zipped.map { |tuples| tuples.second.to_s.empty? ? tuples.first : nil }.compact
+    end
+
+  private
+
+    def obfuscate_token(token)
+      return if token.nil?
+
+      token.size > 3 ? token.gsub(/^.+(.{3,})$/m, '*********************\1') : "***"
+    end
+  end
+end

data/lib/i_delete_my_tweets/presenter.rb

@@ -0,0 +1,61 @@
+module IDeleteMyTweets
+  module Presenter
+    COLORS = [
+      :red,
+      :green,
+      :yellow,
+      :blue,
+      :magenta,
+      :cyan
+    ].freeze
+
+    TABLE_STYLE = {border: Terminal::Table::UnicodeRoundBorder.new}.freeze
+
+    def summary(delete_count, skipped_count, not_found_count, dry_run)
+      Terminal::Table.new do |table|
+        table.title = "Summary"
+        table.headings = ["Deleted", "Skipped", "Not Found", "Dry Run?"]
+        table.rows = [[delete_count, skipped_count, not_found_count, dry_run.present?]]
+        table.style = TABLE_STYLE
+      end
+    end
+
+    def tweet_presenter(tweet, dry_run, verbose: true)
+      if verbose
+        Terminal::Table.new do |table|
+          table.title = "🐤 Deleted Tweet 🚽"
+          table.headings = ["Text", "Date", "Faves", "RTs", "Dry Run?"]
+          table.rows = [[truncate(tweet.text), to_human_time(tweet.created_at), tweet.favorite_count, tweet.retweet_count, dry_run.present?]]
+          table.style = TABLE_STYLE
+        end
+      else
+        ".🐤 "
+      end
+    end
+
+    def tweet_not_found(tweet_id, dry_run, verbose: true)
+      if verbose
+        Terminal::Table.new do |table|
+          table.title = "💥 Tweet Not Found 💥"
+          table.headings = ["ID", "Dry Run?"]
+          table.rows = [[tweet_id, dry_run.present?]]
+          table.style = TABLE_STYLE
+        end
+      else
+        ".💥 "
+      end
+    end
+
+    def truncate(text)
+      text.gsub(/^(.{40,}?).*$/m, '\1...')
+    end
+
+    def to_time(timestamp)
+      Date.parse timestamp
+    end
+
+    def to_human_time(time)
+      time.strftime("%Y-%m-%d %H:%M")
+    end
+  end
+end

data/lib/i_delete_my_tweets/version.rb

@@ -0,0 +1,71 @@
+require 'semver'
+
+module IDeleteMyTweets
+  module Version
+  module_function
+
+    def parsed_version
+      @parsed_version ||= SemVer.find
+    end
+
+    # @return [Integer]
+    def major
+      parsed_version.major
+    end
+
+    # @return [Integer]
+    def minor
+      parsed_version.minor
+    end
+
+    # @return [Integer]
+    def patch
+      parsed_version.patch
+    end
+
+    # @return [Integer, NilClass]
+    def pre
+      parsed_version.prerelease.empty? ? nil : parsed_version.prerelease
+    end
+
+    # @return [Hash]
+    def to_h
+      {
+        major: major,
+        minor: minor,
+        patch: patch,
+        pre: pre,
+      }
+    end
+
+    # @return [Array]
+    def to_a
+      [major, minor, patch, pre].compact
+    end
+
+    # @return [String]
+    def to_s
+      to_a.join('.')
+    end
+  end
+
+  module Description
+  module_function
+
+    def to_s
+      <<~'DESCRIPTION'
+        A CLI (as in Command Line Interface) to delete your tweets based on faves, RTs, and time.
+
+        There are some services out there with a friendly web interface, but this is not one of them. You must know the basics of working with a UNIX terminal and configuring a Twitter API app, as this will only work if you have a Twitter Developer account.
+
+        Due to the irrevocable nature of tweet deletion, all delete commands are dry-run true, meaning you must call all of them with a --dry-run=false flag if you want them to really do something.
+
+        Called with --dry-run=false, there is no way to revoke tweet deletion. They are just gone, disappeared into the ether (or the stashed in the Twitter-owned secret place you have no access to without a mandate since nothing gets really deleted from the web these days, folks).
+
+        This tool won't delete all of your tweets in one fell swoop; it is more of a way to delete your old tweets from time to time. The Twitter API rate limits are relatively complicated, and I don't even wanna go there, but if you do intend on deleting all of your tweets, you can do it with this CLI and some perseverance. I did delete more than 100k of mine by using this script every day for a couple of weeks. The more tweets you delete, the fewer of them you have, and with time the rate limits won't be that much of a problem.
+
+        I Delete My Tweets (IDMT) can delete your tweets by fetching them via API using an APP you will have to set up yourself. Still, it can also delete tweets from an CSV (comma-separated file) that you can generate from the archive you can request from twitter.com by going to Settings and privacy > Your Account > Download an archive of your data. It is out of the scope of this CLI to generate the CSV (at the moment) but there are scripts out there that can do this for you.
+      DESCRIPTION
+    end
+  end
+end

data/lib/i_delete_my_tweets.rb

@@ -0,0 +1,7 @@
+require_relative 'i_delete_my_tweets/version'
+require_relative 'i_delete_my_tweets/config'
+require_relative 'i_delete_my_tweets/presenter'
+require_relative 'i_delete_my_tweets/api'
+require_relative 'i_delete_my_tweets/ascii'
+require_relative 'i_delete_my_tweets/auth'
+require_relative 'i_delete_my_tweets/cli'

data/tweets.csv

@@ -0,0 +1 @@
+"tweet_id","in_reply_to_status_id","in_reply_to_user_id","timestamp","source","text","retweeted_status_id","retweeted_status_user_id","retweeted_status_timestamp","expanded_urls"

metadata

@@ -0,0 +1,246 @@
+--- !ruby/object:Gem::Specification
+name: i_delete_my_tweets
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+platform: ruby
+authors:
+- "'Fabio"
+- Mont
+- Alegre'
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2022-05-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 6.1.5.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 6.1.5.1
+- !ruby/object:Gem::Dependency
+  name: csv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.9
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.7.6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.7.6
+- !ruby/object:Gem::Dependency
+  name: oauth
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: terminal-table
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.2
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+- !ruby/object:Gem::Dependency
+  name: twitter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 7.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 7.0.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.29'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.29'
+- !ruby/object:Gem::Dependency
+  name: rubocop-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.13.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.13.3
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.10.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.10.0
+- !ruby/object:Gem::Dependency
+  name: semver2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.4.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.4.2
+description: |
+  A CLI (as in Command Line Interface) to delete your tweets based on faves, RTs, and time.
+
+  There are some services out there with a friendly web interface, but this is not one of them. You must know the basics of working with a UNIX terminal and configuring a Twitter API app, as this will only work if you have a Twitter Developer account.
+
+  Due to the irrevocable nature of tweet deletion, all delete commands are dry-run true, meaning you must call all of them with a --dry-run=false flag if you want them to really do something.
+
+  Called with --dry-run=false, there is no way to revoke tweet deletion. They are just gone, disappeared into the ether (or the stashed in the Twitter-owned secret place you have no access to without a mandate since nothing gets really deleted from the web these days, folks).
+
+  This tool won't delete all of your tweets in one fell swoop; it is more of a way to delete your old tweets from time to time. The Twitter API rate limits are relatively complicated, and I don't even wanna go there, but if you do intend on deleting all of your tweets, you can do it with this CLI and some perseverance. I did delete more than 100k of mine by using this script every day for a couple of weeks. The more tweets you delete, the fewer of them you have, and with time the rate limits won't be that much of a problem.
+
+  I Delete My Tweets (IDMT) can delete your tweets by fetching them via API using an APP you will have to set up yourself. Still, it can also delete tweets from an CSV (comma-separated file) that you can generate from the archive you can request from twitter.com by going to Settings and privacy > Your Account > Download an archive of your data. It is out of the scope of this CLI to generate the CSV (at the moment) but there are scripts out there that can do this for you.
+email:
+- spiceee@gmail.com
+executables:
+- i_delete_my_tweets
+extensions: []
+extra_rdoc_files: []
+files:
+- ".env.sample"
+- ".env.test"
+- README.md
+- bin/i_delete_my_tweets
+- i_delete_my_tweets.gemspec
+- lib/i_delete_my_tweets.rb
+- lib/i_delete_my_tweets/api.rb
+- lib/i_delete_my_tweets/ascii.rb
+- lib/i_delete_my_tweets/auth.rb
+- lib/i_delete_my_tweets/cli.rb
+- lib/i_delete_my_tweets/config.rb
+- lib/i_delete_my_tweets/presenter.rb
+- lib/i_delete_my_tweets/version.rb
+- tweets.csv
+homepage: https://github.com/spiceee/i_delete_my_tweets
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.5
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.3.5
+requirements: []
+rubygems_version: 3.3.13
+signing_key:
+specification_version: 4
+summary: A CLI to delete your tweets based on faves, RTs, and time.
+test_files: []