URI C++ Library

Overview

uripp is a C++ library for parsing and generating conformant Uniform Resource Identifiers (URIs). Features are listed in the main page of the documentation.

Links

• Code Documentation
• SourceForge Project

Acknowledgements

• zooml.com for donating the initial code.

Installation

1. Download uripp.
2. Uncompress downloaded file (under any directory).
3. Change directory down one to the uncompressed files' root directory.
4. Configure the build. The configure command has many options. Use "-h" to see all the options and where the default installation directories are located. For example, to install to local 64-bit dir use: "--libdir=/usr/local/lib64".
   > ./configure
5. Make the lib locally and run tests:
   > make check
6. If tests pass then install to system directories:
   > sudo make install

(Windows install has not be tried. Note src/apidefs.h for DLL import syntax.)

Developer Notes

• Documentation
  • This page is: doc/index.html
  • Doxygen is generated into: doc/dxydocs
> cd tools
> doxygen uripp.dxy
    
  • Upload doc directory's files as static html to this project's web (what you are looking at :).
    > cd doc
> rsync -avP -e ssh * NAME,uripp@web.sourceforge.net:htdocs/
    
• Automated Build
  • Requires the packages: autoconf, automake, libtool
  • Basic changes can be handled by modifying configure.ac, or one of the Makefile.am files.
  • When adding/removing a src file be sure to change the Makefile.am.
  • Reset configure (run from root):
    > autoreconf --install --force
• Release New Version
  1. Assign new version number. Note that we are using "x.y.z" format, e.g. "1.0.0". Think up a brief summary of the release (to use in svn message).
     1. VERY IMPORTANT: Edit configure.ac and change AC_INIT 2nd param to new version number.
     2. > svn ci configure.ac
> svn copy -m '[RELEASE SUMMARY]' --username NAME https://uripp.svn.sourceforge.net/svnroot/uripp/trunk https://uripp.svn.sourceforge.net/svnroot/uripp/tags/[NEW VERSION NUMBER]
        
  2. Checkout clean source from svn repository (in /tmp, e.g.). (Note that the auto configure files are not in the repository.)
     > svn co --username NAME https://uripp.svn.sourceforge.net/svnroot/uripp/tags/[NEW VERSION NUMBER] uripp-[NEW VERSION NUMBER]
> cd uripp-[NEW VERSION NUMBER]
> autoreconf --install --force
> cd tools
> doxygen uripp.dxy
> cd ../..
> tar cvzf uripp-[NEW VERSION NUMBER].tar.gz uripp-[NEW VERSION NUMBER]
     
  3. FOLLOW Installation INSTRUCTIONS TO TEST!!!
  4. Upload tar file to SourceForge FSM (instructions):
     > rsync -avP -e ssh uripp-[NEW VERSION NUMBER].tar.gz NAME@frs.sourceforge.net:uploads/
     
  5. Create new SourceForge release (instructions).
• Initial svn Setup
  • Note: this has already been done (documented for future projects).
  • > cd /tmp
> mkdir tmpsvn
> cd tmpsvn
> mkdir trunk branches tags
> svn import -m 'Initial setup.' --username NAME https://uripp.svn.sourceforge.net/svnroot/uripp
> cd [root dir of files for initial checkin]
> svn co --username NAME https://uripp.svn.sourceforge.net/svnroot/uripp/trunk .
> svn add *
> svn ci -m 'Initial checkin.'