Skip to content

Documentation outdated for printline() #32

Description

@btalb

Commit 4251e79 seems to have added the strline() function for getting string representations as a replacement for printline(file=None).

Documentation for SE3 still suggests printline() will output a string when supplied with file=None:

printline

Documentation for the new strline() function also doesn't seem to have been built.

Activity

  1. jhavl commented on Oct 27, 2021

    @jhavl
    Contributor

    Thanks for noticing that, the docs seem to be out of date on Github pages. I'll get those rebuilt with the next pip release

  2. petercorke commented on Nov 2, 2021

    @petercorke
    Collaborator

    I've changed this stuff a lot, used to be all done by printline. Are these the right primitives?

  3. btalb commented on Nov 11, 2021

    @btalb
    ContributorAuthor

    I haven't noticed a strong convention in the Python community for "making print flexible enough to meet user needs". There's the extendable custom string formatting, but that looks like it may be a deep rabbit hole.

    If it was me, my approach would be maximise flexibility for users by minimising work done here:

    1. Have a single function that provides all possible "thing to string" conversion functionality
    2. Make something like NumPy's set_printoptions() to support changing the default string representation globally / in contexts using with (optional)
    3. Drop all support for sending the strings to files, and let users handle that through more generic Python methods available

    With the flexibility of maybe swapping out 1 with custom string formatting if you feel the need in the future.

  4. petercorke commented on Jul 27, 2026

    @petercorke
    Collaborator

    Checkout PR #200 which separates printing from stringifying.

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions