pyASDReader 1.2.0__tar.gz → 1.2.2__tar.gz

pyasdreader-1.2.2/.codecov.yml

@@ -0,0 +1,68 @@
+codecov:
+  require_ci_to_pass: yes
+  notify:
+    wait_for_ci: yes
+
+coverage:
+  precision: 2
+  round: down
+  range: "70...100"
+
+  status:
+    project:
+      default:
+        target: auto
+        threshold: 1%
+        informational: false
+    patch:
+      default:
+        target: auto
+        threshold: 1%
+        informational: false
+
+comment:
+  layout: "reach,diff,flags,files,footer"
+  behavior: default
+  require_changes: false
+  require_base: false
+  require_head: true
+
+flags:
+  ubuntu-latest-py3.8:
+    carryforward: false
+  ubuntu-latest-py3.9:
+    carryforward: false
+  ubuntu-latest-py3.10:
+    carryforward: false
+  ubuntu-latest-py3.11:
+    carryforward: false
+  ubuntu-latest-py3.12:
+    carryforward: false
+  windows-latest-py3.8:
+    carryforward: false
+  windows-latest-py3.9:
+    carryforward: false
+  windows-latest-py3.10:
+    carryforward: false
+  windows-latest-py3.11:
+    carryforward: false
+  windows-latest-py3.12:
+    carryforward: false
+  macos-latest-py3.8:
+    carryforward: false
+  macos-latest-py3.9:
+    carryforward: false
+  macos-latest-py3.10:
+    carryforward: false
+  macos-latest-py3.11:
+    carryforward: false
+  macos-latest-py3.12:
+    carryforward: false
+
+ignore:
+  - "tests/"
+  - "examples/"
+  - "docs/"
+  - "scripts/"
+  - "**/__pycache__"
+  - "*.pyc"

pyasdreader-1.2.2/CHANGELOG.md

