SpotDown 0.1.1__py3-none-any.whl → 1.3.0__py3-none-any.whl

SpotDown/utils/logger.py

@@ -0,0 +1,90 @@
+# 05.04.2024
+
+import os
+import logging
+from logging.handlers import RotatingFileHandler
+
+
+# Internal utils
+from SpotDown.utils.config_json import config_manager
+
+
+
+class Logger:
+    _instance = None
+    
+    def __new__(cls):
+        # Singleton pattern to avoid multiple logger instances
+        if cls._instance is None:
+            cls._instance = super(Logger, cls).__new__(cls)
+            cls._instance._initialized = False
+        return cls._instance
+        
+    def __init__(self):
+        # Initialize only once
+        if getattr(self, '_initialized', False):
+            return
+        
+        # Configure root logger
+        self.debug_mode = config_manager.get_bool('DEFAULT', "debug")
+        self.logger = logging.getLogger('')
+        
+        # Remove any existing handlers to avoid duplication
+        for handler in self.logger.handlers[:]:
+            self.logger.removeHandler(handler)
+        
+        # Reduce logging level for external libraries
+        logging.getLogger("httpx").setLevel(logging.WARNING)
+        logging.getLogger("httpcore").setLevel(logging.WARNING)
+        
+        # Set logging level based on debug_mode
+        if self.debug_mode:
+            self.logger.setLevel(logging.DEBUG)
+            # In debug mode: log SOLO nel file, non nel terminale
+            self._configure_console_log_file()
+        else:
+            self.logger.setLevel(logging.ERROR)
+            # In modalità normale: log solo nel terminale per gli errori
+            self._configure_console_logging()
+        
+        self._initialized = True
+        
+    def _configure_console_logging(self):
+        """Configure console logging output to terminal."""
+        console_handler = logging.StreamHandler()
+        console_handler.setLevel(logging.ERROR)  # Solo errori nel terminale
+        formatter = logging.Formatter('[%(filename)s:%(lineno)s - %(funcName)20s() ] %(asctime)s - %(levelname)s - %(message)s')
+        console_handler.setFormatter(formatter)
+        self.logger.addHandler(console_handler)
+            
+    def _configure_console_log_file(self):
+        """Create a console.log file only when debug mode is enabled."""
+        console_log_path = "console.log"
+        try:
+            # Remove existing file if present
+            if os.path.exists(console_log_path):
+                os.remove(console_log_path)
+                
+            # Create handler for console.log
+            console_file_handler = RotatingFileHandler(
+                console_log_path,
+                maxBytes=5*1024*1024,  # 5 MB
+                backupCount=3
+            )
+            console_file_handler.setLevel(logging.DEBUG)
+            formatter = logging.Formatter('[%(filename)s:%(lineno)s - %(funcName)20s() ] %(asctime)s - %(levelname)s - %(message)s')
+            console_file_handler.setFormatter(formatter)
+            self.logger.addHandler(console_file_handler)
+            
+        except Exception as e:
+            print(f"Error creating console.log: {e}")
+            
+    @staticmethod
+    def get_logger(name=None):
+        """
+        Get a specific logger for a module/component.
+        If name is None, returns the root logger.
+        """
+        # Ensure Logger instance is initialized
+        Logger()
+        return logging.getLogger(name)

