Metadata-Version: 2.1
Name: word-tools
Version: 0.0.1
Summary: Utilities for performing actions on words, or collections of words.
Home-page: https://github.com/ncdulo/word_tools
Author: ncdulo
License: MIT
Keywords: word tools dictionary urbandictionary utility cli module
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Processing
Classifier: Topic :: Text Processing :: Filters
Classifier: Topic :: Utilities
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: requests
Requires-Dist: click
Requires-Dist: beautifulsoup4

# word_tools
[![Feature Request](https://img.shields.io/badge/feature%20requests-welcome-green.svg)](https://github.com/Naereen/badges) [![Build Status](https://travis-ci.com/ncdulo/word_tools.svg?branch=master)](https://travis-ci.com/ncdulo/word_tools) [![codecov](https://codecov.io/gh/ncdulo/word_tools/branch/master/graph/badge.svg)](https://codecov.io/gh/ncdulo/word_tools) [![Percentage of issues still open](http://isitmaintained.com/badge/open/ncdulo/word_tools.svg)](http://isitmaintained.com/project/ncdulo/word_tools "Percentage of issues still open") [![made-with-vim](https://img.shields.io/badge/made%20with-Vim-1f425f.svg)](https://www.vim.org/)

Utilities for performing actions on words, or collections of words. This is a slowly
expanding library of functions, conversions, and lookups added to as I see fit.
Mostly intended for fun, or convenience. Not sure what it will grow into, but it's
a nice laid back project.

# Installation & Use
Recommended to install into a virtual environment of your desired flavor. I currently
recommend `virtualenvwrapper`, but am using the stock `venv` module in the example
below for simplicity. Save the user on configuring a dependency if they don't have to

```bash
# Clone the repo
git clone https://github.com/ncdulo/word_tools.git
cd word_tools

# Create a new virtual environment, and enable it
python -m venv .env
source .env/bin/activate

# Update Pip & friends. Optional, but recommended
pip install --upgrade pip

# Install dependencies and create executable
pip install .
# If you receive errors about "No module named 'word_tools'", try this
pip install --editable .

# With venv active, the path will already be in path
# Otherwise, the path to executables will be
# .env/bin/wt.{urban,merriam,wikipedia}
wt.urban WORD [LIMIT=0]
wt.merriam hacker 2
wt.wikipedia python 1

# Deactivate the virtual environment when finished
deactivate


