vlrdevapi 1.0.0__py3-none-any.whl

vlrdevapi/__init__.py

@@ -0,0 +1,68 @@
+"""
+VLR Dev API - Python client for Valorant esports data from VLR.gg
+
+Clean, intuitive API with better naming conventions and full type safety.
+
+Example usage:
+    >>> import vlrdevapi as vlr
+    >>> 
+    >>> # Get upcoming matches
+    >>> matches = vlr.matches.upcoming(limit=10)
+    >>> for match in matches:
+    ...     print(f"{match.teams[0]} vs {match.teams[1]}")
+    >>> 
+    >>> # Get player profile
+    >>> profile = vlr.players.profile(player_id=123)
+    >>> print(f"{profile.handle} from {profile.country}")
+    >>> 
+    >>> # Get series info
+    >>> info = vlr.series.info(match_id=456)
+    >>> print(f"{info.teams[0].name} vs {info.teams[1].name}")
+"""
+
+__version__ = "1.0.0"
+
+# Import modules for clean API access
+from . import matches
+from . import events
+from . import players
+from . import series
+from . import status
+
+# Import exceptions for error handling
+from .exceptions import (
+    VlrdevapiError,
+    NetworkError,
+    ScrapingError,
+    DataNotFoundError,
+    RateLimitError,
+)
+
+# Import status function for convenience
+from .status import check_status
+
+__all__ = [
+    # Modules - these are the main API entry points
+    "matches",
+    "events",
+    "players",
+    "series",
+    "status",
+    
+    # Exceptions for error handling
+    "VlrdevapiError",
+    "NetworkError",
+    "ScrapingError",
+    "DataNotFoundError",
+    "RateLimitError",
+    
+    # Convenience function
+    "check_status",
+]
+
+# Note: Models are NOT exported at the top level to prevent confusion.
+# Access them through their modules:
+#   - vlr.matches.upcoming() returns Match objects
+#   - vlr.players.profile() returns Profile objects
+#   - vlr.events.info() returns Info objects
+#   - etc.

vlrdevapi/constants.py

@@ -0,0 +1,7 @@
+"""Constants used throughout the library."""
+
+VLR_BASE = "https://www.vlr.gg"
+DEFAULT_TIMEOUT = 5.0
+DEFAULT_USER_AGENT = "Mozilla/5.0 (vlrdevapi)"
+MAX_RETRIES = 3
+BACKOFF_FACTOR = 1.0

vlrdevapi/countries.py

