Metadata-Version: 2.2
Name: word-count-package
Version: 1.0.1
Summary: A simple Python package to count words and characters.
Author: Code Aetheris
Author-email: rajat21.iitd@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-python
Dynamic: summary

README.md for word-count-package
md
Copy
Edit
# 📄 Word Count Package (`word-count-package`)

A simple Python package that **counts words & characters** in any given text.  
Useful for **text processing, analytics, and word-based analysis.** 🚀  

---

## 📌 Installation
Install this package using **pip**:

```sh
pip install word-count-package
📌 Importing the Package
Once installed, import it into your Python script:

python
Copy
Edit
import wordcount
📌 Available Functions
🔹 count_words_and_chars(text)
This function counts words and characters in a given text.

📌 Function Signature
python
Copy
Edit
wordcount.count_words_and_chars(text: str) -> dict
📌 Parameters
Parameter	Type	Description
text	str	The input text to analyze
📌 Returns
This function returns a dictionary containing:

"words" → Number of words in the text.
"characters" → Number of characters in the text.
📌 Example Usage
Create a Python script (e.g., test_script.py) and use the package:

python
Copy
Edit
import wordcount

text = "Python packaging is fun and useful!"
result = wordcount.count_words_and_chars(text)

print(f"Words: {result['words']}, Characters: {result['characters']}")
✅ Expected Output
yaml
Copy
Edit
Words: 6, Characters: 37
📌 More Examples
python
Copy
Edit
result = wordcount.count_words_and_chars("Hello world!")
print(result)
Output:
python
Copy
Edit
{'words': 2, 'characters': 12}
python
Copy
Edit
result = wordcount.count_words_and_chars("This is a Python package example.")
print(result)
Output:
python
Copy
Edit
{'words': 6, 'characters': 35}
📌 Updating the Package
If a new version is released, upgrade using:

sh
Copy
Edit
pip install --upgrade word-count-package
📌 Supported Environments
✅ Windows (Command Prompt, PowerShell)
✅ macOS (Terminal)
✅ Linux (Bash, Zsh, etc.)

Works with Python 3.6+.

