From 61c0e03098e4d209cd34523200eeb33c9182cc51 Mon Sep 17 00:00:00 2001 From: Ray Date: Thu, 26 Mar 2009 15:31:03 -0400 Subject: [PATCH 1/4] Remove outdated files in docs/. See wiki instead. --- docs/install-in-ubuntu.txt | 46 ------------------- docs/readme-dev.txt | 71 ----------------------------- docs/readme-overview.txt | 91 -------------------------------------- docs/status.txt | 80 --------------------------------- 4 files changed, 288 deletions(-) delete mode 100644 docs/install-in-ubuntu.txt delete mode 100644 docs/readme-dev.txt delete mode 100644 docs/readme-overview.txt delete mode 100644 docs/status.txt diff --git a/docs/install-in-ubuntu.txt b/docs/install-in-ubuntu.txt deleted file mode 100644 index b3843eca..00000000 --- a/docs/install-in-ubuntu.txt +++ /dev/null @@ -1,46 +0,0 @@ -Last checked: 1 Sep, p74 - -These instructions are for any Ubuntu Linux, but except for the name of the package management software it should be identical on other Linux distributions. - -Using the package manager (I think it's called synaptics) install the dependencies: mysql, python, mysql-python, pygtk -I don't use ubuntu but I'd imagine it will at some point prompt you for a MySQL root password enter one and when it's done installing everything open a shell/terminal and type this: -mysql --user=root --password=YourMysqlRootPassword -It should say something like this: - -Welcome to the MySQL monitor. Commands end with ; or \g. -Your MySQL connection id is 4 -Server version: 5.0.60-log Ubuntu Linux mysql-5.0.60-r1 - -Type 'help;' or '\h' for help. Type '\c' to clear the buffer. - -mysql> - -Now type this: -CREATE DATABASE fpdb; - -Next you need to create a user. Type this (replacing newPassword with the password you want the fpdb user to have - this can, but for security shouldn't, be the same as the root mysql password): -GRANT ALL PRIVILEGES ON fpdb.* TO 'fpdb'@'localhost' IDENTIFIED BY 'newPassword' WITH GRANT OPTION; - -Then download one of the alpha2 archives from the sourceforge page at https://sourceforge.net/projects/fpdb/ and unpack it into a folder of your choice. - -Next create a directory called .fpdb (the . at the beginning is important) in your home directory, e.g. /home/steffen/.fpdb -Then copy the default.conf file from the docs directory of the archive into this new folder. -Finally edit default.conf with any texteditor and enter the fpdb password you entered above (in the GRANT ALL... command). - -This should be it, try double clicking pyfpdb/fpdb.py or open it from a shell with python /path/to/fpdb/pyfpdb/fpdb.py - -Now see readme-user.txt for usage instructions. - - -License -======= -Trademarks of third parties have been used under Fair Use or similar laws. - -Copyright 2008 Steffen Jobbagy-Felso -Permission is granted to copy, distribute and/or modify this -document under the terms of the GNU Free Documentation License, -Version 1.2 as published by the Free Software Foundation; with -no Invariant Sections, no Front-Cover Texts, and with no Back-Cover -Texts. A copy of the license can be found in fdl-1.2.txt - -The program itself is licensed under AGPLv3, see agpl-3.0.txt diff --git a/docs/readme-dev.txt b/docs/readme-dev.txt deleted file mode 100644 index 9bfb4ac3..00000000 --- a/docs/readme-dev.txt +++ /dev/null @@ -1,71 +0,0 @@ -This file is badly out of date, but I'm going to leave it here for now. :) -More up-to-date information is on the wiki: http://fpdb.wiki.sourceforge.net/ -REB 30-Jan-2009 - -Hi, -This document is to serve as a little overview (later: full technical doc) for current and prospective developers with: -a) introduction into the code structure -b) organisational/legal things - -What to do? -=========== -- Anything you want. -- The most useful (because it's the most boring) would be to update print_hand.py, update the expected files (testdata/*.found.txt) and create more .found.txt to ensure import processing is running correctly. -- There's a list of various bugs, deficiencies and important missing features in known_bugs_and_planned_features.txt. -- In the main GUI there's various menu points marked with todo - all of these will have to be done eventually. - -If you want to take a look at coding-style.txt. -Ideally use git (see git-instructions.txt for some commands) and let me know where to pull from, alternatively feel free to send patches or even just changed file in whatever code layout or naming convention you like best. I will, of course, still give you full credit. - -Contact/Communication -===================== -If you start working on something please open a bug or feature request at sf to avoid someone else from doing the same -Please see readme-overview - -Dependencies -============ -Please let me know before you add any new dependencies and ensure that they are source-compatible between *nix and Windows - -Code/File/Class Structure -========================= -Basically the code runs like this - -fpdb.py -> bulk importer tab (import_threaded.py) -> fpdb_import.py -> fpdb_parse_logic.py -> fpdb_save_to_db.py -or -fpdb.py -> table viewer tab (table_viewer.py) (todo: -> libTableViewer) - -All files call the simple methods that I just collected in fpdb_simple.py, to abstract the other files off the nitty gritty details as I was learning python. -I'm currently working on (amongst other things) integrating everything into the fpdb.py GUI with a view to allow easy creation of a CLI client, too. - -Also see filelist.txt. - -How to Commit -============= -Please make sure you read and accept the copyright policy as stated in this file. Then see git-instructions.txt. Don't get me wrong, I hate all this legalese, but unfortunately it's kinda necessary. - -Copyright/Licensing -=================== -Copyright by default is handled on a per-file basis. If you send in a patch or make a commit to an existing file it is done on the understanding that you transfer all rights (as far as legally possible in your jurisdiction) to the current copyright holder of that file, unless otherwise stated. If you create a new file please ensure to include a copyright and license statement. - -The licenses used by this project are the AGPL3 for code and FDL1.2 for documentation. See readme-overview.txt for reasons and if you wish to use fpdb with different licensing. - -Preferred File Formats -====================== -Preferred: Where possible simple text-based formats, e.g. plain text (with Unix end of line char) or (X)HTML. Preferred picture format is PNG. IE-compability for HTML files is optional as IE was never meant to be a real web browser, if it were they would've implemented web standards. - -Also good: Other free and open formats, e.g. ODF. - -Not good: Any format that doesn't have full documentation freely and publicly available with a proper license for anyone to implement it. Sadly, Microsoft has chosen not fulfil these requirements for ISO MS OOXML to become a truly open standard. - -License (of this file) -======= -Trademarks of third parties have been used under Fair Use or similar laws. - -Copyright 2008 Steffen Jobbagy-Felso -Permission is granted to copy, distribute and/or modify this -document under the terms of the GNU Free Documentation License, -Version 1.2 as published by the Free Software Foundation; with -no Invariant Sections, no Front-Cover Texts, and with no Back-Cover -Texts. A copy of the license can be found in fdl-1.2.txt - -The program itself is licensed under AGPLv3, see agpl-3.0.txt diff --git a/docs/readme-overview.txt b/docs/readme-overview.txt deleted file mode 100644 index 3c26769f..00000000 --- a/docs/readme-overview.txt +++ /dev/null @@ -1,91 +0,0 @@ -This file is badly out of date, but I'm going to leave it here for now. :) -More up-to-date information is on the wiki: http://fpdb.wiki.sourceforge.net/ -REB 30-Jan-2009 - - -Summary -======= -A database program to track your online poker games, the behaviour of the other players and your winnings/losses. Supports Holdem, Omaha, Stud and Razz for cash games as well as SnG and MTT tournaments with more possibly coming in the future. Some of this is not yet working though, please see status.txt and known-bugs-and-planned-features.txt - -Contact -======= -Please note that this project has two hostings: one at assembla.com which holds are version control "central tree" (irrelevant for users) and everything else at http://sourceforge.net/projects/fpdb/. - -The best means of contact are the sourceforge page: Use the bug, feature request or patch functions or just post in the forum. - -Alternatively feel free to contact me directly: - -mail: steffen(at)sycamoretest.info -jabber/xmpp/Google Talk: as above -ICQ: 7806355 -MSN: steffenjf@gmx.de (don't email that) - -But you could send all my hand histories to yourself! -===================================================== -At the end of the day this comes down to a question of trust, but unlike Windows and the poker client software you don't have to trust fpdb blindly. You can: -- Verify the source code yourself. -- Convince or pay someone to verify the source code for you. -- Use a personal firewall to completely block fpdb from the Internet -- (for the uber-paranoid) Get yourself the free virtualisation software VirtualBox, set up a VM (virtual machine) to run fpdb but run the poker software on your real PC. Then cut the VM off the Internet, fpdb doesn't need it. If you have a PC made in the last few years this should run fast enough as well. Note that most Windows licenses do NOT permit you to use two Windows installations at once, even if they are on the same PC. - -Installing -========== -See the install-*.txt for your operating system. If your OS is missing or if you have problems let me know (contacts are further below). In particular I'd be happy to provide packages for GNU/Linux and *BSD distributions. - -Using it -======== -See readme-user.txt -If you have a problem, request or question see the contacts section below - -Changing it -=========== -See readme-dev.txt - -Requirements -============ -Software requirements are listed in requirements.txt -As for hardware, my main test machine is a Pentium 3-M 800 with 256 RAM and Gentoo GNU/Linux -(running the poker client through what most people will call emulation). So this -program will have to work on that. If you run an even more ancient machine and -its too slow let me know and I'll see what I can do :) - -Why Free Software? -================== -This program is released under the terms of the free/libre software license AGPL3 as released by the FSF. The AGPL3 protects your rights and those of the wider community. As Richard Stallman, one of the founders of the free software movement, put it: "Free software is a matter of liberty, not price. To understand the concept, you should think of free as in free speech, not as in free beer." (well, it is both really, like the right to vote used to be free) - -For example, a "pirated" copy of proprietary software X is free of charge, but you don't actually have a legal right to use it, you don't have any possibility to fix its bugs and you certainly don't have any legal right to share it with your friends. You also won't be able to get support, often not even security fixes. Actually, even if you pay hundreds of pounds for your program they deny your right to fix their errors for them. Imagine buying a car where you're not permitted (under threat of jail) to replace broken parts.. - -With free/libre software (also known as open source software, or short FOSS or FLOSS) on the other hand you get all these freedoms: -(note: the legally binding terms are in the license text, this is merely an amateur summary so normal people don't have to read pages of legalese) - -Freedom 0: The freedom to use: To run the program, for any purpose. Free of Charge. -Freedom 1: The freedom to study and help yourself. This freedom guarantees your right to study and learn from the source code of the program, and to fix it if it is broken. If you're not a programmer yourself the developers will generally be happy to fix it for you, often even for free. Failing that you can always pay someone from the money you saved on not having to pay for it. -Freedom 2: The freedom to be a decent human being and help your neighbour: I don't threaten you with lawsuits or jail time if you share with your friends and neighbours, subject to the very modest restrictions of the AGPL3. -Freedom 3: The freedom to improve the program and release your improvements to the public (or parts thereof) so that the whole community benefits. Note that you are PERMITTED, but not REQUIRED to distribute your changes. If you do distribute your changes you must do so under the terms of the AGPL3 however. - -Note that this is the license - I retain full copyright over my code, including the right to change the license for future versions. I do not intend to do this however. In any case, any version I released under AGPL3 remains available under that license forever, or more accurately until my copyright expires at which point it goes into the public domain. - -I reject the concept of software patents as a crime and under the European Patent Agreement software patents - even if you mislabel them as "computer-implemented inventions" or whatever - are explicitly prohibited. - -Can I get/use this under a different license? -============================================= -The short answer: Maybe. -The long one: As detailed, I fully support what the FSF does and aims to achieve with the GPL. However, I realise that many free software developers don't object to closed source, some don't even object to closed source profiteering of their charity, and I don't think I have any right to go and tell them they're wrong. -So if anyone wishes to use all or part of my code in another free software/open source project with an AGPL3-incompatible license such as BSD then let me know and we'll figure out a solution that makes everyone happy. -If you wish to use all or part of this in closed source let me know how much if anything that is worth to you and I'm sure we'll be able to reach an agreement. Note that you are NOT permitted to just use fpdb code in closed source development whether in-house or by an independent software developer, you will NEED an additionally agreement with me to get fpdb under different licensing conditions. - - -License of this Document -======================== -The views expressed in this document are those of Steffen Jobbagy-Felso, other members of the fpdb team and external contributors may or may not agree. - -Trademarks of third parties have been used under Fair Use or similar laws. - -Copyright 2008 Steffen Jobbagy-Felso -Permission is granted to copy, distribute and/or modify this -document under the terms of the GNU Free Documentation License, -Version 1.2 as published by the Free Software Foundation; with -no Invariant Sections, no Front-Cover Texts, and with no Back-Cover -Texts. A copy of the license can be found in fdl-1.2.txt - -The program itself is licensed under AGPLv3, see agpl-3.0.txt diff --git a/docs/status.txt b/docs/status.txt deleted file mode 100644 index 80f85039..00000000 --- a/docs/status.txt +++ /dev/null @@ -1,80 +0,0 @@ -This file is badly out of date, but I'm going to leave it here for now. :) -More up-to-date information is on the wiki: http://fpdb.wiki.sourceforge.net/ -REB 30-Jan-2009 - -For all support please note that the tables WILL be changed, almost certainly without keeping backwards compatibility. Therefore you should keep your history files after import so you can re-import when necessary. Should you lose history files and need a "database updater" let me know. - -If support for another site/game would encourage you to help with this software please let me know at steffen@sycamoretest.info. - -IMPORTANT: There appears to be a bug in at least up to git34 in reading WtSD/W$wsF/W$SD - -Holdem/Omaha ring games on PokerStars -====================================== -Works, quite well tested, works in table viewer and is useful now. Functionality is quite limited so far though. This includes the holdem/omaha parts of HORSE, HOSE and any other mixed game - -Stud/Razz ring games on PokerStars -================================== -Broken - used to work, hardly tested. Needs to be updated to new infrastructure using a HudData table rather than hands_players_flags. Will fix this shortly. - -Tournaments/SnGs -================ -Broken - used to work, hardly tested. Needs to be updated to new infrastructure.. Will probably fix this shortly - -Full Tilt Poker -=============== -Might work - used to work and was very well test. It should import them (except HudData), but I believe the table viewer won't work. Would be easy to fix I think, volunteers welcome. This used to work in a pre-alpha but basically was left behind during updates to the other stuff. - -Other Sites -=========== -Patches/Volunteers welcome. Should be quite easy. - -GUI -=== -Alpha - the infrastructure stands and is fast enough, now "just" need to add more functionality. - -HUD -=== -Not started - volunteers welcome. I found a *nix utility based on xlib that does half the work for this (most of the other half is already in the table viewer), see http://www.roard.com/docs/cookbook/cbsu19.html. There's also a python implementation of xlib which should run even on Windows. - -Packaging -========= -Gentoo GNU/Linux: I'll make ebuilds, if you want one now let me know. -Other free/libre systems (e.g. other GNU/Linux-Distros, *BSD, and I'd love to help in getting this to work on any Hurd based system): Let me know what you use (Distribution, version and CPU type) and I'll make a package. -Windows/MacOSX: Manual installation of dependencies for now, integrated installer would be nice - volunteers welcome, but I'll do it eventually in any case. - -Regression Testing -================== -The query scripts are done-ish, need to verify more data so it can be used in automated regression testing. - -Database Backends -================= -- MySQL InnoDB is the default -- PostgreSQL should work but I haven't tried it. If it doesn't please let me know. -- MySQL ISAM won't be supported since it is not transactional - -Legal -===== -General: This will offer more or less the same kind of functionality as HM and PT so there shouldn't be any problem on any site that allows tracking. -PS: I have asked them and they said that due to the fast changing nature - of pre-release software they don't review that. However, looking at their - posted guidelines we're fine -FTP: I sent them an email and what I described there was ok for them. -I will write them again for "certification" on release of 1.0 - -To avoid any misunderstandings, PS and FTP obviously do not sponsor, endorse, or support fpdb. They allow using it, that's all. Any problems with fpdb should be reported to us, not the poker site. - -A note on viewing/tracking mucked hands. Many people will say this is cheating. I agree. However, I don't make the rules on these sites. The sites that store mucked hands into the history file clearly think that being able to see other people's mucked hands is ok. This software - like HM and PT - merely takes info provided by the poker site and makes it more easily accessible. -Apparently PS has now turned this off :) - -License -======= -Trademarks of third parties have been used under Fair Use or similar laws. - -Copyright 2008 Steffen Jobbagy-Felso -Permission is granted to copy, distribute and/or modify this -document under the terms of the GNU Free Documentation License, -Version 1.2 as published by the Free Software Foundation; with -no Invariant Sections, no Front-Cover Texts, and with no Back-Cover -Texts. A copy of the license can be found in fdl-1.2.txt - -The program itself is licensed under AGPLv3, see agpl-3.0.txt From 1846abb6034f135f67d8e1bbce3665f222a7061d Mon Sep 17 00:00:00 2001 From: Ray Date: Thu, 26 Mar 2009 16:17:38 -0400 Subject: [PATCH 2/4] Updated readme. Deleted more obsolete files in docs. --- docs/abbreviations.txt | 47 --------------- docs/benchmarks.txt | 75 ------------------------ docs/codingstyle.txt | 27 --------- docs/db-todo.txt | 22 ------- docs/known-bugs-and-planned-features.txt | 62 -------------------- docs/readme-user.txt | 47 --------------- docs/readme.txt | 64 ++++++++++++++++++++ 7 files changed, 64 insertions(+), 280 deletions(-) delete mode 100644 docs/abbreviations.txt delete mode 100644 docs/benchmarks.txt delete mode 100644 docs/codingstyle.txt delete mode 100644 docs/db-todo.txt delete mode 100644 docs/known-bugs-and-planned-features.txt delete mode 100644 docs/readme-user.txt create mode 100644 docs/readme.txt diff --git a/docs/abbreviations.txt b/docs/abbreviations.txt deleted file mode 100644 index 94fd5b16..00000000 --- a/docs/abbreviations.txt +++ /dev/null @@ -1,47 +0,0 @@ -HUD/table viewer -================ -A3-7=3rd-7th street Complete/Raise percentage -AF=Flop Bet/Raise percentage -AT=River Bet/Raise percentage -AR=Turn Bet/Raise percentage -F3-7=3rd-7th street Fold percentage -FB=like FSB but for big blinds only -FF=Flop Fold percentage -FR=River Fold percentage -FSB=Fold to steal - combined of small and big blind (FSB means Fold Small Big). E.g. if a player faced a steal attempt in the SB 7 times and -FS=like FSB but for small blinds only. -FT=Turn Fold percentage -HD=Hands -PF3B4B=Pre Flop 3Bet or 4Bet -PFR=Pre Flop Raise -Postf A=Postflop (ie. flop+turn+river) Aggression% -Postf F=Postflop Fold % -SD/F=Showdown/Flop=WtSD=How often player went to showdown when he saw the flop -ST=Steal chance (nobody had entered the pot before the player in question, and the player is in cutoff, button or SB position) -W$wsF=Won $ when he saw flop -W$@SD=Won $ at showdown -VPI3=Voluntary Put In on 3rd Street (ie. call+complete+raise) -VPIP=Voluntary Put In Preflop (ie. call+raise) - -Other -===== -CLI=Command Line Interface (Shell, Terminal, "DOS-window") -FTP=Full Tilt Poker -GUI=Graphical User Interface (normal interface with buttons and menus) -HUD=Heads-Up Display (shows stats directly in the poker software) -PS=PokerStars -MTT=Multi Table Tournament -SnG=Sit and Go - -License -======= -Trademarks of third parties have been used under Fair Use or similar laws. - -Copyright 2008 Steffen Jobbagy-Felso -Permission is granted to copy, distribute and/or modify this -document under the terms of the GNU Free Documentation License, -Version 1.2 as published by the Free Software Foundation; with -no Invariant Sections, no Front-Cover Texts, and with no Back-Cover -Texts. A copy of the license can be found in fdl-1.2.txt - -The program itself is licensed under AGPLv3, see agpl-3.0.txt diff --git a/docs/benchmarks.txt b/docs/benchmarks.txt deleted file mode 100644 index 9f3bc680..00000000 --- a/docs/benchmarks.txt +++ /dev/null @@ -1,75 +0,0 @@ -benchmarks -========== -All measurements on my Athlon64@1.1GHz, 1 GB RAM, RAID5, Hardened Gentoo Linux 2.6.23 -From svn47 all measurements on my Athlon64 X2@1GHz, 2GB RAM -All measurements were ran several times in a row, unless otherwise noted the computer was mostly idle -svn12/15 were with PostgreSQL, svn23 onwards with MySQL -All import measurements were taken immediately after reseting the tables - -svn12, whilst compiling open office in the background -===== -reseting tables (incl filling default data): 0.5-0.6s -importing one hand from a file: 0.5-0.7s - -svn15 -===== -reseting tables (incl filling default data): 0.35-0.4s -importing one FTP hand from a file: 0.2-0.3s or 12-18k/hr -importing 51 FTP hands: 2.8-2.9s or 63-66k/hr -The large speedup will be partially due to not compiling in the background, and -partially due to less connecting/disconnecting the DB I'd imagine. -I'm VERY happy with this performance, but large gains could probably be made by -making the importer just a bit more sensible. - -svn23 -===== -reseting tables (incl filling default data): 0.3-0.35s -importing 75 PS hands: 3.2s or 84k/hr -importing 180 FTP hands: 7.7-7.9s 82k/hr -This is the rewrite in import_FTP_and_PS.py, svn12/15 are with import_file.py -Nice, it's substantially faster inspite of supporting PS and FTP (ish) rather -than just FTP and handling more special cases. - -svn24 -===== -importing 75 PS hands: 3.2-3.3s or 82k/hr -importing 507 FTP hands: 23.5-23.8s or 77k/hr -importing 947 FTP hands: 76.2-72.7s or 44k/hr -As you can see FTP has gotten about 6% slower on 500 hands - but the much expanded handling -of new cases (particularly the ante folding will be ALOT of extra string -comparisons) easily explains that. In fact I expected a much bigger impact. - (I suspect this is due to the parsing pausing whilst my shell catches up) - -svn47 -===== -It significantly slows down as the database gets larger, after a few thousand -hands it got to just one hand per second and slower. However, around 90% of the -CPU load was MySQL. Any tips are most welcome.. - -svn52 (whilst watching movie in a small window) -===== -Importing 2500 hands (mixed sites+types): 6m15s or 31k/hr (ran twice) -Of these 230 were skipped as duplicate or partial so counting 2270 hands - -svn53 (whilst watching movie in a small window) -===== -Importing the 2270 hands from svn52: 1m50 or 74k/hr (82 if counting dupes/partial) -Importing my 35661 (plus 427 dupe/part) hands: 51m51s or 41k/hr (ran once) - -The dbsize still has a significant impact, but with these sizes certainly it's -just not a problem. If anyone runs a larger database let me know how long it takes. -Thanks bwarycha for the tip with the foreign keys! - - -License -======= -Trademarks of third parties have been used under Fair Use or similar laws. - -Copyright 2008 Steffen Jobbagy-Felso -Permission is granted to copy, distribute and/or modify this -document under the terms of the GNU Free Documentation License, -Version 1.2 as published by the Free Software Foundation; with -no Invariant Sections, no Front-Cover Texts, and with no Back-Cover -Texts. A copy of the license can be found in fdl-1.2.txt - -The program itself is licensed under AGPLv3, see agpl-3.0.txt diff --git a/docs/codingstyle.txt b/docs/codingstyle.txt deleted file mode 100644 index 31c113f9..00000000 --- a/docs/codingstyle.txt +++ /dev/null @@ -1,27 +0,0 @@ -This is just a loose collection of things so far, but might as well make a start :) - -A word on wrapping: Please avoid making manual line breaks, the computer can and therefore should do it. Whether people use a phone or a 40" super-uber-HD screen, they should be allowed to use as much of it as they wish/can. Incidentially, if anyone knows how to activate line wrap in Eclipse I'd really appreciate if you let me know. - -Comments (or prints) with todo are things that are missing, bugs, or just messy code. - -After every def (ie. at the end of the method) there should be a comment including the name, e.g. -#def end of parseActionLine - -If you don't mind make names in java style, ie.: -Classes, files or tables like this: MyClassName -Methods and variables like this: myMethodName - -I'll eventually change all my code to that style, too. - -License -======= -Trademarks of third parties have been used under Fair Use or similar laws. - -Copyright 2008 Steffen Jobbagy-Felso -Permission is granted to copy, distribute and/or modify this -document under the terms of the GNU Free Documentation License, -Version 1.2 as published by the Free Software Foundation; with -no Invariant Sections, no Front-Cover Texts, and with no Back-Cover -Texts. A copy of the license can be found in fdl-1.2.txt - -The program itself is licensed under AGPLv3, see agpl-3.0.txt diff --git a/docs/db-todo.txt b/docs/db-todo.txt deleted file mode 100644 index 9d8c0042..00000000 --- a/docs/db-todo.txt +++ /dev/null @@ -1,22 +0,0 @@ -stats to add -============ -*CC,TotalColdCalls,TimesFacingRaisePreflop -**Folded to 3-Bet,FoldedToThreeBetPreflop,FacedThreeBetPreflop -Called 3-Bet,CalledThreeBetPreflop,FacedThreeBetPreflop -*Winning %,wonhand,TotalHands -**Flop Aggression Factor,timesaggressiveflop,timescalledflop -**Turn Aggression Factor,timesaggressiveturn,timescalledturn -**River Aggression Factor,timesaggressiveriver,timescalledriver -scoopedPot (useful for hi/lo split games) - -couldSqueeze, didSqueeze, facedSqueeze, calledSqueeze -> if (player raises from EP) and (someone after him calls) and (someone after that goes all in) -Donk Bet Turn,DidDonkBetTurn,CouldDonkBetTurn -> EP raises, LP reraises, EP calls. If EP bets out after the flop, it is considered a donk bet -Float Turn,DidFloatTurn,CouldFloatTurn -> - -other -===== -look at PT3 and HM tables see if i forgot anything -store all-in somewhere -add somewhere: mixed flag to denote that the game is part of a mixed game rotation - -add tables for single draw (5card draw, 2-7 single draw, badugi) and tripple draw (2-7 tripple draw) diff --git a/docs/known-bugs-and-planned-features.txt b/docs/known-bugs-and-planned-features.txt deleted file mode 100644 index aed9eb6c..00000000 --- a/docs/known-bugs-and-planned-features.txt +++ /dev/null @@ -1,62 +0,0 @@ -This file is badly out of date, but I'm going to leave it here for now. :) -More up-to-date information is on the wiki: http://fpdb.wiki.sourceforge.net/ -REB 30-Jan-2009 - -Everything is subject to change and the order does not indicate priority. Patches for any of these or other features are very welcome, see readme-overview.txt for contacts. -Please also see db-todo.txt - -before beta -=========== -change to savannah? - - - -Any comment or print with "todo" in it in the sourcecode except what is marked todo in the menu -make a quick benchmark of mysql and postgresql: import of my whole db, some tableviewer refreshes with and without updated file -Make tab and enter work as sensible in GUIs and implement Ctrl+Q, Ctrl+X and Alt+F4 for close. -use profile file for bulk import and table viewer settings and pathes -check that we read sitout correctly in: Full Tilt Poker Game #6150325318: Table Bogside -verify at least 2 or 3 sng hands - -no rush but before 1.0RC -======================== -improve handling of dead hand before BB, see git101/7bd1631 -make DB version error offer reimport, recreation and continue. -In many places there are unnecessary database accesses or it regenerates information it already had before or just generally does things in obscenely inefficient ways. Optimise this -multi-select in bulk importer -cut down action_types array size to appropriate length -make the gui display errors -log file -move directory import code from gui to backend -convert fpdb_import to not require passing "self", generally clean the parameter passing -Doesn't handle Daylight Saving Time (I don't think at least) -ensure that refresh still takes no more than 10 seks on my P3M-800 (a quick run on git15 indicates this is ok now), or 5 with remote DB -select range of stakes and sng/mtt values and types for hud -recognise somewhere if a file is still active and if so keep it open and only read new hands rather than detecting dupes -return full ftp functionality - -can wait till 1.x -================= -in all importer: stop doing if site=="ftp", make class constants for site_id instead -It treats fold due to disconnect as voluntary fold which is not ideal -aliases -repair hands where the seat lines are missing, happens when observing at FTP -flags for storing the reason for winning (best hi, tie for best low, etc.) to DB. not sure actually if this is such a good idea remember that there can be multiple reasons for the same player in the same hand -benchmark properly on mysql innodb, postgresql, more? -rename things like this: ClassName.methodName and variableName. update codingstyle -CLI (not ncurses, normal CLI) equivalent for fpdb.py -optimise/simplify storing by creating the SQL statements depending on hand rather than calling different methods -make range of activeSeats configurable for tv/hud - -License -======= -Trademarks of third parties have been used under Fair Use or similar laws. - -Copyright 2008 Steffen Jobbagy-Felso -Permission is granted to copy, distribute and/or modify this -document under the terms of the GNU Free Documentation License, -Version 1.2 as published by the Free Software Foundation; with -no Invariant Sections, no Front-Cover Texts, and with no Back-Cover -Texts. A copy of the license can be found in fdl-1.2.txt - -The program itself is licensed under AGPLv3, see agpl-3.0.txt diff --git a/docs/readme-user.txt b/docs/readme-user.txt deleted file mode 100644 index 8a186667..00000000 --- a/docs/readme-user.txt +++ /dev/null @@ -1,47 +0,0 @@ -This file is badly out of date, but I'm going to leave it here for now. :) -More up-to-date information is on the wiki: http://fpdb.wiki.sourceforge.net/ -REB 30-Jan-2009 - -Before you do this make sure you setup the dependencies, the database, user, tables and config file. - -Running it -========== -If you have python setup properly you can execute it by double clicking pyfpdb/fpdb.py. - -Note however that all error messages are currently only printed if you call it from a shell. It'll be much easier to diagnose possible problems (which are likely in alpha stage) if you run it from a shell. In Windows XP it seems to automatically open a shell window with the fpdb window where you can see the command line output. - -In Linux/MacOS/*BSD, e.g. if its in /home/sycamore/fpdb/, do this: -cd /home/sycamore/fpdb/pyfpdb -python fpdb.py - - -That will start the main GUI. - -Have a look at the menus, the stuff that is marked todo is not yet implemented. - -The main things are the bulk importer and the table viewer. To use the importer open it from the menu (import files and directories). You can set a few options at the bottom, then select a folder or single file in the main are and click Import. Please report any errors by one of the contacts listed in readme-overview.txt. -Currently this will block the interface, but you can open another instance of this program e.g. if you wanna play whilst a big import is running. - -Please check the output at the shell for errors, if there are any please get in touch by one of the methods listed in readme-overview.txt - -Table Viewer (tv) -================= -To use the table viewer open it from the menu, select the hand history file of the table you're at, and click the Import&Read&Refresh button. The abbreviations there are explained in abbreviations.txt, but feel free to ask. Note that most poker software will only create the file once the first hand you payed to play is finished. -In each column there is either just the number (hand count for current stake, range of seats and type of game) or a percentage and the number of hands that this percentage is based on. For example, in W$@SD (won $ at shodown) the number in brackets is how many showdowns that player has seen. - -Reimporting -=========== -Currently on most updates a reimport of the whole database is required. To do this open fpdb, click the menu Database and select Create/Recreate tables. Then import all your history files again. - -License -======= -Trademarks of third parties have been used under Fair Use or similar laws. - -Copyright 2008 Steffen Jobbagy-Felso -Permission is granted to copy, distribute and/or modify this -document under the terms of the GNU Free Documentation License, -Version 1.2 as published by the Free Software Foundation; with -no Invariant Sections, no Front-Cover Texts, and with no Back-Cover -Texts. A copy of the license can be found in fdl-1.2.txt - -The program itself is licensed under AGPLv3, see agpl-3.0.txt diff --git a/docs/readme.txt b/docs/readme.txt new file mode 100644 index 00000000..03e071d3 --- /dev/null +++ b/docs/readme.txt @@ -0,0 +1,64 @@ +README.txt +updated 26 March 2009, REB + +fpdb - Free Poker Database + +The most accurate and up-to-date information on fpdb will be found in the wiki: +http://fpdb.wiki.sourceforge.net/ + +Other resources are: + Mailing list: http://sourceforge.net/mailarchive/forum.php?forum_name=fpdb-main + Chat room(irc): #fpdb on freenode.net + +fpdb is a free program for use with on line poker. It provides: + Tracking of your results and statistics. + Tracking of opponents' results statistics. + Win/loss graphing + Heads Up Display (HUD) with a variety of statistics + Display of mucked cards in the HUD + +fpdb supports: + Sites: + PokerStars + Full Tilt Poker + Everleaf Network + Other sites are under development and are easily added + + Games: + Holdem + Omaha (incl Hi/low) + 7 Card Stud (incl Hi/low) + Razz + Draw support is under development + Mixed Games -- HUD under development + + Operating Systems: + Linux and other Unix-like, using X + Windows + Mac OS/X -- no support for HUD + + Databases: + MySQL + PostgreSQL + SQLite under development + +Downloads: + Releases: http://sourceforge.net/project/showfiles.php?group_id=226872 + Development code via git: http://www.assembla.com/spaces/free_poker_tools/trac_git_tool + +Developers: + At least 7 people have contributed code or patches. Others are welcome. + +License +======= +Trademarks of third parties have been used under Fair Use or similar laws. + +Copyright 2008 Steffen Jobbagy-Felso +Copyright 2009 Ray E. Barker +Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, +Version 1.2 as published by the Free Software Foundation; with +no Invariant Sections, no Front-Cover Texts, and with no Back-Cover +Texts. A copy of the license can be found in fdl-1.2.txt + +fpdb itself is licensed under AGPLv3, see agpl-3.0.txt. From c8d80eef191bd36833adc24f38286645025ff6dd Mon Sep 17 00:00:00 2001 From: Ray Date: Fri, 27 Mar 2009 13:21:33 -0400 Subject: [PATCH 3/4] Revert Eric's change that failed on special chars in player name. Should be able to get the new player id from connction.insert_id(). --- pyfpdb/fpdb_simple.py | 40 +++++++++++++++++++++++++++------------- 1 file changed, 27 insertions(+), 13 deletions(-) diff --git a/pyfpdb/fpdb_simple.py b/pyfpdb/fpdb_simple.py index 2c432c75..aa0b2e9f 100644 --- a/pyfpdb/fpdb_simple.py +++ b/pyfpdb/fpdb_simple.py @@ -1393,19 +1393,33 @@ def recogniseTourneyTypeId(cursor, siteId, buyin, fee, knockout, rebuyOrAddon): # then this can be reduced in complexity a bit def recognisePlayerIDs(cursor, names, site_id): - cursor.execute("SELECT name,id FROM Players WHERE name='%s'" % "' OR name='".join(names)) # get all playerids by the names passed in - ids = dict(cursor.fetchall()) # convert to dict - if len(ids) != len(names): - notfound = [n for n in names if n not in ids] # make list of names not in database - if notfound: # insert them into database - cursor.executemany("INSERT INTO Players (name, siteId) VALUES (%s, "+str(site_id)+")", (notfound)) - cursor.execute("SELECT name,id FROM Players WHERE name='%s'" % "' OR name='".join(notfound)) # get their new ids - tmp = dict(cursor.fetchall()) - for n in tmp: # put them all into the same dict - ids[n] = tmp[n] - - # return them in the SAME ORDER that they came in in the names argument, rather than the order they came out of the DB - return [ids[n] for n in names] + result = [] + for i in xrange(len(names)): + cursor.execute ("SELECT id FROM Players WHERE name=%s", (names[i],)) + tmp=cursor.fetchall() + if (len(tmp)==0): #new player + cursor.execute ("INSERT INTO Players (name, siteId) VALUES (%s, %s)", (names[i], site_id)) + #print "Number of players rows inserted: %d" % cursor.rowcount + cursor.execute ("SELECT id FROM Players WHERE name=%s", (names[i],)) + tmp=cursor.fetchall() + #print "recognisePlayerIDs, names[i]:",names[i],"tmp:",tmp + result.append(tmp[0][0]) + return result + +#def recognisePlayerIDs(cursor, names, site_id): +# cursor.execute("SELECT name,id FROM Players WHERE name='%s'" % "' OR name='".join(names)) # get all playerids by the names passed in +# ids = dict(cursor.fetchall()) # convert to dict +# if len(ids) != len(names): +# notfound = [n for n in names if n not in ids] # make list of names not in database +# if notfound: # insert them into database +# cursor.executemany("INSERT INTO Players (name, siteId) VALUES (%s, "+str(site_id)+")", (notfound)) +# cursor.execute("SELECT name,id FROM Players WHERE name='%s'" % "' OR name='".join(notfound)) # get their new ids +# tmp = dict(cursor.fetchall()) +# for n in tmp: # put them all into the same dict +# ids[n] = tmp[n] +# +# # return them in the SAME ORDER that they came in in the names argument, rather than the order they came out of the DB +# return [ids[n] for n in names] #end def recognisePlayerIDs From 1d45137502184151433ce1f8d6193ad8f8c5e7de Mon Sep 17 00:00:00 2001 From: Ray Date: Fri, 27 Mar 2009 13:26:01 -0400 Subject: [PATCH 4/4] Change fastStoreHudCache = False as default Import parameter. --- pyfpdb/Configuration.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pyfpdb/Configuration.py b/pyfpdb/Configuration.py index 1e038445..8db1f14f 100755 --- a/pyfpdb/Configuration.py +++ b/pyfpdb/Configuration.py @@ -213,7 +213,7 @@ class Import: self.callFpdbHud = node.getAttribute("callFpdbHud") self.hhArchiveBase = node.getAttribute("hhArchiveBase") self.saveActions = fix_tf(node.getAttribute("saveActions"), True) - self.fastStoreHudCache = fix_tf(node.getAttribute("fastStoreHudCache"), True) + self.fastStoreHudCache = fix_tf(node.getAttribute("fastStoreHudCache"), False) def __str__(self): return " interval = %s\n callFpdbHud = %s\n hhArchiveBase = %s\n saveActions = %s\n fastStoreHudCache = %s\n" \