pycups

This page is about the Python bindings for the CUPS API, known as pycups. It was written for use with system-config-printer, but can be put to other uses as well.

Download

Download tarball releases from the Python Package Index:
http://pypi.python.org/pypi/pycups

or older releases from:
http://cyberelk.net/tim/data/pycups/

Source Code

The git repository is available at GitHub.

Bug Reporting

Report issues using GitHub.

You can follow any responses to this entry through the RSS 2.0 feed. You can leave a response, or trackback from your own site.

86 Responses to “pycups”

« Older Comments
Newer Comments »
  1. Michael says:
    May 23, 2011 at 10:29 am

    The package doesn’t build properly on fc10
    Here is the output from build:
    python setup.py build
    running build
    running build_ext
    building ‘cups’ extension
    creating build
    creating build/temp.linux-i686-2.6
    gcc -pthread -fno-strict-aliasing -DNDEBUG -g -fwrapv -O3 -Wall -Wstrict-prototypes -fPIC -DVERSION=”1.9.54″ -I/usr/local/include/python2.6 -c cupsmodule.c -o build/temp.linux-i686-2.6/cupsmodule.o
    cupsmodule.c: In function ‘do_password_callback’:
    cupsmodule.c:155: error: ‘cups_password_callback’ undeclared (first use in this function)
    cupsmodule.c:155: error: (Each undeclared identifier is reported only once
    cupsmodule.c:155: error: for each function it appears in.)
    cupsmodule.c: In function ‘cups_setPasswordCB’:
    cupsmodule.c:342: error: ‘struct TLS’ has no member named ‘cups_password_callback_context’
    cupsmodule.c:342: error: ‘struct TLS’ has no member named ‘cups_password_callback_context’
    cupsmodule.c:342: error: ‘struct TLS’ has no member named ‘cups_password_callback_context’
    cupsmodule.c:342: error: ‘struct TLS’ has no member named ‘cups_password_callback_context’
    cupsmodule.c:343: error: ‘struct TLS’ has no member named ‘cups_password_callback_context’
    error: command ‘gcc’ failed with exit status 1
    make: *** [cups.so] Error 1

    Reply
  2. tim says:
    May 23, 2011 at 11:27 am

    Fixed upstream (add “tls->” just before “cups_password_callback” at cupsmodule.c:155).

    However, be aware that Fedora 10 is no longer receiving security updates — you should upgrade to a newer version of Fedora.

    Reply
  3. Michael says:
    May 23, 2011 at 6:31 pm

    Hm, it fixed the first error.
    The others are still there :
    namely the whole
    cupsmodule.c:342: error: ‘struct TLS’ has no member named ‘cups_password_callback_context’
    cupsmodule.c:342: error: ‘struct TLS’ has no member named ‘cups_password_callback_context’
    cupsmodule.c:342: error: ‘struct TLS’ has no member named ‘cups_password_callback_context’
    cupsmodule.c:342: error: ‘struct TLS’ has no member named ‘cups_password_callback_context’
    cupsmodule.c:343: error: ‘struct TLS’ has no member named ‘cups_password_callback_context’

    Reply
  4. Michael says:
    May 23, 2011 at 6:41 pm

    Could it be due to the fact that I have cups 1.31 and not 1.4 ?

    Reply
  5. Michael says:
    May 23, 2011 at 6:57 pm

    Ok I removed the 2 lines referring to the cups_password_callback_context and was able to compile.
    Now there is another problem when trying to run some package using pycups (namely cloudprint).
    ImportError: /usr/local/lib/python2.6/site-packages/cups.so: undefined symbol: cupsGetPPD3
    It is most likely due to the fact that I have cups 1.31 .
    Any way to force the build so it uses 1.31 ?

    Reply
  6. tim says:
    May 24, 2011 at 11:23 am

    Both problems also fixed in the git repository now.

    Reply
  7. Michael says:
    May 24, 2011 at 5:34 pm

    Thanks,
    Actually I fixed them myself in the code and recompiled 🙂
    I also had a problem with getPPD3 and have to comment out the appropriate functions as well.
    Anyway it works fine now with the cloudprint.

    Reply
  8. Rogier says:
    June 1, 2011 at 10:25 pm

    I am also getting this ImportError when starting the python cloudprint script:

    ImportError: /usr/local/lib/python2.6/site-packages/cups.so: undefined symbol: cupsGetPPD3

    Can you point me in the direction where to comment out the appropriate functions so this error will not occur?

    My OS is Ubuntu 8.04 server with python 2.6 and pycups-1.9.55 installed.

    Thanks

    Reply
  9. tim says:
    June 2, 2011 at 9:21 am

    Rogier: you need a newer version of cups or else wait for pycups-1.9.56 which will work around compiling against older versions.

    Reply
  10. macaronij says:
    June 15, 2011 at 4:52 pm

    very good work, it could be very helpfull to have an intro / tutorial whit the basic
    something very easy just to start using the module

    #Connect to CUPS whit the default user
    printer = cups.Connection()

    #Define the default printer name
    default_printer = printer.getDefault()

    #Print a Test Page in the default printer
    printer.printTestPage(default_printer)

    #Print a file whit the default options
    printer.printFile(default_printer,”PATH/FILE”,”Title”,{})

    perhaps some example adding a printer, etc…

    i know it s very noob but it can save some time to a lot of people, i dind’t find any tutorial on the web and didn t know if this module could do the stuff i need until i build it and ask help(cups)…

    Reply
  11. tim says:
    June 20, 2011 at 10:46 pm

    Yes, good idea. Or maybe I should make it a bit more like pysmbc and have the full documentation online.

    Reply
  12. mrbox says:
    June 27, 2011 at 2:56 pm

    Great lib! After some problems everything works like a charm 🙂

    Reply
  13. Gowtham says:
    June 30, 2011 at 7:47 pm

    Hi Tim,

    Thanks for releasing this py binding library. Made my development time much shorter and I didn’t have to put in a lot of effort to write using C library.

    I could accomplish most of my tasks using pycups library. However, there is one API component which is available in C library but not exposed through pycups library, i.e cupsAdminExportSamba.

    I managed to write the PyObject method to extend pycups library for this API call. But, the major constraint is that this call relies on cups-windows drivers to be available on the local machine alongside with libcups. Now, I am not sure how this fits into the pycups library when there is an additional dependency. Perhaps, you have better idea.

    Reply
  14. tim says:
    July 1, 2011 at 9:37 am

    It just needs to behave the same as the libcups function would.

    Reply
  15. Gowtham says:
    July 1, 2011 at 5:04 pm

    One (rather ignorant) question, How do I send you a pull request(like github) for you to check the changes I have made?

    Reply
  16. tim says:
    July 2, 2011 at 10:27 pm

    Just let me know the URL to your git repository and I can take a look.

    Reply
  17. Gowtham says:
    July 6, 2011 at 5:45 pm

    Here the commit to my git repository.

    https://github.com/narisipalli/pycups/commit/068357df8a6868ad679ed4941282d64f5d2713d0

    Reply
  18. tim says:
    July 6, 2011 at 10:26 pm

    Thanks. One comment:

    +  char str[80];