{spotdown-0.1.1.dist-info → spotdown-1.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: SpotDown
-Version: 0.1.1
+Version: 1.3.0
 Summary: A command-line program to download music
 Home-page: https://github.com/Arrowar/spotdown
 Author: Arrowar
@@ -13,12 +13,12 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: rich
 Requires-Dist: httpx
-Requires-Dist: playwright
 Requires-Dist: unidecode
 Requires-Dist: ua-generator
 Requires-Dist: unidecode
 Requires-Dist: yt-dlp
 Requires-Dist: Pillow
+Requires-Dist: spotipy
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -41,6 +41,7 @@ Dynamic: summary
 ## 💝 Support the Project
 
 [![Donate PayPal](https://img.shields.io/badge/💳_Donate-PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white&labelColor=2d3748)](https://www.paypal.com/donate/?hosted_button_id=UXTWMT8P6HE2C)
+
 ## 🚀 Download & Install
 
 [![Windows](https://img.shields.io/badge/🪟_Windows-0078D4?style=for-the-badge&logo=windows&logoColor=white&labelColor=2d3748)](https://github.com/Arrowar/spotdown/releases/latest/download/spotdown_win.exe)
@@ -50,7 +51,7 @@ Dynamic: summary
 
 ---
 
-*⚡ **Quick Start:** `pip install spotdown` or download the executable for your platform above*
+*⚡ **Quick Start:** `pip install spotdown && spotdown`*
 
 </div>
 
@@ -58,9 +59,9 @@ Dynamic: summary
 
 - [✨ Features](#features)
 - [🛠️ Installation](#️installation)
+- [⚙️ Setup](#setup)
 - [⚙️ Configuration](#configuration)
 - [💻 Usage](#usage)
-- [⚠️ Disclaimer](#disclaimer)
 
 ## Features
 
@@ -68,38 +69,61 @@ Dynamic: summary
 - 📋 **Download entire playlists** with ease
 - 🔍 **No authentication required** - uses web scraping
 - 🎨 **Automatic cover art embedding** (JPEG format)
+- ⚡ **Simple command-line interface** - just run `spotdown`!
 
 ## Installation
 
-### Prerequisites
+### Method 1: PyPI (Recommended)
 
-- **Python 3.8+**
-- **FFmpeg** (for audio processing)
-- **yt-dlp** (for downloading)
+```bash
+pip install spotdown
+```
 
-### 1. Install Python Dependencies
+That's it! You can now run `spotdown` from anywhere in your terminal.
+
+### Method 2: From Source
+
+If you prefer to install from source:
 
 ```bash
-pip install -r requirements.txt
+git clone https://github.com/Arrowar/spotdown.git
+cd spotdown
+pip install -e .
 ```
 
-### 2. Install Playwright Chromium
+### Prerequisites
+
+The following dependencies will be automatically installed:
+
+- **Python 3.8+**
+- **FFmpeg** (for audio processing)
+- **yt-dlp** (for downloading)
+- **Playwright** (for web scraping)
+
+After installation, run this one-time setup command:
 
 ```bash
 playwright install chromium
 ```
 
-### 3. Quick Start
+## Setup
 
-Create a simple launcher script:
+1. Go to the [Spotify Developer Dashboard](https://developer.spotify.com/dashboard/)
+2. Log in and create a new application
+3. Copy your **Client ID** and **Client Secret**
+4. Create a file named `.env` in the SpotDown directory with the following content:
 
-```python
-from spotdown.run import main
-
-if __name__ == "__main__":
-    main()
+```
+SPOTIFY_CLIENT_ID=your_client_id_here
+SPOTIPY_CLIENT_SECRET=your_client_secret_here
 ```
 
+5. Save the file. SpotDown will automatically load these credentials.
+
+### Error Handling
+- If the credentials are missing, SpotDown will log an error and exit.
+- If the credentials are invalid, SpotDown will log an error and exit. Please double-check your `.env` file and credentials.
+
 ## Configuration
 
 SpotDown uses a JSON configuration file with the following structure:
@@ -113,10 +137,6 @@ SpotDown uses a JSON configuration file with the following structure:
     "DOWNLOAD": {
         "auto_first": false,
         "quality": "320K"
-    },
-    "BROWSER": {
-        "headless": true,
-        "timeout": 6
     }
 }
 ```
@@ -131,21 +151,21 @@ SpotDown uses a JSON configuration file with the following structure:
 - **`auto_first`**: Automatically select first search result
 - **`quality`**: Audio quality (320K recommended for best quality)
 
-#### BROWSER Settings
-- **`headless`**: Run browser in background (recommended: true)
-- **`timeout`**: Browser timeout in seconds
-
 ## Usage
 
-### Basic Usage
+### Starting SpotDown
+
+Simply run the following command in your terminal:
 
 ```bash
-python run.py
+spotdown
 ```
 
+The interactive interface will guide you through the download process.
+
 ### Download Individual Songs
 
-1. Run the script
+1. Run `spotdown`
 2. Paste the Spotify song URL when prompted
 3. The script will automatically:
    - Extract song information
@@ -154,15 +174,28 @@ python run.py
 
 ### Download Playlists
 
-1. Run the script  
+1. Run `spotdown`
 2. Paste the Spotify playlist URL when prompted
 3. All songs in the playlist will be downloaded automatically
 
+### Example Usage
+
+```bash
+$ spotdown
+🎵 Welcome to SpotDown!
+Please paste your Spotify URL: https://open.spotify.com/track/4iV5W9uYEdYUVa79Axb7Rh
+🔍 Processing: Song Name - Artist Name
+⬇️ Downloading...
+✅ Download complete!
+```
+
 ## To Do
 
 - [ ] Implement batch download queue
 - [ ] Add GUI interface option
 - [ ] Support for additional music platforms
+- [ ] Album art quality selection
+- [ ] Custom output directory configuration
 
 ## Disclaimer
 

spotdown-1.3.0.dist-info/RECORD

@@ -0,0 +1,21 @@
+SpotDown/__init__.py,sha256=ebKRxKh14_cO7UWvOgE4R1RqIFBdekg50xtzc1LU6DU,59
+SpotDown/main.py,sha256=qTNHAyXdxe6BMwwTMssuFBdpfdxMEYwFM6LweGiBBYI,5084
+SpotDown/downloader/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+SpotDown/downloader/youtube_downloader.py,sha256=i4Iq7jFKD8dFxpWHPcxgE2_hykwHf6TQXZSal_FHUAY,5557
+SpotDown/extractor/__init__.py,sha256=pQtkjMzB4D8AVEFQ3pnp_UQI-KbYaQhZbKuDnMImN0o,161
+SpotDown/extractor/spotify_extractor.py,sha256=gI4iJvs_MYV7MO-zcuUXavqtQo5jDAuXNqXs2ScTjDE,7755
+SpotDown/extractor/youtube_extractor.py,sha256=v1JDV_NHBpc56UU5kk4tfaRjPB0Jy23_F5r4LE2gOlU,10442
+SpotDown/upload/version.py,sha256=uvgDGChIXb3JAYtO_GQPGc-au8t6sDfzX40RkqQex14,161
+SpotDown/utils/__init__.py,sha256=ZhJJhNQkUd4XG6vkoVQSC3qvSlaArhsRjscn4bfC9WA,128
+SpotDown/utils/config_json.py,sha256=q_9lQhGLmsaZfM1WU-kOMByf8y1Wt9QWnZT5g_IR4Lg,7447
+SpotDown/utils/console_utils.py,sha256=oW7jD3UjrSlYoZ8R7VJAV8WPymD2NZGs1SS5BUUQ3Zk,6825
+SpotDown/utils/ffmpeg_installer.py,sha256=kFcjr9HqQyxu01mpWumt8d_0D9aEkxMb5sSBJqSkR0w,14889
+SpotDown/utils/file_utils.py,sha256=eNb0JT99FyeMGCoVzFkyhF-39FZE-yogwtUgKSbaTCs,7132
+SpotDown/utils/headers.py,sha256=nSF2rEQEl7g2tIJMjz9c5mAQfLiugfWwdlJBhtMfBSo,312
+SpotDown/utils/logger.py,sha256=Bzje-6nwGxL7TzMVhJfhPe7mv-9upYylFvx_zjWJX3M,3290
+spotdown-1.3.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+spotdown-1.3.0.dist-info/METADATA,sha256=apC3RZd0_akzY0ujIZ_EdcdqWkBsx-9gxMM0CaUh9CA,6836
+spotdown-1.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+spotdown-1.3.0.dist-info/entry_points.txt,sha256=qHq6M94aU-XQL0y9R4yFKoqnHjU2nsN53Bj4OuHp3vQ,47
+spotdown-1.3.0.dist-info/top_level.txt,sha256=1E-ZZ8rsrXmBPAsseY_kEfHfNo9w9PtSCaS6pM63-tw,9
+spotdown-1.3.0.dist-info/RECORD,,

spotdown-0.1.1.dist-info/RECORD

@@ -1,19 +0,0 @@
-SpotDown/__init__.py,sha256=ebKRxKh14_cO7UWvOgE4R1RqIFBdekg50xtzc1LU6DU,59
-SpotDown/main.py,sha256=TjxUMIe0ee8IMbnYhXekO2MoLRiY6pJ5CCPgz7pOpHg,5042
-SpotDown/downloader/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-SpotDown/downloader/youtube_downloader.py,sha256=zHl98F2Ax72wTg3n8pohmkBZgBIPff0NrD9QKhG-TBM,4589
-SpotDown/extractor/__init__.py,sha256=pQtkjMzB4D8AVEFQ3pnp_UQI-KbYaQhZbKuDnMImN0o,161
-SpotDown/extractor/spotify_extractor.py,sha256=abE48E4M8s3xf95a28IYD8L4K2-QFDaYoZC5V0Jqu-4,13486
-SpotDown/extractor/youtube_extractor.py,sha256=XIPNWEBb5oUkGP1DrQ4h4XTJvHlBlbVIkAFNdpFE-Rc,9586
-SpotDown/upload/version.py,sha256=hjqk3lk5Ic6SKn0Dk_-gfU6u75JmZLl5bcDSWIKdOAE,162
-SpotDown/utils/__init__.py,sha256=ZhJJhNQkUd4XG6vkoVQSC3qvSlaArhsRjscn4bfC9WA,128
-SpotDown/utils/config_json.py,sha256=Z_fuM2mYQVPc51sQ_-LXrX-ArTPL-lRDcQ3lLM_hmck,7435
-SpotDown/utils/console_utils.py,sha256=A1zNRyB9yG7BqWzlQgfVZ25cWUjMmYQooRKyeqVlcDw,6823
-SpotDown/utils/file_utils.py,sha256=Lgq_Nu1r-bVIH37H7Mx73WgotN_nrgMUAT2STDyEYoY,3495
-SpotDown/utils/headers.py,sha256=nSF2rEQEl7g2tIJMjz9c5mAQfLiugfWwdlJBhtMfBSo,312
-spotdown-0.1.1.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-spotdown-0.1.1.dist-info/METADATA,sha256=C3V6JqDDU14RFwGsniGuO-uEHOzvVvOezNPZ7Haqi_I,5744
-spotdown-0.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-spotdown-0.1.1.dist-info/entry_points.txt,sha256=qHq6M94aU-XQL0y9R4yFKoqnHjU2nsN53Bj4OuHp3vQ,47
-spotdown-0.1.1.dist-info/top_level.txt,sha256=1E-ZZ8rsrXmBPAsseY_kEfHfNo9w9PtSCaS6pM63-tw,9
-spotdown-0.1.1.dist-info/RECORD,,