Difference between revisions of "Pclog"

From ProgClub
Jump to: navigation, search
m (John moved page PcLog to Pclog)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
PcLog is the ProgClub event logger. That's the software we use to log errors that occur in our software so that we can fix them! In addition to the logging components are reporting components. For other projects see [[projects]].
+
Pclog is the ProgClub event logger. That's the software we use to log errors that occur in our software so that we can fix them! In addition to the logging components are reporting components. For other projects see [[projects]].
  
 
= Status =
 
= Status =
Line 5: Line 5:
 
We use [[Versioning|semantic versioning]].
 
We use [[Versioning|semantic versioning]].
 
Latest production version: unreleased.
 
Latest production version: unreleased.
Latest development version: 0.2.0.
+
Latest development version: 0.3.0.
  
 
See [[#Tasks|tasks]] for work that still needs to be done.
 
See [[#Tasks|tasks]] for work that still needs to be done.
Line 25: Line 25:
 
== Copyright ==
 
== Copyright ==
  
Copyright © 2017, [[#Contributors|Contributors]].
+
Copyright © 2017-2021, [[#Contributors|Contributors]].
  
 
== License ==
 
== License ==
Line 43: Line 43:
 
== Downloads ==
 
== Downloads ==
  
There aren't any downloads yet because we're still under development on our 0.2 version. When we release 1.0 we will (hopefully!) provide tarball packages. Stay tuned.
+
There aren't any downloads yet because we're still under development on our 0.3 version. When we release 1.0 we will (hopefully!) provide tarball packages. Stay tuned.
  
 
== Source code ==
 
== Source code ==
Line 49: Line 49:
 
The repository can be browsed online:
 
The repository can be browsed online:
  
  https://www.progclub.org/pcrepo/pclog/branches/0.2
+
  https://www.progclub.org/pcrepo/pclog/branches/0.3
  
<!-- 2017-02-23 jj5 - NOTE: removed because it's not available yet...
+
Or if you want the latest version for development purposes:
  
The latest stable released version of the code is available from:
+
https://www.progclub.org/svn/pcrepo/pclog/branches/0.3
  
https://www.progclub.org/svn/pcrepo/pclog/tags/latest/0.2
+
The Subversion command to check out the library is:
 
 
-->
 
Or if you want the latest version for development purposes:
 
  
  https://www.progclub.org/svn/pcrepo/pclog/branches/0.2
+
  svn co https://www.progclub.org/svn/pcrepo/pclog/branches/0.3 pclog-0.3
  
 
== Links ==
 
== Links ==
Line 103: Line 100:
 
If you are interested in incorporating this software into your project, here's what you need to know:
 
If you are interested in incorporating this software into your project, here's what you need to know:
  
Grab a recent copy of the code from [[#Source_code|svn]] into a lib/pclog-0.2 directory in your project...
+
Grab a recent copy of the code from [[#Source_code|svn]] into a lib/pclog-0.3 directory in your project...
  
 
TODO: update notes for implementers.
 
TODO: update notes for implementers.
Line 111: Line 108:
 
If you're looking to set up a development environment for this project here's what you need to know:
 
If you're looking to set up a development environment for this project here's what you need to know:
  
So you want to hack on PcLog? Cool! Get in touch with [mailto:jj5@progclub.org?subject=PcLog John] and we'll take it from there!
+
So you want to hack on Pclog? Cool! Get in touch with [mailto:jj5@progclub.org?subject=Pclog John] and we'll take it from there!
  
 
== Notes for ProgClub administrators ==
 
== Notes for ProgClub administrators ==
Line 139: Line 136:
 
Stuff that's done. Latest stuff on top.
 
Stuff that's done. Latest stuff on top.
  
 +
* [[User:John|JE]] 2021-07-26: added some notes about v0.3
 
* [[User:John|JE]] 2017-02-23: created project page
 
* [[User:John|JE]] 2017-02-23: created project page
 
* [[User:John|JE]] 2017-02-18: created the project in svn
 
* [[User:John|JE]] 2017-02-18: created the project in svn

Latest revision as of 00:42, 27 July 2021

Pclog is the ProgClub event logger. That's the software we use to log errors that occur in our software so that we can fix them! In addition to the logging components are reporting components. For other projects see projects.

Status

We use semantic versioning. Latest production version: unreleased. Latest development version: 0.3.0.

See tasks for work that still needs to be done.

Motivation

Why this software? The services facilitated by this software allow us to gather detailed error information when problems occur in our production systems. Collecting such information and knowing about problems is the first step in solving the issues.

Administration

Contributors

Members who have contributed to this project. Newest on top.

All contributors have agreed to the terms of the Contributor License Agreement. This excludes any upstream contributors who tend to have different administrative frameworks.

Copyright

Copyright © 2017-2021, Contributors.

License

Licensed under the MIT license.

Components

Libraries, tools, services or media from third parties used under license:

Resources

Downloads

There aren't any downloads yet because we're still under development on our 0.3 version. When we release 1.0 we will (hopefully!) provide tarball packages. Stay tuned.

Source code

The repository can be browsed online:

https://www.progclub.org/pcrepo/pclog/branches/0.3

Or if you want the latest version for development purposes:

https://www.progclub.org/svn/pcrepo/pclog/branches/0.3

The Subversion command to check out the library is:

svn co https://www.progclub.org/svn/pcrepo/pclog/branches/0.3 pclog-0.3

Links

Links are generated with bugslist.php:

$ bugslist --all -a= -c=s -o=sk -t=s > doc/links.wiki

Specifications

Functional specification

The functional specification describes what the project does.

The client software detects events (errors) in software and submits error info to our servers.

The server software collects event information and provides a reporting interface for viewing it.

Technical specification

The technical specification describes how the project works.

TODO: add a bit of a tech-spec.

Notes

See versioning for information on our semantic version numbers.

Notes for implementers

If you are interested in incorporating this software into your project, here's what you need to know:

Grab a recent copy of the code from svn into a lib/pclog-0.3 directory in your project...

TODO: update notes for implementers.

Notes for developers

If you're looking to set up a development environment for this project here's what you need to know:

So you want to hack on Pclog? Cool! Get in touch with John and we'll take it from there!

Notes for ProgClub administrators

To release a version of this project use the pcrepo-branch-release script from the jj5-bin project:

$ pcrepo-branch-release pclog $MAJOR.$MINOR $PATCH

Where:

$MAJOR = the major version number, presently 0
$MINOR = the minor version number, presently 1
$PATCH = the patch number for this release

See status for last production release.

Tasks

TODO

Things to do, in rough order of priority:

  • create a TODO list... :P

Done

Stuff that's done. Latest stuff on top.

  • JE 2021-07-26: added some notes about v0.3
  • JE 2017-02-23: created project page
  • JE 2017-02-18: created the project in svn