Monthly Archives: July 2014

Overview of Shumgrepper functionalities

fedora, Uncategorized

We have created dev instance for shumgrepper  http://209.132.184.120/ . Till now, I have implemented the following functionalities, i am writing a small summary of it below:

UI

 

  • /    –  home page, front page, shows the user about what the application is and what can be done with it
  • /md5/<md5>     –  Returns all the files in all the packages matching this md5sum

e.g.   /md5/f4aafb270c2f983f35b365aad5fe8870

  • /sha1/<sha1>    –  Returns all the files in all the packages matching this sha1sum

e.g.   /sha1/f83618056ae5601b74a75db03739dd3ec24292f5

  • /sha256/<sha256> – Returns all the files in all the packages matching this sha256sum

e.g.  /sha256/e77b543aefd1595f159e541041a403c48a240913bc65ca5c4267df096f775eb6

  • /tar_sum/<tar_sum> – Returns all the files in all the packages matching this tar_sum

e.g. /tar_sum/4a31a53097eaf029df45dd36ab622a57

  • /packages – List all the packages
  • /package/<package> – Gives overview of the package, different versions of the package

e.g.  /package/fotoxx

  • /package/<package>/filenames – List all the filenames present in a package

e.g. /package/fotoxx/filenames

  • /tar_file/<tar_file>/filenames – List all the filenames present in a specific package version

e.g. /tar_file/fotoxx-14.05.1.tar.gz/filenames

  • /filename/<filename> – Returns all the file details matching that filename

e.g.  /filename/knot-1.5.0%2Fconfig.guess

  • /compare/common – Compare two or more tar_files, matches their sha256sum values  and returns common filenames.

e.g. /compare/common?tar_file=fedora-release-21.tar.bz2&tar_file=fedora-release-22.tar.bz2

  • /common/difference – Compare two or more tar_files, matches their sha256sum values and returns different filenames i.e. filenames that are not common to all the tar_files

e.g. /compare/difference?tar_file=fedora-release-21.tar.bz2&tar_file=fedora-release-22.tar.bz2

  • /history/<package> – Return history of the package with evolution across all its releases. It shows the files that have changed or the files that have remained same   as compared to its previous version. It has not been implemented yet.

 

 

API

 

It returns output in json format and request can be made by http get, curl or wget.

  • /api – Contains documentation for API
  • /api/sha1/<sha1sum> – Returns all the files in all the packages matching this sha1sum.

e.g. /api/sha1/e0ec2c54e7a4fabb2f7e8c78d711efc0ed5f4f43

  • /api/sha256/<sha256sum> – Returns all the files in all the packages matching this sha256sum

e.g./api/sha256/e77b543aefd1595f159e541041a403c48a240913bc65ca5c4267df096f775eb6

  • /api/md5/<md5sum> – Returns all the files in all the packages matching this md5sum

e.g.  /api/md5/bf6f8d7c7022b27534011c4ad8334e2a

  • /api/tar_sum/<tar_sum> – Returns all the files in all the packages matching this tar_sum

e.g. /api/tar_sum/4a31a53097eaf029df45dd36ab622a57

  • /api/package/<package> – Returns all the package details with all the versions available for this package.

e.g.  /api/package/fotoxx

  • /api/package/<package>/filenames – Returns all the filenames present in this package.

e.g.  /api/package/felix-gogo-command/filenames

  • /api/tar_file/<tar_file>/filenames – Returns all the filenames present in a specific version of the package i.e. the tar_file given by user.

e.g.    /api/tar_file/fedora-release-22.tar.bz2/filenames

  • /api/compare/package/common – Compare two or more packages, match their sha256sum  and returns the filenames common to all the packages.

e.g.   /api/compare/package/common \
package==ark \
package==baloo

  • /api/compare/package/difference – Compare two or more packages, match their sha256sum values and returns filenames which are not common to all the packages.

e.g.   /api/compare/package/difference \
package==kamera \
package==fedora-release

  • /api/compare/tar_file/common – If you want to compare two versions of same package, then comparing them by package name won’t work.  It will compare two or more tar_files, match their sha256sum and returns filenames common to all the tar_files.

e.g.    /api/compare/tar_file/common \
tar_file==fedora-release-21.tar.bz2 \
tar_file==fedora-release-22.tar.bz2

  • /api/compare/tar_file/difference – Compare two or more tar_files and return filenames uncommon to all the tar_files.

e.g.    /api/compare/tar_file/difference \
tar_file==fedora-release-21.tar.bz2 \
tar_file==fedora-release-22.tar.bz2