Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated README.rst to include how to do the setup #555

Open
wants to merge 7 commits into
base: main
Choose a base branch
from

Conversation

za
Copy link

@za za commented May 25, 2022

Hi there,

I was wondering if adding this information will be helpful. Esp. for beginners.

@codecov
Copy link

codecov bot commented May 25, 2022

Codecov Report

Merging #555 (912deb3) into main (1fa715e) will not change coverage.
The diff coverage is n/a.

Impacted file tree graph

@@            Coverage Diff            @@
##              main      #555   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files            6         6           
  Lines          357       357           
  Branches        29        29           
=========================================
  Hits           357       357           
Flag Coverage Δ
Python_3.11 100.00% <ø> (ø)
Python_3.12 100.00% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

Copy link
Member

@ezio-melotti ezio-melotti left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the PR -- I left a few comments.
Also remember to sign the CLA :)

README.rst Outdated

Requires Python 3.6+

```
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This file uses rst instead of MarkDown. See https://devguide.python.org/documenting/#showing-code-examples

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ezio-melotti can I use shell? for the codeblock?

.. code-block:: shell

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry, I've updated to use ::.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

https://pygments.org/docs/lexers/#lexers-for-various-shells shell is accepted, otherwise you can use bash or sh too. See also the .. highlight:: directive as suggested in the review.

README.rst Outdated Show resolved Hide resolved
README.rst Outdated Show resolved Hide resolved
@za
Copy link
Author

za commented May 26, 2022

Also remember to sign the CLA :)

Yes, I've signed the CLA ;-)

Copy link
Member

@ezio-melotti ezio-melotti left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The markup looks good now. You could set the highlight language too, but it's not essential.
I'll let @Mariatta double-check if the content is correct and merge the PR.

README.rst Outdated Show resolved Hide resolved
@za
Copy link
Author

za commented May 27, 2022

The markup looks good now. You could set the highlight language too, but it's not essential.

Hi @ezio-melotti Thanks for the review!

Create virtual environment and activate it::

$ python3 -m venv venv
$ source venv/bin/activate
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This assumes a unix environment and won't work for Windows I think. Is that an issue?

Comment on lines +49 to +50
Requires Python 3.6+

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's not repeat this info from line 15:

Suggested change
Requires Python 3.6+

It's probably out of date: since #657 we only test 3.11+ so should match that.


Requires Python 3.6+

Create virtual environment and activate it::
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since #620, we have a tox.ini config, so we can replace the venv setup, dependency installation and pytest call with installing and running tox.

Comment on lines +44 to +45
Setup Info
==========
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section is really about running tests, let's name it to reflect this.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants