hltv-async-api 0.4.1__tar.gz → 0.4.2__tar.gz

hltv_async_api-0.4.2/PKG-INFO

@@ -0,0 +1,288 @@
+Metadata-Version: 2.1
+Name: hltv_async_api
+Version: 0.4.2
+Summary: Hltv-aio An unofficial asynchronous HLTV API Wrapper for Python
+Home-page: https://github.com/akimerslys/aiohltv
+Author: akimerslys
+Author-email: Akim Slys <akimslys2003@gmail.com>
+Project-URL: Homepage, https://github.com/akimerslys/aiohltv
+Project-URL: Issues, https://github.com/akimerslys/aiohltv/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# hltv-async-api an unofficial asynchronous HLTV API Wrapper for Python
+
+
+**This page not completed, not all methods and configs are written**
+
+
+# Features
+
+
+* **Simple Usage** (its realy simple)
+
+
+* **New and modern fully async library**
+
+
+* **Supports proxy usage with huge amount of options**
+
+
+---
+
+# Installation
+
+```
+pip install hltv-async-api
+```
+
+---
+
+
+# Simple Usage
+
+    ```
+    from hltv_async_api import Hltv
+    
+    hltv = Hltv()
+    live_matches = await hltv.get_live_matches()
+    ```
+
+---
+
+# Proxy Usage
+
+**Load Proxies from list**
+    
+    ```
+    proxy_list = ['http://120.234.203.171:9002', 'http://110.38.68.38:80']
+    
+    hltv = Hltv(use_proxy=True, proxy_list=proxy_list)
+    ```
+
+**Load Proxies from file**
+
+    ```
+    hltv = Hltv(use_proxy=True, proxy_path='PATH_TO_PROXY.TXT')
+    ```
+
+
+**One-time proxy**
+    
+    ```
+    hltv = Hltv(use_proxy=True, proxy_path='PATH_TO_PROXY.TXT', proxy_one_time=True)
+    ```
+
+**Protocol usage**
+
+    ```
+    proxy_list = ['120.234.203.171:9002', '110.38.68.38:80']
+    
+    hltv = Hltv(use_proxy=True, proxy_list=proxy_list, proxy_protocol='http')
+    ```
+
+---
+# Methods
+
+* **get_upcoming_matches(days: int = 7, min_star_rating: int = 1)**
+
+    -days (the number of days into the future to fetch matches for)
+  
+    -min_star_rating (the minimum star rating for matches to include)
+  
+    ```
+    await hltv.get_upcoming_matches(1, 5)
+    
+    >>> ['date': '11-11', 'matches': [id: '1111', team1: 'Natus Vincere' | 'TBD', team2: 'FaZe' | 'TBD', time: '14:15', maps: '3', stars: 5, 'PGL CS2 Major Copenhagen 2024' | None]]```
+    
+    ```
+* **get_events(outgoing=True, future=True, max_events=10) -> [('id', 'title', 'startdate', 'enddate')]**
+
+    ```
+    await hltv.get_events(future=False)
+    
+    >>>{'id': '7437', 'name': 'IEM Chengdu 2024', 'start_date': '8-4', 'end_date': '14-4'}, {'id': '7757', 'name': 'BetBoom Dacha Belgrade 2024 Europe Closed Qualifier', 'start_date': '2-4', 'end_date': '12-4'}]
+    
+    ```
+
+* **get_event_results(event_id: int | str)**
+
+  
+    ```
+    await get_event_results(7148)
+    
+    >>> ['date': '31-3', 'matches': ['id': '1111', team1': 'FaZe', 'team2': 'Natus Vincere', 'score1': '1', 'score2': '2']]
+    
+    ```
+
+* **get_event_matches(event_id: str | int):**
+  
+    ```
+    await hltv.get_event_matches(7148)
+    
+    >>>[{'date': 'LIVE', 'matches': [{'id': '2371135', 'team1': 'GUN5', 'team2': 'KOI', 't1_id': '12471', 't2_id': '12591'}]}, {'date': '2024-04-08', 'matches': [{'id': '2371131', 'time': '20:00', 'team1': 'Aurora', 'team2': 'Metizport', 't1_id': '11861', 't2_id': '11641'}]}]
+    ```
+
+* **get_event_info(event_id: str | int, event_title: str) -> (event_id, event_title, event_start, event_end, prize, team_num, location, groups)**
+
+    ```
+    await hltv.get_event_info(7148, 'PGL CS2 Major Copenhagen2024')
+    
+    (7148, 'PGL CS2 Major Copenhagen2024', '21-3', '31-3', '$1,250,000', '16', 'Copenhagen, Denmark', [])
+    ```
+
+
+* **get_top_teams(max_teams=30) -> ['rank', 'title', 'points', 'change', 'id']**
+
+    ```
+    await hltv.get_top_teams(2)
+    
+    >>>[{'id': '1111', 'rank': '1', 'title': 'FaZe', 'points': '939', 'change': '-', 'id': '6667'}, {'id': '1111', 'rank': '2', 'title': 'Natus Vincere', 'points': '757', 'change': '+4', 'id': '4608'}]
+    ```
+
+* **get_team_info(team_id: int | str, title: str) -> (team_id, team_title, rank, [players], coach, average_age, weeks_in_top_20, last_trophy, total_trophys)**
+
+    ```
+    await hltv.get_team_info(6667, 'faze')
+    
+    >>>(6667, 'faze', '1', ['karrigan', 'rain', 'frozen', 'ropz', 'broky'], 'NEO', '26.5', '256', 'CS Asia Championships 2023', 21)
+    ```
+
+* **get_last_news(max_reg_news=2, only_today=True, only_featured=False) -> [date, [featured_id, featured_title, featured_desciption], [regular_id, reg_title, reg_time]]**
+
+    ```
+    await hltv.get_last_news(only_today=True, max_reg_news=1)
+    
+    >>>[{'date': '02-04', 'f_news': [{'f_id': '38682', 'f_title': 'NIP confirm r1nkle signing', 'f_desc': "Ninjas in Pyjamas only have an anchor player left to sign following the young Ukrainian AWPer's addition."}], 'news': [{'id': '38685', 'title': 'Rounds add sLowi, p3kko', 'posted': 'an hour ago'}, {'id': '38690', 'title': 'n1ssim returns to Sharks after paiN loan deal expires', 'posted': 'an hour ago'}]}]
+    ```
+
+* **get_best_players(top=40) -> ('rank', 'name', 'team', 'maps', 'rating')**
+
+    ```
+    await hltv.get_best_players(2)
+    
+    >>>[{'rank': 1, 'name': 'donk', 'team': 'Spirit', 'maps': '33', 'rating': '1.52'}, {'rank': 2, 'name': 'm0NESY', 'team': 'G2', 'maps': '34', 'rating': '1.38'}]
+    ```
+
+---
+# Configs
+
+* max_delay: int = 15
+
+    We automaticly increasing reconnecting delay by 1 sec to max_delay (from 1s to 5s)
+
+    ```
+    hltv = Hltv(max_delay=5, use_proxy=False)
+    
+    >>>Fetching https://www.hltv.org/matches/2370727/faze-vs-natus-vincere-pgl-cs2-major-copenhagen-2024, code: 403
+    >>>Got 403 forbitten
+    >>>Calling again, increasing delay to 4s
+    >>>Fetching https://www.hltv.org/matches/2370727/faze-vs-natus-vincere-pgl-cs2-major-copenhagen-2024, code: 403
+    >>>Got 403 forbitten
+    >>>Calling again, increasing delay to 5s
+    ```
+
+* max_retries: int = 0
+
+    Max retries. 0 or -1 for infinity tries.
+    
+    ```
+    hltv = Hltv(max_retries=2, debug=True)
+    print(await hltv.get_best_players())
+    
+    Creating Session
+    Trying connect to https://www.hltv.org/stats/players?startDate=2024-01-01&endDate=2024-12-31&rankingFilter=Top20, try 1/2
+    Trying connect to https://www.hltv.org/stats/players?startDate=2024-01-01&endDate=2024-12-31&rankingFilter=Top20, try 2/2
+    Connection failed
+    ```
+
+* use_proxy: bool = False
+
+    Proxy Usage. No compatibility with max_delay (max_delay will be ignored)
+
+* proxy_list: list | None = None
+
+    list of your proxies, if your proxies doesnt have any protocol you can use proxy_protocol
+
+* proxy_path: str | None = None
+
+    Path to your proxy (proxy_list will be ignored). If your proxies doesnt have any protocol you can use proxy_protocol
+
+* proxy_protocol: str | None = None,
+
+    Proxy protocol. Your proxies ```hltv = Hltv(proxy_protocol='http' ...) -> '11.11.11.11:1111' -> 'http://11.11.11.11:1111'
+
+* proxy_one_time: bool = False
+
+    Removes proxy from list (proxy_path included) if connection unsuccessfull
+
+* timeout: int = 5
+
+    Max time to close connection. Recommended to use timeout=1 if you are using random proxies.
+
+* debug: bool = False
+
+    More loggs
+
+* true_session=False
+  
+    **(BETA)**
+    This parser automaticaly creating and clossing sessions after every use, if you want to let your session open even when parser is inactive
+    use this method. **!! IMPORTANT YOU SHOULD CLOSE YOUR SESSION BEFORE KILLING PROGRAM**
+
+    ```
+    async def test():
+        hltv = Hltv(true_session=True)
+        print(await hltv.get_best_players())
+        print(await hltv.get_upcoming_matches())
+        await hltv.close_session()
+
+    if __name__ == "__main__":
+        asyncio.run(test())
+    ```
+    
+---
+# Examples
+
+****Simple Example****
+
+```
+from hltv_async_api import Hltv
+
+
+async def test():
+
+    hltv = Hltv()
+    
+    print(await hltv.get_event_info(7148, 'pgl-cs2-major-copenhagen-2024'))
+
+if __name__ == "__main__":
+    asyncio.run(test())
+```
+
+****Proxy Parser****
+```
+from hltv_async_api import Hltv
+
+
+async def test():
+
+    hltv = Hltv(debug=True, use_proxy=True, proxy_path='proxy_test.txt', timeout=1, proxy_one_time=True, proxy_protocol='http')
+    
+    print(await hltv.get_event_info(7148, 'pgl-cs2-major-copenhagen-2024'))
+
+if __name__ == "__main__":
+    asyncio.run(test())
+```
+
+
+# Requirements:
+
+Python 3.9+
+
+License:
+HLTV Async is licensed under the MIT License, allowing for personal and commercial use with minimal restrictions.

hltv_async_api-0.4.2/README.md

@@ -0,0 +1,272 @@
+# hltv-async-api an unofficial asynchronous HLTV API Wrapper for Python
+
+
+**This page not completed, not all methods and configs are written**
+
+
+# Features
+
+
+* **Simple Usage** (its realy simple)
+
+
+* **New and modern fully async library**
+
+
+* **Supports proxy usage with huge amount of options**
+
+
+---
+
+# Installation
+
+```
+pip install hltv-async-api
+```
+
+---
+
+
+# Simple Usage
+
+    ```
+    from hltv_async_api import Hltv
+    
+    hltv = Hltv()
+    live_matches = await hltv.get_live_matches()
+    ```
+
+---
+
+# Proxy Usage
+
+**Load Proxies from list**
+    
+    ```
+    proxy_list = ['http://120.234.203.171:9002', 'http://110.38.68.38:80']
+    
+    hltv = Hltv(use_proxy=True, proxy_list=proxy_list)
+    ```
+
+**Load Proxies from file**
+
+    ```
+    hltv = Hltv(use_proxy=True, proxy_path='PATH_TO_PROXY.TXT')
+    ```
+
+
+**One-time proxy**
+    
+    ```
+    hltv = Hltv(use_proxy=True, proxy_path='PATH_TO_PROXY.TXT', proxy_one_time=True)
+    ```
+
+**Protocol usage**
+
+    ```
+    proxy_list = ['120.234.203.171:9002', '110.38.68.38:80']
+    
+    hltv = Hltv(use_proxy=True, proxy_list=proxy_list, proxy_protocol='http')
+    ```
+
+---
+# Methods
+
+* **get_upcoming_matches(days: int = 7, min_star_rating: int = 1)**
+
+    -days (the number of days into the future to fetch matches for)
+  
+    -min_star_rating (the minimum star rating for matches to include)
+  
+    ```
+    await hltv.get_upcoming_matches(1, 5)
+    
+    >>> ['date': '11-11', 'matches': [id: '1111', team1: 'Natus Vincere' | 'TBD', team2: 'FaZe' | 'TBD', time: '14:15', maps: '3', stars: 5, 'PGL CS2 Major Copenhagen 2024' | None]]```
+    
+    ```
+* **get_events(outgoing=True, future=True, max_events=10) -> [('id', 'title', 'startdate', 'enddate')]**
+
+    ```
+    await hltv.get_events(future=False)
+    
+    >>>{'id': '7437', 'name': 'IEM Chengdu 2024', 'start_date': '8-4', 'end_date': '14-4'}, {'id': '7757', 'name': 'BetBoom Dacha Belgrade 2024 Europe Closed Qualifier', 'start_date': '2-4', 'end_date': '12-4'}]
+    
+    ```
+
+* **get_event_results(event_id: int | str)**
+
+  
+    ```
+    await get_event_results(7148)
+    
+    >>> ['date': '31-3', 'matches': ['id': '1111', team1': 'FaZe', 'team2': 'Natus Vincere', 'score1': '1', 'score2': '2']]
+    
+    ```
+
+* **get_event_matches(event_id: str | int):**
+  
+    ```
+    await hltv.get_event_matches(7148)
+    
+    >>>[{'date': 'LIVE', 'matches': [{'id': '2371135', 'team1': 'GUN5', 'team2': 'KOI', 't1_id': '12471', 't2_id': '12591'}]}, {'date': '2024-04-08', 'matches': [{'id': '2371131', 'time': '20:00', 'team1': 'Aurora', 'team2': 'Metizport', 't1_id': '11861', 't2_id': '11641'}]}]
+    ```
+
+* **get_event_info(event_id: str | int, event_title: str) -> (event_id, event_title, event_start, event_end, prize, team_num, location, groups)**
+
+    ```
+    await hltv.get_event_info(7148, 'PGL CS2 Major Copenhagen2024')
+    
+    (7148, 'PGL CS2 Major Copenhagen2024', '21-3', '31-3', '$1,250,000', '16', 'Copenhagen, Denmark', [])
+    ```
+
+
+* **get_top_teams(max_teams=30) -> ['rank', 'title', 'points', 'change', 'id']**
+
+    ```
+    await hltv.get_top_teams(2)
+    
+    >>>[{'id': '1111', 'rank': '1', 'title': 'FaZe', 'points': '939', 'change': '-', 'id': '6667'}, {'id': '1111', 'rank': '2', 'title': 'Natus Vincere', 'points': '757', 'change': '+4', 'id': '4608'}]
+    ```
+
+* **get_team_info(team_id: int | str, title: str) -> (team_id, team_title, rank, [players], coach, average_age, weeks_in_top_20, last_trophy, total_trophys)**
+
+    ```
+    await hltv.get_team_info(6667, 'faze')
+    
+    >>>(6667, 'faze', '1', ['karrigan', 'rain', 'frozen', 'ropz', 'broky'], 'NEO', '26.5', '256', 'CS Asia Championships 2023', 21)
+    ```
+
+* **get_last_news(max_reg_news=2, only_today=True, only_featured=False) -> [date, [featured_id, featured_title, featured_desciption], [regular_id, reg_title, reg_time]]**
+
+    ```
+    await hltv.get_last_news(only_today=True, max_reg_news=1)
+    
+    >>>[{'date': '02-04', 'f_news': [{'f_id': '38682', 'f_title': 'NIP confirm r1nkle signing', 'f_desc': "Ninjas in Pyjamas only have an anchor player left to sign following the young Ukrainian AWPer's addition."}], 'news': [{'id': '38685', 'title': 'Rounds add sLowi, p3kko', 'posted': 'an hour ago'}, {'id': '38690', 'title': 'n1ssim returns to Sharks after paiN loan deal expires', 'posted': 'an hour ago'}]}]
+    ```
+
+* **get_best_players(top=40) -> ('rank', 'name', 'team', 'maps', 'rating')**
+
+    ```
+    await hltv.get_best_players(2)
+    
+    >>>[{'rank': 1, 'name': 'donk', 'team': 'Spirit', 'maps': '33', 'rating': '1.52'}, {'rank': 2, 'name': 'm0NESY', 'team': 'G2', 'maps': '34', 'rating': '1.38'}]
+    ```
+
+---
+# Configs
+
+* max_delay: int = 15
+
+    We automaticly increasing reconnecting delay by 1 sec to max_delay (from 1s to 5s)
+
+    ```
+    hltv = Hltv(max_delay=5, use_proxy=False)
+    
+    >>>Fetching https://www.hltv.org/matches/2370727/faze-vs-natus-vincere-pgl-cs2-major-copenhagen-2024, code: 403
+    >>>Got 403 forbitten
+    >>>Calling again, increasing delay to 4s
+    >>>Fetching https://www.hltv.org/matches/2370727/faze-vs-natus-vincere-pgl-cs2-major-copenhagen-2024, code: 403
+    >>>Got 403 forbitten
+    >>>Calling again, increasing delay to 5s
+    ```
+
+* max_retries: int = 0
+
+    Max retries. 0 or -1 for infinity tries.
+    
+    ```
+    hltv = Hltv(max_retries=2, debug=True)
+    print(await hltv.get_best_players())
+    
+    Creating Session
+    Trying connect to https://www.hltv.org/stats/players?startDate=2024-01-01&endDate=2024-12-31&rankingFilter=Top20, try 1/2
+    Trying connect to https://www.hltv.org/stats/players?startDate=2024-01-01&endDate=2024-12-31&rankingFilter=Top20, try 2/2
+    Connection failed
+    ```
+
+* use_proxy: bool = False
+
+    Proxy Usage. No compatibility with max_delay (max_delay will be ignored)
+
+* proxy_list: list | None = None
+
+    list of your proxies, if your proxies doesnt have any protocol you can use proxy_protocol
+
+* proxy_path: str | None = None
+
+    Path to your proxy (proxy_list will be ignored). If your proxies doesnt have any protocol you can use proxy_protocol
+
+* proxy_protocol: str | None = None,
+
+    Proxy protocol. Your proxies ```hltv = Hltv(proxy_protocol='http' ...) -> '11.11.11.11:1111' -> 'http://11.11.11.11:1111'
+
+* proxy_one_time: bool = False
+
+    Removes proxy from list (proxy_path included) if connection unsuccessfull
+
+* timeout: int = 5
+
+    Max time to close connection. Recommended to use timeout=1 if you are using random proxies.
+
+* debug: bool = False
+
+    More loggs
+
+* true_session=False
+  
+    **(BETA)**
+    This parser automaticaly creating and clossing sessions after every use, if you want to let your session open even when parser is inactive
+    use this method. **!! IMPORTANT YOU SHOULD CLOSE YOUR SESSION BEFORE KILLING PROGRAM**
+
+    ```
+    async def test():
+        hltv = Hltv(true_session=True)
+        print(await hltv.get_best_players())
+        print(await hltv.get_upcoming_matches())
+        await hltv.close_session()
+
+    if __name__ == "__main__":
+        asyncio.run(test())
+    ```
+    
+---
+# Examples
+
+****Simple Example****
+
+```
+from hltv_async_api import Hltv
+
+
+async def test():
+
+    hltv = Hltv()
+    
+    print(await hltv.get_event_info(7148, 'pgl-cs2-major-copenhagen-2024'))
+
+if __name__ == "__main__":
+    asyncio.run(test())
+```
+
+****Proxy Parser****
+```
+from hltv_async_api import Hltv
+
+
+async def test():
+
+    hltv = Hltv(debug=True, use_proxy=True, proxy_path='proxy_test.txt', timeout=1, proxy_one_time=True, proxy_protocol='http')
+    
+    print(await hltv.get_event_info(7148, 'pgl-cs2-major-copenhagen-2024'))
+
+if __name__ == "__main__":
+    asyncio.run(test())
+```
+
+
+# Requirements:
+
+Python 3.9+
+
+License:
+HLTV Async is licensed under the MIT License, allowing for personal and commercial use with minimal restrictions.

{hltv_async_api-0.4.1 → hltv_async_api-0.4.2}/hltv_async_api/__init__.py

@@ -6,4 +6,4 @@
 from .aiohltv import Hltv
 
 __author__ = 'akimerslys'
-__version__ = '0.4.1'
+__version__ = '0.4.2'