dumont 0.1.0__tar.gz

dumont-0.1.0/PKG-INFO

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: dumont
+Version: 0.1.0
+Summary: Excel file generation tool with pivot tables
+Author: Dumont Developer
+License: MIT
+Project-URL: Homepage, https://github.com/example/dumont
+Project-URL: Repository, https://github.com/example/dumont
+Keywords: excel,pivot,pandas,xlwings,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: pandas>=1.5.0
+Requires-Dist: xlsxwriter>=3.0.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: openpyxl>=3.0.0
+Provides-Extra: xlwings
+Requires-Dist: xlwings>=0.30.0; extra == "xlwings"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+
+# Dumont
+
+Excel file generation tool with data sheets and pivot tables.
+
+## Installation
+
+```bash
+# Install with pip
+pip install -e .
+
+# Or install with xlwings support
+pip install -e ".[xlwings]"
+```
+
+## CLI Usage
+
+### Generate Excel with sample data
+
+```bash
+dumont generate -o sales_report.xlsx
+```
+
+### Generate from CSV/Excel input
+
+```bash
+dumont generate -i data.csv -o report.xlsx
+```
+
+### Customize pivot table
+
+```bash
+dumont generate -o report.xlsx \
+    --pivot-values Revenue \
+    --pivot-index Category \
+    --pivot-columns Region \
+    --aggfunc sum
+```
+
+### Use xlwings engine (requires Excel installed)
+
+```bash
+dumont generate -o report.xlsx --engine xlwings
+```
+
+### Preview sample data
+
+```bash
+dumont sample --rows 20
+```
+
+### Preview Excel file contents
+
+```bash
+dumont preview report.xlsx --sheet Data --rows 10
+```
+
+### Get file information
+
+```bash
+dumont info report.xlsx
+```
+
+## Python API Usage
+
+```python
+from dumont import create_excel_with_pivot, generate_sample_data
+import pandas as pd
+
+# Generate with sample data
+create_excel_with_pivot(
+    output_path="report.xlsx",
+    use_sample_data=True,
+    sample_rows=200,
+)
+
+# Use your own DataFrame
+df = pd.read_csv("my_data.csv")
+create_excel_with_pivot(
+    output_path="report.xlsx",
+    df=df,
+    pivot_values="Sales",
+    pivot_index="Product",
+    pivot_columns="Quarter",
+    pivot_aggfunc="sum",
+)
+
+# Use xlwings for native Excel features
+from dumont import create_excel_with_xlwings
+
+create_excel_with_xlwings(
+    output_path="report.xlsx",
+    use_sample_data=True,
+    visible=True,  # Show Excel during creation
+)
+```
+
+## Output Structure
+
+The generated Excel file contains:
+
+1. **Data Sheet**: Raw data with auto-fitted columns
+2. **Pivot Sheet**: Pivot table summarizing the data with margins/totals
+
+## Requirements
+
+- Python 3.8+
+- pandas
+- xlsxwriter
+- click
+- openpyxl
+- xlwings (optional, for advanced Excel features)

dumont-0.1.0/README.md

@@ -0,0 +1,111 @@
+# Dumont
+
+Excel file generation tool with data sheets and pivot tables.
+
+## Installation
+
+```bash
+# Install with pip
+pip install -e .
+
+# Or install with xlwings support
+pip install -e ".[xlwings]"
+```
+
+## CLI Usage
+
+### Generate Excel with sample data
+
+```bash
+dumont generate -o sales_report.xlsx
+```
+
+### Generate from CSV/Excel input
+
+```bash
+dumont generate -i data.csv -o report.xlsx
+```
+
+### Customize pivot table
+
+```bash
+dumont generate -o report.xlsx \
+    --pivot-values Revenue \
+    --pivot-index Category \
+    --pivot-columns Region \
+    --aggfunc sum
+```
+
+### Use xlwings engine (requires Excel installed)
+
+```bash
+dumont generate -o report.xlsx --engine xlwings
+```
+
+### Preview sample data
+
+```bash
+dumont sample --rows 20
+```
+
+### Preview Excel file contents
+
+```bash
+dumont preview report.xlsx --sheet Data --rows 10
+```
+
+### Get file information
+
+```bash
+dumont info report.xlsx
+```
+
+## Python API Usage
+
+```python
+from dumont import create_excel_with_pivot, generate_sample_data
+import pandas as pd
+
+# Generate with sample data
+create_excel_with_pivot(
+    output_path="report.xlsx",
+    use_sample_data=True,
+    sample_rows=200,
+)
+
+# Use your own DataFrame
+df = pd.read_csv("my_data.csv")
+create_excel_with_pivot(
+    output_path="report.xlsx",
+    df=df,
+    pivot_values="Sales",
+    pivot_index="Product",
+    pivot_columns="Quarter",
+    pivot_aggfunc="sum",
+)
+
+# Use xlwings for native Excel features
+from dumont import create_excel_with_xlwings
+
+create_excel_with_xlwings(
+    output_path="report.xlsx",
+    use_sample_data=True,
+    visible=True,  # Show Excel during creation
+)
+```
+
+## Output Structure
+
+The generated Excel file contains:
+
+1. **Data Sheet**: Raw data with auto-fitted columns
+2. **Pivot Sheet**: Pivot table summarizing the data with margins/totals
+
+## Requirements
+
+- Python 3.8+
+- pandas
+- xlsxwriter
+- click
+- openpyxl
+- xlwings (optional, for advanced Excel features)

dumont-0.1.0/dumont/__init__.py

@@ -0,0 +1,17 @@
+"""Dumont - Excel file generation tool with pivot tables."""
+
+__version__ = "0.1.0"
+
+from .core import (
+    create_excel_with_pivot,
+    create_data_sheet,
+    create_pivot_table,
+    generate_sample_data,
+)
+
+__all__ = [
+    "create_excel_with_pivot",
+    "create_data_sheet",
+    "create_pivot_table",
+    "generate_sample_data",
+]

dumont-0.1.0/dumont/cli.py

@@ -0,0 +1,260 @@
+"""Command-line interface for Dumont Excel generator."""
+
+import click
+from pathlib import Path
+from typing import Optional
+
+from .core import (
+    create_excel_with_pivot,
+    create_excel_with_xlwings,
+    generate_sample_data,
+    read_excel_to_dataframe,
+)
+
+
+@click.group()
+@click.version_option()
+def cli():
+    """Dumont - Excel file generation tool with pivot tables.
+
+    Generate Excel files with data and pivot table sheets using pandas and xlwings.
+    """
+    pass
+
+
+@cli.command()
+@click.option(
+    "-o", "--output",
+    type=click.Path(),
+    default="output.xlsx",
+    help="Output Excel file path (default: output.xlsx)",
+)
+@click.option(
+    "-i", "--input",
+    "input_file",
+    type=click.Path(exists=True),
+    help="Input CSV or Excel file to use as data source",
+)
+@click.option(
+    "--data-sheet",
+    default="Data",
+    help="Name for the data sheet (default: Data)",
+)
+@click.option(
+    "--pivot-sheet",
+    default="Pivot",
+    help="Name for the pivot sheet (default: Pivot)",
+)
+@click.option(
+    "--pivot-values",
+    default="Revenue",
+    help="Column to aggregate in pivot table (default: Revenue)",
+)
+@click.option(
+    "--pivot-index",
+    default="Category",
+    help="Row grouping column for pivot (default: Category)",
+)
+@click.option(
+    "--pivot-columns",
+    default="Region",
+    help="Column grouping for pivot (default: Region)",
+)
+@click.option(
+    "--aggfunc",
+    type=click.Choice(["sum", "mean", "count", "min", "max"]),
+    default="sum",
+    help="Aggregation function (default: sum)",
+)
+@click.option(
+    "--sample/--no-sample",
+    default=True,
+    help="Use sample data if no input file provided (default: True)",
+)
+@click.option(
+    "--rows",
+    type=int,
+    default=100,
+    help="Number of rows for sample data (default: 100)",
+)
+@click.option(
+    "--engine",
+    type=click.Choice(["pandas", "xlwings"]),
+    default="pandas",
+    help="Excel engine to use (default: pandas)",
+)
+@click.option(
+    "--visible",
+    is_flag=True,
+    help="Show Excel window during xlwings creation",
+)
+def generate(
+    output: str,
+    input_file: Optional[str],
+    data_sheet: str,
+    pivot_sheet: str,
+    pivot_values: str,
+    pivot_index: str,
+    pivot_columns: str,
+    aggfunc: str,
+    sample: bool,
+    rows: int,
+    engine: str,
+    visible: bool,
+):
+    """Generate an Excel file with data and pivot table sheets.
+
+    Examples:
+
+        # Generate with sample data
+        dumont generate -o sales_report.xlsx
+
+        # Use custom input file
+        dumont generate -i data.csv -o report.xlsx
+
+        # Customize pivot table
+        dumont generate -o report.xlsx --pivot-values Sales --pivot-index Product
+
+        # Use xlwings engine with visible Excel
+        dumont generate -o report.xlsx --engine xlwings --visible
+    """
+    df = None
+
+    if input_file:
+        click.echo(f"Reading data from: {input_file}")
+        input_path = Path(input_file)
+        if input_path.suffix.lower() == ".csv":
+            import pandas as pd
+            df = pd.read_csv(input_file)
+        else:
+            df = read_excel_to_dataframe(input_file)
+        click.echo(f"Loaded {len(df)} rows")
+
+    try:
+        if engine == "xlwings":
+            result_path = create_excel_with_xlwings(
+                output_path=output,
+                df=df,
+                data_sheet_name=data_sheet,
+                pivot_sheet_name=pivot_sheet,
+                pivot_values=pivot_values,
+                pivot_index=pivot_index,
+                pivot_columns=pivot_columns,
+                use_sample_data=sample and df is None,
+                sample_rows=rows,
+                visible=visible,
+            )
+        else:
+            result_path = create_excel_with_pivot(
+                output_path=output,
+                df=df,
+                data_sheet_name=data_sheet,
+                pivot_sheet_name=pivot_sheet,
+                pivot_values=pivot_values,
+                pivot_index=pivot_index,
+                pivot_columns=pivot_columns,
+                pivot_aggfunc=aggfunc,
+                use_sample_data=sample and df is None,
+                sample_rows=rows,
+            )
+
+        click.echo(f"Excel file created: {result_path}")
+        click.echo(f"  - Sheet '{data_sheet}': Raw data")
+        click.echo(f"  - Sheet '{pivot_sheet}': Pivot table ({pivot_values} by {pivot_index} x {pivot_columns})")
+
+    except Exception as e:
+        click.echo(f"Error: {e}", err=True)
+        raise click.Abort()
+
+
+@cli.command()
+@click.option(
+    "--rows",
+    type=int,
+    default=10,
+    help="Number of sample rows to show (default: 10)",
+)
+def sample(rows: int):
+    """Show sample data that would be generated.
+
+    Example:
+        dumont sample --rows 20
+    """
+    df = generate_sample_data(rows=rows)
+    click.echo("Sample data preview:")
+    click.echo(df.to_string(index=False))
+
+
+@cli.command()
+@click.argument("file", type=click.Path(exists=True))
+@click.option(
+    "--sheet",
+    help="Specific sheet to read",
+)
+@click.option(
+    "--rows",
+    type=int,
+    default=10,
+    help="Number of rows to display (default: 10)",
+)
+def preview(file: str, sheet: Optional[str], rows: int):
+    """Preview contents of an Excel file.
+
+    Example:
+        dumont preview report.xlsx --sheet Data --rows 20
+    """
+    import pandas as pd
+
+    try:
+        if sheet:
+            df = pd.read_excel(file, sheet_name=sheet)
+            click.echo(f"Sheet: {sheet}")
+        else:
+            xl = pd.ExcelFile(file)
+            click.echo(f"Available sheets: {', '.join(xl.sheet_names)}")
+            df = pd.read_excel(file, sheet_name=0)
+            click.echo(f"Showing first sheet: {xl.sheet_names[0]}")
+
+        click.echo(f"Shape: {df.shape[0]} rows x {df.shape[1]} columns")
+        click.echo()
+        click.echo(df.head(rows).to_string(index=False))
+
+    except Exception as e:
+        click.echo(f"Error reading file: {e}", err=True)
+        raise click.Abort()
+
+
+@cli.command()
+@click.argument("file", type=click.Path(exists=True))
+def info(file: str):
+    """Show information about an Excel file.
+
+    Example:
+        dumont info report.xlsx
+    """
+    import pandas as pd
+    from pathlib import Path
+
+    file_path = Path(file)
+    click.echo(f"File: {file_path.name}")
+    click.echo(f"Size: {file_path.stat().st_size / 1024:.1f} KB")
+
+    try:
+        xl = pd.ExcelFile(file)
+        click.echo(f"Sheets: {len(xl.sheet_names)}")
+
+        for sheet_name in xl.sheet_names:
+            df = pd.read_excel(xl, sheet_name=sheet_name)
+            click.echo(f"  - {sheet_name}: {df.shape[0]} rows x {df.shape[1]} columns")
+
+    except Exception as e:
+        click.echo(f"Error: {e}", err=True)
+
+
+def main():
+    """Entry point for the CLI."""
+    cli()
+
+
+if __name__ == "__main__":
+    main()

