linkedin2md 0.1.0__tar.gz

linkedin2md-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,35 @@
+---
+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. Run command '...'
+2. With file '...'
+3. See error
+
+## Expected behavior
+A clear and concise description of what you expected to happen.
+
+## Error output
+```
+Paste the error message here
+```
+
+## Environment
+- OS: [e.g., Ubuntu 22.04, macOS 14, Windows 11]
+- Python version: [e.g., 3.13.0]
+- linkedin2md version: [e.g., 0.1.0]
+
+## Sample data
+If possible, provide a minimal example of the CSV data that causes the issue (please anonymize any personal information).
+
+## Additional context
+Add any other context about the problem here.

linkedin2md-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,24 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+## Is your feature request related to a problem?
+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.
+
+## Additional context
+Add any other context or screenshots about the feature request here.
+
+## Would you be willing to contribute this feature?
+- [ ] Yes, I'd like to submit a PR
+- [ ] I can help with testing
+- [ ] No, I'm just suggesting

linkedin2md-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,25 @@
+## Description
+Brief description of the changes in this PR.
+
+## Related Issue
+Fixes #(issue number)
+
+## Type of Change
+- [ ] Bug fix (non-breaking change that fixes an issue)
+- [ ] New feature (non-breaking change that adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+
+## Checklist
+- [ ] My code follows the project's style guidelines
+- [ ] I have run `ruff check .` and `ruff format .`
+- [ ] I have run `pyright` with no errors
+- [ ] I have added tests that prove my fix/feature works
+- [ ] I have run `pytest` and all tests pass
+- [ ] I have updated documentation as needed
+
+## Testing
+Describe how you tested these changes.
+
+## Screenshots (if applicable)
+Add screenshots to help explain your changes.

linkedin2md-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,39 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.13"]
+
+    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 dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Lint with ruff
+        run: |
+          ruff check .
+          ruff format --check .
+
+      - name: Type check with pyright
+        run: pyright
+        continue-on-error: true # Pre-existing type issues to be addressed later
+
+      - name: Run tests
+        run: pytest -v

linkedin2md-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,47 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # Required for trusted publishing
+
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

linkedin2md-0.1.0/.gitignore

@@ -0,0 +1,87 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Linting / Type checking
+.ruff_cache/
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyright/
+pyrightconfig.json
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# macOS
+.DS_Store
+
+# Output directories (for testing)
+linkedin_export/
+output/

linkedin2md-0.1.0/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2025-01-20
+
+### Added
+- Initial release
+- Convert LinkedIn data exports (ZIP) to Markdown files
+- Support for 40+ data categories:
+  - Profile (name, title, contact, summary)
+  - Experience and education
+  - Skills and certifications
+  - Recommendations and endorsements
+  - LinkedIn Learning history
+  - Connections and network
+  - Posts, comments, and reactions
+  - Job applications and saved jobs
+  - Activity history (searches, logins)
+  - Advertising and privacy data
+- Bilingual support (English and Spanish)
+- CLI with customizable output directory
+- SOLID architecture for extensibility
+- Security features (path traversal protection, URL sanitization, file size limits)
+
+[Unreleased]: https://github.com/juanmanueldaza/linkedin2md/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/juanmanueldaza/linkedin2md/releases/tag/v0.1.0

linkedin2md-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,55 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior:
+
+* The use of sexualized language or imagery and unwelcome sexual attention
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information without explicit permission
+* Other conduct which could reasonably be considered inappropriate
+
+## Enforcement Responsibilities
+
+Project maintainers are responsible for clarifying and enforcing standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the project maintainer at juanmanueldaza@gmail.com.
+
+All complaints will be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+[homepage]: https://www.contributor-covenant.org

linkedin2md-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,105 @@
+# Contributing to linkedin2md
+
+Thank you for your interest in contributing to linkedin2md! This document provides guidelines and instructions for contributing.
+
+## Development Setup
+
+1. **Clone the repository**
+   ```bash
+   git clone https://github.com/juanmanueldaza/linkedin2md.git
+   cd linkedin2md
+   ```
+
+2. **Create a virtual environment**
+   ```bash
+   python -m venv .venv
+   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+   ```
+
+3. **Install development dependencies**
+   ```bash
+   pip install -e ".[dev]"
+   ```
+
+## Code Style
+
+This project uses:
+- **Ruff** for linting and formatting
+- **Pyright** for type checking
+- Line length: 88 characters
+- Target: Python 3.13+
+
+Run checks before submitting:
+```bash
+ruff check .
+ruff format .
+pyright
+pytest
+```
+
+## Architecture
+
+The project follows SOLID principles:
+
+- **Single Responsibility**: Each parser/formatter handles one section
+- **Open/Closed**: Add new parsers via `@register_parser` decorator
+- **Liskov Substitution**: All parsers implement `SectionParser` protocol
+- **Interface Segregation**: Focused protocols for each component
+- **Dependency Inversion**: Converter depends on protocols, not implementations
+
+### Adding a New Parser
+
+1. Create a file in `src/linkedin2md/parsers/`
+2. Implement the `SectionParser` protocol
+3. Use `@register_parser` decorator
+4. Create matching formatter in `src/linkedin2md/formatters/`
+
+Example:
+```python
+from linkedin2md.parsers.base import BaseParser
+from linkedin2md.registry import register_parser
+
+@register_parser
+class MyNewParser(BaseParser):
+    section_key = "my_section"
+    csv_files = ["MyData.csv"]
+    
+    def parse(self, data: dict) -> list:
+        # Parse logic here
+        return []
+```
+
+## Pull Request Process
+
+1. **Fork the repository** and create your branch from `main`
+2. **Write tests** for new functionality
+3. **Update documentation** if needed
+4. **Ensure all checks pass** (ruff, pyright, pytest)
+5. **Submit a PR** with a clear description
+
+### PR Checklist
+
+- [ ] Code follows the project style
+- [ ] Tests added/updated
+- [ ] Documentation updated (if applicable)
+- [ ] All CI checks pass
+
+## Reporting Bugs
+
+When reporting bugs, please include:
+- Python version
+- Operating system
+- Steps to reproduce
+- Expected vs actual behavior
+- Sample data (if possible, anonymized)
+
+## Feature Requests
+
+Feature requests are welcome! Please:
+- Check existing issues first
+- Describe the use case
+- Explain why it would benefit others
+
+## Questions?
+
+Feel free to open an issue for questions or discussions.

linkedin2md-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Juan Manuel Daza
+
+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.

linkedin2md-0.1.0/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: linkedin2md
+Version: 0.1.0
+Summary: Convert LinkedIn data exports to Markdown
+Project-URL: Homepage, https://github.com/juanmanueldaza/linkedin2md
+Project-URL: Repository, https://github.com/juanmanueldaza/linkedin2md
+Project-URL: Issues, https://github.com/juanmanueldaza/linkedin2md/issues
+Author-email: Juan Manuel Daza <juanmanueldaza@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: cv,export,linkedin,markdown,parser,resume
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Text Processing :: Markup :: Markdown
+Classifier: Topic :: Utilities
+Requires-Python: >=3.13
+Provides-Extra: dev
+Requires-Dist: pytest>=9.0; extra == 'dev'
+Requires-Dist: ruff>=0.9; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# linkedin2md
+
+[![PyPI version](https://img.shields.io/pypi/v/linkedin2md)](https://pypi.org/project/linkedin2md/)
+[![Python versions](https://img.shields.io/pypi/pyversions/linkedin2md)](https://pypi.org/project/linkedin2md/)
+[![License](https://img.shields.io/pypi/l/linkedin2md)](https://github.com/juanmanueldaza/linkedin2md/blob/main/LICENSE)
+[![CI](https://github.com/juanmanueldaza/linkedin2md/actions/workflows/ci.yml/badge.svg)](https://github.com/juanmanueldaza/linkedin2md/actions/workflows/ci.yml)
+
+Convert LinkedIn data exports to clean Markdown files.
+
+## Installation
+
+```bash
+pip install linkedin2md
+```
+
+## Usage
+
+```bash
+linkedin2md Complete_LinkedInDataExport.zip
+linkedin2md export.zip -o ./my-profile
+linkedin2md export.zip --lang es
+```
+
+### Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `source` | LinkedIn ZIP export file (required) | - |
+| `-o, --output` | Output directory | `linkedin_export` |
+| `--lang` | Output language (`en` or `es`) | `en` |
+
+## How to Export Your LinkedIn Data
+
+Follow these steps to download your LinkedIn data:
+
+1. **Go to Settings**: Log into LinkedIn, click your profile photo in the top right, then select **"Settings & Privacy"**
+
+2. **Navigate to Data Privacy**: In the left sidebar, click **"Data privacy"**
+
+3. **Request your data**: Click **"Get a copy of your data"**
+
+4. **Select data to download**: 
+   - Choose **"Download larger data archive"** for complete data
+   - Or select specific categories if you only need certain data
+
+5. **Request archive**: Click **"Request archive"**
+
+6. **Wait for email**: LinkedIn will process your request and send an email when ready (usually within 24 hours, sometimes up to 72 hours for large archives)
+
+7. **Download the ZIP file**: Click the download link in the email. The file will be named something like `Complete_LinkedInDataExport_01-20-2025.zip`
+
+> **Note**: The download link expires after a few days. Download it promptly and store it safely.
+
+## Output
+
+Creates markdown files in the output directory, organized by category:
+
+### Core Profile
+- `profile.md` - Name, title, contact, summary
+- `experience.md` - Work history with achievements
+- `education.md` - Educational background
+- `skills.md` - Professional skills
+- `certifications.md` - Certifications and licenses
+- `languages.md` - Language proficiencies
+- `projects.md` - Personal and professional projects
+
+### Recommendations & Endorsements
+- `recommendations.md` - Recommendations received
+- `endorsements.md` - Skill endorsements received
+
+### Learning
+- `learning.md` - LinkedIn Learning courses
+- `learning_reviews.md` - Course reviews and ratings
+
+### Network
+- `connections.md` - Your connections
+- `companies_followed.md` - Companies you follow
+- `members_followed.md` - People you follow
+- `invitations.md` - Connection invitations sent/received
+- `imported_contacts.md` - Contacts imported from address book
+
+### Content & Activity
+- `posts.md` - Your posts and shares
+- `comments.md` - Comments you made
+- `reactions.md` - Likes and reactions
+- `reposts.md` - Content you reposted
+- `votes.md` - Poll votes
+- `saved_items.md` - Bookmarked content
+- `events.md` - Events attended
+
+### Job Search
+- `job_applications.md` - All job applications
+- `saved_jobs.md` - Jobs you saved
+- `job_preferences.md` - Job seeker preferences
+- `saved_job_answers.md` - Saved application answers
+- `screening_responses.md` - Screening question responses
+- `saved_job_alerts.md` - Job alert settings
+
+### Activity History
+- `search_queries.md` - Search history
+- `logins.md` - Login history
+- `security_challenges.md` - Security verification events
+
+### Advertising & Privacy
+- `ads_clicked.md` - Ads you clicked
+- `ad_targeting.md` - How LinkedIn targets ads to you
+- `lan_ads.md` - LinkedIn Audience Network engagement
+- `inferences.md` - LinkedIn's inferences about you
+
+### Payments
+- `receipts.md` - Premium subscription receipts
+
+### Services Marketplace
+- `service_engagements.md` - Service provider engagements
+- `service_opportunities.md` - Service opportunities
+
+### Identity
+- `verifications.md` - Identity verifications
+- `identity_assets.md` - Uploaded documents (resumes, etc.)
+
+## Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT - see [LICENSE](LICENSE) for details.