Advanced types for Python3: ImmutableDict and UniqList.
from nicetypes import ImmutableDict
frozen_dict = ImmutableDict({"foo": 1, "bar": 2})
print(frozen_dict)
# ImmutableDict({'foo': 1, 'bar': 2})
frozen_dict["foo"] = 3
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
TypeError: 'ImmutableDict' object does not support item assignmentfrom nicetypes import UniqList
unql = UniqList([1, 2, 2, 2, 3, 2])
print(unql)
# UniqList([1, 2, 3])
unql.append(4)
unql.append(4)
print(unql)
# UniqList([1, 2, 3, 4])This module is developped on a Fedora 25 machine with Python 3.5.3, but it should theoretically run on any system with a Python3 interpreter. Don't hesitate to report any issues if it doesn't work on your platform. However, this module is not intented to work on Python2.
First, make sure Pip is installed. Linux users should use their package manager. Alternatively, you can follow the official site documentation. Then, make sure virtualenv is installed. Most linux distribution provide a virtualenvwrapper package that make virtualenvs easy-to-use. Otherwise, you might read this documentation.
mkvirtualenv -p python3 foobar
workon foobar # Should be automatically done by the previous command
pip install nicetypes
# Later, check for upgrades with
pip install -U nicetypesThis method is similar to the previous one. First, get pip. Then, install nicetypes directly on your system with admin rights instead of installing it in a isolated virtualenv.
sudo pip3 install nicetypes
# Later, check for upgrades with
sudo pip3 install -U nicetypesIf you can't use Pip, then you could download the sources directly from Github. However, you should understand that you will need to handle updates and system integration all by yourself if you choose this method.
- Make sure you have the following packages installed:
- Python3,
- Git,
- Virtualenv.
- Clone this Github repository and enter the repository.
- Create a Python3 virtualenv and activate it.
- Install the development dependencies with
pip install -r dev-requirements.txt
Keep PEP20 in mind, and use pylint to follow the coding style guide:
pylint --rcfile=.pylintrc src/nicetypes
Make sure that all the code is covered by unit tests. Use a Given-When-Then structure to increase the tests readability. Avoid importing external libraries for the assertions, use the unittest methods instead. Run the tests and check the coverage with:
py.test --verbose --cov=src --cov-fail-under=100
This module use a Travis pipeline for continuous integration. It performs the following actions when a Git branch is pushed on Github:
- check the style guide,
- run the unit tests and checking the coverage,
- in case of tagged release, deploy to PyPI.
This module is licensed under the MIT License - see the LICENSE file for details.