dumont-0.1.0/dumont/core.py

@@ -0,0 +1,289 @@
+"""Core Excel generation functions using pandas and xlwings."""
+
+import pandas as pd
+from pathlib import Path
+from typing import Optional, Union, List, Dict, Any
+from datetime import datetime, timedelta
+import random
+
+
+def generate_sample_data(rows: int = 100) -> pd.DataFrame:
+    """Generate sample sales data for demonstration purposes.
+
+    Args:
+        rows: Number of rows to generate.
+
+    Returns:
+        DataFrame with sample sales data.
+    """
+    random.seed(42)
+
+    categories = ["Electronics", "Clothing", "Food", "Books", "Home & Garden"]
+    regions = ["North", "South", "East", "West", "Central"]
+    products = {
+        "Electronics": ["Laptop", "Phone", "Tablet", "Headphones", "Camera"],
+        "Clothing": ["Shirt", "Pants", "Jacket", "Shoes", "Hat"],
+        "Food": ["Snacks", "Beverages", "Frozen", "Dairy", "Produce"],
+        "Books": ["Fiction", "Non-Fiction", "Technical", "Children", "Comics"],
+        "Home & Garden": ["Furniture", "Tools", "Decor", "Plants", "Lighting"],
+    }
+
+    data = []
+    base_date = datetime(2024, 1, 1)
+
+    for _ in range(rows):
+        category = random.choice(categories)
+        product = random.choice(products[category])
+        region = random.choice(regions)
+        date = base_date + timedelta(days=random.randint(0, 364))
+        quantity = random.randint(1, 50)
+        unit_price = round(random.uniform(10, 500), 2)
+        revenue = round(quantity * unit_price, 2)
+
+        data.append({
+            "Date": date,
+            "Category": category,
+            "Product": product,
+            "Region": region,
+            "Quantity": quantity,
+            "Unit_Price": unit_price,
+            "Revenue": revenue,
+        })
+
+    return pd.DataFrame(data)
+
+
+def create_data_sheet(
+    df: pd.DataFrame,
+    writer: pd.ExcelWriter,
+    sheet_name: str = "Data",
+    format_as_table: bool = True,
+) -> None:
+    """Write a DataFrame to an Excel sheet.
+
+    Args:
+        df: DataFrame to write.
+        writer: ExcelWriter object.
+        sheet_name: Name of the sheet.
+        format_as_table: Whether to format as Excel table.
+    """
+    df.to_excel(writer, sheet_name=sheet_name, index=False)
+
+    workbook = writer.book
+    worksheet = writer.sheets[sheet_name]
+
+    # Auto-adjust column widths
+    for idx, col in enumerate(df.columns):
+        max_length = max(
+            df[col].astype(str).map(len).max(),
+            len(str(col))
+        ) + 2
+        worksheet.set_column(idx, idx, min(max_length, 50))
+
+
+def create_pivot_table(
+    df: pd.DataFrame,
+    writer: pd.ExcelWriter,
+    sheet_name: str = "Pivot",
+    values: str = "Revenue",
+    index: Union[str, List[str]] = "Category",
+    columns: Optional[Union[str, List[str]]] = "Region",
+    aggfunc: str = "sum",
+) -> pd.DataFrame:
+    """Create a pivot table and write it to an Excel sheet.
+
+    Args:
+        df: Source DataFrame.
+        writer: ExcelWriter object.
+        sheet_name: Name of the pivot sheet.
+        values: Column to aggregate.
+        index: Row grouping column(s).
+        columns: Column grouping column(s).
+        aggfunc: Aggregation function ('sum', 'mean', 'count', etc.).
+
+    Returns:
+        The pivot table DataFrame.
+    """
+    pivot_df = pd.pivot_table(
+        df,
+        values=values,
+        index=index,
+        columns=columns,
+        aggfunc=aggfunc,
+        margins=True,
+        margins_name="Total",
+    )
+
+    # Round numeric values
+    pivot_df = pivot_df.round(2)
+
+    pivot_df.to_excel(writer, sheet_name=sheet_name)
+
+    workbook = writer.book
+    worksheet = writer.sheets[sheet_name]
+
+    # Auto-adjust column widths for pivot
+    for idx in range(len(pivot_df.columns) + 1):
+        worksheet.set_column(idx, idx, 15)
+
+    return pivot_df
+
+
+def create_excel_with_pivot(
+    output_path: Union[str, Path],
+    df: Optional[pd.DataFrame] = None,
+    data_sheet_name: str = "Data",
+    pivot_sheet_name: str = "Pivot",
+    pivot_values: str = "Revenue",
+    pivot_index: Union[str, List[str]] = "Category",
+    pivot_columns: Optional[Union[str, List[str]]] = "Region",
+    pivot_aggfunc: str = "sum",
+    use_sample_data: bool = False,
+    sample_rows: int = 100,
+) -> Path:
+    """Create an Excel file with a data sheet and a pivot table sheet.
+
+    Args:
+        output_path: Path for the output Excel file.
+        df: DataFrame to use. If None and use_sample_data is True, generates sample data.
+        data_sheet_name: Name of the data sheet.
+        pivot_sheet_name: Name of the pivot table sheet.
+        pivot_values: Column to aggregate in pivot.
+        pivot_index: Row grouping for pivot.
+        pivot_columns: Column grouping for pivot.
+        pivot_aggfunc: Aggregation function for pivot.
+        use_sample_data: Generate sample data if df is None.
+        sample_rows: Number of rows for sample data.
+
+    Returns:
+        Path to the created Excel file.
+    """
+    output_path = Path(output_path)
+
+    if df is None:
+        if use_sample_data:
+            df = generate_sample_data(rows=sample_rows)
+        else:
+            raise ValueError("Either provide a DataFrame or set use_sample_data=True")
+
+    with pd.ExcelWriter(output_path, engine="xlsxwriter") as writer:
+        # Create data sheet
+        create_data_sheet(df, writer, sheet_name=data_sheet_name)
+
+        # Create pivot table sheet
+        create_pivot_table(
+            df,
+            writer,
+            sheet_name=pivot_sheet_name,
+            values=pivot_values,
+            index=pivot_index,
+            columns=pivot_columns,
+            aggfunc=pivot_aggfunc,
+        )
+
+    return output_path
+
+
+def create_excel_with_xlwings(
+    output_path: Union[str, Path],
+    df: Optional[pd.DataFrame] = None,
+    data_sheet_name: str = "Data",
+    pivot_sheet_name: str = "Pivot",
+    pivot_values: str = "Revenue",
+    pivot_index: str = "Category",
+    pivot_columns: str = "Region",
+    use_sample_data: bool = False,
+    sample_rows: int = 100,
+    visible: bool = False,
+) -> Path:
+    """Create an Excel file using xlwings for more advanced features.
+
+    This function uses xlwings to interact with Excel directly,
+    enabling native Excel pivot tables and formatting.
+
+    Args:
+        output_path: Path for the output Excel file.
+        df: DataFrame to use.
+        data_sheet_name: Name of the data sheet.
+        pivot_sheet_name: Name of the pivot table sheet.
+        pivot_values: Column to aggregate in pivot.
+        pivot_index: Row grouping for pivot.
+        pivot_columns: Column grouping for pivot.
+        use_sample_data: Generate sample data if df is None.
+        sample_rows: Number of rows for sample data.
+        visible: Whether to show Excel during creation.
+
+    Returns:
+        Path to the created Excel file.
+    """
+    try:
+        import xlwings as xw
+    except ImportError:
+        raise ImportError("xlwings is required for this function. Install with: pip install xlwings")
+
+    output_path = Path(output_path)
+
+    if df is None:
+        if use_sample_data:
+            df = generate_sample_data(rows=sample_rows)
+        else:
+            raise ValueError("Either provide a DataFrame or set use_sample_data=True")
+
+    # Create workbook with xlwings
+    app = xw.App(visible=visible)
+    try:
+        wb = app.books.add()
+
+        # Add data sheet
+        data_sheet = wb.sheets[0]
+        data_sheet.name = data_sheet_name
+        data_sheet.range("A1").value = df
+
+        # Auto-fit columns
+        data_sheet.autofit()
+
+        # Add pivot sheet with pandas pivot (xlwings native pivot requires Excel COM)
+        pivot_df = pd.pivot_table(
+            df,
+            values=pivot_values,
+            index=pivot_index,
+            columns=pivot_columns,
+            aggfunc="sum",
+            margins=True,
+            margins_name="Total",
+        ).round(2)
+
+        pivot_sheet = wb.sheets.add(name=pivot_sheet_name, after=data_sheet)
+        pivot_sheet.range("A1").value = pivot_df
+        pivot_sheet.autofit()
+
+        # Format pivot table headers
+        header_range = pivot_sheet.range("A1").expand("right")
+        header_range.color = (66, 133, 244)  # Blue
+        header_range.font.color = (255, 255, 255)  # White
+        header_range.font.bold = True
+
+        # Save and close
+        wb.save(str(output_path))
+        wb.close()
+
+    finally:
+        app.quit()
+
+    return output_path
+
+
+def read_excel_to_dataframe(
+    file_path: Union[str, Path],
+    sheet_name: Optional[str] = None,
+) -> pd.DataFrame:
+    """Read an Excel file into a DataFrame.
+
+    Args:
+        file_path: Path to the Excel file.
+        sheet_name: Specific sheet to read. If None, reads first sheet.
+
+    Returns:
+        DataFrame with the Excel data.
+    """
+    return pd.read_excel(file_path, sheet_name=sheet_name)

dumont-0.1.0/dumont.egg-info/PKG-INFO

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: dumont
+Version: 0.1.0
+Summary: Excel file generation tool with pivot tables
+Author: Dumont Developer
+License: MIT
+Project-URL: Homepage, https://github.com/example/dumont
+Project-URL: Repository, https://github.com/example/dumont
+Keywords: excel,pivot,pandas,xlwings,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: pandas>=1.5.0
+Requires-Dist: xlsxwriter>=3.0.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: openpyxl>=3.0.0
+Provides-Extra: xlwings
+Requires-Dist: xlwings>=0.30.0; extra == "xlwings"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+
+# Dumont
+
+Excel file generation tool with data sheets and pivot tables.
+
+## Installation
+
+```bash
+# Install with pip
+pip install -e .
+
+# Or install with xlwings support
+pip install -e ".[xlwings]"
+```
+
+## CLI Usage
+
+### Generate Excel with sample data
+
+```bash
+dumont generate -o sales_report.xlsx
+```
+
+### Generate from CSV/Excel input
+
+```bash
+dumont generate -i data.csv -o report.xlsx
+```
+
+### Customize pivot table
+
+```bash
+dumont generate -o report.xlsx \
+    --pivot-values Revenue \
+    --pivot-index Category \
+    --pivot-columns Region \
+    --aggfunc sum
+```
+
+### Use xlwings engine (requires Excel installed)
+
+```bash
+dumont generate -o report.xlsx --engine xlwings
+```
+
+### Preview sample data
+
+```bash
+dumont sample --rows 20
+```
+
+### Preview Excel file contents
+
+```bash
+dumont preview report.xlsx --sheet Data --rows 10
+```
+
+### Get file information
+
+```bash
+dumont info report.xlsx
+```
+
+## Python API Usage
+
+```python
+from dumont import create_excel_with_pivot, generate_sample_data
+import pandas as pd
+
+# Generate with sample data
+create_excel_with_pivot(
+    output_path="report.xlsx",
+    use_sample_data=True,
+    sample_rows=200,
+)
+
+# Use your own DataFrame
+df = pd.read_csv("my_data.csv")
+create_excel_with_pivot(
+    output_path="report.xlsx",
+    df=df,
+    pivot_values="Sales",
+    pivot_index="Product",
+    pivot_columns="Quarter",
+    pivot_aggfunc="sum",
+)
+
+# Use xlwings for native Excel features
+from dumont import create_excel_with_xlwings
+
+create_excel_with_xlwings(
+    output_path="report.xlsx",
+    use_sample_data=True,
+    visible=True,  # Show Excel during creation
+)
+```
+
+## Output Structure
+
+The generated Excel file contains:
+
+1. **Data Sheet**: Raw data with auto-fitted columns
+2. **Pivot Sheet**: Pivot table summarizing the data with margins/totals
+
+## Requirements
+
+- Python 3.8+
+- pandas
+- xlsxwriter
+- click
+- openpyxl
+- xlwings (optional, for advanced Excel features)

