pyveil 0.1.0__tar.gz

pyveil-0.1.0/CLAUDE.md

@@ -0,0 +1,67 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Veil is a Python library for masking sensitive data (PII) - emails, phones, names, and more. The library is in early development stage.
+
+## Project Setup
+
+This project uses Python 3.11+ with a virtual environment:
+- Virtual environment: `.venv/` (already created)
+- License: MIT
+- Python environment management appears to use standard venv
+
+## Expected Architecture
+
+Since this is a PII masking library, the typical structure should include:
+- Core masking functions for different data types (email, phone, names, etc.)
+- Pattern detection/recognition for identifying PII in text
+- Configurable masking strategies (partial masking, full masking, tokenization)
+- Support for different locales/regions (phone formats, name patterns vary by country)
+
+## Development Guidelines
+
+### PII Masking Considerations
+- Ensure masking is irreversible unless explicitly designed for reversible tokenization
+- Support both in-place masking and returning masked copies
+- Consider performance for large-scale text processing
+- Handle edge cases (malformed emails, international phone formats, etc.)
+- Provide clear documentation about what constitutes "masked" vs "anonymized" data
+
+### Testing Requirements
+- Test with diverse PII formats across different locales
+- Include negative tests (text without PII should remain unchanged)
+- Test performance with large inputs
+- Verify no PII leakage in edge cases
+
+### Security Considerations
+- Never log or expose unmasked PII during processing
+- Ensure no PII appears in error messages or stack traces
+- If implementing reversible masking, secure the key management
+
+### Project Structure
+
+veil/
+├── veil/                      # 메인 패키지 (내용 비움)
+│   ├── __init__.py           # __version__ = "0.1.0"만 유지
+│   ├── masker.py             # docstring만 유지
+│   ├── patterns.py           # docstring만 유지
+│   └── utils.py              # docstring만 유지
+├── tests/                     # 테스트 (내용 비움)
+│   ├── __init__.py
+│   ├── test_masker.py
+│   ├── test_patterns.py
+│   └── test_utils.py
+├── examples/                  # 예제 (내용 비움)
+│   └── basic_usage.py
+├── docs/
+│   └── README.md
+├── pyproject.toml            # PyPI 설정 유지
+├── setup.py                  # 호환성 파일 유지
+├── MANIFEST.in               # 배포 설정 유지
+├── README.md                 # 프로젝트 README 유지
+├── LICENSE                   # MIT 라이선스 유지
+├── CLAUDE.md                 # AI 가이드 유지
+└── .gitignore               # Git 설정 유지

pyveil-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Hyeon Sang Jeon 
+
+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.

pyveil-0.1.0/MANIFEST.in

@@ -0,0 +1,19 @@
+# Include documentation
+include README.md
+include LICENSE
+include CLAUDE.md
+
+# Include examples
+recursive-include examples *.py
+
+# Include tests
+recursive-include tests *.py
+
+# Include docs
+recursive-include docs *.md
+
+# Exclude unnecessary files
+global-exclude __pycache__
+global-exclude *.py[cod]
+global-exclude .DS_Store
+global-exclude *.so

pyveil-0.1.0/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: pyveil
+Version: 0.1.0
+Summary: A Python library for masking sensitive data (PII) - emails, phones, names, and more
+Author-email: Hyeon Sang Jeon <your.email@example.com>
+Maintainer-email: Hyeon Sang Jeon <your.email@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/pyveil
+Project-URL: Documentation, https://github.com/yourusername/pyveil#readme
+Project-URL: Repository, https://github.com/yourusername/pyveil
+Project-URL: Issues, https://github.com/yourusername/pyveil/issues
+Project-URL: Changelog, https://github.com/yourusername/pyveil/releases
+Keywords: pii,privacy,masking,data-protection,security,anonymization,sensitive-data,gdpr,compliance
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+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
+Classifier: Topic :: Security
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-cov>=4.0.0; extra == "test"
+Dynamic: license-file
+
+# pyveil 🎭
+
+A Python library for masking sensitive data (PII) - emails, phones, names, and more
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+
+## Overview
+
+pyveil helps protect sensitive information by detecting and masking various types of personally identifiable information (PII) in text data. Whether you're handling logs, user data, or any text containing sensitive information, PyVeil provides flexible and easy-to-use tools to protect privacy.
+
+## Features

pyveil-0.1.0/README.md

@@ -0,0 +1,12 @@
+# pyveil 🎭
+
+A Python library for masking sensitive data (PII) - emails, phones, names, and more
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+
+## Overview
+
+pyveil helps protect sensitive information by detecting and masking various types of personally identifiable information (PII) in text data. Whether you're handling logs, user data, or any text containing sensitive information, PyVeil provides flexible and easy-to-use tools to protect privacy.
+
+## Features

pyveil-0.1.0/docs/README.md

@@ -0,0 +1,13 @@
+# pyveil Documentation
+
+## Overview
+
+pyveil is a Python library designed to mask sensitive personally identifiable information (PII) in text data. It helps protect privacy by detecting and masking various types of sensitive information including emails, phone numbers, credit cards, SSNs, IP addresses, and names.
+
+## Installation
+
+```bash
+pip install veil
+```
+
+## Quick Start

pyveil-0.1.0/examples/basic_usage.py

@@ -0,0 +1 @@
+"""Basic usage examples for the veil library."""

pyveil-0.1.0/pyproject.toml

