nlpfileio 0.1.1

An open-source Python library for CLI and NLP tasks

nlpfileio

An open-source Python CLI tool for NLP tasks

nlpfileio is a command-line interface library that simplifies natural language processing (NLP) tasks such as removing stopwords, normalizing text, stemming, and sentiment analysis.
It is built with Click and provides an interactive, colorful CLI with configuration support.

---

✨ Features

• 📝 Stopword Removal — Remove stopwords using spaCy or TextBlob.
• 🔄 Text Normalization — Clean and normalize sentences.
• 🌱 Stemming — Perform stemming on sentences.
• 😊 Sentiment Analysis — Get polarity & subjectivity for each sentence.
• ⚙️ Configurable — Supports config.ini for default settings.
• 🎨 Interactive CLI — Colorful, user-friendly prompts.

---

📦 Installation

Install from PyPI (after publishing):

pip install nlpfileio

Then, download the required NLP resources (must be done once before first use):

nlpfileio-download

Or install from source:

git clone https://github.com/Ahmadzadeh920/nlpcli-pakage-library.git
cd nlpcli-pakage-library
pip install .

---

⚡ Usage

The CLI tool is available as nlpfileio once installed.

Note: Before using nlpfileio for the first time, you must download the necessary NLP models and resources. Run:

  nlpfileio-download

Run it with an input file (.csv or .txt):

nlpfileio input.txt

---

🛠 Commands

1. Remove Stopwords

nlpfileio input.txt remove_stop_words

Removes stopwords and shows an example. Optionally save results.

2. Normalize Sentences

nlpfileio input.txt normalize

Normalizes text and saves to normalized_sentences.txt if desired.

3. Stem Sentences

nlpfileio input.txt stem

Applies stemming. Example and optional file export included.

4. Sentiment Analysis

nlpfileio input.txt sentiment

Computes sentiment for each sentence:

Sentence: I love open-source projects.
Polarity: 0.500, Subjectivity: 0.600

Exports results to sentiments_sentences.txt if selected.

---

📂 Project Structure

nlpfileio/
├── src/nlpclinlpfileio/
│   ├── cli.py          # CLI entry point
│   ├── services.py     # Core NLP functions
│   ├── config.ini      # Default configuration
│   └── __init__.py
├── tests/              # Unit tests
├── README.md           # Documentation
├── pyproject.toml      # Project metadata
└── poetry.lock

---

⚙️ Configuration

Default options can be stored in config.ini, automatically loaded by the CLI.

Example:

[settings]
language = en
output_format = txt

---

🧪 Development

Clone and install dependencies:

poetry install

Run tests:

poetry run pytest

---

🚀 Roadmap

Planned features and improvements:

• Lemmatization — Add support for lemmatizing words.
• Language Detection — Automatically detect the language of input text.
• Additional Input Formats — Support JSON, Excel, and other file types.
• Enhanced Visualization — Use rich for better CLI output formatting.

---

📜 License

This project is licensed under the MIT License

---

👩‍💻 Author

Fatemeh Ahmadzadeh

• 📧 Email: [e-mail]
• 🌐 GitHub: @Ahmadzadeh920
• 💼 LinkedIn: Fatemeh Ahmadzadeh