Metadata-Version: 2.1
Name: osometweet
Version: 0.3
Summary: OSoMe Twitter library for academic researchers
Home-page: https://github.com/truthy/osometweet
Author: Matthew DeVerna, Christopher Torres-Lugo, Kaicheng Yang
Author-email: mdeverna@iu.edu, torresch@indiana.edu, yangkc@iu.edu
License: MIT
Download-URL: https://pypi.org/project/osometweet/
Project-URL: Documentation, https://github.com/truthy/osometweet
Project-URL: Issue Tracker, https://github.com/truthy/osometweet/issues
Project-URL: Source Code, https://github.com/truthy/osometweet
Description: [![PyPI version](https://badge.fury.io/py/osometweet.svg)](https://badge.fury.io/py/osometweet)
        [![v2](https://img.shields.io/endpoint?url=https%3A%2F%2Ftwbadges.glitch.me%2Fbadges%2Fv2)](https://developer.twitter.com/en/docs/twitter-api)
        
        # Introduction
        
        The OSoMeTweet project intends to provide a set of tools to help researchers work with the V2 API of Twitter.
        The Wiki will work as an unofficial archive of knowledge people gather through the process.
        
        
        # Installation
        ## Install the PyPI version
        ```bash
        pip install osometweet
        ```
        
        **Warning 1**: the package is still in development, so the functionalities are very limited and the robustness is low.
        
        **Warning 2**: we will try to keep the interface of the package consistent, but there maybe drastic changes in the future.
        
        ## Use the newest features & local development
        
        The PyPI version is behind the GitHub version.
        To take advantage of the newest features and functionalities, you can install the GitHub version locally.
        
        To do so, clone this project, go to the source directory, type the following command to install the package locally:
        
        ```bash
        pip install -e .
        ```
        
        ## Requirements
        
        ```bash
        python>=3.5
        requests>=2.24.0
        requests_oauthlib>=1.3.0
        ```
        
        ## Tests
        
        Go to `tests` directory and run:
        
        ```bash
        python tests.py
        ```
        
        # How to seek helps and contribute
        
        OSoMeTweet will be a community project. **If you encounter bugs, please create [Issues](https://github.com/truthy/osometweet/issues)**. If you want to contribute to the project, you are welcome to create [Pull Requests](https://github.com/truthy/osometweet/pulls).
        
        # Quick start
        
        Here is an example of how to use our package to pull user information: 
        ```python
        import osometweet
        
        # Initialize the OSoMeTweet object
        bearer_token = "YOUR_TWITTER_BEARER_TOKEN"
        oauth2 = osometweet.OAuth2(bearer_token=bearer_token)
        ot = osometweet.OsomeTweet(oauth2)
        
        # Set some test IDs (these are Twitter's own accounts)
        ids2find = ["2244994945", "6253282"]
        
        # Call the function without these ids
        response = ot.user_lookup_ids(user_ids=ids2find)
        print(response["data"])
        ```
        which returns a list of dictionaries, where each dictionary contains the requested information for an individual user.
        ```python
        [
            {'id': '2244994945', 'name': 'Twitter Dev', 'username': 'TwitterDev'},
            {'id': '6253282', 'name': 'Twitter API', 'username': 'TwitterAPI'}
        ]
        ```
        
        We offer [examples](examples) for working with different endpoints.
        
        For detailed instructions, check out our [wiki](https://github.com/osome-iu/osometweet/wiki).
        
Platform: UNKNOWN
Requires-Python: >=3.5
Description-Content-Type: text/markdown
