Metadata-Version: 2.1
Name: pysmashgg
Version: 0.2.1
Summary: Python Wrapper for smash.gg's GraphQL API
Home-page: https://github.com/JeremySkalla/SmashGGPythonWrapper
Author: Jeremy Skalla
Author-email: jthroughs@gmail.com
License: UNKNOWN
Description: # SmashGGPy: Python Wrapper for Smash.gg's GraphQL API
        
        ![GitHub last commit](https://img.shields.io/github/last-commit/JeremySkalla/pysmashgg)
        ![PyPI](https://img.shields.io/pypi/v/pysmashgg)
        ![GitHub](https://img.shields.io/github/license/JeremySkalla/pysmashgg)
        
        ## Overview
        
        #### SmashGGPy is a simple wrapper for [smash.gg](https://smash.gg)'s new GraphQL API that takes inspiration from [Petercat12's PySmash](https://github.com/PeterCat12/pysmash), but using the GraphQL API instead of the older, slower one
        
        #### Currently in Beta -- v0.2.1 right now! Will be adding features that weren't in PySmash (the inspiration, as stated above) -- See CHANGELOG.md for the most recent changes
        
        ## How to install current version
        
        - `pip install pysmashgg`
        
        - PyPI Page: [https://pypi.org/project/pysmashgg/](https://pypi.org/project/pysmashgg/)
        
        ## Required packages
        
        - Requests - `pip install requests`
        
        ## Motivation
        
        I decided to make this project because I started working with smash.gg's API not too long ago, and I didn't have any experience using APIs or anything, and I found PySmash. It's using the older API, and its functionality is now limited. Version 1.0 of SmashGGPy has the same commands as PySmash with slightly different responses (but mostly the same) using the updated API. In the future, I am looking to add more commands.
        
        However, I would like to say I think the best thing to do with this project if you're looking to interact with the API a lot is learn how the code works, learn how to interact with a GraphQL API, and send your own requests! I hope that this code can be of help to those who want to develop much larger applications but don't know where to start! Of course, this is going to be helpful but limited compared to the entire scope of the API, but should be very helpful nonetheless, especially in terms of getting a bunch of data.
        
        ## Metadata Usage
        
        ```
        import SmashGGPy
        
        # Initialize the SmashGGPy class
        smash = pysmashgg.SmashGG('KEY')
        
        # All results will be returned as normal Python dictionaries
        
        # Show meta information for a tournament
        tournament = smash.tournament_show("smash-summit-10-online")
        print(tournament)
        
        # Show meta information for a tournament with bracket id for an event
        tournament_with_bracket = smash.tournament_show_with_brackets("smash-summit-10-online", "melee-singles")
        print(tournament_with_bracket)
        
        # Show meta information for a tournament with bracket id for all events
        tournament_with_all_brackets = tournament_show_with_brackets_all('smash-summit-10-online')
        print(tournament_with_all_brackets)
        ```
        
        ## Convenience Usage
        
        ```
        import SmashGGPy
        # Initialize the SmashGGPy class
        smash = pysmashgg.SmashGG('KEY')
        
        # All results will be returned as normal Python dictionaries
        
        # Show only a list of events for a tournament (excludes meta data info)
        events = smash.tournament_show_events('smash-summit-10-online')
        print(events)
        
        # Shows a complete list of sets given tournament and event names
        # NOTE: sleep_time is the third arg, but don't touch it unless you
        # you know what you're doing (it is there to make sure you don't get Status Code 429)
        # If you do get Status Code 429, change sleep_time to 30 or so for large tournaments
        sets = smash.tournament_show_sets('smash-summit-10-online', 'melee-singles')
        print(sets) # note: result might be VERY large for larger tournaments.
        
        # Shows a complete list of entrants given tournament and event names
        # NOTE: sleep_time is the third arg, but don't touch it unless you
        # you know what you're doing (it is there to make sure you don't get code 429)
        # If you do get Status Code 429, change sleep_time to 30 or so for large tournaments
        entrants = smash.tournament_show_entrants('smash-summit-10-online', 'melee-singles')
        print(players)
        
        # Shows a complete list of bracket ids given tournament and event names
        brackets = smash.tournament_show_event_brackets('smash-summit-10', 'melee-singles')
        print(brackets)
        
        # Shows a complete list of bracket ids for a givern tournament and all events
        brackets = tournament_show_all_event_brackets('smash-summit-10-online')
        
        # Shows entrant info and a list of every set that entrant competed in given tournament and event names
        player_sets = smash.tournament_show_entrant_sets('smash-summit-10-online', 'melee-singles', 'Mang0')
        print(player_sets)
        
        #Show sets between two players for a given tournament and event name
        player_head_to_head = smash.tournament_show_head_to_head('smash-summit-10-online', 'melee-singles', 'Mang0', 'Zain')
        print(player_head_to_head)
        ```
        
        ## Bracket Usage
        
        ```
        import SmashGGPy
        # Initialize the SmashGGPy class
        smash = pysmashgg.SmashGG('KEY')
        
        # These bracket IDs are found from the tournament_show_event_brackets command, as well as others
        
        # Shows players in a certain bracket
        # NOTE: sleep_time is the second arg, but don't touch it unless you
        # you know what you're doing (it is there to make sure you don't get code 429)
        # If you do get Status Code 429, change sleep_time to 30 or so for large tournaments
        bracket_players = smash.bracket_show_entrants(224997)
        print(bracket_players)
        
        # Shows sets from a bracket
        # NOTE: sleep_time is the second arg, but don't touch it unless you
        # you know what you're doing (it is there to make sure you don't get code 429)
        # If you do get Status Code 429, change sleep_time to 30 or so for large tournaments
        sets = self.smash.bracket_show_sets(1401911)
        print(sets)
        ```
        
        ## API Documentation
        
        #### [Intro](https://developer.smash.gg/docs/intro/)
        
        #### [References](https://developer.smash.gg/reference/)
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.9
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
