subscriptions-to-csv 1.0.0__py3-none-any.whl

subscriptions_to_csv/__init__.py

@@ -0,0 +1,26 @@
+"""Convert subscription lists to CSV with EUR conversion.
+
+This package provides both a command-line tool and a Python library
+for converting subscription data to CSV format with EUR conversion.
+"""
+
+from .converter import (
+    convert_subscriptions,
+    fetch_exchange_rate,
+    parse_subscription_data,
+    write_csv_file,
+    SubscriptionConverter,
+    SubscriptionParseError,
+    ExchangeRateError,
+)
+
+__version__ = "1.0.0"
+__all__ = [
+    "convert_subscriptions",
+    "fetch_exchange_rate",
+    "parse_subscription_data",
+    "write_csv_file",
+    "SubscriptionConverter",
+    "SubscriptionParseError",
+    "ExchangeRateError",
+]

subscriptions_to_csv/cli.py

@@ -0,0 +1,100 @@
+"""Command-line interface for subscription-to-csv converter."""
+
+import sys
+import argparse
+from pathlib import Path
+from .converter import convert_subscriptions, ExchangeRateError, SubscriptionParseError
+
+
+def parse_arguments():
+    """Parse command line arguments."""
+    parser = argparse.ArgumentParser(
+        description='Convert subscription list to CSV with EUR conversion',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Input File Format:
+Each subscription consists of 2 lines:
+  Line 1: Service name (e.g., "Netflix")
+  Line 2: Price with currency, optionally preceded by tabs/spaces (e.g., "$15.99 USD" or "€9.99")
+
+Example input file format:
+Netflix
+\t12.99 €
+Spotify
+\t9.99 €
+
+Supported currencies: USD ($), EUR (€)
+All prices are converted to EUR in the output CSV.
+
+Examples:
+  subscriptions-to-csv subscriptions.txt output.csv
+  subscriptions-to-csv --input subscriptions.txt --output output.csv
+  subscriptions-to-csv  # uses default files
+        """
+    )
+    parser.add_argument('input_pos', nargs='?', help='Input file containing subscriptions')
+    parser.add_argument('output_pos', nargs='?', help='Output CSV file')
+    parser.add_argument('--input', '-i', help='Input file containing subscriptions')
+    parser.add_argument('--output', '-o', help='Output CSV file')
+    args = parser.parse_args()
+
+    # Use optional args if provided, otherwise positional, otherwise defaults
+    args.input = args.input or args.input_pos or 'subscriptions.txt'
+    args.output = args.output or args.output_pos or 'subscriptions.csv'
+
+    return args
+
+
+def print_summary(output_file: str, subscriptions: list, total_eur: float):
+    """Print summary of the conversion."""
+    print(f'Created {output_file}')
+    print('First few lines:')
+
+    # Show header and first few rows
+    if subscriptions:
+        print('Service,Price,Currency,PriceEUR')
+        for sub in subscriptions[:3]:  # Show first 3 subscriptions
+            print(f"{sub['Service']},{sub['Price']},{sub['Currency']},{sub['PriceEUR']}")
+        if len(subscriptions) > 3:
+            print('...')
+
+    print(f'Total in EUR: {total_eur:.2f}')
+
+
+def main():
+    """Main function to run the subscription converter CLI."""
+    args = parse_arguments()
+
+    try:
+        # Check if input file exists
+        input_path = Path(args.input)
+        if not input_path.exists():
+            print(f"Error: Input file '{args.input}' does not exist", file=sys.stderr)
+            sys.exit(1)
+
+        # Read input file
+        with open(args.input, 'r', encoding='utf-8') as f:
+            content = f.read()
+
+        # Convert subscriptions
+        subscriptions, total_eur = convert_subscriptions(content, args.output)
+
+        # Print summary
+        print_summary(args.output, subscriptions, total_eur)
+
+    except ExchangeRateError as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+    except SubscriptionParseError as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+    except FileNotFoundError as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+    except Exception as e:
+        print(f"Unexpected error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == '__main__':
+    main()

subscriptions_to_csv/converter.py

@@ -0,0 +1,209 @@
+"""Convert subscription lists to CSV with EUR conversion."""
+
+import json
+import urllib.request
+import csv
+from typing import List, Dict, Union, Optional, Tuple
+
+
+class SubscriptionParseError(Exception):
+    """Exception raised when subscription data cannot be parsed."""
+    pass
+
+
+class ExchangeRateError(Exception):
+    """Exception raised when exchange rate cannot be fetched."""
+    pass
+
+
+def fetch_exchange_rate() -> float:
+    """Fetch USD to EUR exchange rate from API.
+
+    Returns:
+        Exchange rate as float
+
+    Note:
+        Falls back to 1.0 if the API request fails
+    """
+    try:
+        with urllib.request.urlopen('https://api.exchangerate-api.com/v4/latest/USD') as f:
+            data = json.load(f)
+        return data['rates']['EUR']
+    except Exception:
+        return 1.0  # fallback
+
+
+def parse_subscription_data(content: Union[str, List[str]], rate: float) -> List[Dict[str, str]]:
+    """Parse subscription data from string or list of lines into list of dictionaries.
+
+    Args:
+        content: Subscription data as string or list of lines
+        rate: USD to EUR exchange rate
+
+    Returns:
+        List of subscription dictionaries with Service, Price, Currency, and PriceEUR keys
+
+    Raises:
+        SubscriptionParseError: If the content format is invalid
+    """
+    if isinstance(content, str):
+        lines = [line.strip() for line in content.strip().split('\n') if line.strip()]
+    else:
+        lines = [line.strip() for line in content if line.strip()]
+
+    subscriptions = []
+    for i in range(0, len(lines), 2):
+        if i + 1 >= len(lines):
+            break
+
+        service = lines[i]
+        price_line = lines[i + 1].lstrip('\t')
+        parts = price_line.split()
+
+        if not parts:
+            continue
+
+        price_str = parts[0].lstrip('$').lstrip('€')
+        try:
+            price = float(price_str)
+        except ValueError:
+            continue  # Skip invalid prices
+
+        # Determine currency from the price string
+        if parts[0].startswith('€') or (len(parts) > 1 and parts[1].upper() in ('EUR', '€')):
+            currency = 'EUR'
+        elif parts[0].startswith('$') or (len(parts) > 1 and parts[1].upper() == 'USD'):
+            currency = 'USD'
+        else:
+            currency = parts[1] if len(parts) > 1 else 'EUR'
+
+        if currency.upper() == 'USD':
+            eur_price = price * rate
+        elif currency.upper() in ('EUR', '€'):
+            eur_price = price
+        else:
+            raise SubscriptionParseError(f"Unsupported currency '{currency}' for service '{service}'")
+
+        subscriptions.append({
+            'Service': service,
+            'Price': f'{price:.2f}',
+            'Currency': currency.upper(),
+            'PriceEUR': f'{eur_price:.2f}'
+        })
+
+    return subscriptions
+
+
+def write_csv_file(subscriptions: List[Dict[str, str]], output_file: str) -> float:
+    """Write subscriptions to CSV file.
+
+    Args:
+        subscriptions: List of subscription dictionaries
+        output_file: Path to output CSV file
+
+    Returns:
+        Total EUR amount
+    """
+    total_eur = sum(float(sub['PriceEUR']) for sub in subscriptions)
+    with open(output_file, 'w', newline='') as csvfile:
+        fieldnames = ['Service', 'Price', 'Currency', 'PriceEUR']
+        writer = csv.DictWriter(csvfile, fieldnames=fieldnames)
+        writer.writeheader()
+        writer.writerows(subscriptions)
+    return total_eur
+
+
+def convert_subscriptions(
+    content: Union[str, List[str]],
+    output_file: Optional[str] = None,
+    exchange_rate: Optional[float] = None
+) -> Tuple[List[Dict[str, str]], float]:
+    """Convert subscription data to CSV format with EUR conversion.
+
+    This is the main library function for converting subscription data.
+
+    Args:
+        content: Subscription data as string or list of lines
+        output_file: Optional path to write CSV file to
+        exchange_rate: Optional exchange rate (will fetch if not provided)
+
+    Returns:
+        Tuple of (subscriptions_list, total_eur_amount)
+
+    Raises:
+        ExchangeRateError: If exchange rate cannot be fetched
+        SubscriptionParseError: If subscription data is malformed
+    """
+    rate = exchange_rate if exchange_rate is not None else fetch_exchange_rate()
+    subscriptions = parse_subscription_data(content, rate)
+
+    if output_file:
+        total_eur = write_csv_file(subscriptions, output_file)
+    else:
+        total_eur = sum(float(sub['PriceEUR']) for sub in subscriptions)
+
+    return subscriptions, total_eur
+
+
+class SubscriptionConverter:
+    """Advanced converter class for subscription data processing.
+
+    This class provides more control over the conversion process,
+    allowing you to reuse exchange rates and customize behavior.
+    """
+
+    def __init__(self, exchange_rate: Optional[float] = None):
+        """Initialize the converter.
+
+        Args:
+            exchange_rate: Optional exchange rate to use (will fetch if not provided)
+        """
+        self.exchange_rate = exchange_rate
+
+    def set_exchange_rate(self, rate: float):
+        """Set a custom exchange rate."""
+        self.exchange_rate = rate
+
+    def get_exchange_rate(self) -> float:
+        """Get the current exchange rate, fetching if necessary."""
+        if self.exchange_rate is None:
+            self.exchange_rate = fetch_exchange_rate()
+        return self.exchange_rate
+
+    def convert(self, content: Union[str, List[str]]) -> List[Dict[str, str]]:
+        """Convert subscription content to list of dictionaries.
+
+        Args:
+            content: Subscription data as string or list of lines
+
+        Returns:
+            List of subscription dictionaries
+        """
+        rate = self.get_exchange_rate()
+        return parse_subscription_data(content, rate)
+
+    def convert_to_csv(self, content: Union[str, List[str]], output_file: str) -> float:
+        """Convert subscription content and write to CSV file.
+
+        Args:
+            content: Subscription data as string or list of lines
+            output_file: Path to output CSV file
+
+        Returns:
+            Total EUR amount
+        """
+        subscriptions = self.convert(content)
+        return write_csv_file(subscriptions, output_file)
+
+    def convert_with_total(self, content: Union[str, List[str]]) -> Tuple[List[Dict[str, str]], float]:
+        """Convert subscription content and return data with total.
+
+        Args:
+            content: Subscription data as string or list of lines
+
+        Returns:
+            Tuple of (subscriptions_list, total_eur_amount)
+        """
+        subscriptions = self.convert(content)
+        total_eur = sum(float(sub['PriceEUR']) for sub in subscriptions)
+        return subscriptions, total_eur

subscriptions_to_csv-1.0.0.dist-info/METADATA

@@ -0,0 +1,331 @@
+Metadata-Version: 2.4
+Name: subscriptions-to-csv
+Version: 1.0.0
+Summary: Convert subscription lists to CSV with EUR conversion
+Author: Subscription Converter Team
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/MBanucu/subscriptions-to-csv
+Keywords: csv,subscriptions,eur,conversion,finance
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+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: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Utilities
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+
+# Subscriptions to CSV
+
+A Python package built as a Nix flake utility that provides both CLI and library functionality to convert subscription lists into CSV files with EUR conversions and totals. Includes comprehensive type hints, error handling, and a full test suite.
+
+## Description
+
+This tool processes subscription data (from files or strings) containing service names and prices, generates CSV output with columns for Service, Price, Currency, and Price in EUR (with automatic USD to EUR conversion), and calculates total sums in EUR.
+
+Available as both:
+- **Command-line tool**: Process files directly from the terminal
+- **Python library**: Import and use programmatically in your applications
+
+The project includes comprehensive unit tests covering all major functionality and supports PyPI distribution.
+
+## Installation
+
+### Option 1: PyPI (Library + CLI)
+
+```bash
+pip install subscriptions-to-csv
+```
+
+This installs both the command-line tool and Python library.
+
+### Option 2: Nix Flake (Development/Direct Usage)
+
+Ensure you have Nix installed with flakes enabled.
+
+#### Clone the Repository
+
+```bash
+git clone https://github.com/MBanucu/subscriptions-to-csv.git
+cd subscriptions-to-csv
+
+# Allow direnv to load the .envrc file (one-time setup)
+direnv allow
+```
+
+The project uses [direnv](https://direnv.net/) for automatic development environment loading. After running `direnv allow`, the Nix devShell will be automatically activated whenever you enter the directory.
+
+#### Direct from GitHub
+
+You can also use this flake directly from GitHub without cloning:
+
+```bash
+# Run with default files
+nix run github:MBanucu/subscriptions-to-csv#subscriptions-to-csv
+
+# Specify input and output files
+nix run github:MBanucu/subscriptions-to-csv#subscriptions-to-csv path/to/input.txt path/to/output.csv
+
+# Show help
+nix run github:MBanucu/subscriptions-to-csv#subscriptions-to-csv -- --help
+```
+
+This approach allows you to use the tool immediately without downloading the source code.
+
+**Note**: When using `nix run` directly from GitHub, use positional arguments for input/output files or the `--` separator before option flags. Both approaches work the same way. Options work normally when running locally after cloning.
+
+## Usage
+
+### CLI Usage
+
+#### Basic Usage
+
+```bash
+# Enter the development shell (or use direnv for automatic loading)
+nix develop
+
+# Run the converter
+subscriptions-to-csv
+```
+
+This will read `subscriptions.txt` and output `subscriptions.csv`.
+
+**Note**: If you have direnv installed, the development shell will be automatically activated when you enter the directory, making the `nix develop` step unnecessary.
+
+### Custom Files
+
+```bash
+# Specify input and output files (positional)
+nix run .#subscriptions-to-csv path/to/input.txt path/to/output.csv
+
+# Or using options
+nix run .#subscriptions-to-csv --input path/to/input.txt --output path/to/output.csv
+```
+
+### Direct Run
+
+```bash
+nix run .#subscriptions-to-csv
+```
+
+### Help
+
+```bash
+# Show usage information
+nix run .#subscriptions-to-csv -- --help
+```
+
+Note: The `--` separates nix arguments from application arguments.
+
+## Library Usage
+
+When installed via pip, you can use the package as a Python library:
+
+### Basic Usage
+
+```python
+from subscriptions_to_csv import convert_subscriptions
+
+# Convert from string data
+data = """Netflix
+$15.99 USD
+Spotify
+€9.99"""
+
+subscriptions, total = convert_subscriptions(data)
+print(f"Total: €{total:.2f}")
+for sub in subscriptions:
+    print(f"{sub['Service']}: {sub['Price']} {sub['Currency']} = €{sub['PriceEUR']}")
+```
+
+### Advanced Usage
+
+```python
+from subscriptions_to_csv import SubscriptionConverter, fetch_exchange_rate
+
+# Manual control over exchange rates
+converter = SubscriptionConverter()
+converter.set_exchange_rate(0.85)  # Set custom rate
+
+# Convert and get data
+subscriptions = converter.convert("Netflix\n$15.99 USD")
+total, count = converter.convert_with_total("Netflix\n$15.99 USD")
+
+# Write to CSV file
+converter.convert_to_csv("Netflix\n$15.99 USD", "output.csv")
+
+# Individual functions
+rate = fetch_exchange_rate()
+```
+
+## Input Format
+
+The input file should contain subscription data in the following format:
+
+```
+Service Name
+	Price Currency
+Service Name
+	Price Currency
+```
+
+Example:
+
+```
+Spotify
+	12.99 €
+Netflix
+	19.99 €
+GutHub Copilot Pro
+	$10.00 USD
+```
+
+Supported currencies: € (Euro), USD (automatically converted to EUR).
+
+## Output
+
+The output CSV contains:
+
+- **Service**: The subscription name
+- **Price**: The original price
+- **Currency**: The original currency
+- **PriceEUR**: The price in EUR (converted if necessary)
+
+Plus a total sum in EUR printed to the console.
+
+Example output:
+
+```
+Service,Price,Currency,PriceEUR
+Spotify,12.99,€,12.99
+Netflix,19.99,€,19.99
+GutHub Copilot Pro,10.00,USD,8.62
+Total in EUR: 41.60
+```
+
+## Configuration
+
+- **Input file**: Default `subscriptions.txt`, can be overridden with `--input` or positional argument
+- **Output file**: Default `subscriptions.csv`, can be overridden with `--output` or positional argument
+- **Exchange rate**: Automatically fetched from exchangerate-api.com
+- **Fallback**: If API fails, uses rate 1.0
+
+## Test Coverage
+
+The project includes comprehensive unit tests covering:
+- Command-line argument parsing (default, positional, optional)
+- Exchange rate API fetching with fallback behavior
+- Subscription data parsing and currency conversion
+- CSV file generation and total calculations
+- Integration testing of the full workflow
+
+## Requirements
+
+### CLI Usage
+- Nix with flakes support (for nix-based installation)
+- Internet connection for exchange rate fetching
+
+### Library Usage
+- Python 3.6+ (3.13 recommended)
+- pip for installation
+- Internet connection for exchange rate fetching
+
+## Development
+
+### Project Structure
+
+The project is structured as a proper Python package:
+
+- `flake.nix`: Nix flake configuration for multi-platform builds
+- `flake.lock`: Nix flake lock file
+- `.envrc`: Direnv configuration for automatic devShell loading
+- `pyproject.toml`: Python package configuration and build system
+- `subscriptions_to_csv/`: Main Python package
+  - `__init__.py`: Package initialization and exports
+  - `converter.py`: Core conversion functions and classes
+  - `cli.py`: Command-line interface
+- `tests/test_main.py`: Comprehensive unit test suite
+
+### Building
+
+Build the Python package:
+
+```bash
+nix build
+```
+
+This creates a proper Python package using `buildPythonPackage` that can be installed and distributed.
+
+### Testing
+
+Run the comprehensive test suite including CLI integration tests:
+
+```bash
+# Run unit tests (direnv automatically loads environment)
+pytest
+
+# Or manually enter devShell and run tests
+nix develop --command pytest
+
+# Run flake checks (includes CLI functionality tests)
+nix flake check
+
+# Run specific flake checks
+nix build .#checks.x86_64-linux.help-test
+nix build .#checks.x86_64-linux.basic-test
+nix build .#checks.x86_64-linux.named-args-test
+```
+
+The flake checks verify that:
+- The `--help` command works correctly
+- Basic functionality with sample data works
+- Positional and named arguments function properly
+
+### Testing
+
+```bash
+# Run the test suite (environment loads automatically with direnv)
+pytest
+
+# Or enter devShell manually
+nix develop
+pytest
+
+# Run specific tests
+pytest tests/test_main.py
+pytest -k "parse"  # Run tests matching pattern
+
+# Manual testing - Run with defaults
+nix run .#subscriptions-to-csv
+
+# Test CLI options
+nix run .#subscriptions-to-csv -- --help
+
+# Check the output CSV and total
+```
+
+### Code Style
+
+See AGENTS.md for detailed coding guidelines.
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make changes
+4. Run tests: `pytest` (direnv automatically loads the environment)
+5. Test CLI: `nix run .#subscriptions-to-csv -- --help`
+6. Test library: `python3 -c "from subscriptions_to_csv import convert_subscriptions; print('Library works')"`
+7. Submit a pull request
+
+## License
+
+This project is open source. Please check the license file if present.

subscriptions_to_csv-1.0.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+subscriptions_to_csv/__init__.py,sha256=aZiEm8F7jC9z_0KN3hJdhsH6lgA2Y58aermSenJJEY0,635
+subscriptions_to_csv/cli.py,sha256=etEm9R9BXlywSKD8YMRIMKGpOOroVF6SPbkhNRQOjbk,3267
+subscriptions_to_csv/converter.py,sha256=EZ8ziBxGFkJYyzOvtQEFLP5uP-SevPYa34-6X--x9JU,6739
+subscriptions_to_csv-1.0.0.dist-info/METADATA,sha256=kimiPYwOK1dRK3datpRgNY_5v7_2QgaI4XwwpDRyW8Y,9068
+subscriptions_to_csv-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+subscriptions_to_csv-1.0.0.dist-info/entry_points.txt,sha256=euesE9jMcLXw3mocwe4eGn0EVLoIurCg_nPc6lNaXkA,71
+subscriptions_to_csv-1.0.0.dist-info/top_level.txt,sha256=AxP-dG7UH18VV3vIIXuwPM9VWz3Lwxy4rhUNhsrEqN8,21
+subscriptions_to_csv-1.0.0.dist-info/RECORD,,

subscriptions_to_csv-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

subscriptions_to_csv-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+subscriptions-to-csv = subscriptions_to_csv.cli:main

subscriptions_to_csv-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+subscriptions_to_csv