diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json index c9a934c8..cf911e92 100644 --- a/.devcontainer/devcontainer.json +++ b/.devcontainer/devcontainer.json @@ -33,7 +33,8 @@ "python.linting.pycodestylePath": "/usr/local/py-utils/bin/pycodestyle", "python.linting.pydocstylePath": "/usr/local/py-utils/bin/pydocstyle", "python.linting.pylintPath": "/usr/local/py-utils/bin/pylint", - "python.analysis.typeCheckingMode": "strict" + "python.analysis.typeCheckingMode": "basic", + "python.formatting.provider": "black" }, // Add the IDs of extensions you want installed when the container is created. diff --git a/.github/workflows/python-package.yml b/.github/workflows/python-package.yml index 922f1695..593fe061 100644 --- a/.github/workflows/python-package.yml +++ b/.github/workflows/python-package.yml @@ -36,8 +36,8 @@ jobs: - name: Run integrity checks run: | ./scripts/version.sh - pycodestyle --format=pylint setup.py archivist examples functests unittests - python3 -m pylint --rcfile=pylintrc setup.py archivist examples functests unittests + pycodestyle --format=pylint archivist examples functests unittests + python3 -m pylint archivist examples functests unittests python3 -m pyright archivist black archivist examples unittests functests (cd docs && make clean && make html) diff --git a/.github/workflows/python-publish.yml b/.github/workflows/python-publish.yml index b7ed4b77..682c57dc 100644 --- a/.github/workflows/python-publish.yml +++ b/.github/workflows/python-publish.yml @@ -30,7 +30,7 @@ jobs: sudo rm -rf /var/lib/apt/lists/* python3 -m pip install --upgrade pip python3 -m pip install -r requirements-dev.txt - python3 -m pip install build setuptools wheel twine + python3 -m pip install setuptools wheel - name: Build and publish env: TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }} diff --git a/Taskfile.yml b/Taskfile.yml index fadc734e..be72a759 100644 --- a/Taskfile.yml +++ b/Taskfile.yml @@ -41,8 +41,8 @@ tasks: cmds: - ./scripts/builder.sh python3 --version - ./scripts/builder.sh python3 -m pyright archivist - - ./scripts/builder.sh pycodestyle --format=pylint setup.py archivist examples functests unittests - - ./scripts/builder.sh python3 -m pylint --rcfile=pylintrc setup.py archivist examples functests unittests + - ./scripts/builder.sh pycodestyle --format=pylint archivist examples functests unittests + - ./scripts/builder.sh python3 -m pylint archivist examples functests unittests clean: desc: Clean git repo @@ -65,7 +65,7 @@ tasks: desc: Format code using black deps: [about] cmds: - - ./scripts/builder.sh black setup.py archivist examples functests unittests + - ./scripts/builder.sh black archivist examples functests unittests type-check: desc: Runs the pyright type checker against the core archivst files @@ -101,7 +101,4 @@ tasks: desc: Builds python wheel package deps: [about] cmds: - - rm -rf *egg-info - - rm -rf build - - rm -f dist/* - - python3 setup.py bdist_wheel + - ./scripts/builder.sh ./scripts/wheel.sh diff --git a/pylintrc b/pyproject.toml similarity index 57% rename from pylintrc rename to pyproject.toml index c573ac3e..04502767 100644 --- a/pylintrc +++ b/pyproject.toml @@ -1,606 +1,550 @@ -[MAIN] - -# Analyse import fallback blocks. This can be used to support both Python 2 and -# 3 compatible code, which means that the block might have code that exists -# only in one or another interpreter, leading to false positives when analysed. -analyse-fallback-blocks=no - -# Load and enable all available extensions. Use --list-extensions to see a list -# all available extensions. -#enable-all-extensions= - -# In error mode, checkers without error messages are disabled and for others, -# only the ERROR messages are displayed, and no reports are done by default. -#errors-only= - -# Always return a 0 (non-error) status code, even if lint errors are found. -# This is primarily useful in continuous integration scripts. -#exit-zero= +[build-system] +requires = [ "setuptools>=61.0", "wheel", "setuptools-git-versioning", ] +build-backend = "setuptools.build_meta" + +[tool.coverage.report] +fail_under = 100 + +[tool.coverage.run] +omit = [ + "archivist/timestamp.py", + "archivist/composite.py", + "archivist/logger.py", + "archivist/parser.py", + "archivist/cmds/*", + "exec*", +] + +[tool.setuptools-git-versioning] +enabled = true +template = "{tag}" +dev_template = "{tag}.post{ccount}+git.{sha}" +dirty_template = "{tag}.post{ccount}+git.{sha}.dirty" +count_commits_from_version_file = false + +[tool.pyright] +include = ["archivist"] + +[tool.pylint.main] +# Analyse import fallback blocks. This can be used to support both Python 2 and 3 +# compatible code, which means that the block might have code that exists only in +# one or another interpreter, leading to false positives when analysed. +# analyse-fallback-blocks = + +# Always return a 0 (non-error) status code, even if lint errors are found. This +# is primarily useful in continuous integration scripts. +# exit-zero = # A comma-separated list of package or module names from where C extensions may # be loaded. Extensions are loading into the active Python interpreter and may # run arbitrary code. -extension-pkg-allow-list= +# extension-pkg-allow-list = # A comma-separated list of package or module names from where C extensions may # be loaded. Extensions are loading into the active Python interpreter and may # run arbitrary code. (This is an alternative name to extension-pkg-allow-list # for backward compatibility.) -extension-pkg-whitelist= +# extension-pkg-whitelist = # Return non-zero exit code if any of these messages/categories are detected, # even if score is above --fail-under value. Syntax same as enable. Messages # specified are enabled, while categories only check already-enabled messages. -fail-on= +# fail-on = # Specify a score threshold to be exceeded before program exits with error. -fail-under=10 +fail-under = 10.0 # Interpret the stdin as a python script, whose filename needs to be passed as # the module_or_package argument. -#from-stdin= +# from-stdin = # Files or directories to be skipped. They should be base names, not paths. -ignore=CVS +ignore = ["CVS"] # Add files or directories matching the regex patterns to the ignore-list. The # regex matches against paths and can be in Posix or Windows format. -ignore-paths= +# ignore-paths = -# Files or directories matching the regex patterns are skipped. The regex -# matches against base names, not paths. The default value ignores Emacs file -# locks -ignore-patterns=^\.# +# Files or directories matching the regex patterns are skipped. The regex matches +# against base names, not paths. The default value ignores Emacs file locks +ignore-patterns = ["^\\.#"] -# List of module names for which member attributes should not be checked -# (useful for modules/projects where namespaces are manipulated during runtime -# and thus existing member attributes cannot be deduced by static analysis). It -# supports qualified module names, as well as Unix pattern matching. -ignored-modules= +# List of module names for which member attributes should not be checked (useful +# for modules/projects where namespaces are manipulated during runtime and thus +# existing member attributes cannot be deduced by static analysis). It supports +# qualified module names, as well as Unix pattern matching. +# ignored-modules = # Python code to execute, usually for sys.path manipulation such as # pygtk.require(). -#init-hook= +# init-hook = # Use multiple processes to speed up Pylint. Specifying 0 will auto-detect the -# number of processors available to use. -jobs=1 +# number of processors available to use, and will cap the count on Windows to +# avoid hangs. +jobs = 1 -# Control the amount of potential inferred values when inferring a single -# object. This can help the performance when dealing with large functions or -# complex, nested conditions. -limit-inference-results=100 +# Control the amount of potential inferred values when inferring a single object. +# This can help the performance when dealing with large functions or complex, +# nested conditions. +limit-inference-results = 100 # List of plugins (as comma separated values of python module names) to load, # usually to register additional checkers. -load-plugins= +# load-plugins = # Pickle collected data for later comparisons. -persistent=yes +persistent = true -# Minimum Python version to use for version dependent checks. Will default to -# the version used to run pylint. -py-version=3.7 +# Minimum Python version to use for version dependent checks. Will default to the +# version used to run pylint. +py-version = "3.7" # Discover python modules and packages in the file system subtree. -recursive=no +# recursive = # When enabled, pylint would attempt to guess common misconfiguration and emit # user-friendly hints instead of false-positive error messages. -suggestion-mode=yes +suggestion-mode = true # Allow loading of arbitrary C extensions. Extensions are imported into the # active Python interpreter and may run arbitrary code. -unsafe-load-any-extension=no - -# In verbose mode, extra non-checker-related info will be displayed. -#verbose= - - -[REPORTS] - -# Python expression which should return a score less than or equal to 10. You -# have access to the variables 'fatal', 'error', 'warning', 'refactor', -# 'convention', and 'info' which contain the number of messages in each -# category, as well as 'statement' which is the total number of statements -# analyzed. This score is used by the global evaluation report (RP0004). -evaluation=max(0, 0 if fatal else 10.0 - ((float(5 * error + warning + refactor + convention) / statement) * 10)) - -# Template used to display messages. This is a python new-style format string -# used to format the message information. See doc for all details. -msg-template= - -# Set the output format. Available formats are text, parseable, colorized, json -# and msvs (visual studio). You can also give a reporter class, e.g. -# mypackage.mymodule.MyReporterClass. -#output-format= - -# Tells whether to display a full report or only the messages. -reports=no - -# Activate the evaluation score. -score=yes - - -[MESSAGES CONTROL] - -# Only show warnings with the listed confidence levels. Leave empty to show -# all. Valid levels: HIGH, CONTROL_FLOW, INFERENCE, INFERENCE_FAILURE, -# UNDEFINED. -confidence=HIGH, - CONTROL_FLOW, - INFERENCE, - INFERENCE_FAILURE, - UNDEFINED - -# Disable the message, report, category or checker with the given id(s). You -# can either give multiple identifiers separated by comma (,) or put this -# option multiple times (only on the command line, not in the configuration -# file where it should appear only once). You can also use "--disable=all" to -# disable everything first and then re-enable specific checks. For example, if -# you want to run only the similarities checker, you can use "--disable=all -# --enable=similarities". If you want to run only the classes checker, but have -# no Warning level messages displayed, use "--disable=all --enable=classes -# --disable=W". -disable=raw-checker-failed, - bad-inline-option, - locally-disabled, - file-ignored, - suppressed-message, - useless-suppression, - deprecated-pragma - -# Enable the message, report, category or checker with the given id(s). You can -# either give multiple identifier separated by comma (,) or put this option -# multiple time (only on the command line, not in the configuration file where -# it should appear only once). See also the "--disable" option for examples. -enable=c-extension-no-member - +# unsafe-load-any-extension = -[CLASSES] - -# Warn about protected attribute access inside special methods -check-protected-access-in-special-methods=no - -# List of method names used to declare (i.e. assign) instance attributes. -defining-attr-methods=__init__, - __new__, - setUp, - __post_init__ - -# List of member names, which should be excluded from the protected access -# warning. -exclude-protected=_asdict, - _fields, - _replace, - _source, - _make - -# List of valid names for the first argument in a class method. -valid-classmethod-first-arg=cls +[tool.pylint.basic] +# Naming style matching correct argument names. +argument-naming-style = "snake_case" -# List of valid names for the first argument in a metaclass class method. -valid-metaclass-classmethod-first-arg=cls +# Regular expression matching correct argument names. Overrides argument-naming- +# style. If left empty, argument names will be checked with the set naming style. +argument-rgx = "" +# Naming style matching correct attribute names. +attr-naming-style = "snake_case" -[SPELLING] +# Regular expression matching correct attribute names. Overrides attr-naming- +# style. If left empty, attribute names will be checked with the set naming +# style. +# attr-rgx = -# Limits count of emitted suggestions for spelling mistakes. -max-spelling-suggestions=4 +# Bad variable names which should always be refused, separated by a comma. +bad-names = ["foo", "bar", "baz", "toto", "tutu", "tata"] -# Spelling dictionary name. Available dictionaries: en (aspell), en_AU -# (aspell), en_CA (aspell), en_GB (aspell), en_US (hunspell). -spelling-dict= +# Bad variable names regexes, separated by a comma. If names match any regex, +# they will always be refused +# bad-names-rgxs = -# List of comma separated words that should be considered directives if they -# appear at the beginning of a comment and should not be checked. -spelling-ignore-comment-directives=fmt: on,fmt: off,noqa:,noqa,nosec,isort:skip,mypy: +# Naming style matching correct class attribute names. +class-attribute-naming-style = "any" -# List of comma separated words that should not be checked. -spelling-ignore-words= +# Regular expression matching correct class attribute names. Overrides class- +# attribute-naming-style. If left empty, class attribute names will be checked +# with the set naming style. +# class-attribute-rgx = -# A path to a file that contains the private dictionary; one word per line. -spelling-private-dict-file=docs/spelling_wordlist.txt +# Naming style matching correct class constant names. +class-const-naming-style = "UPPER_CASE" -# Tells whether to store unknown words to the private dictionary (see the -# --spelling-private-dict-file option) instead of raising a message. -spelling-store-unknown-words=no +# Regular expression matching correct class constant names. Overrides class- +# const-naming-style. If left empty, class constant names will be checked with +# the set naming style. +# class-const-rgx = +# Naming style matching correct class names. +class-naming-style = "PascalCase" -[FORMAT] +# Regular expression matching correct class names. Overrides class-naming-style. +# If left empty, class names will be checked with the set naming style. +# class-rgx = -# Expected format of line ending, e.g. empty (any line ending), LF or CRLF. -expected-line-ending-format= +# Naming style matching correct constant names. +const-naming-style = "UPPER_CASE" -# Regexp for a line that is allowed to be longer than the limit. -ignore-long-lines=^\s*(# )??$ +# Regular expression matching correct constant names. Overrides const-naming- +# style. If left empty, constant names will be checked with the set naming style. +# const-rgx = -# Number of spaces of indent required inside a hanging or continued line. -indent-after-paren=4 +# Minimum line length for functions/classes that require docstrings, shorter ones +# are exempt. +docstring-min-length = -1 -# String used as indentation unit. This is usually " " (4 spaces) or "\t" (1 -# tab). -indent-string=' ' +# Naming style matching correct function names. +function-naming-style = "snake_case" -# Maximum number of characters on a single line. -max-line-length=100 +# Regular expression matching correct function names. Overrides function-naming- +# style. If left empty, function names will be checked with the set naming style. +# function-rgx = -# Maximum number of lines in a module. -max-module-lines=1000 +# Good variable names which should always be accepted, separated by a comma. +good-names = ["a", "b", "c", "d", "e", "i", "j", "k", "m", "c", "s", "fd", "r", "v", "y", "ex", "Run", "_"] -# Allow the body of a class to be on the same line as the declaration if body -# contains single statement. -single-line-class-stmt=no +# Good variable names regexes, separated by a comma. If names match any regex, +# they will always be accepted +# good-names-rgxs = -# Allow the body of an if to be on the same line as the test if there is no -# else. -single-line-if-stmt=no +# Include a hint for the correct naming format with invalid-name. +# include-naming-hint = +# Naming style matching correct inline iteration names. +inlinevar-naming-style = "any" -[SIMILARITIES] +# Regular expression matching correct inline iteration names. Overrides +# inlinevar-naming-style. If left empty, inline iteration names will be checked +# with the set naming style. +# inlinevar-rgx = -# Comments are removed from the similarity computation -ignore-comments=yes +# Naming style matching correct method names. +method-naming-style = "snake_case" -# Docstrings are removed from the similarity computation -ignore-docstrings=yes +# Regular expression matching correct method names. Overrides method-naming- +# style. If left empty, method names will be checked with the set naming style. +# method-rgx = -# Imports are removed from the similarity computation -ignore-imports=yes +# Naming style matching correct module names. +module-naming-style = "snake_case" -# Signatures are removed from the similarity computation -ignore-signatures=yes +# Regular expression matching correct module names. Overrides module-naming- +# style. If left empty, module names will be checked with the set naming style. +# module-rgx = -# Minimum lines number of a similarity. -min-similarity-lines=180 +# Colon-delimited sets of names that determine each other's naming style when the +# name regexes allow several styles. +# name-group = +# Regular expression which should only match function or class names that do not +# require a docstring. +no-docstring-rgx = "^_" -[REFACTORING] +# List of decorators that produce properties, such as abc.abstractproperty. Add +# to this list to register other decorators that produce valid properties. These +# decorators are taken in consideration only for invalid-name. +property-classes = ["abc.abstractproperty"] -# Maximum number of nested blocks for function / method body -max-nested-blocks=5 +# Regular expression matching correct type variable names. If left empty, type +# variable names will be checked with the set naming style. +# typevar-rgx = -# Complete name of functions that never returns. When checking for -# inconsistent-return-statements if a never returning function is called then -# it will be considered as an explicit return statement and no message will be -# printed. -never-returning-functions=sys.exit,argparse.parse_error +# Naming style matching correct variable names. +variable-naming-style = "snake_case" +# Regular expression matching correct variable names. Overrides variable-naming- +# style. If left empty, variable names will be checked with the set naming style. +# variable-rgx = -[LOGGING] +[tool.pylint.classes] +# Warn about protected attribute access inside special methods +# check-protected-access-in-special-methods = -# The type of string formatting that logging methods do. `old` means using % -# formatting, `new` is for `{}` formatting. -logging-format-style=old +# List of method names used to declare (i.e. assign) instance attributes. +defining-attr-methods = ["__init__", "__new__", "setUp", "__post_init__"] -# Logging modules to check that the string format arguments are in logging -# function parameter format. -logging-modules=logging +# List of member names, which should be excluded from the protected access +# warning. +exclude-protected = ["_asdict", "_fields", "_replace", "_source", "_make"] +# List of valid names for the first argument in a class method. +valid-classmethod-first-arg = ["cls"] -[DESIGN] +# List of valid names for the first argument in a metaclass class method. +valid-metaclass-classmethod-first-arg = ["cls"] +[tool.pylint.design] # List of regular expressions of class ancestor names to ignore when counting # public methods (see R0903) -exclude-too-few-public-methods= +# exclude-too-few-public-methods = -# List of qualified class names to ignore when counting class parents (see -# R0901) -ignored-parents= +# List of qualified class names to ignore when counting class parents (see R0901) +# ignored-parents = # Maximum number of arguments for function / method. -max-args=6 +max-args = 6 # Maximum number of attributes for a class (see R0902). -max-attributes=7 +max-attributes = 7 # Maximum number of boolean expressions in an if statement (see R0916). -max-bool-expr=5 +max-bool-expr = 5 # Maximum number of branch for function / method body. -max-branches=12 +max-branches = 12 # Maximum number of locals for function / method body. -max-locals=20 +max-locals = 20 # Maximum number of parents for a class (see R0901). -max-parents=7 +max-parents = 7 # Maximum number of public methods for a class (see R0904). -max-public-methods=20 +max-public-methods = 20 # Maximum number of return / yield for function / method body. -max-returns=6 +max-returns = 6 # Maximum number of statements in function / method body. -max-statements=50 +max-statements = 50 # Minimum number of public methods for a class (see R0903). -min-public-methods=2 - - -[BASIC] - -# Naming style matching correct argument names. -argument-naming-style=snake_case - -# Regular expression matching correct argument names. Overrides argument- -# naming-style. If left empty, argument names will be checked with the set -# naming style. -argument-rgx= - -# Naming style matching correct attribute names. -attr-naming-style=snake_case - -# Regular expression matching correct attribute names. Overrides attr-naming- -# style. If left empty, attribute names will be checked with the set naming -# style. -#attr-rgx= - -# Bad variable names which should always be refused, separated by a comma. -bad-names=foo, - bar, - baz, - toto, - tutu, - tata - -# Bad variable names regexes, separated by a comma. If names match any regex, -# they will always be refused -bad-names-rgxs= - -# Naming style matching correct class attribute names. -class-attribute-naming-style=any - -# Regular expression matching correct class attribute names. Overrides class- -# attribute-naming-style. If left empty, class attribute names will be checked -# with the set naming style. -#class-attribute-rgx= - -# Naming style matching correct class constant names. -class-const-naming-style=UPPER_CASE +min-public-methods = 2 -# Regular expression matching correct class constant names. Overrides class- -# const-naming-style. If left empty, class constant names will be checked with -# the set naming style. -#class-const-rgx= +[tool.pylint.exceptions] +# Exceptions that will emit a warning when caught. +overgeneral-exceptions = ["BaseException", "Exception"] -# Naming style matching correct class names. -class-naming-style=PascalCase +[tool.pylint.format] +# Expected format of line ending, e.g. empty (any line ending), LF or CRLF. +# expected-line-ending-format = -# Regular expression matching correct class names. Overrides class-naming- -# style. If left empty, class names will be checked with the set naming style. -#class-rgx= +# Regexp for a line that is allowed to be longer than the limit. +ignore-long-lines = "^\\s*(# )??$" -# Naming style matching correct constant names. -const-naming-style=UPPER_CASE +# Number of spaces of indent required inside a hanging or continued line. +indent-after-paren = 4 -# Regular expression matching correct constant names. Overrides const-naming- -# style. If left empty, constant names will be checked with the set naming -# style. -#const-rgx= +# String used as indentation unit. This is usually " " (4 spaces) or "\t" (1 +# tab). +indent-string = " " -# Minimum line length for functions/classes that require docstrings, shorter -# ones are exempt. -docstring-min-length=-1 +# Maximum number of characters on a single line. +max-line-length = 100 -# Naming style matching correct function names. -function-naming-style=snake_case +# Maximum number of lines in a module. +max-module-lines = 1000 -# Regular expression matching correct function names. Overrides function- -# naming-style. If left empty, function names will be checked with the set -# naming style. -#function-rgx= +# Allow the body of a class to be on the same line as the declaration if body +# contains single statement. +# single-line-class-stmt = -# Good variable names which should always be accepted, separated by a comma. -good-names=a,b,c,d,e,i,j,k,m,c,s,fd, - r,v,y, - ex, - Run, - _ +# Allow the body of an if to be on the same line as the test if there is no else. +# single-line-if-stmt = -# Good variable names regexes, separated by a comma. If names match any regex, -# they will always be accepted -good-names-rgxs= +[tool.pylint.imports] +# List of modules that can be imported at any level, not just the top level one. +# allow-any-import-level = -# Include a hint for the correct naming format with invalid-name. -include-naming-hint=no +# Allow wildcard imports from modules that define __all__. +# allow-wildcard-with-all = -# Naming style matching correct inline iteration names. -inlinevar-naming-style=any +# Deprecated modules which should not be used, separated by a comma. +# deprecated-modules = -# Regular expression matching correct inline iteration names. Overrides -# inlinevar-naming-style. If left empty, inline iteration names will be checked -# with the set naming style. -#inlinevar-rgx= +# Output a graph (.gv or any supported image format) of external dependencies to +# the given file (report RP0402 must not be disabled). +# ext-import-graph = -# Naming style matching correct method names. -method-naming-style=snake_case +# Output a graph (.gv or any supported image format) of all (i.e. internal and +# external) dependencies to the given file (report RP0402 must not be disabled). +# import-graph = -# Regular expression matching correct method names. Overrides method-naming- -# style. If left empty, method names will be checked with the set naming style. -#method-rgx= +# Output a graph (.gv or any supported image format) of internal dependencies to +# the given file (report RP0402 must not be disabled). +# int-import-graph = -# Naming style matching correct module names. -module-naming-style=snake_case +# Force import order to recognize a module as part of the standard compatibility +# libraries. +# known-standard-library = -# Regular expression matching correct module names. Overrides module-naming- -# style. If left empty, module names will be checked with the set naming style. -#module-rgx= +# Force import order to recognize a module as part of a third party library. +known-third-party = ["enchant"] -# Colon-delimited sets of names that determine each other's naming style when -# the name regexes allow several styles. -name-group= +# Couples of modules and preferred modules, separated by a comma. +# preferred-modules = -# Regular expression which should only match function or class names that do -# not require a docstring. -no-docstring-rgx=^_ +[tool.pylint.logging] +# The type of string formatting that logging methods do. `old` means using % +# formatting, `new` is for `{}` formatting. +logging-format-style = "old" -# List of decorators that produce properties, such as abc.abstractproperty. Add -# to this list to register other decorators that produce valid properties. -# These decorators are taken in consideration only for invalid-name. -property-classes=abc.abstractproperty +# Logging modules to check that the string format arguments are in logging +# function parameter format. +logging-modules = ["logging"] + +[tool.pylint."messages control"] +# Only show warnings with the listed confidence levels. Leave empty to show all. +# Valid levels: HIGH, CONTROL_FLOW, INFERENCE, INFERENCE_FAILURE, UNDEFINED. +confidence = ["HIGH", "CONTROL_FLOW", "INFERENCE", "INFERENCE_FAILURE", "UNDEFINED"] + +# Disable the message, report, category or checker with the given id(s). You can +# either give multiple identifiers separated by comma (,) or put this option +# multiple times (only on the command line, not in the configuration file where +# it should appear only once). You can also use "--disable=all" to disable +# everything first and then re-enable specific checks. For example, if you want +# to run only the similarities checker, you can use "--disable=all +# --enable=similarities". If you want to run only the classes checker, but have +# no Warning level messages displayed, use "--disable=all --enable=classes +# --disable=W". +disable = ["raw-checker-failed", "bad-inline-option", "locally-disabled", "file-ignored", "suppressed-message", "useless-suppression", "deprecated-pragma", "use-symbolic-message-instead"] -# Regular expression matching correct type variable names. If left empty, type -# variable names will be checked with the set naming style. -#typevar-rgx= +# Enable the message, report, category or checker with the given id(s). You can +# either give multiple identifier separated by comma (,) or put this option +# multiple time (only on the command line, not in the configuration file where it +# should appear only once). See also the "--disable" option for examples. +enable = ["c-extension-no-member"] -# Naming style matching correct variable names. -variable-naming-style=snake_case +[tool.pylint.miscellaneous] +# List of note tags to take in consideration, separated by a comma. +notes = ["FIXME", "XXX", "TODO"] -# Regular expression matching correct variable names. Overrides variable- -# naming-style. If left empty, variable names will be checked with the set -# naming style. -#variable-rgx= +# Regular expression of note tags to take in consideration. +# notes-rgx = +[tool.pylint.refactoring] +# Maximum number of nested blocks for function / method body +max-nested-blocks = 5 -[MISCELLANEOUS] +# Complete name of functions that never returns. When checking for inconsistent- +# return-statements if a never returning function is called then it will be +# considered as an explicit return statement and no message will be printed. +never-returning-functions = ["sys.exit", "argparse.parse_error"] -# List of note tags to take in consideration, separated by a comma. -notes=FIXME, - XXX, - TODO +[tool.pylint.reports] +# Python expression which should return a score less than or equal to 10. You +# have access to the variables 'fatal', 'error', 'warning', 'refactor', +# 'convention', and 'info' which contain the number of messages in each category, +# as well as 'statement' which is the total number of statements analyzed. This +# score is used by the global evaluation report (RP0004). +evaluation = "max(0, 0 if fatal else 10.0 - ((float(5 * error + warning + refactor + convention) / statement) * 10))" -# Regular expression of note tags to take in consideration. -notes-rgx= +# Template used to display messages. This is a python new-style format string +# used to format the message information. See doc for all details. +# msg-template = +# Set the output format. Available formats are text, parseable, colorized, json +# and msvs (visual studio). You can also give a reporter class, e.g. +# mypackage.mymodule.MyReporterClass. +# output-format = -[EXCEPTIONS] +# Tells whether to display a full report or only the messages. +# reports = -# Exceptions that will emit a warning when caught. -overgeneral-exceptions=BaseException, - Exception +# Activate the evaluation score. +score = true +[tool.pylint.similarities] +# Comments are removed from the similarity computation +ignore-comments = true -[IMPORTS] +# Docstrings are removed from the similarity computation +ignore-docstrings = true -# List of modules that can be imported at any level, not just the top level -# one. -allow-any-import-level= +# Imports are removed from the similarity computation +ignore-imports = true -# Allow wildcard imports from modules that define __all__. -allow-wildcard-with-all=no +# Signatures are removed from the similarity computation +ignore-signatures = true -# Deprecated modules which should not be used, separated by a comma. -deprecated-modules= +# Minimum lines number of a similarity. +min-similarity-lines = 180 -# Output a graph (.gv or any supported image format) of external dependencies -# to the given file (report RP0402 must not be disabled). -ext-import-graph= +[tool.pylint.spelling] +# Limits count of emitted suggestions for spelling mistakes. +max-spelling-suggestions = 4 -# Output a graph (.gv or any supported image format) of all (i.e. internal and -# external) dependencies to the given file (report RP0402 must not be -# disabled). -import-graph= +# Spelling dictionary name. Available dictionaries: en (aspell), en_AU (aspell), +# en_CA (aspell), en_GB (aspell), en_US (hunspell). +# spelling-dict = -# Output a graph (.gv or any supported image format) of internal dependencies -# to the given file (report RP0402 must not be disabled). -int-import-graph= +# List of comma separated words that should be considered directives if they +# appear at the beginning of a comment and should not be checked. +spelling-ignore-comment-directives = "fmt: on,fmt: off,noqa:,noqa,nosec,isort:skip,mypy:" -# Force import order to recognize a module as part of the standard -# compatibility libraries. -known-standard-library= +# List of comma separated words that should not be checked. +# spelling-ignore-words = -# Force import order to recognize a module as part of a third party library. -known-third-party=enchant +# A path to a file that contains the private dictionary; one word per line. +spelling-private-dict-file = "docs/spelling_wordlist.txt" -# Couples of modules and preferred modules, separated by a comma. -preferred-modules= +# Tells whether to store unknown words to the private dictionary (see the +# --spelling-private-dict-file option) instead of raising a message. +# spelling-store-unknown-words = +[tool.pylint.string] +# This flag controls whether inconsistent-quotes generates a warning when the +# character used as a quote delimiter is used inconsistently within a module. +# check-quote-consistency = -[TYPECHECK] +# This flag controls whether the implicit-str-concat should generate a warning on +# implicit string concatenation in sequences defined over several lines. +# check-str-concat-over-line-jumps = +[tool.pylint.typecheck] # List of decorators that produce context managers, such as # contextlib.contextmanager. Add to this list to register other decorators that # produce valid context managers. -contextmanager-decorators=contextlib.contextmanager +contextmanager-decorators = ["contextlib.contextmanager"] # List of members which are set dynamically and missed by pylint inference # system, and so shouldn't trigger E1101 when accessed. Python regular # expressions are accepted. -generated-members= +# generated-members = -# Tells whether to warn about missing members when the owner of the attribute -# is inferred to be None. -ignore-none=yes +# Tells whether missing members accessed in mixin class should be ignored. A +# class is considered mixin if its name matches the mixin-class-rgx option. +# Tells whether to warn about missing members when the owner of the attribute is +# inferred to be None. +ignore-none = true # This flag controls whether pylint should warn about no-member and similar -# checks whenever an opaque object is returned when inferring. The inference -# can return multiple potential results while evaluating a Python object, but -# some branches might not be evaluated, which results in partial inference. In -# that case, it might be useful to still emit no-member and other checks for -# the rest of the inferred objects. -ignore-on-opaque-inference=yes +# checks whenever an opaque object is returned when inferring. The inference can +# return multiple potential results while evaluating a Python object, but some +# branches might not be evaluated, which results in partial inference. In that +# case, it might be useful to still emit no-member and other checks for the rest +# of the inferred objects. +ignore-on-opaque-inference = true # List of symbolic message names to ignore for Mixin members. -ignored-checks-for-mixins=no-member, - not-async-context-manager, - not-context-manager, - attribute-defined-outside-init +ignored-checks-for-mixins = ["no-member", "not-async-context-manager", "not-context-manager", "attribute-defined-outside-init"] # List of class names for which member attributes should not be checked (useful # for classes with dynamically set attributes). This supports the use of # qualified names. -ignored-classes=optparse.Values,thread._local,_thread._local,argparse.Namespace +ignored-classes = ["optparse.Values", "thread._local", "_thread._local", "argparse.Namespace"] -# Show a hint with possible names when a member name was not found. The aspect -# of finding the hint is based on edit distance. -missing-member-hint=yes +# Show a hint with possible names when a member name was not found. The aspect of +# finding the hint is based on edit distance. +missing-member-hint = true # The minimum edit distance a name should have in order to be considered a # similar match for a missing member name. -missing-member-hint-distance=1 +missing-member-hint-distance = 1 # The total number of similar names that should be taken in consideration when # showing a hint for a missing member. -missing-member-max-choices=1 +missing-member-max-choices = 1 # Regex pattern to define which classes are considered mixins. -mixin-class-rgx=.*[Mm]ixin +mixin-class-rgx = ".*[Mm]ixin" # List of decorators that change the signature of a decorated function. -signature-mutators= +# signature-mutators = - -[VARIABLES] - -# List of additional names supposed to be defined in builtins. Remember that -# you should avoid defining new builtins when possible. -additional-builtins= +[tool.pylint.variables] +# List of additional names supposed to be defined in builtins. Remember that you +# should avoid defining new builtins when possible. +# additional-builtins = # Tells whether unused global variables should be treated as a violation. -allow-global-unused-variables=yes +allow-global-unused-variables = true # List of names allowed to shadow builtins -allowed-redefined-builtins= +# allowed-redefined-builtins = -# List of strings which can identify a callback function by name. A callback -# name must start or end with one of those strings. -callbacks=cb_, - _cb +# List of strings which can identify a callback function by name. A callback name +# must start or end with one of those strings. +callbacks = ["cb_", "_cb"] -# A regular expression matching the name of dummy variables (i.e. expected to -# not be used). -dummy-variables-rgx=_+$|(_[a-zA-Z0-9_]*[a-zA-Z0-9]+?$)|dummy|^ignored_|^unused_ +# A regular expression matching the name of dummy variables (i.e. expected to not +# be used). +dummy-variables-rgx = "_+$|(_[a-zA-Z0-9_]*[a-zA-Z0-9]+?$)|dummy|^ignored_|^unused_" -# Argument names that match this expression will be ignored. Default to name -# with leading underscore. -ignored-argument-names=_.*|^ignored_|^unused_ +# Argument names that match this expression will be ignored. Default to name with +# leading underscore. +ignored-argument-names = "_.*|^ignored_|^unused_" # Tells whether we should check for unused import in __init__ files. -init-import=no +# init-import = # List of qualified module names which can have objects that can redefine # builtins. -redefining-builtins-modules=six.moves,past.builtins,future.builtins,builtins,io - +redefining-builtins-modules = ["six.moves", "past.builtins", "future.builtins", "builtins", "io"] -[STRING] - -# This flag controls whether inconsistent-quotes generates a warning when the -# character used as a quote delimiter is used inconsistently within a module. -check-quote-consistency=no -# This flag controls whether the implicit-str-concat should generate a warning -# on implicit string concatenation in sequences defined over several lines. -check-str-concat-over-line-jumps=no diff --git a/requirements-dev.txt b/requirements-dev.txt index a12c19a8..8292bba1 100644 --- a/requirements-dev.txt +++ b/requirements-dev.txt @@ -3,7 +3,7 @@ # code quality autopep8~=1.6 black~=22.6 -coverage~=6.4 +coverage[toml]~=6.4 pip-audit~=2.4 pycodestyle~=2.9 pylint~=2.14 diff --git a/scripts/version.sh b/scripts/version.sh index 6de01bac..e6d6ba98 100755 --- a/scripts/version.sh +++ b/scripts/version.sh @@ -2,7 +2,7 @@ # # inserts version into python package # -version=$(python3 setup.py --version) +version=$(git describe --tags --long --dirty) cat > archivist/about.py <=3.7 +setup_requires = setuptools-git-versioning + +[options.entry_points] +console_scripts = + archivist_runner = archivist.cmds.runner.main:main + archivist_template = archivist.cmds.template.main:main + +[bdist_wheel] +universal = 1 diff --git a/setup.py b/setup.py deleted file mode 100644 index 6049c561..00000000 --- a/setup.py +++ /dev/null @@ -1,55 +0,0 @@ -#!/usr/bin/env python3 - -""" -Setup script for python build system -""" -import os -from setuptools import setup, find_packages - -HERE = os.path.dirname(__file__) -REPO_URL = "https://github.com/jitsuin-inc/archivist-python/" -NAME = "jitsuin-archivist" - -with open(os.path.join(HERE, "README.rst"), encoding="utf-8") as FF: - DESC = FF.read() - -with open(os.path.join(HERE, "requirements.txt"), encoding="utf-8") as FF: - requirements = [f"{line.strip()}" for line in FF] - -setup( - name=NAME, - author="RKVST Inc.", - author_email="support@rkvst.com", - description="RKVST Client", - long_description=DESC, - long_description_content_type="text/x-rst", - url=REPO_URL, - packages=find_packages(exclude=("examples", "unittests", "functests")), - platforms=["any"], - classifiers=[ - "Development Status :: 3 - Alpha", # pre-delivery - "Environment :: Console", - "Intended Audience :: Developers", - "License :: OSI Approved :: MIT License", # MIT - "Operating System :: POSIX :: Linux", # https://pypi.org/classifiers/ # on anything - "Programming Language :: Python :: 3.7", - "Topic :: Utilities", # https://pypi.org/classifiers/ # check another option client-sdk - ], - install_requires=requirements, - setuptools_git_versioning={ - "template": "{tag}", - "dev_template": "{tag}.post{ccount}+git.{sha}", - "dirty_template": "{tag}.post{ccount}+git.{sha}.dirty", - "version_callback": None, - "version_file": None, - "count_commits_from_version_file": False, - }, - setup_requires=["setuptools-git-versioning"], - python_requires=">=3.7", - entry_points={ - "console_scripts": [ - "archivist_runner = archivist.cmds.runner.main:main", - "archivist_template = archivist.cmds.template.main:main", - ], - }, -)