@@ -0,0 +1,199 @@
+"""Country code mapping utilities."""
+
+from typing import Optional
+
+COUNTRY_MAP = {
+    "ad": "Andorra",
+    "ae": "United Arab Emirates",
+    "af": "Afghanistan",
+    "al": "Albania",
+    "am": "Armenia",
+    "an": "Netherlands Antilles",
+    "ao": "Angola",
+    "ar": "Argentina",
+    "at": "Austria",
+    "au": "Australia",
+    "aw": "Aruba",
+    "az": "Azerbaijan",
+    "ba": "Bosnia and Herzegovina",
+    "bb": "Barbados",
+    "bd": "Bangladesh",
+    "be": "Belgium",
+    "bf": "Burkina Faso",
+    "bg": "Bulgaria",
+    "bh": "Bahrain",
+    "bi": "Burundi",
+    "bj": "Benin",
+    "bm": "Bermuda",
+    "bn": "Brunei",
+    "bo": "Bolivia",
+    "br": "Brazil",
+    "bs": "Bahamas",
+    "bt": "Bhutan",
+    "bw": "Botswana",
+    "by": "Belarus",
+    "bz": "Belize",
+    "ca": "Canada",
+    "cf": "Central African Republic",
+    "cg": "Republic of the Congo",
+    "ch": "Switzerland",
+    "ck": "Cook Islands",
+    "cl": "Chile",
+    "cm": "Cameroon",
+    "cn": "China",
+    "co": "Colombia",
+    "cr": "Costa Rica",
+    "cu": "Cuba",
+    "cv": "Cape Verde",
+    "cy": "Cyprus",
+    "cz": "Czech Republic",
+    "de": "Germany",
+    "dk": "Denmark",
+    "do": "Dominican Republic",
+    "dz": "Algeria",
+    "ec": "Ecuador",
+    "ee": "Estonia",
+    "eg": "Egypt",
+    "en": "England",
+    "es": "Spain",
+    "et": "Ethiopia",
+    "eu": "Europe",
+    "fi": "Finland",
+    "fj": "Fiji",
+    "fo": "Faroe Islands",
+    "fr": "France",
+    "ga": "Gabon",
+    "gb": "United Kingdom",
+    "ge": "Georgia",
+    "gi": "Gibraltar",
+    "gl": "Greenland",
+    "gp": "Guadeloupe",
+    "gr": "Greece",
+    "gt": "Guatemala",
+    "gu": "Guam",
+    "gy": "Guyana",
+    "hk": "Hong Kong",
+    "hn": "Honduras",
+    "hr": "Croatia",
+    "ht": "Haiti",
+    "hu": "Hungary",
+    "id": "Indonesia",
+    "ie": "Ireland",
+    "il": "Israel",
+    "in": "India",
+    "iq": "Iraq",
+    "ir": "Iran",
+    "is": "Iceland",
+    "it": "Italy",
+    "jm": "Jamaica",
+    "jo": "Jordan",
+    "jp": "Japan",
+    "ke": "Kenya",
+    "kg": "Kyrgyzstan",
+    "kh": "Cambodia",
+    "ki": "Kiribati",
+    "kp": "North Korea",
+    "kr": "South Korea",
+    "kw": "Kuwait",
+    "ky": "Cayman Islands",
+    "kz": "Kazakhstan",
+    "la": "Laos",
+    "lb": "Lebanon",
+    "lc": "Saint Lucia",
+    "lk": "Sri Lanka",
+    "lt": "Lithuania",
+    "lu": "Luxembourg",
+    "lv": "Latvia",
+    "ly": "Libya",
+    "m1": "Mars",
+    "ma": "Morocco",
+    "mc": "Monaco",
+    "md": "Moldova",
+    "mg": "Madagascar",
+    "mk": "North Macedonia",
+    "mm": "Myanmar",
+    "mn": "Mongolia",
+    "mo": "Macau",
+    "mp": "Northern Mariana Islands",
+    "ms": "Montserrat",
+    "mt": "Malta",
+    "mv": "Maldives",
+    "mx": "Mexico",
+    "my": "Malaysia",
+    "mz": "Mozambique",
+    "na": "Namibia",
+    "nc": "New Caledonia",
+    "nf": "Norfolk Island",
+    "ng": "Nigeria",
+    "ni": "Nicaragua",
+    "nl": "Netherlands",
+    "no": "Norway",
+    "np": "Nepal",
+    "nr": "Nauru",
+    "nz": "New Zealand",
+    "om": "Oman",
+    "pa": "Panama",
+    "pe": "Peru",
+    "pf": "French Polynesia",
+    "pg": "Papua New Guinea",
+    "ph": "Philippines",
+    "pk": "Pakistan",
+    "pl": "Poland",
+    "pm": "Saint Pierre and Miquelon",
+    "pr": "Puerto Rico",
+    "ps": "Palestine",
+    "pt": "Portugal",
+    "py": "Paraguay",
+    "qa": "Qatar",
+    "ro": "Romania",
+    "rs": "Serbia",
+    "ru": "Russia",
+    "sa": "Saudi Arabia",
+    "sb": "Solomon Islands",
+    "sc": "Seychelles",
+    "sd": "Sudan",
+    "se": "Sweden",
+    "sg": "Singapore",
+    "si": "Slovenia",
+    "sk": "Slovakia",
+    "sl": "Sierra Leone",
+    "sn": "Senegal",
+    "so": "Somalia",
+    "sr": "Suriname",
+    "sv": "El Salvador",
+    "sx": "Sint Maarten",
+    "sy": "Syria",
+    "tb": "East Timor",
+    "tc": "Turks and Caicos Islands",
+    "tg": "Togo",
+    "th": "Thailand",
+    "to": "Tonga",
+    "tr": "Turkey",
+    "tt": "Trinidad and Tobago",
+    "tv": "Tuvalu",
+    "tw": "Taiwan",
+    "tz": "Tanzania",
+    "ua": "Ukraine",
+    "ug": "Uganda",
+    "un": "United Nations",
+    "us": "United States",
+    "uy": "Uruguay",
+    "uz": "Uzbekistan",
+    "va": "Vatican City",
+    "ve": "Venezuela",
+    "vg": "British Virgin Islands",
+    "vi": "U.S. Virgin Islands",
+    "vn": "Vietnam",
+    "wa": "Wales",
+    "ws": "Samoa",
+    "ye": "Yemen",
+    "za": "South Africa",
+    "zw": "Zimbabwe",
+}
+
+
+def map_country_code(code: Optional[str]) -> Optional[str]:
+    """Map country code to full country name."""
+    if code is None:
+        return None
+    return COUNTRY_MAP.get(code.lower(), code.lower())