Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

A handy Python library to validate, manipulate and generate strings

License

NotificationsYou must be signed in to change notification settings

daveoncode/python-string-utils

Repository files navigation

Build StatuscodecovDocumentation StatusPython 3.5Python 3.6Python 3.7Python 3.8

Python String Utils

Latest version:1.0.0 (March 2020)

A handy library to validate, manipulate and generate strings, which is:

  • Simple and "pythonic"
  • Fully documented and with examples! (html version onreadthedocs.io)
  • 100% code coverage! (see it with your own eyes oncodecov.io)
  • Tested (automatically on each push thanks to Travis CI) against all officially supported Python versions
  • Fast (mostly based on compiled regex)
  • Free from external dependencies
  • PEP8 compliant

What's inside...

Library structure

The library basically consists in the python packagestring_utils, containing the following modules:

  • validation.py (contains string check api)
  • manipulation.py (contains string transformation api)
  • generation.py (contains string generation api)
  • errors.py (contains library-specific errors)
  • _regex.py (contains compiled regexFOR INTERNAL USAGE ONLY)

Plus a secondary packagetests which includes several submodules.
Specifically one for each test suite and named according to the api to test (eg. tests foris_ip()will be intest_is_ip.py and so on).

All the public API are importable directly from the main packagestring_utils, so this:

from string_utils.validation import is_ip

can be simplified as:

from string_utils import is_ip

Api overview

Bear in mind: this is just an overview,for the full API documentation see:readthedocs.io

String validation functions:

is_string: checks if the given object is a string

is_string('hello') # returns trueis_string(b'hello') # returns false

is_full_string: checks if the given object is non empty string

is_full_string(None) # returns falseis_full_string('') # returns falseis_full_string(' ') # returns falseis_full_string('foo') # returns true

is_number: checks if the given string represents a valid number

is_number('42') # returns trueis_number('-25.99') # returns trueis_number('1e3') # returns trueis_number(' 1 2 3 ') # returns false

is_integer: checks if the given string represents a valid integer

is_integer('42') # returns trueis_integer('42.0') # returns false

is_decimal: checks if the given string represents a valid decimal number

is_decimal('42.0') # returns trueis_decimal('42') # returns false

is_url: checks if the given string is an url

is_url('foo.com') # returns falseis_url('http://www.foo.com') # returns trueis_url('https://foo.com') # returns true

is_email: Checks if the given string is an email

is_email('my.email@some.provider.com') # returns trueis_eamil('@gmail.com') # retruns false

is_credit_card: Checks if the given string is a credit card

is_credit_card(value)# returns true if `value` represents a valid card number for one of these:# VISA, MASTERCARD, AMERICAN EXPRESS, DINERS CLUB, DISCOVER or JCB

is_camel_case: Checks if the given string is formatted as camel case

is_camel_case('MyCamelCase') # returns trueis_camel_case('hello') # returns false

is_snake_case: Checks if the given string is formatted as snake case

is_snake_case('snake_bites') # returns trueis_snake_case('nope') # returns false

is_json: Checks if the given string is a valid json

is_json('{"first_name": "Peter", "last_name": "Parker"}') # returns trueis_json('[1, 2, 3]') # returns trueis_json('{nope}') # returns false

is_uuid: Checks if the given string is a valid UUID

is_uuid('ce2cd4ee-83de-46f6-a054-5ee4ddae1582') # returns true

is_ip_v4: Checks if the given string is a valid ip v4 address

is_ip_v4('255.200.100.75') # returns trueis_ip_v4('255.200.100.999') # returns false (999 is out of range)

is_ip_v6: Checks if the given string is a valid ip v6 address

is_ip_v6('2001:db8:85a3:0000:0000:8a2e:370:7334') # returns trueis_ip_v6('123:db8:85a3:0000:0000:8a2e:370,1') # returns false

is_ip: Checks if the given string is a valid ip (any version)

is_ip('255.200.100.75') # returns trueis_ip('2001:db8:85a3:0000:0000:8a2e:370:7334') # returns trueis_ip('255.200.100.999') # returns falseis_ip('123:db8:85a3:0000:0000:8a2e:370,1') # returns false

is_isnb_13: Checks if the given string is a valid ISBN 13

is_isbn_13('9780312498580') # returns trueis_isbn_13('978-0312498580') # returns trueis_isbn_13('978-0312498580', normalize=False) # returns false

is_isbn_10: Checks if the given string is a valid ISBN 10

is_isbn_10('1506715214') # returns trueis_isbn_10('150-6715214') # returns trueis_isbn_10('150-6715214', normalize=False) # returns false

is_isbn: Checks if the given string is a valid ISBN (any version)

