#== main.py ==# __all__ = ( 'Github', ) from getpass import getpass import aiohttp from . import http from .exceptions import AlreadyStarted, NotStarted from .objects import User class Github: _auth = None has_started = False def __init__( self, *, using_auth: bool = False, custom_headers: dict[str, str | int] = {} ): """The main client, used to start most use-cases.""" self._headers = custom_headers if using_auth: username = input('Enter your username: ') #these two lines are blocking, but it's probably not a problem auth_token = getpass.getpass('Enter your token: ') self._auth = aiohttp.BasicAuth(username, auth_token) def __await__(self): return self.start().__await__() def __repr__(self) -> str: return f'' def check_limits(self, as_dict: bool = False) -> dict[str, str | int] | list[str]: if not self.has_started: raise NotStarted if not as_dict: output = [] for key, value in self.session._rates._asdict().items(): output.append(f'{key} : {value}') return output return self.session._rates._asdict() def update_auth(self) -> None: """Allows you to input auth information after instantiating the client.""" username = input('Enter your username: ') token = getpass('Enter your token: ') self._auth = aiohttp.BasicAuth(username, token) async def start(self) -> None: """Main entry point to the wrapper, this creates the ClientSession.""" if self.has_started: raise AlreadyStarted self.session = await http.make_session(headers=self._headers, authorization=self._auth) self.has_started = True return self async def get_user(self, username: str) -> User: """Fetch a Github user from their username.""" return User(await http.get_user(self.session, username), self.session) async def get_repo(self, repo_name: str) -> 'Repo': """Fetch a Github repository from it's name.""" pass async def get_org(self, org_name: str) -> 'Org': """Fetch a Github organization from it's name""" pass