easyder 0.2.0__tar.gz

easyder-0.2.0/.github/workflows/black.yml

@@ -0,0 +1,26 @@
+name: Code Formatting (Black)
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  black:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.10'
+    
+    - name: Install black
+      run: pip install black
+    
+    - name: Check code formatting with black
+      run: black --check easyder tests
+      continue-on-error: true

easyder-0.2.0/.github/workflows/docs.yml

@@ -0,0 +1,28 @@
+name: Documentation
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.10'
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e .
+    
+    - name: Check README
+      run: |
+        python -c "import easyder; print(f'EASYDER {easyder.__version__} ready!')"

easyder-0.2.0/.github/workflows/release.yml

@@ -0,0 +1,34 @@
+name: Release to PyPI
+
+on:
+  release:
+    types: [created]
+  workflow_dispatch:
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.10'
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build wheel twine
+    
+    - name: Build distribution
+      run: python -m build
+    
+    - name: Check distribution
+      run: twine check dist/*
+    
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        password: ${{ secrets.PYPI_API_TOKEN }}

easyder-0.2.0/.github/workflows/security.yml

@@ -0,0 +1,34 @@
+name: Security Checks
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+  schedule:
+    - cron: '0 0 * * 0'
+
+jobs:
+  security:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.10'
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install bandit safety
+    
+    - name: Run bandit security check
+      run: bandit -r easyder -f json -o bandit-report.json
+      continue-on-error: true
+    
+    - name: Run safety check
+      run: safety check --json
+      continue-on-error: true

easyder-0.2.0/.github/workflows/tests.yml

@@ -0,0 +1,51 @@
+name: Tests
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12']
+
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e .[dev]
+    
+    - name: Lint with flake8
+      run: |
+        flake8 easyder --count --select=E9,F63,F7,F82 --show-source --statistics
+        flake8 easyder --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+    
+    - name: Type check with mypy
+      run: |
+        mypy easyder --ignore-missing-imports
+      continue-on-error: true
+    
+    - name: Run tests with pytest
+      run: |
+        pytest tests/ -v --cov=easyder --cov-report=xml
+    
+    - name: Upload coverage to Codecov
+      uses: codecov/codecov-action@v3
+      with:
+        file: ./coverage.xml
+        flags: unittests
+        name: codecov-umbrella
+        fail_ci_if_error: false

easyder-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ReiZyuki
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

easyder-0.2.0/PKG-INFO

@@ -0,0 +1,504 @@
+Metadata-Version: 2.4
+Name: easyder
+Version: 0.2.0
+Summary: EASYDER - CSS-inspired video downloader with automatic cookie fallback, powered by yt-dlp + FFmpeg
+Home-page: https://github.com/ReiZyuki/easyder
+Author: ReiZyuki
+Author-email: ReiZyuki <rei@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/ReiZyuki/easyder
+Project-URL: Bug Tracker, https://github.com/ReiZyuki/easyder/issues
+Project-URL: Documentation, https://github.com/ReiZyuki/easyder#readme
+Project-URL: Source Code, https://github.com/ReiZyuki/easyder
+Keywords: video,downloader,youtube,instagram,tiktok,yt-dlp,ffmpeg,css-inspired,easy
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: yt-dlp>=2023.12.30
+Requires-Dist: requests>=2.31.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+EASYDER — CSS-Inspired Video Downloader
+
+""Python 3.8+" (https://img.shields.io/badge/python-3.8+-blue.svg)" (https://www.python.org/downloads/)
+""License: MIT" (https://img.shields.io/badge/License-MIT-yellow.svg)" (https://opensource.org/licenses/MIT)
+
+EASYDER is a CSS-inspired video downloader built with yt-dlp + FFmpeg.
+
+Easyder V1.0 focuses on downloading video/audio, extracting metadata, downloading thumbnails, handling playlists, and automatically trying supplied cookie files when a normal request fails.
+
+---
+
+Features
+
+- ✅ CSS-inspired dictionary syntax
+- ✅ Video quality selection
+- ✅ Audio-only downloads
+- ✅ 360p, 480p, 720p and 1080p quality stages
+- ✅ Original/best quality selection
+- ✅ Automatic cookie fallback
+- ✅ Multiple supplied cookie files
+- ✅ Playlist downloads
+- ✅ Video metadata extraction
+- ✅ Thumbnail downloading
+- ✅ yt-dlp + FFmpeg based downloading
+- ✅ Download progress display
+- ✅ MP4 output for video downloads
+
+---
+
+Installation
+
+From PyPI
+
+pip install easyder
+
+From GitHub
+
+git clone https://github.com/ReiZyuki/Easyder.git
+cd Easyder
+pip install -e .
+
+---
+
+Quick Start
+
+from easyder import rz
+
+result = rz(
+    {
+        "video[3]": "video",
+        "title": "title",
+        "creator": "creator",
+    },
+    url,
+)
+
+print("Video:", result["video"])
+print("Title:", result["title"])
+print("Creator:", result["creator"])
+
+The right-side values such as ""video"", ""title"" and ""creator"" are user-defined variable names.
+
+---
+
+Video Quality
+
+Easyder uses CSS-inspired quality selectors:
+
+"video[0]"
+"video[1]"
+"video[2]"
+"video[3]"
+"video[4]"
+"video[5]"
+
+Selector| Quality
+"video[0]"| Audio only
+"video[1]"| 360p
+"video[2]"| 480p
+"video[3]"| 720p
+"video[4]"| 1080p
+"video[5]"| Best/original available quality
+
+Example:
+
+from easyder import rz
+
+result = rz(
+    {
+        "video[4]": "video",
+    },
+    url,
+)
+
+print(result["video"])
+
+If the requested quality is unavailable, yt-dlp selects an appropriate available format according to Easyder's format selection rules.
+
+---
+
+Audio Only
+
+Use "video[0]" for audio:
+
+from easyder import rz
+
+result = rz(
+    {
+        "video[0]": "audio",
+    },
+    url,
+)
+
+print(result["audio"])
+
+---
+
+Metadata
+
+Easyder can extract video metadata without downloading the video.
+
+from easyder import rz
+
+result = rz(
+    {
+        "title": "title",
+        "creator": "creator",
+        "url": "video_url",
+        "views": "views",
+        "likes": "likes",
+        "count": "comments",
+        "time": "duration",
+        "thumbnail": "thumbnail",
+        "formats": "formats",
+    },
+    url,
+)
+
+print("Title:", result["title"])
+print("Creator:", result["creator"])
+print("URL:", result["video_url"])
+print("Views:", result["views"])
+print("Likes:", result["likes"])
+print("Comments:", result["comments"])
+print("Duration:", result["duration"])
+print("Thumbnail:", result["thumbnail"])
+print("Formats:", result["formats"])
+
+Metadata variable names are completely user-defined.
+
+For example:
+
+result = rz(
+    {
+        "title": "MyTitle",
+        "creator": "MyCreator",
+    },
+    url,
+)
+
+print(result["MyTitle"])
+print(result["MyCreator"])
+
+---
+
+Thumbnail
+
+Use the "thumbnail" selector to download the video's thumbnail.
+
+from easyder import rz
+
+result = rz(
+    {
+        "thumbnail": "thumb",
+    },
+    url,
+)
+
+print(result["thumb"])
+
+The returned value is the path of the downloaded thumbnail.
+
+Default download directory:
+
+/storage/emulated/0/Download/ReiDownloader
+
+---
+
+Playlist
+
+Playlist syntax:
+
+"playlist": "QUALITY:SKIP:COUNT"
+
+Example:
+
+from easyder import rz
+
+result = rz(
+    {
+        "playlist": "3:5:10",
+    },
+    playlist_url,
+)
+
+print(result["videos"])
+
+Meaning:
+
+3 = 720p
+5 = skip the first 5 videos
+10 = download the next 10 videos
+
+Quality values
+
+Quality| Meaning
+"0"| Audio
+"1"| 360p
+"2"| 480p
+"3"| 720p
+"4"| 1080p
+"5"| Best/original
+
+Example:
+
+result = rz(
+    {
+        "playlist": "4:0:5",
+    },
+    playlist_url,
+)
+
+This requests:
+
+1080p
+Skip 0
+Download 5 videos
+
+Downloaded playlist files are returned in:
+
+result["videos"]
+
+---
+
+Automatic Cookie Fallback
+
+Easyder first attempts the request without cookies.
+
+If the normal request fails, Easyder checks the cookie files supplied through the "Cooki" variable.
+
+from easyder import rz
+
+Cooki = [
+    "/storage/emulated/0/Download/youtube.txt",
+    "/storage/emulated/0/Download/other.txt",
+]
+
+result = rz(
+    {
+        "video[3]": "video",
+        "title": "title",
+    },
+    url,
+)
+
+Easyder tests the supplied cookie files one by one and uses the first working cookie.
+
+No cookie filenames are hardcoded by Easyder.
+
+---
+
+Cookie Variable
+
+The cookie variable name is:
+
+Cooki
+
+It can contain a single path:
+
+Cooki = "/path/to/cookies.txt"
+
+or multiple paths:
+
+Cooki = [
+    "/path/to/cookies1.txt",
+    "/path/to/cookies2.txt",
+]
+
+Easyder does not scan directories for cookie files.
+
+---
+
+Progress
+
+During downloads Easyder displays progress information similar to:
+
+Downloading: 1080p
+[Download 50%] [Network 2.0 MB/s] [Mode Video]
+
+The downloader can also receive a progress callback:
+
+from easyder import rz
+
+def progress(percent, network, mode):
+    print(percent, network, mode)
+
+result = rz(
+    {
+        "video[3]": "video",
+    },
+    url,
+    progress_callback=progress,
+)
+
+The callback receives:
+
+percent
+network
+mode
+
+---
+
+Custom Variable Names
+
+Easyder does not require fixed output variable names.
+
+For example:
+
+result = rz(
+    {
+        "video[3]": "MyVideo",
+        "title": "MyTitle",
+        "creator": "MyCreator",
+        "thumbnail": "MyThumbnail",
+    },
+    url,
+)
+
+Then:
+
+print(result["MyVideo"])
+print(result["MyTitle"])
+print(result["MyCreator"])
+print(result["MyThumbnail"])
+
+This keeps the selector syntax separate from the variable names used by your application.
+
+---
+
+Complete Example
+
+from easyder import rz
+
+Cooki = [
+    "/storage/emulated/0/Download/youtube.txt",
+]
+
+result = rz(
+    {
+        "video[4]": "video",
+        "title": "title",
+        "creator": "creator",
+        "thumbnail": "thumbnail",
+        "views": "views",
+        "likes": "likes",
+        "time": "duration",
+    },
+    url,
+)
+
+print("Video:", result["video"])
+print("Title:", result["title"])
+print("Creator:", result["creator"])
+print("Thumbnail:", result["thumbnail"])
+print("Views:", result["views"])
+print("Likes:", result["likes"])
+print("Duration:", result["duration"])
+
+---
+
+Selector Reference
+
+Selector| Example value| Description
+"video[0]"| ""video""| Audio only
+"video[1]"| ""video""| 360p video
+"video[2]"| ""video""| 480p video
+"video[3]"| ""video""| 720p video
+"video[4]"| ""video""| 1080p video
+"video[5]"| ""video""| Best/original quality
+"title"| ""title""| Video title
+"creator"| ""creator""| Uploader/creator
+"url"| ""video_url""| Video URL
+"views"| ""views""| View count
+"likes"| ""likes""| Like count
+"count"| ""comments""| Comment count
+"time"| ""duration""| Duration
+"thumbnail"| ""thumbnail""| Download thumbnail
+"formats"| ""formats""| Available formats
+"playlist"| ""QUALITY:SKIP:COUNT""| Playlist download
+
+---
+
+Quality Reference
+
+video[0] = Audio only
+video[1] = 360p
+video[2] = 480p
+video[3] = 720p
+video[4] = 1080p
+video[5] = Best/original available
+
+---
+
+Requirements
+
+Easyder uses:
+
+- Python
+- yt-dlp
+- FFmpeg
+
+FFmpeg is required for media processing and merging separate video/audio streams.
+
+---
+
+Download Location
+
+The default download directory is:
+
+/storage/emulated/0/Download/ReiDownloader
+
+Videos and thumbnails downloaded by Easyder are stored there.
+
+---
+
+V1.0 Scope
+
+Easyder V1.0 intentionally focuses on:
+
+Video
+Audio
+Thumbnail
+Metadata
+Playlist
+Automatic cookie fallback
+Progress reporting
+
+Easyder V1.0 does not include:
+
+Gallery / gallery-dl
+Telegram / TeleBot integration
+Sender functionality
+
+These features may be considered separately in future versions.
+
+---
+
+License
+
+MIT License