Skip to content

Commit 947ceb1

Browse files
committed
added overview to shpinx doc index.rst
1 parent 3103a3e commit 947ceb1

File tree

2 files changed

+40
-5
lines changed

2 files changed

+40
-5
lines changed

README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,9 +12,9 @@
1212
A handy library to validate, manipulate and generate strings, which is:
1313

1414
- Simple and "pythonic"
15-
- Fully documented!
16-
- 100% code coverage!
17-
- Tested against all officially supported Python versions (3.5, 3.6, 3.7, 3.8)
15+
- Fully documented and with examples! (html version on [readthedocs.io](https://python-string-utils.readthedocs.io/en/develop))
16+
- 100% code coverage! (see it with your own eyes on [codecov.io](https://codecov.io/gh/daveoncode/python-string-utils/branch/develop))
17+
- Tested (automatically on each push thanks to Travis CI) against all officially supported Python versions: 3.5, 3.6, 3.7, 3.8.
1818
- Fast (mostly based on compiled regex)
1919
- Free from external dependencies
2020
- PEP8 complaint

docs/index.rst

Lines changed: 37 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,47 @@
1-
Python String Utils Documentation
2-
=================================
1+
Python String Utils: Overview
2+
-----------------------------
3+
4+
This is a handy library to validate, manipulate and generate strings, which is:
5+
6+
- Simple and "pythonic"
7+
- Fully documented and with examples!
8+
- 100% code coverage!
9+
- Tested against all officially supported Python versions: 3.5, 3.6, 3.7, 3.8.
10+
- Fast (mostly based on compiled regex)
11+
- Free from external dependencies
12+
- PEP8 complaint
13+
314

415
Installing
516
----------
617

718
>>> pip install python-string-utils
819

920

21+
Library structure
22+
-----------------
23+
24+
The library basically consists in the python package `string_utils`, containing the following modules:
25+
26+
- `validation.py` (contains string check api)
27+
- `manipulation.py` (contains string transformation api)
28+
- `generation.py` (contains string generation api)
29+
- `errors.py` (contains library-specific errors)
30+
- `_regex.py` (contains compiled regex **FOR INTERNAL USAGE ONLY**)
31+
32+
Plus a secondary package `tests` which includes several submodules.
33+
Specifically one for each test suite and named according to the api to test (eg. tests for `is_ip()`
34+
will be in `test_is_ip.py` and so on).
35+
36+
All the public API are importable directly from the main package `string_utils`, so this:
37+
38+
>>> from string_utils.validation import is_ip
39+
40+
can be simplified as:
41+
42+
>>> from string_utils import is_ip
43+
44+
1045
Modules
1146
-------
1247

0 commit comments

Comments
 (0)
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy