littledl 0.1.0__tar.gz

littledl-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,56 @@
+---
+name: Bug Report
+about: Report a bug to help us improve
+title: '[BUG] '
+labels: bug, needs-triage
+assignees: ''
+---
+
+## Describe the Bug
+
+A clear and concise description of what the bug is.
+
+## To Reproduce
+
+Steps to reproduce the behavior:
+
+1. Install version '...'
+2. Run code '...'
+3. See error
+
+### Minimal Reproducible Code
+
+```python
+from little_tree_downloader import download_file
+
+# Your code here
+```
+
+## Expected Behavior
+
+A clear and concise description of what you expected to happen.
+
+## Actual Behavior
+
+What actually happened.
+
+## Error Output
+
+```
+Paste the full error traceback here
+```
+
+## Environment
+
+- OS: [e.g., Windows 11, Ubuntu 22.04, macOS 14]
+- Python version: [e.g., 3.11.5]
+- Package version: [e.g., 0.1.0]
+- Installation method: [e.g., pip, uv]
+
+## Additional Context
+
+Add any other context about the problem here.
+
+- Does this happen consistently or intermittently?
+- Any workarounds you've found?
+- Any recent changes to your environment?

littledl-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,46 @@
+---
+name: Feature Request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: enhancement, needs-triage
+assignees: ''
+---
+
+## Is your feature request related to a problem?
+
+A clear and concise description of what the problem is.
+
+Example: I'm always frustrated when [...]
+
+## Describe the Solution You'd Like
+
+A clear and concise description of what you want to happen.
+
+## Describe Alternatives You've Considered
+
+A clear and concise description of any alternative solutions or features you've considered.
+
+## Proposed API (if applicable)
+
+```python
+from little_tree_downloader import DownloadConfig
+
+config = DownloadConfig(
+    # Your proposed configuration
+    new_feature=True,
+)
+```
+
+## Use Case
+
+Describe how this feature would be useful.
+
+Example: This would help me to...
+
+## Additional Context
+
+Add any other context, code examples, or references to similar features in other projects.
+
+- Would this be a breaking change?
+- Are there any security implications?
+- Does this require new dependencies?

littledl-0.1.0/.github/dependabot.yml

@@ -0,0 +1,30 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
+    reviewers:
+      - "shu-shu-1"
+    labels:
+      - "dependencies"
+    commit-message:
+      prefix: "chore"
+      include: "scope"
+    groups:
+      production-dependencies:
+        dependency-type: "production"
+      dev-dependencies:
+        dependency-type: "development"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+    reviewers:
+      - "shu-shu-1"
+    labels:
+      - "github-actions"
+      - "dependencies"

littledl-0.1.0/.github/pull_request_template.md

@@ -0,0 +1,45 @@
+## Description
+
+Please include a summary of the changes and the related issue.
+
+Fixes # (issue)
+
+## Type of Change
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Performance improvement
+- [ ] Code refactoring
+
+## How Has This Been Tested?
+
+Please describe the tests that you ran to verify your changes.
+
+- [ ] Unit tests pass locally
+- [ ] Integration tests pass locally
+- [ ] Manual testing performed
+
+### Test Configuration
+
+- OS:
+- Python version:
+- Package version:
+
+## Checklist
+
+- [ ] My code follows the style guidelines of this project
+- [ ] I have performed a self-review of my code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] New and existing unit tests pass locally with my changes
+- [ ] Any dependent changes have been merged and published
+
+## Screenshots (if appropriate)
+
+## Additional Context
+
+Add any other context about the pull request here.

littledl-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,106 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+    paths-ignore:
+      - '**.md'
+      - 'LICENSE'
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run Ruff
+        run: uv run ruff check src/
+
+      - name: Run Ruff format check
+        run: uv run ruff format --check src/
+
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run MyPy
+        run: uv run mypy src/
+
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ['3.10', '3.11', '3.12']
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run tests
+        run: uv run pytest tests/ -v --cov --cov-report=xml
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.12'
+        with:
+          file: ./coverage.xml
+          fail_ci_if_error: false
+
+  build:
+    runs-on: ubuntu-latest
+    needs: [lint, typecheck, test]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Build package
+        run: uv build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/

littledl-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,35 @@
+name: Build Documentation
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - 'mkdocs.yml'
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install MkDocs and plugins
+        run: pip install mkdocs-material mkdocs-static-i18n mkdocs-llmstxt
+
+      - name: Build documentation
+        run: mkdocs build --strict --site-dir site
+
+      - name: Deploy to gh-pages branch
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./site
+          publish_branch: gh-pages

littledl-0.1.0/.github/workflows/pypi.yml

@@ -0,0 +1,55 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Clean previous builds
+        run: |
+          rm -rf dist/ build/ *.egg-info/
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Build package
+        run: uv build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    runs-on: ubuntu-latest
+    needs: [build]
+    environment:
+      name: production
+      url: https://pypi.org/project/littledl/
+    permissions:
+      id-token: write
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

littledl-0.1.0/CHANGELOG.md

@@ -0,0 +1,42 @@
+English | [简体中文](CHANGELOG.zh.md)
+
+# Changelog
+
+All notable changes to littledl will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0][0.1.0] - 2026-03-28
+
+### Added
+
+- IDM-style multi-threaded chunked downloading
+- Smart scheduling with slow chunk detection and resplitting
+- Resume support with chunk-level progress tracking
+- Speed monitoring with real-time calculation
+- Adaptive concurrency adjustment
+- Connection pooling with HTTP/2 support
+- Progress callback support
+- Rich configuration options
+- Comprehensive error handling
+- File integrity verification (SHA256, MD5)
+- Automatic filename detection from various sources
+
+### Features
+
+- **Multi-threaded Downloads**: Split files into chunks and download in parallel
+- **Smart Scheduling**: Intelligent chunk resplitting for optimal speed
+- **Resume Support**: Continue interrupted downloads seamlessly
+- **Speed Monitoring**: Real-time speed calculation and ETA estimation
+- **Adaptive Scheduling**: Dynamic adjustment based on network conditions
+- **Connection Management**: Efficient HTTP connection reuse
+
+### Supported Platforms
+
+- Windows 10/11
+- macOS 10.15+
+- Linux (Ubuntu 20.04+, Debian 11+, Fedora 35+)
+- FreeBSD 13+
+
+[0.1.0]: https://github.com/little-tree/little-tree-downloader/releases/tag/v0.1.0

littledl-0.1.0/CHANGELOG.zh.md

