Skip to content

io.ascii - #154

Merged
taldcroft merged 18 commits into
astropy:masterfrom
taldcroft:table
Feb 20, 2012
Merged

taldcroft merged 18 commits into
astropy:masterfrom
taldcroft:table

Conversation

@taldcroft

Copy link
Copy Markdown
Member

This is a preview pull-request for my rework of asciitable as astropy.io.ascii. The goal is to enable initial review and discussion.

All tests pass on linux x86_64 py3.2 and py2.7, but I've just gotten a slew of emails that OSX10.7 is failing miserably on TR's jenkins server. Will need to investigate. EDIT: this was resolved.

This code base is structured to allow rsync'ing of code and test files between standalone asciitable and astropy.io.ascii. Thus there are some things that might look awkward (and of course suggestions for improvement are welcome!). In addition asciitable supports 2.5 and doesn't require NumPy, so there are still more tests that look ugly.

On the plus side both asciitable (optionally) and astropy.io.ascii (by default) now take advantage of astropy.table.Table.

Docs are ported as well.

@eteq

eteq commented Feb 9, 2012

Copy link
Copy Markdown
Member

I definitely like it big-picture (I'm a fan of asciitable, for that matter), although I haven't read through this terribly closely yet.

A couple organizational question/comments, though: What is the astropy/io/ascii/tests/t directory for? Is that just for storing the data that the tests use? If so, this is exactly the sort of place where the astropy.config.data package might be useful. I understand that this is pre-existing code, and it might be a lot harder to keep it in sync with the standalone version, but it's something you at least want to consider.

Also, I would also strongly encourage you to include the docs whenever you get a chance to that (before merging) - one of the best things about asciitable is the excellent docs, IMHO!

Tom Aldcroft and others added 2 commits February 9, 2012 15:46
For unknown reasons this caused an obscure problem when testing on MacOSX.
@taldcroft

Copy link
Copy Markdown
Member Author

@eteq :

I'm working on getting the docs in now. This requires a wee bit of work since some of the content needs to be different (e.g. no installation instructions etc) from standalone asciitable and as usual I'm aiming for (basically) one code base.

astropy/io/ascii/tests/t is the test data, and as you suspected the reason it is in tests is for compatibility with standalone asciitable. This is also matches what io.fits does (which may also be motivated by the duality with pyfits).

The io.ascii docs are automatically derived from the asciitable
docs, with some slight modifications like elimination of
download/installation instructions.  Currently "asciitable"
is globally replaced by "astropy.io.ascii", which is formally
correct but gives a heavy look to some examples.

Some modifications to io.ascii docstrings were also made to fix
doc build errors or warnings.

The io.ascii docs were refactored into separate .rst files for each
section.  The same change was made in asciitable docs.
Comment thread docs/ascii/index.rst Outdated

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I would recommend you make this ``astropy.io.ascii Documentation (and add the necessary `===` below it) to be consistent with the rest of the documentation.

@eteq

eteq commented Feb 15, 2012

Copy link
Copy Markdown
Member

Looks pretty good (and tests pass for me), aside from the documentation comment I made inline above. Other than that, are you done making changes?

@taldcroft

Copy link
Copy Markdown
Member Author

Commit e1d54f0 updates the docs per the comments from @eteq. I don't have any other changes in the queue, so maybe we should merge this?

@taldcroft

Copy link
Copy Markdown
Member Author

If anybody has additional comments or wants more time for review then speak by Friday. Otherwise I'll plan to merge sometime this weekend.

@astrofrog

Copy link
Copy Markdown
Member

As you mentioned in #174, maybe you could add a legacy shim into this pull request?

@taldcroft

Copy link
Copy Markdown
Member Author

@astrofrog - since there is pending pull request #174 that will change the behavior of the legacy shim, I've opened issue #175 to track adding this for io.ascii and do it after #174 is merged.

@astrofrog

Copy link
Copy Markdown
Member

@taldcroft - sounds good. From my point of view, this looks ready to merge.

@eteq

eteq commented Feb 20, 2012

Copy link
Copy Markdown
Member

Looks fine to me too... But @taldcroft, I didn't fully understand your comment above: do you mean you want to implement #175 in this pull request, or should we merge this pull request and then you'll issue another one to fix #175?

taldcroft added a commit that referenced this pull request Feb 20, 2012
@taldcroft
taldcroft merged commit 140f4a3 into astropy:master Feb 20, 2012
keflavich pushed a commit to keflavich/astropy that referenced this pull request Oct 9, 2013
astrofrog referenced this pull request in astrofrog/astropy Nov 23, 2016
When trying to create an overlay from a non-existent frame a crazy error is raised.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants