Metadata-Version: 2.1
Name: osometweet
Version: 0.2
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
Platform: UNKNOWN
Requires-Python: >=3.5
Description-Content-Type: text/markdown
Requires-Dist: requests (>=2.24.0)
Requires-Dist: requests-oauthlib (>=1.3.0)

[![PyPI version](https://badge.fury.io/py/osometweet.svg)](https://badge.fury.io/py/osometweet)

# 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'}
]
```

For detailed instructions, check out our [wiki](https://github.com/osome-iu/osometweet/wiki).


