{"id":26942120,"url":"https://github.com/deadpool2000/netinterfaces","last_synced_at":"2026-05-04T09:32:55.310Z","repository":{"id":285214252,"uuid":"957418867","full_name":"Deadpool2000/netinterfaces","owner":"Deadpool2000","description":"A lightweight and cross-platform Python library to retrieve network interface names with a simple API.","archived":false,"fork":false,"pushed_at":"2025-03-30T11:51:44.000Z","size":10,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-26T07:08:03.169Z","etag":null,"topics":["interfaces","linux","mac","netinterfaces","pypi","pypi-package","python","python-library","python3","windows","wlan0"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/netinterfaces/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Deadpool2000.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-30T10:23:54.000Z","updated_at":"2025-03-30T11:55:19.000Z","dependencies_parsed_at":null,"dependency_job_id":"68439324-1eeb-4a74-9248-689a3cad1bb6","html_url":"https://github.com/Deadpool2000/netinterfaces","commit_stats":null,"previous_names":["deadpool2000/netinterfaces"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Deadpool2000/netinterfaces","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Deadpool2000%2Fnetinterfaces","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Deadpool2000%2Fnetinterfaces/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Deadpool2000%2Fnetinterfaces/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Deadpool2000%2Fnetinterfaces/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Deadpool2000","download_url":"https://codeload.github.com/Deadpool2000/netinterfaces/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Deadpool2000%2Fnetinterfaces/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32601532,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T22:12:39.696Z","status":"online","status_checked_at":"2026-05-04T02:00:06.625Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["interfaces","linux","mac","netinterfaces","pypi","pypi-package","python","python-library","python3","windows","wlan0"],"created_at":"2025-04-02T16:39:54.654Z","updated_at":"2026-05-04T09:32:55.304Z","avatar_url":"https://github.com/Deadpool2000.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# netinterfaces\n\n[![Python Version](https://img.shields.io/badge/python-3.7%2B-blue.svg)](https://www.python.org/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nA lightweight and cross-platform Python library to retrieve network interface names with a simple API.\n\nFind on PyPI -  https://pypi.org/project/netinterfaces/\n\n## Features\n- **Single-function API** – Quickly retrieve network interface names with minimal effort.\n- **Cross-platform support** – Works on Windows, Linux, and macOS.\n- **No external dependencies** – Pure Python implementation with no additional requirements.\n- **Consistent output format** – Provides a uniform list output across different operating systems.\n- **Handles errors gracefully** – Returns an empty list in case of errors instead of crashing.\n\n## Installation\n\nInstall `netinterfaces` using `pip`:\n\n```bash\npip install netinterfaces\n```\n\n## Usage\n\nImport and use `get_interfaces` to retrieve network interface names:\n\n```python\nfrom netinterfaces import get_interfaces\n\ninterfaces = get_interfaces()\nprint(interfaces)  # Example output: ['eth0', 'wlan0', 'lo']\n```\n\n## Platform-Specific Examples\n\nThe library adapts to different platforms and returns interface names accordingly:\n\n- **Linux**: `['lo', 'eth0', 'wlan0']`\n- **Windows**: `['Ethernet', 'Wi-Fi', 'Loopback Pseudo-Interface']`\n- **macOS**: `['lo0', 'en0', 'en1']`\n\n## API Documentation\n\n### `get_interfaces()`\n```python\ndef get_interfaces() -\u003e list:\n    \"\"\"\n    Retrieves a list of network interface names available on the system.\n    \n    Returns:\n        list: A list of network interface names (e.g., ['eth0', 'wlan0', 'lo']).\n        If an error occurs, an empty list is returned.\n    \"\"\"\n```\n#### Returns\n- **List of strings**: Each string represents a network interface name.\n- **Empty list**: Returned in case of an error (e.g., lack of permissions, unexpected system behavior).\n\n## Contributing\n\nContributions are welcome! To contribute:\n1. Fork the repository.\n2. Create a new branch (`feature-branch`).\n3. Implement your changes and write tests if necessary.\n4. Submit a pull request.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](https://github.com/Deadpool2000/netinterfaces/blob/main/LICENSE) file for details.\n\n## Support\n\nIf you encounter any issues or have feature requests, please open an [issue](https://github.com/Deadpool2000/netinterfaces/issues) on the GitHub repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeadpool2000%2Fnetinterfaces","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeadpool2000%2Fnetinterfaces","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeadpool2000%2Fnetinterfaces/lists"}