[...]
      fgets (str, 79, tf);

    That would be better as:

          fgets (str, sizeof (str), tf);

    and perhaps a comment explaining what that file is expected to look like and why the last line is relevant in this situation.

    (Note that fgets already leaves space for, and stores, a terminating nul character.)

    Reply
  19. Gowtham says:
    July 15, 2011 at 9:02 pm

    Thanks for looking into it. Took some time to come back to this, blame on holiday time.

    Heres my commit with changes as per your suggestions-
    https://github.com/narisipalli/pycups/commit/38911235208055324299a4df6699672528ffccc6

    Reply
  20. tim says:
    July 15, 2011 at 11:32 pm

    Thanks. Some warnings when building though:

    upsconnection.c: In function ‘Connection_adminExportSamba’:
cupsconnection.c:3808:13: warning: ignoring return value of ‘fgets’, declared with
attribute warn_unused_result [-Wunused-result]

    Should really check this.

    cupsconnection.c:3817:8: warning: attempt to free a non-heap object ‘str’ [enabled by default]

    I didn’t spot this when looking through first of all, but str is declared on the stack so we don’t need to free it.

    When I import your git repository it has a separate history of its own instead of branching from mine… isn’t it meant to share a common ancestor?

    Reply
« Older Comments
Newer Comments »

Leave a reply

Comments are moderated. Comments that are inappropriate, offensive, vulgar, badly written or insulting will be deleted or edited to make the author look silly.