{"id":5567,"library":"apeye-core","title":"apeye-core","description":"apeye-core provides the core, offline-capable functionality for the broader `apeye` library. It acts as a foundational component, offering essential utilities that do not require network access. The library is actively maintained, with frequent minor releases mirroring PyPI updates.","status":"active","version":"1.1.5","language":"en","source_language":"en","source_url":"https://github.com/domdfcoding/apeye-core","tags":["URL","API","core","utility","offline","dependency","networking"],"install":[{"cmd":"pip install apeye-core","lang":"bash","label":"Install with pip"},{"cmd":"conda install -c conda-forge apeye-core","lang":"bash","label":"Install with Conda"}],"dependencies":[{"reason":"Required for core utilities and tooling.","package":"domdf-python-tools","optional":false}],"imports":[{"note":"While underlying components may reside in `apeye-core`, direct end-user imports are typically from the `apeye` library which re-exports or builds upon `apeye-core`'s functionality. For example, the `URL` object, a core concept, is exposed via `apeye`.","symbol":"URL","correct":"from apeye.url import URL"}],"quickstart":{"code":"import os\nfrom apeye.url import URL\n\n# apeye-core itself is primarily an internal dependency.\n# Most user-facing functionality is exposed via the 'apeye' library.\n# Here's an example of using a core component (URL) from 'apeye' that likely leverages apeye-core.\n\nmy_url = URL('https://example.com/api/data')\nprint(f\"Created URL object: {my_url}\")\nprint(f\"URL scheme: {my_url.scheme}\")\nprint(f\"URL hostname: {my_url.hostname}\")\n\n# To see the full capabilities of apeye (which uses apeye-core),\n# install 'apeye' and refer to its documentation for features like caching and rate limiting.\n# pip install apeye","lang":"python","description":"apeye-core provides foundational, offline functionality. For most user-facing interactions, such as creating URL objects or utilizing API tools, you should typically use the higher-level `apeye` library, which depends on `apeye-core`. This quickstart demonstrates a core component (URL) as exposed by `apeye`."},"warnings":[{"fix":"Install `apeye` (`pip install apeye`) for a full set of tools and refer to its documentation for usage examples.","message":"`apeye-core` is primarily intended as an internal dependency for the `apeye` library. End-users seeking functionality for working with URLs, APIs, caching, or rate limiting should typically install and use the `apeye` library, not `apeye-core` directly.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Consult the GitHub repository's commit history or the `apeye` library's documentation for more detailed insights into specific changes.","message":"The release notes for `apeye-core` often simply state 'Automatically copied from PyPI', providing minimal detail about specific changes or potential breaking changes between minor versions. Users should exercise caution and review changes if upgrading across several minor versions.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-12T00:00:00.000Z","next_check":"2026-07-11T00:00:00.000Z"}