is_isbn('9780312498580') # returns trueis_isbn('1506715214') # returns true

is_slug: Checks if the string is a slug (as created byslugify())

is_slug('my-blog-post-title') # returns trueis_slug('My blog post title') # returns false

contains_html: Checks if the strings contains one ore more HTML/XML tag

contains_html('my string is <strong>bold</strong>') # returns truecontains_html('my string is not bold') # returns false

words_count: Returns the number of words contained in the string

words_count('hello world') # returns 2words_count('one,two,three') # returns 3 (no need for spaces, punctuation is recognized!)

is_palindrome: Checks if the string is a palindrome

is_palindrome('LOL') # returns trueis_palindrome('ROTFL') # returns false

is_pangram: Checks if the string is a pangram

is_pangram('The quick brown fox jumps over the lazy dog') # returns trueis_pangram('hello world') # returns false

is_isogram: Checks if the string is an isogram

is_isogram('dermatoglyphics') # returns trueis_isogram('hello') # returns false

String manipulation:

camel_case_to_snake: Converts a camel case formatted string into a snake case one

camel_case_to_snake('ThisIsACamelStringTest') # returns 'this_is_a_camel_case_string_test'

snake_case_to_camel: Converts a snake case formatted string into a camel case one

snake_case_to_camel('the_snake_is_green') # returns 'TheSnakeIsGreen'

reverse: Returns the string in a reversed order

reverse('hello') # returns 'olleh'

shuffle: Returns the string with its original chars but at randomized positions

shuffle('hello world') # possible output: 'l wodheorll'

strip_html: Removes all the HTML/XML tags found in a string

strip_html('test: <a href="foo/bar">click here</a>') # returns 'test: 'strip_html('test: <a href="foo/bar">click here</a>', keep_tag_content=True) # returns 'test: click here'

prettify: Reformat a string by applying basic grammar and formatting rules

prettify(' unprettified string ,, like this one,will be"prettified" .it\' s awesome! ')# the ouput will be: 'Unprettified string, like this one, will be "prettified". It\'s awesome!'

asciify: Converts all non-ascii chars contained in a string into the closest possible ascii representation

asciify('èéùúòóäåëýñÅÀÁÇÌÍÑÓË') # returns 'eeuuooaaeynAAACIINOE' (string is deliberately dumb in order to show char conversion)

slugify: Convert a string into a formatted "slug"

slugify('Top 10 Reasons To Love Dogs!!!') # returns: 'top-10-reasons-to-love-dogs'

booleanize: Convert a string into a boolean based on its content

booleanize('true') # returns truebooleanize('YES') # returns truebooleanize('y') # returns truebooleanize('1') # returns truebooelanize('something else') # returns false

strip_margin: Removes left indentation from multi-line strings (inspired by Scala)

strip_margin('''        line 1        line 2        line 3''')#returns:'''line 1line 2line 3'''

compress/decompress: Compress strings into shorted ones that can be restored back to the original one later on

compressed = compress(my_long_string) # shorter string (URL safe base64 encoded)decompressed = decompress(compressed) # string restoredassert(my_long_string == decompressed) # yep

roman_encode: Encode integers/string into roman numbers

roman_encode(37) # returns 'XXXVII'

roman_decode: Decode roman number into an integer

roman_decode('XXXVII') # returns 37

roman_range: Generator which returns roman numbers on each iteration

for n in roman_range(10): print(n) # prints: I, II, III, IV, V, VI, VII, VIII, IX, Xfor n in roman_range(start=7, stop=1, step=-1): print(n) # prints: VII, VI, V, IV, III, II, I

String generations:

uuid: Returns the string representation of a newly created UUID object

uuid() # possible output: 'ce2cd4ee-83de-46f6-a054-5ee4ddae1582'uuid(as_hex=True) # possible output: 'ce2cd4ee83de46f6a0545ee4ddae1582'

random_string: Creates a string of the specified size with random chars

random_string(9) # possible output: 'K1URtlTu5'

secure_random_hex: Creates an hexadecimal string using a secure strong random generator

secure_random_hex(12) # possible ouput: 'd1eedff4033a2e9867c37ded' # (len is 24, because 12 represents the number of random bytes generated, which are then converted to hexadecimal value)

Installation

pip install python-string-utils

Checking installed version

import string_utilsstring_utils.__version__'1.0.0' # (if '1.0.0' is the installed version)

Documentation

Full API documentation available onreadthedocs.io

Support the project!

Do you like this project? Would you like to see it updated more often with new features and improvements?If so, you can make a small donation by clicking the button down below, it would be really appreciated! :)

[8]ページ先頭
©2009-2025 Movatter.jp