aioneverdark

v0.3.0 safe
4.0
Medium Risk

Asynchronous Python client for the Neverdark Fireplace

🤖 AI Analysis

Final verdict: SAFE

The package appears to be a legitimate asynchronous client for interfacing with the Neverdark smart fireplace API. Despite some concerns about metadata quality and maintainer activity, there is no evidence of malicious behavior or supply-chain attack.

  • No shell execution, obfuscation, or credential harvesting risks detected.
  • Low maintainer activity and poor metadata quality may suggest potential abandonment or lack of updates.
Per-check LLM notes
  • Network: The observed network calls are typical for an HTTP client using aiohttp, possibly for legitimate API interactions.
  • Shell: No shell execution patterns were detected.
  • Obfuscation: No obfuscation patterns detected, indicating low risk.
  • Credentials: No credential harvesting patterns detected, indicating low risk.
  • Metadata: The package shows signs of low maintainer activity and poor metadata quality, which could indicate potential risk.

📦 Package Quality Overall: Medium (6.2/10)

✦ High Test Suite 9.0

Test suite present — 2 test file(s) found

  • Test runner config found: conftest.py
  • Test runner config found: pyproject.toml
  • 2 test file(s) detected (e.g. conftest.py)
◈ Medium Documentation 7.0

Some documentation present

  • Documentation URL: "documentation" -> https://github.com/mlankamp/aioneverdark
  • Brief PyPI description (594 chars)
○ Low Contributing Guide 2.0

No contributing guide or governance files found

  • No CONTRIBUTING, CODE_OF_CONDUCT, or governance files found
◈ Medium Type Annotations 7.0

Partial type annotation coverage

  • Type checker (mypy / pyright / pytype) referenced in project
  • 22 type-annotated function signatures detected in source
◈ Medium Multiple Contributors 6.0

Limited contributor diversity

  • 2 unique contributor(s) across 9 commits in mlankamp/aioneverdark
  • Two distinct contributors found

🔬 Heuristic Checks

⚠ Outbound Network Calls score 4.5

Found 3 network call pattern(s)

  • ain() -> None: async with aiohttp.ClientSession() as session: # Both clients reuse the same session;
  • ng it:: async with aiohttp.ClientSession() as session: async with NeverdarkClient(host="
  • INFO_RESPONSE) session = aiohttp.ClientSession() try: async with NeverdarkClient(host=HOST, ses
✓ Code Obfuscation

No obfuscation patterns detected

✓ Shell / Subprocess Execution

No shell execution patterns detected

✓ Credential Harvesting

No credential harvesting patterns detected

✓ Typosquatting

No typosquatting candidates detected

✓ Registered Email Domain

Email domain looks legitimate: c-hekje.nl>

✓ Suspicious Page Links

All external links appear legitimate

⚠ Git Repository History score 2.5

Git history flags: Repository has zero stars and zero forks

  • Repository has zero stars and zero forks
⚠ Maintainer History score 6.0

3 maintainer concern(s) found

  • Author name is missing or very short
  • Author "" appears to have only 1 package on PyPI (new or inactive account)
  • Package has no PyPI classifiers (low effort / metadata quality)
✓ Known CVE Vulnerabilities

No known vulnerabilities found in OSV database.

💡 AI App Starter Prompt

Use this prompt to build a project with aioneverdark 
Create a fully-functional asynchronous fireplace controller app using the Python package 'aioneverdark'. This app will allow users to remotely control their Neverdark Fireplace via a simple command-line interface (CLI). The app should support the following core functionalities:

1. **Connection Management**: Allow users to connect to their fireplace through the CLI. Ensure that the connection is established securely and efficiently.
2. **Fireplace Status**: Implement a feature that retrieves the current status of the fireplace, including whether it is on or off, the temperature setting, and any active modes (e.g., eco-mode).
3. **Control Commands**: Enable users to send commands to the fireplace, such as turning it on/off, adjusting the temperature, switching between different modes, and setting timers.
4. **Logging**: Integrate logging capabilities so that all interactions with the fireplace are recorded in a log file. This includes successful commands, errors, and status updates.
5. **User Interface**: Design a user-friendly CLI that guides users through the process of connecting to their fireplace and provides clear prompts for sending commands.

The 'aioneverdark' package will be utilized to handle all asynchronous communication with the Neverdark Fireplace. Your task is to explore the documentation provided by 'aioneverdark', understand its API, and implement the above functionalities using its core features. Additionally, consider adding optional features such as:
- **Error Handling**: Gracefully handle any errors that may occur during the connection or command execution.
- **Configuration File**: Allow users to store their fireplace credentials and settings in a configuration file for easy access.
- **Help and Documentation**: Provide comprehensive help and documentation within the CLI to assist users in understanding and using the app effectively.

Your goal is to create a robust, user-friendly, and efficient fireplace controller that showcases the capabilities of the 'aioneverdark' package.

💬 Discussion Feed

Leave a comment

No discussion yet. Be the first to share your thoughts!