dumont-0.1.0/dumont.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+dumont/__init__.py
+dumont/cli.py
+dumont/core.py
+dumont.egg-info/PKG-INFO
+dumont.egg-info/SOURCES.txt
+dumont.egg-info/dependency_links.txt
+dumont.egg-info/entry_points.txt
+dumont.egg-info/requires.txt
+dumont.egg-info/top_level.txt

dumont-0.1.0/dumont.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dumont-0.1.0/dumont.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dumont = dumont.cli:main

dumont-0.1.0/dumont.egg-info/requires.txt

@@ -0,0 +1,12 @@
+pandas>=1.5.0
+xlsxwriter>=3.0.0
+click>=8.0.0
+openpyxl>=3.0.0
+
+[dev]
+pytest>=7.0.0
+black>=23.0.0
+ruff>=0.1.0
+
+[xlwings]
+xlwings>=0.30.0

dumont-0.1.0/dumont.egg-info/top_level.txt

@@ -0,0 +1 @@
+dumont

dumont-0.1.0/pyproject.toml

@@ -0,0 +1,59 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dumont"
+version = "0.1.0"
+description = "Excel file generation tool with pivot tables"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "Dumont Developer"}
+]
+keywords = ["excel", "pivot", "pandas", "xlwings", "cli"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "pandas>=1.5.0",
+    "xlsxwriter>=3.0.0",
+    "click>=8.0.0",
+    "openpyxl>=3.0.0",
+]
+
+[project.optional-dependencies]
+xlwings = ["xlwings>=0.30.0"]
+dev = [
+    "pytest>=7.0.0",
+    "black>=23.0.0",
+    "ruff>=0.1.0",
+]
+
+[project.scripts]
+dumont = "dumont.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/example/dumont"
+Repository = "https://github.com/example/dumont"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["dumont*"]
+
+[tool.black]
+line-length = 100
+target-version = ["py38", "py39", "py310", "py311", "py312"]
+
+[tool.ruff]
+line-length = 100
+select = ["E", "F", "W", "I", "N"]

dumont-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+