Path: csiph.com!usenet.pasdenom.info!aioe.org!news.stack.nl!newsfeed.xs4all.nl!newsfeed2a.news.xs4all.nl!xs4all!newsgate.cistron.nl!newsgate.news.xs4all.nl!post.news.xs4all.nl!not-for-mail Return-Path: X-Original-To: python-list@python.org Delivered-To: python-list@mail.python.org X-Spam-Status: OK 0.001 X-Spam-Evidence: '*H*': 1.00; '*S*': 0.00; 'python,': 0.02; 'programmer': 0.03; 'beginner': 0.05; 'classes,': 0.05; 'algorithms,': 0.07; 'apis': 0.09; 'received:80.91': 0.09; 'received:80.91.229': 0.09; 'received:gmane.org': 0.09; 'received:list': 0.09; 'api': 0.11; 'bug': 0.12; 'wrote': 0.14; 'api,': 0.16; 'awesome.': 0.16; 'competent': 0.16; 'debugger,': 0.16; 'editor,': 0.16; 'globals.': 0.16; 'interface"': 0.16; 'interpreter,': 0.16; 'received:80.91.229.3': 0.16; 'received:plane.gmane.org': 0.16; 'subject:books': 0.16; 'subject:tutorials': 0.16; 'throwaway': 0.16; 'tracker,': 0.16; 'bit': 0.19; 'code,': 0.22; 'fairly': 0.24; 'helpful': 0.24; 'source': 0.25; 'define': 0.26; 'subject:/': 0.26; 'header:X -Complaints-To:1': 0.27; 'generally': 0.29; 'related': 0.29; "doesn't": 0.30; 'code': 0.31; 'bunch': 0.31; 'subject:with': 0.35; 'something': 0.35; 'test': 0.35; "didn't": 0.36; 'subject:?': 0.36; 'subject:New': 0.37; 'system,': 0.38; 'to:addr :python-list': 0.38; 'explain': 0.39; 'to:addr:python.org': 0.39; 'received:org': 0.40; 'how': 0.40; 'days': 0.60; 'even': 0.60; 'most': 0.60; 'ago.': 0.61; 'save': 0.62; 'complete': 0.62; 'real': 0.63; 'more': 0.64; 'world': 0.66; 'experience.': 0.67; 'fact,': 0.69; 'lack': 0.78; 'life.': 0.83; 'describes': 0.84; 'examples.': 0.84; 'subject:good': 0.84; 'subject::': 0.85; 'yourself,': 0.95 X-Injected-Via-Gmane: http://gmane.org/ To: python-list@python.org From: Dave Angel Subject: Re:New to working with APIs, any good tutorials/books/guides? Date: Fri, 21 Feb 2014 06:49:50 -0500 (EST) Organization: news.gmane.org References: <9f4db1e7-800f-4fd2-945d-d0972a440071@googlegroups.com> X-Gmane-NNTP-Posting-Host: dpc6744192008.direcpc.com X-Newsreader: PiaoHong Usenet NewsReaders 1.36 X-BeenThere: python-list@python.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: General discussion list for the Python programming language List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Newsgroups: comp.lang.python Message-ID: Lines: 31 NNTP-Posting-Host: 2001:888:2000:d::a6 X-Trace: 1392983179 news.xs4all.nl 2964 [2001:888:2000:d::a6]:54045 X-Complaints-To: abuse@xs4all.nl Xref: csiph.com comp.lang.python:66827 ApathyBear Wrote in message: > I don't understand how APIs work to save my life. I am a complete beginner. In fact, I am a bit confused on what API even means and what the meaning entails. > > I am fairly competent with python, though I do lack some real world experience. Regardless, any tutorials/books/guides that deal with API for a complete beginner would be awesome. > At its most fundamental, the API is the documentation that makes it practical to reuse code you didn't write yourself, or that you wrote longer than 30 days ago. "Application Programmer Interface" describes the functions, the classes, the globals. The semantics, the algorithms, the assumptions, the gotchas. The license, the restrictions. If you inherit a body of code and it doesn't define an API, chances are it's throwaway code, good only for examples. > > > PS: Something that can explain SDKs would be helpful as well. > SDK is "Software Development Kit" Generally it's a bunch of related APIs plus one or more of tools like editor, compiler, interpreter, debugger, profiler, test generator, IDE, source control system, bug tracker, etc. -- DaveA