Package: ressenter
RessenterRessenter is a command line tool to pull content from Dissenter.com, a browser-based social network operated by Gab.com. (We will not reward either of these domains with hyperlinks.)This tool does not require any authentication with Dissenter; all the data it pulls is available publicly.Currently, this tool can:Reliably pull all comments made on Dissenter within the last seven daysPull the current 'top' commentsPull the current 'controversial' commentsPull the current trending URLsPull all the comments for a particular URLPull all the comments made by a particular userRobustnessThis tool was made by reverse engineering Dissenter's API. (To be fair, it wasn't that hard.) Because we have no insight into Dissenter's internals, there's no guarantee that this tool provides an exhaustive or reliable archive of Dissenter content.For example, we don't know whether comments become inaccessible after some period of time, or whether there is a limit on how many comments we can pull from any particular user.UsageUsage: ressenter [OPTIONS] COMMAND [ARGS]...

Options:
  --format [jsonl|csv]  output format
  --help                Show this message and exit.

Commands:
  comments  Pull all the most recent comments
  trending  Pull the current trending URLs
  url       Pull comments for a particular URL.
  user      Pull all the comments of a particular userRessenter can output data tojsonlandcsv(the default isjsonl). Just pass the--formatoption before the subcommand (e.g.,ressenter --format=csv comments). All data is currently written tostdout; to save output to a file, use pipes (e.g.,ressenter comments > comments.jsonl).commentsUsage: ressenter comments [OPTIONS]

  Pull all the most recent comments

Options:
  --sort [latest|controversial|top]
                                  comment sort order
  --after-id TEXT                 pull no earlier than this comment ID
  --after-time TEXT               pull no comments posted earlier than this
                                  time

  --max INTEGER                   maximum number of comments to pull
  --help                          Show this message and exit.trendingUsage: ressenter trending [OPTIONS]

  Pull the current trending URLs

Options:
  --help  Show this message and exit.urlUsage: ressenter url [OPTIONS] URL

  Pull comments for a particular URL. Note that several comment metadata
  items (such as upvotes, downvotes, and comments) are not available when
  pulling comments from a URL.

Options:
  --sort [latest|controversial|top]
                                  comment sort order
  --after-id TEXT                 pull no earlier than this comment ID
  --after-time TEXT               pull no comments posted earlier than this
                                  time

  --max INTEGER                   maximum number of comments to pull
  --help                          Show this message and exit.userUsage: ressenter user [OPTIONS] USER

  Pull all the comments of a particular user, identified by their UID

Options:
  --sort [latest|controversial|top]
                                  comment sort order
  --after-id TEXT                 pull no earlier than this comment ID
  --after-time TEXT               pull no comments posted earlier than this
                                  time

  --max INTEGER                   maximum number of comments to pull
  --help                          Show this message and exit.PlaybookHere are some common use cases:Pull all the most recent commentsressentercommentsPull all the recent top commentsressentercomments--sort=topPull all the recent controversial commentsressentercomments--sort=controversialPull all comments made in the past hourressentercomments--after-time"one hour ago"Pull all the current trending URLsressentertrendingPull all of the comments for a particular URLressenterurlhttps://www.facebook.comModule UsageTo use Ressenter as a Python module, just import it and setup a listener—a function that will be called on every result. You may also want to disable the standard output. For example:importressenterresults=[]ressenter.disable_standard_output()ressenter.result_listeners.append(results.append)ressenter.result_listeners.append(lambdak:print(f"Output:{k}"))ressenter.comments()print(f"Found{len(results)}results!")All the commands are imported at the top-level namespace (e.g.,ressenter.comments,ressenter.trending,ressenter.url,ressenter.user) and support the same arguments as their command-line equivalents. Consult the source code and the command-level docs for more information about the specific parameters supported.DevelopmentTo run Ressenter locally, perform the following steps:Install dependencies withpipenv installActivate the virtual environment withpipenv shellRun the tool usingmain.py-- for example,./main.py commentsPackaging and PublishingMake sure you have access to PyPI credentials with permission for theressenterrepository.Clear thedist/folder (rm dist/*).Package everything withpython setup.py sdist bdist_wheel.Check the packaging withtwine check dist/*.Upload withtwine upload dist/*.TroubleshootingIf you work at the Stanford Internet Observatory, ping Miles McCain on Slack or via email to get help with Ressenter. To report bugs or submit feature requests, please open an issue.Desired FeaturesThere are a few features that this tool currently lacks, but that we'd like to add. We haven't yet found reliable ways to extract this data. (If you have, please let us know!)Find the most recent URLs commented onIterate through all the URLs with commentsIterate through all comments, instead of just those made in the past seven days