@mseep/csv-editor 1.0.0

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,53 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: '[BUG] '
+labels: 'bug'
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Install CSV Editor with '...'
+2. Run command '....'
+3. Process CSV file '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Error message**
+```
+Paste the full error message here
+```
+
+**CSV file sample**
+If possible, provide a minimal CSV file that reproduces the issue:
+```csv
+header1,header2,header3
+value1,value2,value3
+```
+
+**Environment:**
+ - OS: [e.g. Ubuntu 22.04, macOS 13, Windows 11]
+ - Python version: [e.g. 3.11.0]
+ - CSV Editor version: [e.g. 1.0.1]
+ - Installation method: [e.g. pip install git+https://github.com/santoshray02/csv-editor.git]
+
+**MCP Configuration**
+If using with an AI assistant, please share your MCP configuration:
+```json
+{
+  "csv-editor": {
+    "command": "csv-editor",
+    "args": []
+  }
+}
+```
+
+**Additional context**
+Add any other context about the problem here.

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,38 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: 'enhancement'
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. 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.
+
+**Use case**
+Describe the specific use case for this feature:
+- What type of CSV operations would this enable?
+- How would this integrate with AI assistants?
+- What data analysis workflows would this support?
+
+**Example**
+If possible, provide an example of how this feature would work:
+
+```python
+# Example usage
+csv_editor.new_feature(
+    input_file="data.csv",
+    operation="your_feature",
+    parameters={"param1": "value1"}
+)
+```
+
+**Additional context**
+Add any other context, screenshots, or examples about the feature request here.

package/.github/workflows/deploy-docs.yml

@@ -0,0 +1,62 @@
+name: Deploy Docs to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - '.github/workflows/deploy-docs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: docs/package-lock.json
+
+      - name: Install dependencies
+        run: |
+          cd docs
+          npm ci
+
+      - name: Build website
+        run: |
+          cd docs
+          npm run build
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/build
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package/.github/workflows/publish-github.yml

@@ -0,0 +1,52 @@
+name: Publish to GitHub Packages
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:  # Allow manual triggering
+
+jobs:
+  publish-github:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    
+    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.11
+    
+    - name: Install dependencies
+      run: uv sync --dev
+    
+    - name: Build package
+      run: uv build
+    
+    - name: Check package
+      run: uv run twine check dist/*
+    
+    - name: Publish to GitHub Packages
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.GITHUB_TOKEN }}
+      run: |
+        # Configure for GitHub Packages
+        echo "Publishing to GitHub Packages..."
+        uv run twine upload --repository-url https://upload.pypi.org/legacy/ dist/*
+        
+    - name: Create GitHub Release Assets
+      uses: softprops/action-gh-release@v1
+      if: github.event_name == 'release'
+      with:
+        files: |
+          dist/*.whl
+          dist/*.tar.gz
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/publish.yml

@@ -0,0 +1,44 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:  # Allow manual triggering
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # Required for trusted publishing
+      contents: read
+    
+    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.11
+    
+    - name: Install dependencies
+      run: uv sync --dev
+    
+    - name: Build package
+      run: uv build
+    
+    - name: Check package
+      run: uv run twine check dist/*
+    
+    - name: Publish to Test PyPI
+      if: github.event_name == 'workflow_dispatch'
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        repository-url: https://test.pypi.org/legacy/
+        skip-existing: true
+    
+    - name: Publish to PyPI
+      if: github.event_name == 'release'
+      uses: pypa/gh-action-pypi-publish@release/v1

package/.github/workflows/test.yml

@@ -0,0 +1,32 @@
+name: test
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+jobs:
+  pytest:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b  # v8.1.0
+        with:
+          enable-cache: true
+
+      - name: Sync dependencies
+        run: uv sync --all-extras
+
+      - name: Run pytest
+        run: uv run pytest tests/ -v --tb=short

package/.pre-commit-config.yaml

@@ -0,0 +1,157 @@
+# Pre-commit hooks for code quality and consistency
+# Install: pip install pre-commit && pre-commit install
+# Run manually: pre-commit run --all-files
+# Update hooks: pre-commit autoupdate
+
+default_language_version:
+  python: python3.11
+
+repos:
+  # General file checks
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: check-added-large-files
+        args: ['--maxkb=1000']
+      - id: check-ast
+      - id: check-builtin-literals
+      - id: check-case-conflict
+      - id: check-docstring-first
+      - id: check-executables-have-shebangs
+      - id: check-json
+      - id: check-merge-conflict
+      - id: check-symlinks
+      - id: check-toml
+      - id: check-vcs-permalinks
+      - id: check-xml
+      - id: check-yaml
+        args: ['--unsafe']
+      - id: debug-statements
+      - id: detect-private-key
+      - id: end-of-file-fixer
+      - id: fix-byte-order-marker
+      - id: fix-encoding-pragma
+        args: ['--remove']
+      - id: mixed-line-ending
+        args: ['--fix=lf']
+      - id: name-tests-test
+        args: ['--pytest-test-first']
+      - id: trailing-whitespace
+
+  # Python code formatting with Black
+  - repo: https://github.com/psf/black
+    rev: 24.10.0
+    hooks:
+      - id: black
+        language_version: python3.11
+        args: ['--config', 'pyproject.toml']
+
+  # Python linting with Ruff (fast!)
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.7.4
+    hooks:
+      - id: ruff
+        args: ['--fix', '--exit-non-zero-on-fix']
+      - id: ruff-format
+
+  # Type checking with MyPy
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.13.0
+    hooks:
+      - id: mypy
+        additional_dependencies:
+          - pandas-stubs>=2.2.3
+          - types-aiofiles>=24.1.0
+          - types-tabulate>=0.9.0
+          - types-pytz>=2024.2
+        args: ['--config-file', 'pyproject.toml']
+        pass_filenames: false
+        args: ['src/']
+
+  # Security checks with Bandit
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.7.10
+    hooks:
+      - id: bandit
+        args: ['-r', 'src/', '-ll', '-x', 'tests/']
+
+  # Markdown formatting
+  - repo: https://github.com/igorshubovych/markdownlint-cli
+    rev: v0.43.0
+    hooks:
+      - id: markdownlint
+        args: ['--fix']
+
+  # YAML formatting
+  - repo: https://github.com/pre-commit/mirrors-prettier
+    rev: v4.0.0-alpha.8
+    hooks:
+      - id: prettier
+        types_or: [yaml, json]
+        exclude: ^(.*\.min\.(js|css)|package-lock\.json)$
+
+  # Check for outdated Python syntax
+  - repo: https://github.com/asottile/pyupgrade
+    rev: v3.19.0
+    hooks:
+      - id: pyupgrade
+        args: ['--py38-plus']
+
+  # Remove unused imports
+  - repo: https://github.com/PyCQA/autoflake
+    rev: v2.3.1
+    hooks:
+      - id: autoflake
+        args:
+          - --in-place
+          - --remove-all-unused-imports
+          - --remove-unused-variables
+          - --remove-duplicate-keys
+          - --ignore-init-module-imports
+
+  # Sort imports
+  - repo: https://github.com/PyCQA/isort
+    rev: 5.13.2
+    hooks:
+      - id: isort
+        args: ['--profile', 'black', '--line-length', '100']
+
+  # Docstring formatting
+  - repo: https://github.com/PyCQA/docformatter
+    rev: v1.7.5
+    hooks:
+      - id: docformatter
+        args:
+          - --in-place
+          - --wrap-summaries=100
+          - --wrap-descriptions=100
+
+  # Check for common security issues
+  - repo: https://github.com/Yelp/detect-secrets
+    rev: v1.5.0
+    hooks:
+      - id: detect-secrets
+        args: ['--baseline', '.secrets.baseline']
+
+  # License headers
+  - repo: https://github.com/Lucas-C/pre-commit-hooks
+    rev: v1.5.5
+    hooks:
+      - id: insert-license
+        files: \.py$
+        args:
+          - --license-filepath
+          - LICENSE
+          - --comment-style
+          - "#"
+        exclude: ^(tests/|examples/|__pycache__/)
+
+ci:
+  autofix_prs: true
+  autofix_commit_msg: |
+    [pre-commit.ci] auto fixes from pre-commit hooks
+
+    for more information, see https://pre-commit.ci
+  autoupdate_schedule: weekly
+  autoupdate_commit_msg: '[pre-commit.ci] pre-commit autoupdate'
+  skip: [mypy, bandit]  # These can be slow in CI

package/ALTERNATIVE_PUBLISHING.md

@@ -0,0 +1,175 @@
+# Alternative Publishing Strategy for CSV Editor
+
+Since the name `csv-editor` conflicts with existing PyPI packages, we'll use alternative distribution methods while keeping our preferred name.
+
+## 🎯 Publishing Strategy
+
+### 1. **GitHub Releases** (Primary Distribution)
+- **Direct downloads** of wheel and source files
+- **Easy installation** via pip from GitHub
+- **No naming conflicts**
+
+**Installation**:
+```bash
+# Install directly from GitHub
+pip install git+https://github.com/santoshray02/csv-editor.git
+
+# Or using uv
+uv pip install git+https://github.com/santoshray02/csv-editor.git
+
+# Install specific version
+pip install git+https://github.com/santoshray02/csv-editor.git@v1.0.1
+```
+
+### 2. **GitHub Packages** (Python Package Registry)
+- **GitHub's package registry**
+- **Integrated with repository**
+- **Professional distribution**
+
+**Setup**:
+```bash
+# Configure pip for GitHub Packages
+pip config set global.extra-index-url https://pypi.pkg.github.com/santoshray02/
+```
+
+### 3. **Conda-Forge** (Future)
+- **Popular in data science community**
+- **Better for scientific Python packages**
+- **No naming conflicts typically**
+
+### 4. **Alternative Package Indices**
+- **fury.io** - Private package hosting
+- **gemfury.com** - Package hosting service
+- **devpi** - Self-hosted PyPI server
+
+## 🚀 Current Publishing Workflow
+
+### Manual Publishing
+```bash
+# Build package
+uv build
+
+# Publish to GitHub Releases (manual)
+# 1. Go to https://github.com/santoshray02/csv-editor/releases
+# 2. Create new release with tag v1.0.1
+# 3. Upload dist/*.whl and dist/*.tar.gz files
+
+# Or use GitHub CLI
+gh release create v1.0.1 dist/*.whl dist/*.tar.gz --title "CSV Editor v1.0.1" --notes-file CHANGELOG.md
+```
+
+### Automated Publishing
+- **GitHub Actions** automatically publishes on release
+- **Creates release assets** with wheel and source files
+- **No manual intervention needed**
+
+## 📦 Installation Methods for Users
+
+### Method 1: Direct from GitHub (Recommended)
+```bash
+pip install git+https://github.com/santoshray02/csv-editor.git
+```
+
+### Method 2: Download and Install
+```bash
+# Download from releases page
+wget https://github.com/santoshray02/csv-editor/releases/download/v1.0.1/csv_editor-1.0.1-py3-none-any.whl
+pip install csv_editor-1.0.1-py3-none-any.whl
+```
+
+### Method 3: Clone and Install
+```bash
+git clone https://github.com/santoshray02/csv-editor.git
+cd csv-editor
+pip install -e .
+```
+
+## 🌟 Promotion Strategy
+
+### 1. **GitHub Community**
+- **GitHub Topics**: Add relevant tags to repository
+- **Awesome Lists**: Submit to awesome-python, awesome-mcp lists
+- **GitHub Trending**: Optimize for discovery
+
+### 2. **Documentation Sites**
+- **Read the Docs**: Host comprehensive documentation
+- **GitHub Pages**: Create project website
+- **MCP Documentation**: Get listed in official MCP tools
+
+### 3. **Community Platforms**
+- **Reddit**: r/Python, r/MachineLearning, r/datascience
+- **Discord/Slack**: MCP community, Python communities
+- **Stack Overflow**: Answer questions, mention tool when relevant
+
+### 4. **Blog Posts and Articles**
+- **Dev.to**: Technical tutorials
+- **Medium**: Deep-dive articles
+- **Personal blog**: Case studies and examples
+
+## 📈 Advantages of This Approach
+
+### ✅ **Benefits**
+- **Keep preferred name** (`csv-editor`)
+- **No naming conflicts**
+- **Direct GitHub integration**
+- **Professional appearance**
+- **Easy version management**
+- **Automatic CI/CD**
+
+### ✅ **User Benefits**
+- **Simple installation** from GitHub
+- **Always latest version** available
+- **Clear release notes**
+- **Direct access to source**
+- **Issue tracking integration**
+
+## 🔄 Future Migration to PyPI
+
+If we want to publish to PyPI later:
+
+### Option 1: **Request Name Release**
+- Contact current `csv-editor` package owner
+- Request name transfer if package is abandoned
+
+### Option 2: **Alternative Names**
+- `csv-mcp-editor`
+- `mcp-csv-editor` 
+- `csv-editor-mcp`
+- `fastmcp-csv`
+
+### Option 3: **Namespace Package**
+- `santoshray02-csv-editor`
+- Use personal/org namespace
+
+## 📊 Success Metrics
+
+### Short-term (1-3 months):
+- [ ] 100+ GitHub stars
+- [ ] 50+ direct installations
+- [ ] 10+ community issues/discussions
+- [ ] Featured in MCP documentation
+
+### Medium-term (3-6 months):
+- [ ] 500+ GitHub stars
+- [ ] 200+ installations
+- [ ] 5+ contributors
+- [ ] Conda-forge package
+- [ ] Read the Docs site
+
+### Long-term (6+ months):
+- [ ] 1000+ GitHub stars
+- [ ] 1000+ installations
+- [ ] Active community
+- [ ] PyPI package (if name becomes available)
+- [ ] Conference presentations
+
+## 🎉 Getting Started
+
+1. **Push current changes** to GitHub
+2. **Create first release** (v1.0.1)
+3. **Update README** with installation instructions
+4. **Announce on social media**
+5. **Submit to awesome lists**
+6. **Engage with MCP community**
+
+This approach gives you full control over your package name and distribution while building a strong community around your project!