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

DOC: Updated docstrings related to DateTimeIndex. GH22459 #22504

Merged
merged 3 commits into from
Nov 4, 2018
Merged

DOC: Updated docstrings related to DateTimeIndex. GH22459 #22504

merged 3 commits into from
Nov 4, 2018

Conversation

eldritchideen
Copy link
Contributor

  • closes #xxxx
  • tests added / passed
  • passes git diff upstream/master -u -- "*.py" | flake8 --diff
  • whatsnew entry

Updated pandas.date_range and pandas.bdate_range docstrings to resolve errors raised from scripts/validate_docstrings.py from #22459. Also added an example to pandas.bdate_range.

@codecov
Copy link

codecov bot commented Aug 25, 2018

Codecov Report

Merging #22504 into master will increase coverage by <.01%.
The diff coverage is n/a.

Impacted file tree graph

@@            Coverage Diff             @@
##           master   #22504      +/-   ##
==========================================
+ Coverage   92.22%   92.23%   +<.01%     
==========================================
  Files         161      161              
  Lines       51187    51197      +10     
==========================================
+ Hits        47209    47220      +11     
+ Misses       3978     3977       -1
Flag Coverage Δ
#multiple 90.61% <ø> (ø) ⬆️
#single 42.27% <ø> (+0.01%) ⬆️
Impacted Files Coverage Δ
pandas/core/indexes/datetimes.py 96.41% <ø> (ø) ⬆️
pandas/core/arrays/timedeltas.py 93.75% <0%> (-0.56%) ⬇️
pandas/core/indexes/api.py 99% <0%> (ø) ⬆️
pandas/core/generic.py 96.81% <0%> (ø) ⬆️
pandas/core/series.py 93.87% <0%> (ø) ⬆️
pandas/core/indexes/timedeltas.py 90.74% <0%> (+0.12%) ⬆️
pandas/core/indexes/frozen.py 92.1% <0%> (+0.43%) ⬆️
pandas/core/arrays/period.py 98.08% <0%> (+0.59%) ⬆️

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 4f71755...0e825d8. Read the comment docs.

>>> pd.bdate_range(start='1/1/2018', end='1/08/2018')
DatetimeIndex(['2018-01-01', '2018-01-02', '2018-01-03', '2018-01-04',
'2018-01-05', '2018-01-08'],
dtype='datetime64[ns]', freq='B')
Copy link
Member

Choose a reason for hiding this comment

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

Hmmm...that output formatting of the lines is a little weird there. Should they be more aligned?

the 'left', 'right', or both sides (None)
the 'left', 'right', or both sides (None).
**kwargs
For compatibility. Has no effect on the result.
Copy link
Member

Choose a reason for hiding this comment

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

Not sure we need to document **kwargs?

cc @WillAyd @datapythonista

Copy link
Member

Choose a reason for hiding this comment

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

Yes, we've been documenting them, even when we need to say that they don't have any effect. Explicit is better than implicit. :)

@gfyoung gfyoung added Docs Datetime Datetime data dtype labels Aug 25, 2018
@jreback
Copy link
Contributor

jreback commented Sep 18, 2018

@datapythonista

@pep8speaks
Copy link

Hello @eldritchideen! Thanks for updating the PR.

Copy link
Member

@datapythonista datapythonista left a comment

Choose a reason for hiding this comment

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

lgtm

@gfyoung
Copy link
Member

gfyoung commented Sep 19, 2018

@eldritchideen : Can you rebase onto master ? That will fix the Circle CI failures.

@datapythonista
Copy link
Member

@eldritchideen Can you please merge master into your PR? git fetch upstream && git merge upstream/master && git push

This will rerun the CI checks, and when everything is green we can merge this.

@datapythonista
Copy link
Member

Rebased, merging on green.

@jreback jreback added this to the 0.24.0 milestone Nov 4, 2018
@jreback jreback merged commit 2792cb1 into pandas-dev:master Nov 4, 2018
@jreback
Copy link
Contributor

jreback commented Nov 4, 2018

thanks @eldritchideen

JustinZhengBC pushed a commit to JustinZhengBC/pandas that referenced this pull request Nov 14, 2018
tm9k1 pushed a commit to tm9k1/pandas that referenced this pull request Nov 19, 2018
Pingviinituutti pushed a commit to Pingviinituutti/pandas that referenced this pull request Feb 28, 2019
Pingviinituutti pushed a commit to Pingviinituutti/pandas that referenced this pull request Feb 28, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Datetime Datetime data dtype Docs
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants