Package: twitter-list-mgmt
About the repotwitter_list_mgmtis a python package that makes it easier to add users to your twitter list from other lists.Say you've created a covid twitter list to keep track of news around the pandemic. You've just found another list on covid curated by an epidemiologist in London, and you want to add members from that to your own Covid list. This is the package you use for it.Now for most basic operations like retrieving the current membership of a Twitter list, adding users to it, removing them etc. theTweepylibrary is good enough.twitter_list_mgmtjust adds extra functionality on top of Tweepy to make working with lists easier.This package will help heavy twitter and tweetdeck users, especially those who use lists to manage the firehose of information from social media.List of functionsHere's what you can do with thetwitter_list_mgmtpackage:Main functionsAdd members to your list from another listAdd members to your list from multiple listsRemove members from your list who are in another listRemove members from your list who are in any of multiple other listsCreate a new list that combines members from multiple listsCreate a new list that has members common to multiple listsCreate a new list with members from a list, who aren't in any of multiple other listsOther functionsGet the list id from a list urlGet all the user ids of list membersAdd user ids to a listRemove user ids from a listCreate a pandas dataframe from a listHow to install the package and set things upVersions of Tweepy >= 4.0.0a0 are required for this package to work. At the time of writing, 4.0.0 isn't available inpypi. Install it from the terminal by doingpip install git+https://github.com/tweepy/tweepy.gitThen install the main package by going to the terminal and typingpip install twitter_list_mgmtIn terms of setting up, you'll have tocreateauthentication credentials for yourself. (Thisarticlefrom Realpython has a how-to on it.) Four text strings will be generated -- Consumer Key, Consumer Secret, Access Token and Access Token Secret. Create a file named 'config_twitter.ini', use the format below and paste in the credentials. You can also download a sample filehere. Place the config in the same directory and on the same level as your script.[info]
CONSUMER_KEY = XXXXXX
CONSUMER_SECRET = XXXXXX
ACCESS_TOKEN = XXXXXX
ACCESS_TOKEN_SECRET = XXXXXXHow to use the packageImport the package into your code withimport twitter_list_mgmt as tlmThe package has7main functions:1.Add members to your list from another list— Here 'list1' and 'list2' are twitter list ids, with list1 being the one you own. (You can get the ids from the url for a list page. For example, in the urlhttps://twitter.com/i/lists/15299140, the list id is '15299140'.)tlm.add_to_list1_from_list2(list1, list2)2.Add members to your list from several other lists— 'multiple_lists' is a python list of twitter list ids. (To comply with Twitter's rate limits, only upto 1000 members can be added in a day.)tlm.add_to_list1_from_multiple_lists(list1, multiple_lists)3.Remove members from your list who are in another list— Let's say you have a twitter list on covid that's a mix of experts and journalists, and you want it to have experts only. Now you can remove many of the journalists from it manually, but you can also do it in an automated fashion by getting a list of science/health journalists. Using this function, if any of your list members are on that journalist list, they'll be removed. 'list1' here is your list id.tlm.remove_from_list1_based_on_list2(list1, list2)4.Remove members from your list who are in any of the other lists specified— 'list1' here is your list id and 'multiple_lists' is a python list of twitter list ids.tlm.remove_from_list1_based_on_multiple_lists(list1,multiple_lists)5.Create a new list that combines members from several lists— 'multiple_lists' is the python list containing the twitter list ids and 'list_name' is the name for the new list. (The Twitter list created is set as 'private' but can be made 'public' later.)tlm.create_list_union(multiple_lists,list_name)6.Create a new list that has members common to several lists— 'multiple_lists' is the python list containing the twitter list ids and 'list_name' is the name for the new list.tlm.create_list_intersection(multiple_lists,list_name)7.Create a new list with all the members from a list, who aren't in any of the other lists specified— 'list1' can be your own list or someone else's, 'multiple_lists' is a python list of twitter list ids and 'list_name' is the name for the new list.tlm.create_list_difference(list1,multiple_lists,list_name)Other things you can doThe functions that have been listed are the main ones. There are others too, but most people won't need them. Will go through some of those functions for coders who want to build something on top of them. (Go throughhelpers.pyto see how they've been defined.)These are some of the other functions:Get the list id from a list url— Extracts the list_id and returns it as a string.tlm.get_list_id_from_url(url)Get all the members of a list— The function returns a python list of their user ids. Tweepy has a similar functionget_list_membersbut that retrieves user objects. This function goes a step further by extracting the user ids within those objects.tlm.get_list_members_ids(list_idx)Add user ids to a list— 'ids' here is a python list of user ids and 'list1' is a twitter list id.tlm.add_ids_to_list(ids,list1)Remove user ids from a list— 'ids' here is a python list of user ids and 'list1' is a twitter list id.tlm.remove_ids_from_list(ids,list1)Create a pandas dataframe from a list— Here, each row is for a different member and each column an attribute like number of followers, number of tweets posted etc. This is for anyone who wants to analyze the membership of a list.tlm.create_df_from_list(list_idx)Suggestions, criticism etc.I'm not a professional developer/programmer/coder, so am sure there are things here I should be doing differently. If you have any suggestions, please contact me onmail@shijith.comor at my twitter handle@shijith.For example, I would be interested in hearing about my python application layout. Whether it could be simplified further, if I could be doing imports better etc.