Join GitHub today
GitHub is home to over 50 million developers working together to host and review code, manage projects, and build software together.
Sign upDev sprint ideas: More tests, type hints and less complexity #2128
Comments
We push all new contributions to use type hints as discussed in CONTRIBUTING.md.
We do this already https://github.com/TheAlgorithms/Python/blob/master/.travis.yml#L17 |
@cclauss How about a dev sprint kind of thing where we go about adding all such improvements? |
Cool idea! Another thing (a sprint topic?) that is bugging me is code complexity which we currently set to 25 but I would be much happier to see it at 15. We would need to ensure that the files have strong type hints and tests before modifying them to reduce their cyclomatic complexity. |
Another cool sprint topic would be to add doctests to Python files that have <10% test coverage. Some files like file_transfer/send_file.py and the web programming files are difficult to write tests for but others should be fair game. |
Should we have a short sprint or a long one? One idea would be 24 hour sprint — given that tomorrow is summer solstice (longest day of the year) — the sprint could start at midnight tonight (in whatever timezone the contributer is in) and last for 24 hours. #2128 could be our tracking issue for keeping track of tasks and accomplishments. Thoughts on this Summer Solstice Special Sprint idea. |
Seems awesome, we can gain some attention by Summer Solstice Special Sprint, I am up on gitter if you want to discuss |
Difficult but not impossible. We can create issue with some labels. Perhaps we find someone who will write tests or even code (for example simple server for response) for testing it |
…#2141) * Euler problem 551 sol 1: Reduce McCabe code complexity As discussed in TheAlgorithms#2128 * fixup! Format Python code with psf/black push Co-authored-by: github-actions <${GITHUB_ACTOR}@users.noreply.github.com>
* hamming_code.py: Reduce McCabe code complexity As discussed in TheAlgorithms#2128 * fixup! Format Python code with psf/black push Co-authored-by: github-actions <${GITHUB_ACTOR}@users.noreply.github.com>
I have an idea. How about making the code more idiomatic and Pythonic? For example, currently I see a lot of code of the form: for i in range(len(some_iterable)):
...
do something with i or some_iterable[i] It is better to do: for index, item in enumerate(some_iterable):
...
do something with item or index or if it is a dictionary: for key, value in some_iterable.items():
do something with key or value This is just one example. There are also many pieces of code where comprehension can replace for-loops. There are many other ways to write more Pythonic code. Here are some excellent videos from one of the experts of the subject: I understand this would be a huge undertaking, but it's just an idea that pays off greatly in the long run. We can all become better Python coders! |
Incrementalism wins. Please don't try to do this across many files at once. Instead, please find a file that needs improvement and submit a pull request to improve just that one file. Please create other similar PRs for other individual files. We can progress file-by-file in this manner. |
@cclauss Got it. |
) * added type hints and doctests to arithmetic_analysis/bisection.py continuing in line with #2128 * modified arithmetic_analysis/bisection.py Put back print statement at the end, replaced algorithm's print statement with an exception. * modified arithmetic_analysis/bisection.py Removed unnecessary type import "Optional" * modified arithmetic_analysis/bisection.py Replaced generic Exception with ValueError. * modified arithmetic_analysis/bisection.py fixed doctests
…#2259) * added type hints and doctests to arithmetic_analysis/newton_method.py Continuing #2128 Also changed some variable names, made them more descriptive. * Added type hints and doctests to arithmetic_analysis/newton_method.py added a type alias for Callable[[float], float] and cleaned up the exception handling * added type hints and doctests to arithmetic_analysis/newton_method.py improved exception handling * Update newton_method.py Co-authored-by: Christian Clauss <[email protected]>
Hey, keen to contribute. I am first timer in open source |
currently, some of the programs use static type checking like this program but some of the programs did not use static typing.
it's a good practice to use static typing as it makes code more clear and readable, should we make it a standard for this repository.we can use mypy for testing code
more on static typing
thank you
Dev sprint ideas:
flake8 --max-complexity=15
(Ensure files have strong tests before refactoring). Test results from #2139...