@@ -0,0 +1,42 @@
+English | 简体中文
+
+# 变更日志
+
+本文档记录 littledl 的所有重要变更。
+
+格式基于 [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)，
+本项目遵循 [语义化版本](https://semver.org/spec/v2.0.0.html)。
+
+## [0.1.0][0.1.0] - 2026-03-28
+
+### 新增
+
+- IDM 风格的多线程分块下载
+- 智能调度（慢分块检测和重分配）
+- 断点续传（分块级别进度跟踪）
+- 实时速度监控
+- 自适应并发调整
+- HTTP/2 连接池
+- 进度回调支持
+- 丰富的配置选项
+- 全面的错误处理
+- 文件完整性验证（SHA256、MD5）
+- 自动文件名检测
+
+### 功能
+
+- **多线程下载**：分块并行下载
+- **智能调度**：智能分块重分配优化速度
+- **断点续传**：无缝继续中断的下载
+- **速度监控**：实时速度计算和预计剩余时间
+- **自适应调度**：根据网络状况动态调整
+- **连接管理**：高效的 HTTP 连接复用
+
+### 支持的平台
+
+- Windows 10/11
+- macOS 10.15+
+- Linux (Ubuntu 20.04+, Debian 11+, Fedora 35+)
+- FreeBSD 13+
+
+[0.1.0]: https://github.com/little-tree/little-tree-downloader/releases/tag/v0.1.0

littledl-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,189 @@
+English | [简体中文](CONTRIBUTING.zh.md)
+
+# Contributing to littledl
+
+First off, thank you for considering contributing to littledl! It's people like you that make this project great.
+
+## Table of Contents
+
+- [Code of Conduct](#code-of-conduct)
+- [Getting Started](#getting-started)
+- [Development Setup](#development-setup)
+- [How to Contribute](#how-to-contribute)
+- [Coding Standards](#coding-standards)
+- [Commit Guidelines](#commit-guidelines)
+- [Pull Request Process](#pull-request-process)
+- [Reporting Bugs](#reporting-bugs)
+- [Feature Requests](#feature-requests)
+
+## Code of Conduct
+
+This project and everyone participating in it is governed by our Code of Conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to the project maintainers.
+
+## Getting Started
+
+### Prerequisites
+
+- Python 3.10 or higher
+- [uv](https://github.com/astral-sh/uv) package manager
+- Git
+
+### Development Setup
+
+1. **Fork and clone the repository**
+
+```bash
+git clone https://github.com/YOUR_USERNAME/little-tree-downloader.git
+cd little-tree-downloader
+```
+
+2. **Install dependencies**
+
+```bash
+uv sync --all-extras
+```
+
+3. **Run tests to verify setup**
+
+```bash
+uv run pytest tests/ -v
+```
+
+4. **Run linting**
+
+```bash
+uv run ruff check src/
+```
+
+## How to Contribute
+
+### Reporting Bugs
+
+Before creating bug reports, please check the existing issues. When you are creating a bug report, please include as many details as possible:
+
+- **Use a clear and descriptive title**
+- **Describe the exact steps to reproduce the problem**
+- **Provide specific examples with code snippets**
+- **Describe the behavior you observed and expected**
+- **Include your environment details** (OS, Python version, package version)
+
+### Suggesting Enhancements
+
+Enhancement suggestions are tracked as GitHub issues. When creating an enhancement suggestion:
+
+- **Use a clear and descriptive title**
+- **Provide a step-by-step description of the suggested enhancement**
+- **Provide specific examples to demonstrate the use case**
+- **Describe the current behavior and explain the expected behavior**
+- **Explain why this enhancement would be useful**
+
+### Pull Requests
+
+1. **Create a branch**
+
+```bash
+git checkout -b feature/your-feature-name
+# or
+git checkout -b fix/your-bug-fix
+```
+
+2. **Make your changes**
+
+- Follow the [coding standards](#coding-standards)
+- Add tests for new functionality
+- Update documentation as needed
+
+3. **Run tests and linting**
+
+```bash
+uv run pytest tests/ -v --cov
+uv run ruff check src/
+```
+
+4. **Commit your changes**
+
+Follow the [commit guidelines](#commit-guidelines).
+
+5. **Push and create a pull request**
+
+```bash
+git push origin your-branch-name
+```
+
+## Coding Standards
+
+### Python Style
+
+- Follow [PEP 8](https://pep8.org/) style guide
+- Use type hints for all function signatures
+- Write docstrings for public modules, functions, classes, and methods
+- Maximum line length is 120 characters
+
+### Code Organization
+
+```
+src/littledl/
+├── __init__.py      # Public API exports
+├── config.py        # Configuration classes
+├── downloader.py    # Main downloader implementation
+├── chunk.py         # Chunk management
+├── worker.py        # Download workers
+├── scheduler.py     # Smart scheduling
+├── monitor.py       # Speed monitoring
+├── resume.py        # Resume support
+├── connection.py    # Connection management
+├── auth.py          # Authentication
+├── proxy.py         # Proxy support
+├── limiter.py       # Speed limiting
+├── detector.py      # Server detection
+├── compat.py        # Cross-platform compatibility
+├── exceptions.py    # Custom exceptions
+├── utils.py         # Utility functions
+└── i18n/            # Internationalization
+```
+
+## Commit Guidelines
+
+We follow [Conventional Commits](https://www.conventionalcommits.org/):
+
+### Format
+
+```
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+### Types
+
+- `feat`: A new feature
+- `fix`: A bug fix
+- `docs`: Documentation only changes
+- `style`: Changes that do not affect the meaning of the code
+- `refactor`: A code change that neither fixes a bug nor adds a feature
+- `perf`: A code change that improves performance
+- `test`: Adding missing tests or correcting existing tests
+- `chore`: Changes to the build process or auxiliary tools
+
+## Pull Request Process
+
+1. **Ensure all tests pass** before submitting
+2. **Update documentation** for any new features
+3. **Add tests** for any new functionality
+4. **Follow the PR template** when creating your PR
+5. **Request review** from maintainers
+6. **Address review feedback** promptly
+
+## Additional Resources
+
+- [Python Type Hints](https://docs.python.org/3/library/typing.html)
+- [pytest Documentation](https://docs.pytest.org/)
+- [httpx Documentation](https://www.python-httpx.org/)
+
+## Questions?
+
+Feel free to open an issue for questions or reach out to the maintainers.
+
+Thank you for contributing!