Some Thoughts about Library Design

Warning! Some information on this page is older than 3 years now. I keep it for reference, but it probably doesn't reflect my current knowledge and beliefs.

May 2010

Some Thoughts about Library Design

Much has been said about designing good user interface, whether for desktop applications, websites or games. There are whole books available about GUI design and even this year's IGK-7'2010 conference featured two lectures about the interface in games. But what about interfaces for programmers?

I can't find much about the rules of good library API design and I believe there is much to say in this subject. I only know The Little Manual of API Design written by Jasmin Blanchette from Trolltech/Nokia, one of the creators of Qt library (thanks for the link Przemek!). There is also a blog entry about Math Library, which is quite interesting. Inspired by it, I've came up with a general thought that you cannot have all the following features when designing a library and its API, you have to choose 2 or 3 of them and make some compromise:

I think some patterns and best practices as well as some anti-patterns could be found when you look at interfaces of many libraries. Maybe I'll post some more of my thoughts on this subject in the future. In the meantime, do you know any other resources about API design?

Comments (1) | Tags: philosophy software engineering libraries | Author: Adam Sawicki | Share


2016-03-29 08:56:06
my first time to Shanghai, to help me find a dozen dollars hostel, please?"So, to accompany her to find hostels. At 7:00 pm was staying in a cheap hostel but also 40 yuan a night. I want to leave, she let go, her eyes riveted on me, repeated the phrase: "? I first came to Shanghai, you spend time with me, please" like to see her, I could not help students from compassion heart of. I inserted through the team in Jiangxi Province. Twenty years of joint swelling and pain can not walk, the production team with a dray uncle sent me to commune health centers for treatment. Now the little girl and I was not also the case with what? A single person, in need of help, I can not ask her? I went to apply for a stay formalities, she lives upstairs, I live downstairs. I went to the supermarket to buy two sets of towels, toothbrush, toothpaste, they have to spend to stay.After dinner, I go with her to the supermarket plaza. The first time I saw so many customers, bustling crowd, her age girl wearing Western style fashion, she was very envious. The first elevator ride elevators and stairs room, gesticulating see so many people standing looking at her surprised. First sat on a long bench enjoying central air conditioning blowing cool breezes, her temperament is particularly comfortable. She opened the door panel of the soul, to tell me her story. Her surname situation, 24 years old this year, who lives in Jiangxi Nanshan District, poor economic conditions at home, and nothing good local place to make moneI heard that Shanghai life is better, earn more, she charmed one day to see. The village has seen young men and women to go to Guangzhou, Shanghai to work, she echocardiography. But mother does not agree, do not trust her to go out alone. That day, she and her mother had a big fight. At night, while sleeping parents left home alone, by car, by train, they go to work in Shanghai Pudong cousin. In Shanghai, because the address does not have to call home to ask, he said, can not find the address of the first to come back, her mother fell ill in bed, so he had to return. In the road to the train station, a brother lie to her on the bus, turn a long time to ask for 100 dollars. In the car, but also hands and feet, touched her breasts. She was afraid. Later I met, I feel like her cousin, honest, caring, considerate. Come here and opened the eyes, I feel very happy. I said, you yearn for Fu-life is right. Now your mother sick, certainly you do not worry. You can go home and talk to my mother, reassured her, and then you come to Shanghai. A girl is not easy to Shanghai to work, to learn skills, to adapt to the urban environment as soon as possible, but also pay attention to protect themselves. As long as they work hard, work hard, you will succeed.Back to Hostel has 10 points. In her room,

Post comment

Nick *
Your name or nickname
Your contact information (optional, will not be shown)
Text *
Content of your comment
Calculate *
(* - required field)
STAT NO AD [Stat] [Admin] [STAT NO AD] [pub] [Mirror] Copyright © 2004-2017 Adam Sawicki
Copyright © 2004-2017 Adam Sawicki