@@ -0,0 +1,282 @@
+# Changelog - pyASDReader
+
+[![PyPI version](https://img.shields.io/pypi/v/pyASDReader.svg)](https://pypi.org/project/pyASDReader/)
+[![Version](https://img.shields.io/badge/version-v1.1.0-blue.svg)](https://github.com/KaiTastic/pyASDReader/releases)
+[![Semantic Versioning](https://img.shields.io/badge/semver-2.0.0-green.svg)](https://semver.org/spec/v2.0.0.html)
+[![Keep a Changelog](https://img.shields.io/badge/changelog-Keep%20a%20Changelog-orange.svg)](https://keepachangelog.com/en/1.0.0/)
+[![Latest Release](https://img.shields.io/github/v/release/KaiTastic/pyASDReader)](https://github.com/KaiTastic/pyASDReader/releases/latest)
+[![Release Date](https://img.shields.io/github/release-date/KaiTastic/pyASDReader)](https://github.com/KaiTastic/pyASDReader/releases)
+
+All notable changes to this project will be documented in this file.
+
+This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html), and the format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+## [Unreleased]
+
+## [1.2.2] - 2025-10-05
+
+### Added
+- 📋 **Codecov Configuration** - Added `.codecov.yml` for comprehensive code coverage tracking
+  - Multi-platform coverage flags (Ubuntu, Windows, macOS)
+  - Per-Python-version coverage tracking (3.8-3.12)
+  - Automatic coverage status checks on PRs
+  - Detailed coverage reporting with customizable thresholds
+- ✅ **Enhanced Test Suite** - Significantly expanded test coverage
+  - Added `test_file_attributes.py` with 12 comprehensive test cases for FileAttributes class
+  - Expanded `test_asd_file_reader.py` with new property tests and validation tests
+  - Added tests for spectral data parsing, constituent types, BSTR, and audit events
+  - Improved test coverage for file version validation, GPS parsing, and datetime handling
+- 📊 **Coverage Reporting** - Added `coverage.json` for detailed coverage metrics
+  - Per-file coverage statistics
+  - Function-level coverage tracking
+  - Class-level coverage analysis
+
+### Changed
+- 🏗️ **Improved Code Structure** - Enhanced ASDFile class inheritance
+  - `ASDFile` now properly inherits from `FileAttributes` class
+  - Better integration of file handling capabilities
+  - Improved logger initialization with proper setup in module scope
+- 🔧 **Optimized CI/CD Workflows** - Performance improvements for GitHub Actions
+  - Removed redundant pip caching from PyPI verification steps
+  - Streamlined publish workflows for faster deployments
+- 📚 **Updated Documentation** - Improved README formatting
+  - Fixed test workflow badge to reference correct workflow file
+  - Cleaned up citation section for better readability
+  - Removed verbose contribution and community sections for conciseness
+
+### Fixed
+- 🐛 **Fixed FileAttributes Methods** - Corrected attribute naming inconsistencies
+  - Fixed `set_file_name()` method to use `self.filename` instead of `self.file_name`
+  - Fixed `set_file_path()` method to use `self.filepath` instead of `self.file_path`
+  - Improved consistency across FileAttributes class methods
+- 🔧 **Enhanced Test Robustness** - Improved test initialization and execution
+  - Fixed ASDFile test initialization to work without parent class conflicts
+  - Added proper subTest contexts for all file iteration tests
+  - Improved error handling in test cases
+
+### Removed
+- ❌ **CITATION.cff** - Temporarily removed to streamline package metadata
+  - Citation information now maintained in README only
+  - Reduces maintenance overhead for version updates
+  - GitHub citation feature still available via repository metadata
+
+### Technical Improvements
+- Better test organization with comprehensive property testing
+- Improved code coverage from ~61% to higher levels across core modules
+- Enhanced file attribute handling with proper inheritance chain
+- More reliable CI/CD pipeline with optimized caching strategy
+- Better separation of concerns between file I/O and ASD parsing logic
+
+## [1.2.1] - 2025-10-05
+
+### Added
+- ✨ **CITATION.cff** - Academic citation file for proper software citation
+  - Includes author information with ORCID placeholder
+  - Comprehensive metadata (abstract, keywords, repository info)
+  - MIT license specification
+  - Version and release date tracking
+- 📤 CITATION.cff now included in GitHub releases
+- 🔄 Automatic CITATION.cff version and date updates during release
+- 📊 Codecov integration for code coverage reporting
+  - Automatic coverage upload after test runs
+  - Per-platform and per-Python-version coverage tracking
+  - Coverage badges support
+
+### Changed
+- 🚀 Enhanced CI/CD workflows with performance improvements:
+  - Upgraded `actions/setup-python` from v4 to v5
+  - Added pip caching to all workflows for faster builds
+  - Streamlined cache configuration (removed redundant cache steps)
+  - Improved cache key structure using pyproject.toml
+- 🧪 Improved test workflow (`python-package.yml`):
+  - Better pip caching strategy
+  - Enhanced coverage reporting with Codecov
+  - More efficient dependency caching
+- 📦 Enhanced PyPI publishing workflow:
+  - Added CITATION.cff to release assets
+  - Automatic citation file updates on tag releases
+  - Improved release notes generation
+- 📚 Updated README.md with better formatting and organization
+
+### Fixed
+- 🔧 Fixed package metadata verification using `importlib.metadata` instead of manual version checking
+  - More accurate and reliable version detection
+  - Better compatibility with different Python versions
+  - Improved error handling in CI/CD pipelines
+
+### Technical Improvements
+- Reduced workflow execution time through better caching
+- Enhanced CI/CD reliability with updated actions
+- Improved maintainability of GitHub Actions workflows
+- Better separation of concerns in workflow steps
+- More robust release automation
+
+## [1.2.0] - 2025-10-05
+
+### Changed
+- 🔄 **Package renamed** from `pyASD` to `pyASDReader` across all configuration files
+- 📦 Updated package configuration in pyproject.toml with improved metadata
+- 🏗️ **Major code structure refactoring** for improved readability and maintainability
+- 📚 Significantly enhanced README.md with comprehensive documentation
+- 🔧 Modernized dependency management with expanded dev tools
+- 🧪 Improved CI/CD workflows for better reliability and accuracy
+- 📝 Updated all GitHub Actions workflows to use correct branch references (main)
+- 🎯 Enhanced pre-commit configuration for better code quality
+- 🚀 Improved publish scripts with better error handling
+
+### Added
+- ✨ **CITATION.cff** - Formal citation support for academic use
+- 📚 **VERSION_MANAGEMENT.md** - Comprehensive version management documentation
+- 📝 **examples/README.md** - Detailed examples documentation
+- 📝 **examples/basic_usage.py** - Practical usage examples
+- 🛠️ Enhanced development dependencies:
+  - Added `black>=21.0.0` for code formatting
+  - Added `isort>=5.0.0` for import sorting
+  - Added `build>=0.7.0` for package building
+  - Added `twine>=3.0.0` for PyPI publishing
+  - Added `pre-commit>=2.15.0` for git hooks
+  - Added `tox>=3.20.0` for testing automation
+- 🎨 Added maintainers field to project metadata
+- 📦 Added "all" optional dependencies group for complete installation
+- 🔗 Enhanced project URLs with Source and Issues links
+- 📄 Improved README content-type specification in pyproject.toml
+- ✅ Enhanced package metadata verification using importlib.metadata
+- 🔍 Improved CI workflows with better testing and validation
+
+### Removed
+- ❌ **Deleted requirements.txt** (consolidated into pyproject.toml)
+- ❌ **Deleted requirements-dev.txt** (consolidated into pyproject.toml)
+- ❌ **Deleted setup.py** (fully migrated to pyproject.toml)
+
+### Fixed
+- 🔧 Fixed package metadata verification in CI/CD workflows
+- ✅ Corrected test file naming convention (test_ASD_File_Reader.py → test_asd_file_reader.py)
+- 🔗 Updated all repository URLs from pyASD to pyASDReader
+- 📝 Fixed MANIFEST.in to properly include package data
+- 🐛 Improved error handling in asd_file_reader.py
+
+### Technical Improvements
+- Centralized all dependencies in pyproject.toml optional-dependencies
+- Improved package structure with proper namespace configuration
+- Enhanced setuptools_scm integration for version management
+- Better test coverage configuration targeting pyASDReader module
+- Streamlined build and publish workflows
+
+## [1.1.0] - 2025-10-05
+
+### Fixed
+- 🔴 **Critical**: Removed broken root `__init__.py` that caused ModuleNotFoundError
+- 🔴 **Critical**: Fixed pyproject.toml package configuration for proper pip installation
+- 🔴 **Critical**: Unified version management (removed conflicting version definitions)
+- 🔴 **Critical**: Fixed GitHub Actions branch configuration (now triggers on main branch)
+- 🔴 **Critical**: Removed conflicting setup.py (now using only pyproject.toml)
+- 🔴 Fixed binary flag error in SWIR2_TEC_ALARM detection (0x16 → 0x10)
+- 🟠 Fixed read() method to properly return False on file errors
+- ⚠️ Fixed logger undefined error by adding module-level logger
+- ⚠️ Added Python 3.8 compatibility with `from __future__ import annotations`
+
+### Changed
+- 🔄 **Repository renamed** from `ASD_File_Reader` to `pyASDReader` for consistency with PyPI package name
+- 📦 **PyPI package name**: `pyASDReader` (install: `pip install pyASDReader`)
+- 🏠 **New repository URL**: https://github.com/KaiTastic/pyASDReader
+- ℹ️ **Module import**: `from pyASDReader import ASDFile` (improved package exports)
+- 🧪 GitHub Actions now tests stable Python versions only (3.8-3.12, removed 3.13 and 3.x)
+- 🧪 Removed `continue-on-error` from CI to properly report test failures
+- 📊 Test matrix reduced from 21 to 15 combinations for better stability
+- Modernized dependency management: moved all dependencies to pyproject.toml optional-dependencies
+- Updated all CI/CD workflows to use `pip install -e ".[dev]"` instead of requirements files
+- Enhanced README with Development Installation section
+- Standardized version number to 1.1.0 across all configuration files
+
+### Added
+- ✨ Automatic version management using setuptools-scm
+- 🤖 Dual GitHub Actions workflows: dev branch → TestPyPI, tag → PyPI
+- 📚 Comprehensive documentation for version management and publishing
+- 📝 CLAUDE.md - Guide for Claude Code integration
+- 📝 VERSION_MANAGEMENT.md - Complete guide for version management with Git tags and setuptools_scm
+- 📝 SECURITY.md - Security policy and vulnerability reporting guidelines
+- 📝 PROJECT_IMPROVEMENT_ANALYSIS.md - Detailed analysis of 26 issues
+- 📝 FIXES_APPLIED.md - First round fix summary
+- 📝 ADDITIONAL_IMPROVEMENTS.md - Second round analysis of 15 issues
+- 📝 ROUND2_FIXES_APPLIED.md - Second round fix summary
+- ✅ Support for auto-loading files: `ASDFile(filepath)` constructor
+- Added examples/ directory with basic usage examples
+- Enhanced project URLs in pyproject.toml (Issues, Source, Changelog, PyPI)
+- Comprehensive optional-dependencies groups: dev, docs, all
+
+### Removed
+- ❌ Deleted conflicting `setup.py`
+- ❌ Deleted broken root `__init__.py`
+- ❌ Deleted requirements.txt (moved to pyproject.toml)
+- ❌ Deleted requirements-dev.txt (moved to pyproject.toml)
+- ❌ Removed duplicate v1.0.0 git tag
+
+### Note
+- Old repository URLs will redirect automatically
+- No breaking changes for existing users - all fixes are backward compatible
+- Package is now fully functional (fixed from "broken" state)
+- Version management now uses Git tags as single source of truth
+
+## [1.0.1] - 2025-08-29
+
+### Added
+
+- Enhanced README documentation with compatibility testing details
+- Improved GitHub Actions CI/CD workflow with multi-platform testing
+- Extended Python version support (3.8-3.13)
+- Code quality improvements and linting integration (flake8)
+- Comprehensive badge system showing CI status, version, Python compatibility, and license
+
+### Changed
+
+- Updated documentation structure and clarity
+- Improved project organization and maintainability
+- Enhanced cross-platform compatibility testing
+
+### Fixed
+
+- Minor documentation formatting issues
+- CI/CD pipeline optimizations
+
+## [1.0.0] - 2025-03-12
+
+### Added
+
+- Initial release with full ASD file format support (versions 1-8)
+- Comprehensive parsing capabilities for all ASD file structures:
+  - Spectrum File Header and metadata
+  - Spectrum Data parsing
+  - Reference File Header and Reference Data
+  - Classifier Data support
+  - Dependent Variables handling
+  - Calibration Header and calibration series data
+  - Audit Log parsing
+  - Digital signature support
+- Benchmark testing against ASD ViewSpecPro 6.2.0 for accuracy validation
+- Support for multiple ASD instrument types:
+  - ASD AgriSpec, FieldSpec series, HandHeld 2, LabSpec series, TerraSpec series
+- Spectral data processing capabilities:
+  - Digital number extraction
+  - Reflectance calculations (with derivatives)
+  - Absolute reflectance
+  - log(1/R) calculations
+  - Transmittance support
+- Comprehensive unit test suite
+- MIT License
+- Python package structure with setuptools support
+
+### Features
+
+- **File Format Compatibility**: Complete support for ASD file format versions 1 through 8
+- **Multi-instrument Support**: Works with all major ASD spectroradiometer models
+- **Data Extraction**: Full access to all data blocks within ASD files
+- **Calculation Support**: Built-in spectral calculations and transformations
+- **Validation**: Benchmark-tested against official ASD software
+
+## Upcoming Features
+
+- [ ] Spectral discontinuities correction (Hueni & ASD Parabolic methods)
+- [ ] File format converter (ASCII export functionality)
+- [ ] Enhanced radiometric and statistical tools
+- [ ] Extended instrument support and metadata extraction
+- [ ] PyPI package distribution

{pyasdreader-1.2.0 → pyasdreader-1.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyASDReader
-Version: 1.2.0
+Version: 1.2.2
 Summary: A Python library for reading and parsing all versions of ASD binary spectral files
 Author-email: Kai Cao <caokai_cgs@163.com>
 Maintainer-email: Kai Cao <caokai_cgs@163.com>
@@ -86,7 +86,7 @@ Dynamic: license-file
 [![PyPI version](https://img.shields.io/pypi/v/pyASDReader?style=flat-square)](https://pypi.org/project/pyASDReader/)
 [![Python versions](https://img.shields.io/pypi/pyversions/pyASDReader?style=flat-square)](https://pypi.org/project/pyASDReader/)
 [![License](https://img.shields.io/github/license/KaiTastic/pyASDReader?style=flat-square)](https://github.com/KaiTastic/pyASDReader/blob/main/LICENSE)
-[![Tests](https://img.shields.io/github/actions/workflow/status/KaiTastic/pyASDReader/test.yml?branch=main&label=tests&style=flat-square)](https://github.com/KaiTastic/pyASDReader/actions)
+[![Tests](https://img.shields.io/github/actions/workflow/status/KaiTastic/pyASDReader/python-package.yml?branch=main&label=tests&style=flat-square)](https://github.com/KaiTastic/pyASDReader/actions)
 [![Coverage](https://img.shields.io/codecov/c/github/KaiTastic/pyASDReader?style=flat-square)](https://codecov.io/gh/KaiTastic/pyASDReader)
 
 pyASDReader is a robust Python library designed to read and parse all versions (v1-v8) of ASD (Analytical Spectral Devices) binary spectral files. It provides seamless access to spectral data, metadata, and calibration information from various ASD instruments including FieldSpec, LabSpec, TerraSpec, and more.
@@ -388,80 +388,27 @@ Comprehensive export capabilities beyond the standard ASCII format:
 - Integration with popular spectral analysis libraries
 
 
-
-## Contributing
-
-### Development Setup
-
-1. **Fork and Clone**:
-   ```bash
-   git clone https://github.com/yourusername/pyASDReader.git
-   cd pyASDReader
-   ```
-
-2. **Create Development Environment**:
-   ```bash
-   python -m venv venv
-   source venv/bin/activate  # On Windows: venv\Scripts\activate
-   pip install -e ".[dev]"
-   ```
-
-3. **Run Tests**:
-   ```bash
-   pytest tests/
-   python -m pytest --cov=src --cov-report=html
-   ```
-
-### Contribution Guidelines
-
-- **Bug Reports**: Use GitHub Issues with detailed reproduction steps
-- **Feature Requests**: Open an issue to discuss before implementing
-- **Code Style**: Follow PEP 8 and use provided pre-commit hooks
-- **Testing**: Add tests for new features and ensure all tests pass
-- **Documentation**: Update README and docstrings for any API changes
-
-### Development Workflow
-
-1. Create a feature branch: `git checkout -b feature/amazing-feature`
-2. Make your changes with appropriate tests
-3. Run the test suite: `pytest`
-4. Commit your changes: `git commit -m 'Add amazing feature'`
-5. Push to your fork: `git push origin feature/amazing-feature`
-6. Submit a Pull Request
-
-## � Support & Community
-
-### Getting Help
-
-- 📋 **GitHub Issues**: [Report bugs or request features](https://github.com/KaiTastic/pyASDReader/issues)
-- 📧 **Email**: `caokai_cgs@163.com` for direct support
-- 🔒 **Security**: Report vulnerabilities via our [Security Policy](SECURITY.md)
-
-### Community Guidelines
-
-- Be respectful and inclusive
-- Help others learn and grow
-- Share knowledge and experiences
-- Provide constructive feedback
-
 ## Citation
 
-If you use pyASDReader in your research, please cite:
+If you use pyASDReader in your research, please cite it using the following information:
 
+**BibTeX format**:
 ```bibtex
 @software{cao2025pyasdreader,
   author = {Cao, Kai},
   title = {pyASDReader: A Python Library for ASD Spectral File Reading},
   year = {2025},
   url = {https://github.com/KaiTastic/pyASDReader},
-  version = {1.0.0}
+  version = {1.2.1}
 }
 ```
 
 **Plain text citation**:
-> Cao, Kai. (2025). pyASDReader: A Python Library for ASD Spectral File Reading. https://github.com/KaiTastic/pyASDReader
+```
+Cao, Kai. (2025). pyASDReader: A Python Library for ASD Spectral File Reading. Available at: https://github.com/KaiTastic/pyASDReader
+```
 
-## 📖 References
+## References
 
 ### Official Documentation
 - [ASD Inc. (2017). ASD File Format: Version 8 (Revision): 1-10](https://www.malvernpanalytical.com/en/learn/knowledge-center/user-manuals/asd-file-format-v8)
@@ -476,12 +423,6 @@ If you use pyASDReader in your research, please cite:
 
 This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for complete details.
 
-### Built With
-
-- [NumPy](https://numpy.org/) - Numerical computing library
-- [Python](https://python.org/) - Programming language
-- [pytest](https://pytest.org/) - Testing framework
-
 ---
 
 <div align="center">

{pyasdreader-1.2.0 → pyasdreader-1.2.2}/README.md

@@ -3,7 +3,7 @@
 [![PyPI version](https://img.shields.io/pypi/v/pyASDReader?style=flat-square)](https://pypi.org/project/pyASDReader/)
 [![Python versions](https://img.shields.io/pypi/pyversions/pyASDReader?style=flat-square)](https://pypi.org/project/pyASDReader/)
 [![License](https://img.shields.io/github/license/KaiTastic/pyASDReader?style=flat-square)](https://github.com/KaiTastic/pyASDReader/blob/main/LICENSE)
-[![Tests](https://img.shields.io/github/actions/workflow/status/KaiTastic/pyASDReader/test.yml?branch=main&label=tests&style=flat-square)](https://github.com/KaiTastic/pyASDReader/actions)
+[![Tests](https://img.shields.io/github/actions/workflow/status/KaiTastic/pyASDReader/python-package.yml?branch=main&label=tests&style=flat-square)](https://github.com/KaiTastic/pyASDReader/actions)
 [![Coverage](https://img.shields.io/codecov/c/github/KaiTastic/pyASDReader?style=flat-square)](https://codecov.io/gh/KaiTastic/pyASDReader)
 
 pyASDReader is a robust Python library designed to read and parse all versions (v1-v8) of ASD (Analytical Spectral Devices) binary spectral files. It provides seamless access to spectral data, metadata, and calibration information from various ASD instruments including FieldSpec, LabSpec, TerraSpec, and more.
@@ -305,80 +305,27 @@ Comprehensive export capabilities beyond the standard ASCII format:
 - Integration with popular spectral analysis libraries
 
 
-
-## Contributing
-
-### Development Setup
-
-1. **Fork and Clone**:
-   ```bash
-   git clone https://github.com/yourusername/pyASDReader.git
-   cd pyASDReader
-   ```
-
-2. **Create Development Environment**:
-   ```bash
-   python -m venv venv
-   source venv/bin/activate  # On Windows: venv\Scripts\activate
-   pip install -e ".[dev]"
-   ```
-
-3. **Run Tests**:
-   ```bash
-   pytest tests/
-   python -m pytest --cov=src --cov-report=html
-   ```
-
-### Contribution Guidelines
-
-- **Bug Reports**: Use GitHub Issues with detailed reproduction steps
-- **Feature Requests**: Open an issue to discuss before implementing
-- **Code Style**: Follow PEP 8 and use provided pre-commit hooks
-- **Testing**: Add tests for new features and ensure all tests pass
-- **Documentation**: Update README and docstrings for any API changes
-
-### Development Workflow
-
-1. Create a feature branch: `git checkout -b feature/amazing-feature`
-2. Make your changes with appropriate tests
-3. Run the test suite: `pytest`
-4. Commit your changes: `git commit -m 'Add amazing feature'`
-5. Push to your fork: `git push origin feature/amazing-feature`
-6. Submit a Pull Request
-
-## � Support & Community
-
-### Getting Help
-
-- 📋 **GitHub Issues**: [Report bugs or request features](https://github.com/KaiTastic/pyASDReader/issues)
-- 📧 **Email**: `caokai_cgs@163.com` for direct support
-- 🔒 **Security**: Report vulnerabilities via our [Security Policy](SECURITY.md)
-
-### Community Guidelines
-
-- Be respectful and inclusive
-- Help others learn and grow
-- Share knowledge and experiences
-- Provide constructive feedback
-
 ## Citation
 
-If you use pyASDReader in your research, please cite:
+If you use pyASDReader in your research, please cite it using the following information:
 
+**BibTeX format**:
 ```bibtex
 @software{cao2025pyasdreader,
   author = {Cao, Kai},
   title = {pyASDReader: A Python Library for ASD Spectral File Reading},
   year = {2025},
   url = {https://github.com/KaiTastic/pyASDReader},
-  version = {1.0.0}
+  version = {1.2.1}
 }
 ```
 
 **Plain text citation**:
-> Cao, Kai. (2025). pyASDReader: A Python Library for ASD Spectral File Reading. https://github.com/KaiTastic/pyASDReader
+```
+Cao, Kai. (2025). pyASDReader: A Python Library for ASD Spectral File Reading. Available at: https://github.com/KaiTastic/pyASDReader
+```
 
-## 📖 References
+## References
 
 ### Official Documentation
 - [ASD Inc. (2017). ASD File Format: Version 8 (Revision): 1-10](https://www.malvernpanalytical.com/en/learn/knowledge-center/user-manuals/asd-file-format-v8)
@@ -393,12 +340,6 @@ If you use pyASDReader in your research, please cite:
 
 This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for complete details.
 
-### Built With
-
-- [NumPy](https://numpy.org/) - Numerical computing library
-- [Python](https://python.org/) - Programming language
-- [pytest](https://pytest.org/) - Testing framework
-
 ---
 
 <div align="center">