@@ -0,0 +1,159 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pyveil"
+version = "0.1.0"
+description = "A Python library for masking sensitive data (PII) - emails, phones, names, and more"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "Hyeon Sang Jeon", email = "your.email@example.com"}
+]
+maintainers = [
+    {name = "Hyeon Sang Jeon", email = "your.email@example.com"}
+]
+keywords = [
+    "pii",
+    "privacy",
+    "masking",
+    "data-protection",
+    "security",
+    "anonymization",
+    "sensitive-data",
+    "gdpr",
+    "compliance"
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "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",
+    "Topic :: Security",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Text Processing",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "black>=23.0.0",
+    "ruff>=0.1.0",
+    "mypy>=1.0.0",
+]
+test = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/yourusername/pyveil"
+Documentation = "https://github.com/yourusername/pyveil#readme"
+Repository = "https://github.com/yourusername/pyveil"
+Issues = "https://github.com/yourusername/pyveil/issues"
+Changelog = "https://github.com/yourusername/pyveil/releases"
+
+[tool.setuptools]
+packages = ["pyveil"]
+
+[tool.setuptools.package-data]
+pyveil = ["py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = [
+    "--verbose",
+    "--cov=pyveil",
+    "--cov-report=term-missing",
+    "--cov-report=html",
+]
+
+[tool.black]
+line-length = 100
+target-version = ["py38", "py39", "py310", "py311", "py312"]
+include = '\.pyi?$'
+extend-exclude = '''
+/(
+  # directories
+  \.eggs
+  | \.git
+  | \.hg
+  | \.mypy_cache
+  | \.tox
+  | \.venv
+  | build
+  | dist
+)/
+'''
+
+[tool.ruff]
+line-length = 100
+target-version = "py38"
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+]
+ignore = [
+    "E501",  # line too long, handled by black
+    "B008",  # do not perform function calls in argument defaults
+    "C901",  # too complex
+]
+
+[tool.ruff.per-file-ignores]
+"__init__.py" = ["F401"]
+
+[tool.mypy]
+python_version = "3.8"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+follow_imports = "normal"
+strict_optional = true
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+disallow_untyped_defs = false
+
+[tool.coverage.run]
+source = ["pyveil"]
+omit = [
+    "*/tests/*",
+    "*/test_*.py",
+]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+    "class .*\\bProtocol\\):",
+    "@(abc\\.)?abstractmethod",
+]

pyveil-0.1.0/pyveil/__init__.py

@@ -0,0 +1,5 @@
+"""Veil - A Python library for masking sensitive data (PII)"""
+
+__version__ = "0.1.0"
+__author__ = "Hyeon Sang Jeon"
+__license__ = "MIT"

pyveil-0.1.0/pyveil/masker.py

@@ -0,0 +1 @@
+"""Core masking functionality for PII data."""

pyveil-0.1.0/pyveil/patterns.py

@@ -0,0 +1 @@
+"""Pattern definitions for detecting various types of PII in text."""

pyveil-0.1.0/pyveil/utils.py

@@ -0,0 +1 @@
+"""Utility functions for the veil package."""

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

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: pyveil
+Version: 0.1.0
+Summary: A Python library for masking sensitive data (PII) - emails, phones, names, and more
+Author-email: Hyeon Sang Jeon <your.email@example.com>
+Maintainer-email: Hyeon Sang Jeon <your.email@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/pyveil
+Project-URL: Documentation, https://github.com/yourusername/pyveil#readme
+Project-URL: Repository, https://github.com/yourusername/pyveil
+Project-URL: Issues, https://github.com/yourusername/pyveil/issues
+Project-URL: Changelog, https://github.com/yourusername/pyveil/releases
+Keywords: pii,privacy,masking,data-protection,security,anonymization,sensitive-data,gdpr,compliance
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+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
+Classifier: Topic :: Security
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-cov>=4.0.0; extra == "test"
+Dynamic: license-file
+
+# pyveil 🎭
+
+A Python library for masking sensitive data (PII) - emails, phones, names, and more
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+
+## Overview
+
+pyveil helps protect sensitive information by detecting and masking various types of personally identifiable information (PII) in text data. Whether you're handling logs, user data, or any text containing sensitive information, PyVeil provides flexible and easy-to-use tools to protect privacy.
+
+## Features

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

@@ -0,0 +1,21 @@
+CLAUDE.md
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+docs/README.md
+examples/basic_usage.py
+pyveil/__init__.py
+pyveil/masker.py
+pyveil/patterns.py
+pyveil/utils.py
+pyveil.egg-info/PKG-INFO
+pyveil.egg-info/SOURCES.txt
+pyveil.egg-info/dependency_links.txt
+pyveil.egg-info/requires.txt
+pyveil.egg-info/top_level.txt
+tests/__init__.py
+tests/test_masker.py
+tests/test_patterns.py
+tests/test_utils.py

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,11 @@
+
+[dev]
+pytest>=7.0.0
+pytest-cov>=4.0.0
+black>=23.0.0
+ruff>=0.1.0
+mypy>=1.0.0
+
+[test]
+pytest>=7.0.0
+pytest-cov>=4.0.0

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

@@ -0,0 +1 @@
+pyveil

pyveil-0.1.0/setup.cfg

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

pyveil-0.1.0/setup.py

@@ -0,0 +1,12 @@
+"""
+Setup script for backward compatibility.
+
+For modern installation, use pyproject.toml.
+This file is kept for compatibility with older tools.
+"""
+
+from setuptools import setup
+
+# All configuration is in pyproject.toml
+# This file is here for compatibility with tools that don't support PEP 621
+setup()

pyveil-0.1.0/tests/__init__.py

@@ -0,0 +1 @@
+"""Tests for the veil package."""

pyveil-0.1.0/tests/test_masker.py

@@ -0,0 +1 @@
+"""Tests for the masker module."""

pyveil-0.1.0/tests/test_patterns.py

@@ -0,0 +1 @@
+"""Tests for the patterns module."""

pyveil-0.1.0/tests/test_utils.py

@@ -0,0 +1 @@
+"""Tests for the utils module."""