Difference between revisions of "Liblicense"

From Creative Commons

Jump to: navigation, search

Latest revision as of 20:53, 23 September 2015


Description of Software	Low-level license metadata integration for applications.
Bug Tracker	Link to Bug Tracker
Code Repository	Link to Code repository
Mailing List	Link to Mailing list

What is liblicense?

liblicense provides a straight-forward way for developers to build license-aware applications. liblicense utilizes a pluggable module system for reading and writing metadata from specific file types, allowing extensibility for specific content types.

For a brief introduction video, check Asheesh Laroia talking about liblicense
To see liblicense in action take a look at License tagger, the cross platform file metadata editor.

Features

Extract and write license information for files
Supports enumeration of available licenses
Wraps internationalized license information for Creative Commons licenses
Bindings for dynamic languages (currently Python and Ruby)
Extensible support for file types using module system
No specific GUI library dependency allows applications to build the graphical chooser most appropriate for their platform.

Future Improvements

Supports verification URLs for metadata verification

Architecture

Liblicense Architecture - SVG

Bindings

Python
Ruby

Media

See Operating System Mockups for ideas on how liblicense could be integrated into various platforms.

Download

Latest Release tar.gz
Debian and Ubuntu repositories.
Read the tutorial.

Developers: Using git

If you want to check out the source code and develop on it, use this command:

git clone git://code.creativecommons.org/liblicense.git
git submodule init
git submodule update

That should give you a working copy you can commit to. In case you wonder: the latter two commandsfill the directories

icons/jurisdictions
license.rdf
licenses

with content from external repositories similar to svn:externals for Subversion.

More Information

Release History and Roadmap
Desktop Integration
Screenshots
RDF Reference
File Metadata Information
Library Documentation (generated from source)
Buildbot helps test out liblicense on various platforms.

