libstdcow

Made with <3 by Amazing Cow.

Websites:

• libstdcow Website
• Libs Website - The Amazing Cow's Libs site.

Description:

The libstdcow objective is to create a ease to use C library with the common day-to-day programming tasks made easy.

We bring the inspiration from some other languages standard libraries, primarily python, but some Objective-C (Cocoa|Foundation) and some C# (.NET), can appears here and there.

Motivation:

For example, we love the os.path module from python - It's very easy to get what you want without much fuzz. We would love have the same kind of stuff in C. So we decide to write it.
Take a look:

In python:

import os.path;

print os.path.expanduser("~/Desktop"); #Prints /home/you/Desktop
print os.path.abspath(".");            #Prints /full/path/to/your/cwd
print os.path.split("/usr/local");     #Prints /usr, local
print os.path.splitext("Music.ogg");   #Prints Music, ogg

In C with libstdcow:

#include "cowpath.h"

char *expanded = cow_path_expanduser("~/Desktop");
COW_DLOG("%s", expanded); /* COW_DLOG is active only in debug */
COW_FREE_NULL(expanded);  /* cow_path_expanduser will ALWAYS use malloc */

char *absolute = cow_path_abspath(".");
COW_DLOG("%s", absolute); /* Think as printf for debug builds */
COW_FREE_NULL(absolute);  /* cow_path_abspath will ALWAYS use malloc */

char *head, *tail;
cow_path_split("/usr/local", &head, &tail);
COW_DLOG("%s - %s", head, tail);
COW_SAFE_FREE_NULL(head); /* It will free only if the pointer isn't NULL */
COW_SAFE_FREE_NULL(tail); /* and will set the pointer as NULL too.       */

char *root, *ext;
cow_path_splitext("Music.ogg", &root, &ext);
COW_DLOG("%s - %s", root, ext);
COW_SAFE_FREE_NULL(root); 
COW_SAFE_FREE_NULL(ext ); 

As usual, you are very welcomed to share and hack it.

Examples:

Documentation:

We strive to make our source code fully documented.
While there are a myriad of comments, one might find useful take a look at:

• Project Website.
• Pydoc Docs.
• A list of blog posts about the project.

Anyway if you didn't understand something let us know sending a mail to
help_opensource@amazingcow.com with the subject filled with the name of this repo.

Dependencies:

• There is no dependency for libstdcow

License:

This software is released under GPLv3.

TODO:

Check the TODO file for general things.

This projects uses the COWTODO tags.
So install cowtodo and run:

$ cd path/to/the/project
$ cowtodo 

That's gonna give you all things to do :D.

Others:

Check our repos and take a look at our open source site.