Liblicense
Have an idea about this page? Want to help build the CC ecosystem? Check out the challenges related to Liblicense, or add one of your own below.
Open Challenges
{{#ask: Is Complete::no Related To::Liblicense\|format=table}}
Completed Challenges
{{#ask: Is Complete::yes Related To::Liblicense\|format=table}}
{{#forminput:Challenge\|35	Challenge[related_to]=Liblicense }}

Retrieved from "https://wiki.creativecommons.org/index.php?title=Liblicense&oldid=114426"

Categories:

@@ Line 1: / Line 1: @@
-[[Category:Developer]]
+{{Software Project
-[[Category:Metadata]]
+|Description=Low-level license metadata integration for applications.
-[[Category:Desktop]]
+|Bug tracker=http://code.creativecommons.org/issues/issue?status=-1,1,2,3,4,5,6,7&@sort=-activity&@search_text=&@dispname=liblicense&@filter=status,project&@group=priority&project=4&@columns=id,activity,title,creator,assignedto,status&@pagesize=50&@startwith=0
-[[Category:Labs]]
+|Code repository=http://code.creativecommons.org/viewgit/liblicense.git/
-[[Category:Tools]]
+|Mailing list=http://lists.ibiblio.org/mailman/listinfo/cc-devel
-[[Category:Specification]]
+}}
-[[Category:Operating System]]
+== What is liblicense? ==
-[[Category:Technology]]
+liblicense provides a straight-forward way for developers to build license-aware applications.  liblicense utilizes a pluggable module system for reading and writing metadata from specific file types, allowing extensibility for specific content types.
+* For a brief introduction video, check [http://blip.tv/file/1142312/ Asheesh Laroia talking about liblicense]
+* To see '''liblicense in action''' take a look at [[License tagger]], the cross platform file metadata editor.
+== Features ==
+* Extract and write license information for files
+* Supports enumeration of available licenses
+* Wraps internationalized license information for Creative Commons licenses
+* Bindings for dynamic languages (currently Python and Ruby)
+* Extensible support for file types using module system
+* No specific GUI library dependency allows applications to build the graphical chooser most appropriate for their platform.
-== System Overview ==
+== Future Improvements ==
-=== Purpose ===
+* Supports [[WebStatement|verification]] URLs for metadata verification
-To provide a simple way for developers to make their applications license aware.  Additionally, supplemental modules aim to provide a method for users to track licenses of files on their system.  This project complements [[Companion File metadata specification]] and [[Tracker CC Indexing]].
-=== Architecture ===
+== Architecture ==
 [[Image:System_architecture.png]]
-[[Image:System_architecture.svg | svg version]]
+[[:Image:System_architecture.svg|Liblicense Architecture - SVG]]
-== Config Modules ==
+== Bindings ==
-* '''in_use'''() - returns whether or not the corresponding config system exists on the computer
-* '''get'''() - returns the current default license uri
-* '''set'''(uri) - sets the default license uri and returns 0 upon success (non-zero for errors)
-== I/O Modules ==
+* [[Liblicense/Python|Python]]
-* '''mime_types''' - null terminated list of handled mime-types (all indicates external storage method which works for any file)
+* [[Liblicense/Ruby|Ruby]]
-* '''read'''(filename) - returns the license uri for the given file (embedded license takes precedence)
-* '''write'''(filename,uri) - writes the license uri for the given file
-== License Files (.rdf) ==
+== Media ==
-=== Attributes ===
-* cc:license
+See [[Operating System Mockups]] for ideas on how '''liblicense''' could be integrated into various platforms.
-** about
-** permits
-** requires
-** prohibits
-* dc:title - The human readable name of the license.
-* dc:description - Description of the license.
-* dc:coverage - The jurisdiction of the license. (country code from [http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html ISO3166])
-* dc:language - The language of the license. (language code under [http://www.ietf.org/rfc/rfc3066.txt RFC3066])
-* dc:relation
-** hasVersion - version number
-** isReplacedBy - indicates retired license ([http://www.ietf.org/rfc/rfc2396.txt URI])
-** isBasedOn - indicates ported version ([http://www.ietf.org/rfc/rfc2396.txt URI])
-* dc:rights license - license the license is available under ([http://www.ietf.org/rfc/rfc2396.txt URI])
-* dc:type - always "License"
-* dc:creator
-* dc:publisher
-* dc:identifier - URI of license ([http://www.ietf.org/rfc/rfc2396.txt URI])
-=== Example ===
+== Download ==
-== Frontends ==
+* [http://mirrors.creativecommons.org/software/liblicense/liblicense-0.8.1.tar.gz Latest Release tar.gz]
-See [[Desktop Integration]]
+* Debian and Ubuntu [http://mirrors.creativecommons.org/packages/ repositories].
+* Read the [[Liblicense tutorial| tutorial]].
-== Timeline ==
+=== Developers: Using git ===
-=== 6/18 ===
-* Finalize liblicense API.
-=== 6/25 ===
+If you want to check out the source code and develop on it, use this command:
-* Write liblicense.
-* Stub config and IO modules.
-=== 7/2 ===
+ git clone git://code.creativecommons.org/liblicense.git
-* liblicense python bindings.
+ git submodule init
+ git submodule update
-=== 7/9 ===
+That should give you a working copy you can commit to.  In case you wonder: the latter two commandsfill the directories
-* Gconf config module.
+* icons/jurisdictions
-* Nautilus IO module.
+* license.rdf
+* licenses
+with content from external repositories similar to ''svn:externals'' for Subversion.
-=== 7/16 ===
+== More Information ==
-* Nautilus GUI frontend.
-* Gnome control panel frontend.
-=== 7/23 ===
+* [[Liblicense/Releases|Release History]] and [[Liblicense/Roadmap|Roadmap]]
-* Sugar Journal backend.
+* [[Liblicense/Desktop_Integration|Desktop Integration]]
-* Sugar frontend.
+* [[Liblicense/Screenshots|Screenshots]]
+* [[License RDF|RDF Reference]]
+* [[Liblicense/Metadata_Table|File Metadata Information]]
+* [http://code.creativecommons.org/doc/liblicense/ Library Documentation] (generated from source)
+* [[Buildbot]] helps test out liblicense on various platforms.
-=== 7/30 ===
+== See Also ==
-* Bug hunting.
-* Frontend polishing.
-=== 8/6 ===
+* [[Companion File metadata specification]]
-{{stub}}
+* [[Tracker CC Indexing]] - also there is a great chart showing progress on reading/writing different filetypes (copied above).
-=== 8/13 ===
+{{Challenge Enabled}}
-{{stub}}
+[[Category:Developer]]
+[[Category:Metadata]]
+[[Category:Desktop]]
+[[Category:Labs]]
+[[Category:Tools]]
+[[Category:Specification]]
+[[Category:Operating System]]
+[[Category:Technology]]
+[[Category:Integration]]
-=== 8/20 ===
+__NOTOC__
-{{stub}}
+{{lowercase}}

Difference between revisions of "Liblicense"

Latest revision as of 20:53, 23 September 2015

What is liblicense?

Features

Future Improvements

Architecture

Bindings

Media

Download

Developers: Using git

More Information

See Also

Navigation menu

Personal tools

Namespaces

Variants

Views

More

Search

default links

wiki navigation

Tools